Skip to content

3.0.0

Choose a tag to compare

@vbabenkoru vbabenkoru released this 30 Jul 21:17
· 2516 commits to master since this release

3.0.0

Released on 2018-07-30

Added

  • Full FCM support
  • Added support for push action buttons
  • Added a new SDK initialization method that takes IterableConfig object with configuration options
  • User ID/email is now decoupled from SDK initialization. It can be changed by calling setEmail or setUserId on the IterableApi instance.
  • The SDK now stores attribution data within 24 hours of opening the app from a push notififcation or from an App Link in an email
  • Added two handlers: IterableUrlHandler and IterableCustomActionHandler that can be used to customize URL and custom action handling for push notifications
  • Added getPayloadData() method to retrieve the entire notification payload for the notification that opened the app (thanks @steelbrain)

Removed

  • Removed GCM support

Changed

  • Old initialization methods (sharedInstanceWithApiKey) are now deprecated
  • Old registerForPush and registerDeviceToken methods are now deprecated

Migration Notes

  1. If you're using GCM, update your Android app to Firebase Cloud Messaging
  2. Replace IterableAPI.sharedInstanceWithApiKey(...) with the following:
IterableConfig config = new IterableConfig.Builder()
        .setPushIntegrationName("myPushIntegration")
        .setUrlHandler(this)        // If you want to handle URLs coming from push notifications
        .build();
IterableApi.initialize(context, "YOUR API KEY", config);
  1. Call registerForPush() to retrieve the push token and register the device.
  2. User email/userId is now persisted, so you'll only need to call setEmail or setUserId when the user logs in or logs out.
  3. The SDK now tracks push opens automatically, as long as the SDK is initialized in Application's onCreate. See README for instructions. Once it is set up, remove all direct calls to trackPushOpen.