Show Menu


Cumulative release notes for iOS.
To find the current library version, turn on debug logging.
Mobile library downloads are available on GitHub and on Developer Connection .

Version 4.13.4

The iOS SDK version 4.13.4 (Feb 16, 2017) includes the following changes:
Feature Description
In-App Messaging
Fixed an issue preventing the proper app version to be used when determining an audience. This issue occurred when a user had an app version upgrade without a new Lifecycle launch.
Added a three-second delay prior to making API calls for Apple Search Ad data on app installs (as per the recommendation of the documentation).

Version 4.13.3

The iOS SDK version 4.13.3 (Jan 19, 2017) includes the following changes:
Feature Description
In-App Messaging
You can now disable fullscreen messages when VoiceOver is running.
Improved handling of read-only database access.
Fixed an issue that could sometimes cause a crash when calling a tracking method from the background while using App Groups.

Version 4.13.2

The iOS SDK version 4.13.2 (Nov 10, 2016) includes the following changes:
Feature Description
Visitor ID Service
Added timestamp and Experience Cloud Organization ID to adobe_mc parameter.
Invalid IDFAs (00000000-0000-0000-0000-000000000000) passed to the SDK via setAdvertisingIdentifier: will be ignored.
Deep Linking
When calling trackAdobeDeepLink , variables prefixed with " adb " and " ctx " are now handled properly.
Data from Apple Search Ads will now be sent along with your acquisition data.

Version 4.13.1

The iOS SDK version 4.13.1 (Oct 20, 2016) includes the following changes:
Feature Description
The SDK now supports custom acquisition data to be returned appropriately by AdobeDataCallback invocations.
Visitor ID Service parameters are now passed in Target requests via mboxParams .
Bug Fixes
  • Fixed an issue that could cause a crash when trying to sync new ID to the VisitorID service at the same time as sending tracking hits to Adobe Analytics.
  • Fixed an issue that was causing build warnings when targeting iOS versions older than 8.

Version 4.13.0

The iOS SDK version 4.13.0 (Sep 15, 2016) includes the following changes:
Feature Description
In-App Messaging
New feature: Added a new message type that opens a deep link URI.

Version 4.12.0

The iOS SDK version 4.12.0 (Aug 18, 2016) includes the following changes:
Feature Description
Visitor ID Service
Added new method to append visitor identity to a given URL in order to transfer identity to a web-based implementation.
In-App Messaging
Fixed an issue that could cause a crash when setting the "target" attribute to "_blank" in an HTML tag in a custom full-screen message.

Version 4.11.0

The iOS SDK version 4.11.0 (June 22, 2016) includes the following changes:
Feature Description
Target methods
You can now use the following new Target method:
  • targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mboxParameters:requestLocationParameters:callback:

Version 4.10.0

The iOS SDK version 4.10.0 (May 20, 2016) includes the following changes:
Feature Description
Target methods
You can now use the following new Target methods:
  • targetLoadRequestWithName:defaultContent:profileParameters:orderParameters:mboxParameters:callback:
  • targetThirdPartyID
  • targetSetThirdPartyID:
  • targetPcID
  • targetSessionID
TVJS methods
You can now use the following new Target TVJS methods:
  • targetThirdPartyID
  • targetSetThirdPartyID
  • targetPcID
  • targetSessionID
Adobe Target for TVML/TVJS
You can now use the following property names when configuring your ADBTarget element:
  • id
  • total
  • purchasedProductIds
  • mboxParameters

Version 4.9.0

The iOS SDK version 4.9.0 (May 5, 2016) includes the following changes:
Feature Description
Deep linking
You can implement deep linking in your applications to drive users to app or web link destinations.

Version 4.8.6

The iOS SDK version 4.8.6 (March 9, 2016) includes the following changes:
Feature Description
Track app crashes
The iOS SDK version 4.8.6 contains critical changes that prevent false crashes from being reported. We highly recommend that you update to version 4.8.6.

Version 4.8.5

The iOS SDK version 4.8.5 (February 18, 2016) includes the following changes:
Feature Description
Opt-out and privacy settings
Starting with iOS SDK 4.8.5, privacy settings set via the setPrivacyStatus method affect activity from Analytics , Target , and Audience Manager .

Version 4.8.0

The iOS SDK version 4.8.0 (November 2, 2015) includes the following changes:
Feature Description
New Experience Cloud Visitor ID Service methods
Added the following new methods:
  • visitorSyncIdentifiers:authenticationState:
  • visitorSyncIdentifierWithType:identifier:authenticationState:
  • visitorGetIDs
Changed the visitorSyncIdentifiers:identifiers method to visitorSyncIdentifiers:
New TVJS methods
Added the following new methods:
  • visitorSyncIdentifiersAuthenticationState
  • visitorSyncIdentifierWithTypeIdentifierAuthenticationState
  • visitorGetIDsJs
New ADBMobile JSON Config variable
Added the following variable:
  • analyticsForwardingEnabled

Version 4.7.0

The iOS SDK version 4.7.0 (October 15, 2015) includes the following changes:
Feature Description
tvOS Support
tvOS is supported for Apple TV.
App Transport Security Support
Starting with iOS 9, Apple introduced App Transport Security, a set of requirements that conforms to best practices for secure connections.
PhoneGap Plugin methods
Added the following new methods:
Configuration Methods
  • setPushIdentifier
  • setAdvertisingIndentifier
  • keepLifecycleSessionAlive
  • trackingSendQueuedHits
Tracking Methods
  • trackPushMessageClickthrough
New Target method:
  • targetClearCookies
Acquisition Methods
  • acquisitionCampaignStartForApp
Audience Manager Methods
  • audienceGetVisitorProfile
  • audienceGetDpuuid
  • audienceGetDpid
  • audienceSetDpidAndDpuuid
  • audienceSignalWithData
  • audienceReset
Visitor ID Service Methods
  • visitorGetMarketingCloudId
  • visitorSyncIdentifiers
App Extensions and Apple Watch Methods
  • setAppGroup
  • syncSettings
  • initializeWatch

Version 4.6

The iOS SDK version 4.6 (September 17, 2015) includes the following changes:
Feature Description
Push Messaging to Analytics Segments
Adobe Mobile Services and the Adobe Mobile SDK allow you to send push messages to Analytics segments. The SDK also allows you to easily report users that have opened your app as a result of opening the push message.
Acquisition Methods
Allows developers to start an app acquisition campaign as if the user had clicked a link. This is helpful for creating manual acquisition links and handling the app store redirect yourself.
Postbacks let you send data collected by the SDK to a separate third-party server. Leveraging the same triggers and traits you use to display an in-app message, you can configure the SDK to send customized data to a third-party destination.
Added the following new identifiers:
  • setPushIdentifier
  • setAdvertisingIdentifier
  • The trackPushMessageClickThrough
WatchKit Support for WatchOS 2
Added WatchKit support for WatchOS 2.

Version 4.5

The iOS SDK version 4.5 includes the following changes:
Feature Description
iOS Extension
Starting in iOS SDK version 4.5, a new iOS extension lets you collect usage data from your Apple Watch Apps, Today Widgets, Photo Editing widgets, and all the other iOS extension apps.
We strongly recommend that you use the iOS SDK rather than using your own wrapper.
Apple provides a set of APIs that lets the Watch app communicate with the containing app (sending requests to the containing app and then receiving responses).
Although you can send tracking data as a dictionary from the Watch app to the containing app and then call any tracking method on the containing app to send the data, this solution has limitations.
In most cases when a user is using the Watch app, the containing app is running in the background and it is only safe to call TrackActionInBackground , TrackLocation , and TrackBeacon . Calling other tracking methods interferes with lifecycle data, so you should use only these three methods to send the data from Watch app.
Even if these three tracking methods meet your requirements, we recommend using the iOS SDK because the SDK for watch app includes all Mobile features except in-app messaging.

Version 4.4

Feature Description
Custom data with lifecycle metrics
You can now include custom context data variables with lifecycle metrics.
Beacon tracking support in PhoneGap
The trackBeacon and clearCurrentBeacon calls are now available in PhoneGap .

Version 4.3

Release Date: November 24, 2014
  • New - Adobe Experience Cloud ID integration
  • Improved debug logs for clarity

Version 4.2

Release Date: October 16, 2014
  • New - In App Messaging Capabilities.
  • New - Location for config file can now be specified during app startup.
  • New - Points of Interest can now be updated automatically without requiring a new config file.
  • New - Analytics calls are now sent as HTTP POST requests.
  • Cleared up log messages, added more verbose logging when debugLogging is enabled.
  • Multiple performance and stability enhancements.

Version 4.1.3

Release Date: September 18, 2014
  • Resolved potential crash that could occur if Audience Manager Submit Signal call or Target Load Request call failed due to an unknown network error.

Version 4.1.2

Release Date: August 5, 2014
  • Resolved deadlock issue that could occur with the specific configuration of privacyStatus:optunknown and offlineEnabled:false
Release Date: August 4, 2014
  • Resolved issue that could cause Lifecycle hit to not get sent when referrer timeout was >= 5 seconds and offline tracking was disabled.
Release Date: April 17, 2014
  • Bluetooth beacon tracking.
  • App acquisition analytics.
  • Apps that are timestamp enabled, crash hits are backdated to the correct session.
  • Apps that are timestamp enabled, previous session is sent in a hit that is backdated to the correct session. (no longer previous session)
  • Hit batching.

Version 4.0.2

Release Date: February 20, 2014
  • Resolved issue that caused incorrect behavior when the same media item was opened in sequence without closing previous item.

Version 4.0.1

Release Date: January 30, 2014
  • Resolved issue that could cause multiple hits to be sent when database was corrupted.
  • Resolved issue that could cause large session length averages if a device had incorrect time settings.

Version 3.3.2

Release Date: January 30, 2014
  • Resolved issue that could cause large session length averages if a device had incorrect time settings.

Version 4.0.0

Release Date: 27 September, 2013
iOS SDK 4.x for Experience Cloud Solutions is now available providing the following new features:
  • Significant performance enhancements. All processing is performed on background threads, the SDK is fully thread safe.
  • Geo-location & points-of-interest
  • Lifetime value
  • Timed events
  • Opt-in/opt-out management
  • Audience Manager Support
  • Lifecycle metrics passed to Target as mbox parameters
  • Standardized on context data and processing rules

Version 3.3.0

Release Date: 23 September, 2013
  • Added support for ARM64 and X64 Simulator architectures (iPhone 5s)

Version 3.2.1

Release Date: 16 August, 2013
  • Optimized by removing unused code.
  • Fixed potential crash that could occur when clearVars was used in a threaded scenario.

Version 3.2

Release Date: 6 August, 2013
  • Added support for Adobe Audience Manager.
  • Lifecycle data is now sent with Target Mbox requests when lifecycle tracking is enabled.

Version 3.1.8

Release Date: 20 June, 2013
  • Fixed a bug introduced in 3.1.7 that was causing issues with lifecycle on devices below iOS 5.0.

Version 3.1.7

Release Date: 23 May, 2013
  • Added code to prevent excessive lifecycle hits from being sent via location notifications and Newsstand notifications that launch an app.

Version 3.1.6

Release Date: 18 April, 2013
  • Fixed an issue that was causing previous session length to sometimes be calculated incorrectly.

Version 3.1.5

Release Date: 21 March, 2013
  • ADMS_Measurement.visitorID now gets pre-populated with the default value.

Version 3.1.4

Release Date: 21 February, 2013
  • Deprecated offlineThrottleDelay as the setting is no longer necessary due to thread optimization. The setting still exists to preserve backwards compatibility, but no longer has any effect.

Version 3.1.3

Release Date: November 2012
  • Fixed a potential EXEC_BAD_Access issue when setting the Products variable manually.
  • Fixed a potential invalid selector crash when an mbox timed out.
  • Added ad tracking support to media measurement.

Version 3.1.2

Release Date: October 2012
  • Added a lifecycleSessionTimeout configuration variable that lets you specify the length of time, in seconds, that must elapse between app launches before the launch is considered a new session.
  • Fixed an issue in the media module that caused events set on the measurement object to overwrite events set by the media module.
  • Fixed an issue that caused an exception when allocating an mbox through the Target integration.

Version 3.1.0

Release Date: September 2012
  • Added support for armv7s architecture
  • Removed support for armv6 architecture
  • Minimum supported iOS SDK is now 4.3

Version 3.0.2

Release Date: August 2012
  • Customers using media monitor delegate will no longer see two close events
  • Resolved an issue where close hits could sometimes cause a loop condition in media monitor

Version 3.0

Release Date: July 2012
Initial release.
  • Added "Auto-Tracking" functionality
  • Reduced library size to appx. 90k in final build.
  • Added "trackEvents" and "trackAppState" methods
  • Improved context data support and functionality. (Recommend using context data for all information sent)
  • Simplified tracking so a basic tracking implementation can be done in 5 minutes.
  • AppMeasurement Class is now ADMS_Measurement
  • ADMS_Measurement now acts as a proper Singleton
  • Changed getters and setters for eVars, props, lists, hiers, pevs
  • All variables passed into "track" calls will only persist for that call.
Modified the following variables
Previous (version 2.x)
Current (version 3.x)
Repurposed the following variables:
  • linkURL (sent with trackLinkURL:)
  • linkName (sent with trackLinkURL:)
  • linkType (sent with trackLinkURL:)
  • lightProfileID (sent with trackLight:)
  • lightStoreForSeconds (sent with trackLight:)
  • lightIncrementBy (sent with trackLight:)
  • trackingServerSecure (trackingServer is used when ssl is on)
Removed the following variables:
  • timestamp
  • userAgent
  • dynamicVariablePrefix
  • visitorNamespace
  • pageURL
  • pageType
  • referrer
  • linkLeaveQueryString
  • usePlugins
  • useBestPractices (handled by AutoTracking)
  • delegate
  • retrieveLightData
  • deleteLightProfiles
  • retrieveLightProfiles

Previous iOS Version (2.x)

The following release notes apply to the 2.x version of AppMeasurement for iOS. We recommend customers upgrade to the 3.x version when possible.

Version 2.1.12

Release Date: April 2012
  • Added support for video measurement.
  • Resolved issues regarding linktrackvars and context data.
  • Made several additional performance enhancements.

Version 2.1.11

Release Date: March 2012
  • Fixed an issue that caused offline tracking to stop sending data in some circumstances.

Version 2.1.10

Release Date: February 2012
  • Fixed an issue that caused an EXC_BAD_ACCESS exception in some circumstances when multiple threads attempted to simultaneously make a tracking call.
  • Added time stamp to variables used with light tracking calls (trackLight).

Version 2.1.8

Release Date: January 2012
  • Significantly increased performance of tracking thread.
  • Moved offline hit storage to a location that is not synchronized to iCloud to conform to iCloud best practices.
  • Updated the library to the Apple fat binary format so you no longer need to include the specific library for your build architecture.

Version 2.1.6

Release Date: November 2011
  • Added support for iOS 5.
  • AppMeasurement for iOS was updated to no longer use the deprecated UDID value as the default value for visitorID. If you set a custom visitorID in your application (for example, s.visitorID = @12345 ), then you are unaffected by this change. If you do not set a custom visitorID, instead of using the UDID as the value for visitorID, a random visitorID is generated on initial launch and then stored in a user defaults key. This key is used by AppMeasurement from that point forward. This key is also saved and restored during the standard application backup process.
  • Updated calls from the iOS Best Practices plug-in that are not associated with a page view to send hits using trackLink. This helps prevent these hits from recording page views with the default value of "application name/version" name.

Version 2.1.3

Release Date: October 2011
  • Improved delegate handling. This fixes an issue that caused the iOS Best Practices Plug-in to crash when bringing the application out of the background.

Version 2.1.2

Release Date: September 2011
  • Updated the header to enable use of prop and eVar 51-75.

Version 2.1.1

Release Date: August 2011
  • Ability to search report suites and metrics when running a report.
  • Support for context data that drives server-side processing rules (v15 only).
  • Support for light server calls (currently in beta).