This document provides release notes for significant updates to Iterable's iOS SDK.
For more granular release notes, read the Iterable iOS SDK releases page on GitHub.
Table of contents
- Deprecation and End-of-Life Schedule
- Further reading
6.3.0 - GA (Friday, May 27, 2021)
Iterable's iOS SDK introduces offline events processing. This feature saves a local
copy of events triggered in your app while the device is offline (up to 1000
events). When a connection is re-established and your app is in the foreground, the
events will be sent to Iterable.
Offline events processing off by default, and we're rolling it out on a customer-by-customer basis. After you start using this version of the SDK, we'll send you a message before we enable the feature on your account (unfortunately, we can't give you an exact timeline for when this will happen). If you have any questions, talk to your Iterable customer success manager.
6.2.21 - GA (Tuesday, March 30, 2021)
Iterable's iOS SDK includes:
- Support for syncing in-app message read state across multiple devices. Note
- When the SDK fetches in-app messages from Iterable, it examines each
readfield to determine if it has already been read.
- The SDK's default implementation no longer automatically displays in-app messages that have already been seen on another device (even if those messages were not configured to go directly to the inbox).
- When you view a message, the SDK calls
POST /api/events/trackInAppOpento create an
inAppOpenevent on the user's Iterable profile. Previous versions of the SDK made this same API call, but the call now also causes Iterable to set the message's
- Previous versions of the SDK will correctly sync a message's read / unread indicator for the default implementation of a mobile inbox. However, these older SDK versions will not automatically suppress messages that have already been seen on another device (as this version of the SDK will).
- When the SDK fetches in-app messages from Iterable, it examines each message's
- Support for the display of a custom message (title and body) in an empty mobile inbox. For more details, see Customizing Mobile Inbox on iOS
6.3.0 - Beta 2 (Friday, February 12, 2021)
of Iterable's iOS SDK includes:
- The features introduced in the 6.2.x releases (for example, Mobile Inbox, JWT-enabled API keys, and in-app animations).
- Beta support for offline events processing (capturing engagement events when a device is offline and sending them to Iterable when a network connection is reestablished) and in-app message prioritization (specifying a priority for an in-app message campaign, to determine its display order for your users). To try these beta features, have your Iterable customer success manager enable them for your project.
6.2.0 - GA (Tuesday, February 25, 2020)
6.2.0 - Beta (Tuesday, October 15, 2019)
Version 6.2.0 (beta) of Iterable's iOS SDK works with Iterable's Mobile Inbox feature. With Mobile Inbox, users of your mobile apps can save in-app messages and revisit them when it's convenient or when the content is more relevant.
The SDK includes a default implementation of an inbox user interface, which can be customized as necessary to match your brand's styles. Also, it automatically captures inbox-related events to Iterable, where they can be used to segment users, filter and trigger workflows, or send system webhooks.
To get started with Mobile Inbox:
6.1.0 - GA (June 10, 2019)
Version 6.1.0 of the Iterable iOS SDK is now generally available and supported by Iterable.
This version of the SDK automatically downloads new in-app messages, allows apps more control over which in-app messages to display and when to display them, and consolidates the way deep links are handled across push notifications, in-app messages, and emails. For more information, see the beta announcement.
How to upgrade
Upgrading to version 6.1.0 of the Iterable iOS SDK requires some code changes in your mobile apps. For more details, take a look at the Migrating from a version prior to 6.1.0 instructions on GitHub.
6.1.0 - Beta (Monday, May 13, 2019)
Version 6.1.0 (beta) of Iterable's iOS SDK provides various new features:
- Automatic downloading of new in-app messages
- More control for mobile apps to decide when and how to display in-app messages
- Consolidated handling of deep link URLs, so that the same URLs work when sent in emails, in-app messages, or push notifications
Beta versions of Iterable's mobile SDKs are subject to the Beta Mobile SDK Disclaimer.
New and updated features
This version of the SDK provides the following new and updated features:
Automatic downloading of new in-app messages
With this version of the SDK, mobile apps automatically download all available in-app messages and store them on device. This makes it possible to inspect the messages to decide when and how to display them. Automatic in-app message downloads happen:
- When Iterable sends silent push notifications (not visible or audible to the user) indicating that new in-app messages are available.
- At key points in the mobile app's lifecycle, such as when it launches or comes to the foreground.
This feature makes it easier than ever to test in-app message campaigns. Simply send a proof and wait for it to appear in the app (no need to manually force the app to download new messages, as could be the case with previous versions of the SDK).
More control for mobile apps to decide when and how to display in-app messages
Since this version of the SDK automatically downloads all available in-app messages and stores them on device, the mobile app can examine each message to decide when and how to display it. For example, the app might:
- Skip displaying a particular message
- Display multiple messages in sequence (by default, in-app messages display in sequence, with a 30-second delay between messages—but this is customizable)
- Wait to display a particular message until a network connection is available
- Create a native user interface for a particular message, rather than rendering the HTML supplied by Iterable
- Display a particular in-app message when a user completes a specific action in the app
Consolidated handling of deep link URLs
This version of the SDK provides a common way to handle deep link URLs in a mobile app. With this feature, deep link URLs in emails, in-app messages, and push notifications are all handled in the same way, making it easier for marketers to define a set of deep link URLs that work as expected, regardless of message type.
How to upgrade
Upgrading to the 6.1.0 beta of the Iterable iOS SDK requires some code changes in your mobile apps. For more details, take a look at the Migrating from a version prior to 6.1.0 instructions on GitHub.
To learn more, take a look at the Iterable iOS SDK 6.1.0 beta on GitHub.
Deprecation and End-of-Life Schedule
The following schedule lists the deprecation dates, support windows, and end-of-life dates for various versions of Iterable's iOS SDK. For details about how Iterable supports mobile SDKs, see the Mobile SDK Support Policy.
|SDK||SDK version(s)||Deprecation announcement date||Support window||End-of-life date|
|swift-sdk (Swift)||6.0.x (where x >= 9)||6/10/2019||12 months||6/9/2020|
|swift-sdk (Swift)||6.0.8 and older||6/10/2019||6 months||12/9/2019|
|iterable-ios-sdk (Objective-C)||5.0.3||6/10/2019||6 months||12/9/2019|