AppsFlyer iOS SDK release notes

For:

Marketers Developers

Last update: May 07, 2023 08:13

At a glance: Release notes for iOS SDK V4+.

iOS SDK V6

iOS SDK integration guides for developers

Version	Release date	Maintenance only	Notes
6.11.0	2023-04-25		A new AppsFlyer domain name in the URL used by the SDK to send requests to AppsFlyer servers. Changed behaviour of the setHost API when empty or null values are sent. Learn more
6.10.1	2023-04-02		Added the `link` parameter to the UDL payload of Direct Deep Linkinig scenarios
6.10.0	2023-02-15		SKAdNetwork 4.0 support. Learn more about the AppsFlyer SKAdNetwork solution
6.9.2	2023-01-31		Updated the internal request structure for Get Conversion Data (GCD). Note: Response data remains the same.
6.9.1	2022-11-28		Updated the internal request structure for Get Conversion Data (GCD). Note: Response data remains the same.
6.9.0	2022-11-06		Updated the internal API for AdRevenue reporting. Starting this version, only the Generic Connector for AdRevenue is supported. This version of the SDK is compatible with AdRevenue Connector `V6.9.0`.
6.8.1	2022-08-09		Reinstall Detection: Improved the ability to detect and report re-installations of the app using on-device storage. This capability can be controlled in the AppsFlyer dashboard from the Apps Setting page.
6.8.0 (Deprecated)	2022-07-19		For Reinstall Detection, please use SDK V6.8.1+
6.7.0	2022-06-19		Update the implementation for SKAdNetwork to use the updated Apple API `updatePostbackConversionValue`, introduced in iOS 15.4. This has no effect on the data sent from SKAdNetwork, and does not require any change to the app code.
6.6.1	2022-05-16	Yes
6.6.0	2022-05-01		Added more parameters to UDL's `didResolveDeepLink` callback for Direct Deep Linking flow (existing users). For more information.
6.5.4	2022-03-23	Yes
6.5.3	2022-03-02		Bugfix: Fixed an issue with a double invocation of `didResolveDeepLink` on links based on URI scheme.
6.5.2	2022-01-26	Yes
6.5.1	2022-01-03	Yes
6.5.0	2021-12-22		Refactoring and internal changes.
6.4.4	2021-12-12	Yes
6.4.3	2021-11-30		Stability fix for MacOS 10.14.6 with xcframework.
6.4.2	2021-10-28	Yes
6.4.1	2021-10-24		Resolved stability in Unity apps.
6.4.0	2021-09-12		Added API: `setSharingFilterForPartners` lets you configure which partners the SDK should exclude from data-sharing. As of this version, `setSharingFilter` and `setSharingFilterForAllPartners` are deprecated.
6.3.5	2021-08-19		Added API: `setCurrentDeviceLanguage` Starting this version the language is no longer collected automatically by the SDK.
6.3.4	2021-07-21		Bugfix: Fixed issue with running the SDK on XCode 12.5 Simulators Minor fixes and updates.
6.3.2	2021-06-17		Improved debug logs.
6.3.1	2021-06-02	Yes	Improved stability in Unity plugin.
6.3.0	2021-05-13		Apple Silicon support: Added support to run the SDK on a simulator using Mac machines with the M1 chipset Starting this version, the SDK supports iOS `9`+. iOS `8` is no longer supported. iOS Strict Mode SDK: Added support for Carthage dependency manager Technical update for the OneLink API
6.2.6	2021-04-25		Bugfix: SKAdNetwork rules didn't load when SDK initialization occurred after `didFinishLaunchingWithOptions` Bugfix: `waitForATTUserAuthorization` edge-case causing the launch event to be sent without IDFA, even if user consent is given Allow the SDK to run on iOS 8 devices Cleanup and removal of unused code and data
6.2.5	2021-04-06		Refactoring, cleanup, removal of unused data from the SDK. Starting this version: The `setShouldCollectDeviceName` method is deprecated and will not return the device name The `wifi` parameter sent from the SDK is set to `False`
6.2.4	2021-03-15		Bugfix related to SKAdNetwork revenue measurement mode and in-app events that contain `AF_REVENUE` parameter. Starting this version, in the case of revenue measurement: any event containing `AF_REVENUE` affects the conversion value. Prior to this change, the conversion value was set only if it was in the framework of the`AF_PURCHASE` event. Note: If you implement SKAdNetwork Revenue measurement, you must upgrade to this version.
6.2.3	2021-03-07		Bugfix related to calling SKAdNetwork's `updateConversionValue`.
6.2.2	2021-02-18	Yes
6.2.1	2021-02-15		Support Event reporting by S2S
6.2.0	2021-02-07		Additional API: setPartnerData
6.1.4	2021-01-12	Yes
6.1.3	2020-12-24		Additional API: `addPushNotificationDeepLinkPath` (supports Movable Ink) Support Apple AdServices Framework
6.1.2	2020-12-03	Yes
6.1.1	2020-11-17		Introduce Strict mode SDK
6.1.0	2020-11-09		Support Unified deep linking API
6.0.8	2020-10-28		Support Apple App Clips attribution
6.0.7	2020-10-21	Yes
6.0.6	2020-10-20	Yes
6.0.5	2020-10-08	Yes
6.0.4	2020-09-30		Supports multiple redirects from ESPs
6.0.3	2020-09-06		API name change: waitForAdvertisingIdentifier --> waitForATTUserAuthorization SDK collects IDFA by default for iOS 14 (as for earlier iOS versions)
6.0.2 [deprecated]	2020-08-27		API name change: deviceLoggingDisabled --> anonymizeUser AppTrackingTransparency (ATT) dialog is required to collect IDFA for iOS 14 Added support for IDFV cross-promotion attribution
6.0.1 beta [deprecated]	2020-08-06		Support added for SKAdNetwork attribution, to help advertisers measure campaign success while maintaining user privacy
6.0.0 beta [deprecated]	2020-08-04		Extended debugging capabilities Major changes to SDK functionality and API. Learn more

iOS V6.0.0 release notes

Methods added, removed, or renamed

Methods added

The following methods have been added to the SDK:

waitForAdvertisingIdentifier

Methods removed

The following methods have been removed from the SDK:

disableAppleAdSupportTracking

Methods renamed

API name (before V6)	Current API name (V6 and later)
AppsFlyerTracker	AppsFlyerLib
disableIAdTracking	disableCollectASA
trackAppLaunchWithCompletionHandler	startWithCompletionHandler
trackLocation	logLocationEvent
trackAppLaunch	start
trackEvent	logEvent
disableAppleAdSupportTracking	disableAdvertiserIdentifier
validateAndTrackInAppPurchase	validateAndLogInAppPurchase
isStopTracking	isStopped
deviceTrackingDisabled	deviceLoggingDisabled
sharedTracker (Objective C)	shared

App Tracking Transparency (ATT) support

The iOS SDK supports IDFA collection on iOS 14+ via the App Tracking Transparency framework. For more details:

iOS SDK V5

Version	Release date	Notes
5.4.4	2020-08-23	Bug fixes and maintenance
5.4.3	2020-07-30	Extended logging and debugging capabilities Bug fixes and maintenance
5.4.1	2020-06-30	Allow advertisers to control sharing data with integrated partners/networks. Learn more onAppOpenAttribution method improved for Universal Links long URLs: Link parameters are returned already parsed Bug fixes and maintenance
5.4.0	2020-06-03	MAC Catalyst project support
5.3.0	2020-04-27	Access the latest direct deep linking conversion data anytime, via the onAppOpenAttribution method Additional parameters available for cross-promotion impressions Main apps and app extensions get the same AppsFlyer ID, so in-app events are grouped similarly Bug fixes and maintenance
5.2.0	2020-03-10	Extended logging and debugging capabilities Bug fixes and maintenance
5.1.0	2019-12-23	Improved Obj-C - Swift interoperability Bug fixes and maintenance

iOS V5.0.0 release notes

Improved SDK response time

Starting with SDK V5.0.0 improved GCD response time for organic installs.

Methods removed or renamed

Method name changes

Install conversion data method names are now the same for Android and iOS. This impacts methods that handle:

Conversion data on install
Errors if data is not available

Android name prior to SDK V5	iOS name prior to SDK V5	Standardized name
`onInstallConversionDataLoaded`	`onConversionDataReceived`	`onConversionDataSuccess`
`onInstallConversionFailure`	`onConversionDataRequestFailure`	`onConversionDataFail`

Methods removed

The following methods were deprecated in previous SDK versions. They have now been removed from the SDK.

Android

setGCMProjectID (String projectNumber)
setGCMProjectNumber (String projectNumber)
setGCMProjectNumber (Context context, String projectNumber)
enableUninstallTracking (String senderId)
setAppUserId (String id)
setUserEmail (String email)
setCollectFingerPrint (boolean isCollect)
getAttributionId (ContentResolver contentResolver)
FirebaseInstanceIdListener class (instance of FirebaseInstanceIdService)

iOS

loadConversionDataWithDelegate: (id<AppsFlyerTrackerDelegate>)delegate
setHost:(NSString *)host

Changes to get conversion data format

In this version, for each install or app open, the SDK returns a map object that contains conversion data (GCD) such as media source and campaign name. In previous SDK versions, GCD returned only parameters that had a value

Starting with this version, all parameters are returned, including those without a value. Parameters without value have a null value.

Example

An install follows a click on the following URL:

https://app.appsflyer.com/com.sample.app?pid=super_media_source&c=awesome_campaign
  &campaign_id=1234&af_sub1=promo

The responses are as follows:


   {
      "install_time": "2019-11-11 15:00:59.828",
      "media_source": "super_media_source",
      "orig_cost": "0.0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8c",
      "af_status": "Non-organic",
      "is_first_launch": true,
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "cost_cents_USD": "0",
      "iscache": "true",
      "click_time": "2019-11-11 15:00:35.102",
      "campaign": "awesome_campaign",
      "campaign_id": "1234",
  }


   {
      "adgroup": null,
      "campaign": "awesome_campaign",
      "media_source": "super_media_source",
      "adset_id": null,
      "campaign_id": 1234,
      "iscache": true,
      "install_time": "2019-11-11 15:00:59.828",
      "adgroup_id": null,
      "af_sub5": null,
      "click_time": "2019-11-11 15:00:35.102",
      "agency": null,
      "cost_cents_USD": "0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8",
      "adset": null,
      "af_sub3": null,
      "af_siteid": null,
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "af_cpi": null,
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic",
      "is_first_launch": true,
      "retargeting_conversion_type": "none"
  }

GCD returns the same structure no matter the data. If a parameter is empty, it is included in GCD with a null value. This makes it easier for developers to process GCD without having to adjust the GCD processing logic, irrespective of whether certain parameters are included or not. To learn more about conversion data in different scenarios, see here.

Deprecated versions

Related reading: AppsFlyer SDK version control policy

Version	Release Date	Notes
5.0.0	2019-11-12	Bug fixes and maintenance Major changes to SDK functionality and API. Learn more
4.11.2	2019-11-07	Bug fixes and maintenance
4.11.1	2019-10-31	Bug fixes and maintenance
4.11.0	2019-10-17	Dropped support for iOS 7. iOS 8 is the minimum supported version now. Improved logging for better debug capabilities, ESP and Branded Links resolving as well as for onInstallConversionData and onAppOpenAttribution. Improved fetching of Apple Search Ads.
4.10.4	2019-09-12	Update for iOS 13 push token retrieval needed for Uninstall Measurement Bug fixes and maintenance
4.10.3	2019-07-16	Bug fixes and maintenance
4.10.2	2019-07-02	Bug fixes and maintenance
4.10.1	2019-07-01	Bug fixes and maintenance
4.10.0	2019-05-14	trackAppLaunchWithCompletionHandler API for handling success or failure of tracking app launch completionHandler API for handling success or failure of recording in-app events Bug fixes and maintenance
4.9.0	2019-03-18	setResolveDeepLinkURLs API for resolving OneLinks wrapped with another Universal Link Removed UIPasteboard usage for Meta ads attribution for iOS 7 and below Bug fixes and maintenance
4.8.12	2019-02-13	Improved zero-rating capabilities for cellular providers Improved zero-rating capabilities for cellular providers Bug fixes and maintenance
4.8.11	2019-01-09	waitForCustomerUserId() API is breaking generateLink fixed
4.8.10	2018-10-31	Fixed a race condition when continueUserActivity was invoked after applicationDidBecomeActive causing onAppOpenAttribution not to be called validateAndTrackInAppPurchase ignores extra params fix Bug fixes and maintenance
4.8.9	2018-08-27	New SDK events: Subscribe, Start Trial, Ad Click, Ad View Bug fixes and maintenance
4.8.8	2018-07-30	Fixed an issue when using is_first_launch through JSONSerialiser was returned as an integer rather than boolean Bug fixes and maintenance4.8.7
4.8.7	2018-07-22	Bug fixes and maintenance
4.8.6	2018-06-18	Bug fixes and maintenance
4.8.5	2018-05-29	Bug fixes and maintenance
4.8.4	2018-05-03	Bug fixes and maintenance
4.8.3	2018-01-25	Bug fixes and maintenance shouldCollectDeviceName API af_content event parameter shouldCollectDeviceName API af_content event parameter

iOS SDK checksums

AppsFlyer uses md5 checksums:

V6 checksums

iOS SDK Version	Static Lib	Static Framework
6.6.1	ff41a3dfeb9fe7579f8f706f3c62bbbc	7acf1f10de7602b363a70d4a710b050d
6.6.0	ba2d2d0b64f3b0f6476b818c1b8faf5f	544c7c7e4af29afa4100b6c43affcf8f
6.5.4	5a1146a95abc84b20940b43cacc8b42a	3a0a22a28b4082a5b2f0931104b0a9c8
6.5.3	b33008f83f5eafa864902db97c003c06	3ff6754c8c238dd13e4c6251ffb4aedf
6.5.2	3083df065d14553fb1b4e34f3f7fb381	3ce0ea75e4fe3cf6313fde27d57d20ed
6.5.1	8d91f52cc2df073d1bca9919b44aeeeb	c9353bdfa71ff9b4acc9097eee83d35e
6.5.0	4b72dcf125430d3d374967df5e084c6a	5d6ac0e9f7a1430e106685da117a7716
6.4.4	86586acda674d95f5661a613dccea3dd	7f4c431de13b84fd0926132c2154f0a8
6.4.3	dd5fcf42065ba2ad28f6311153fd4752	178274e63a6aa604682a3095ddf59ac5
6.4.2	2341911e4f34d17560b85409b86528c4	46df5badc29ee983a872d7859cedd59a
6.4.1	4ef6e6d424bc9b95a1ee8ebda0d5c639	0efc4140b47cbaf65b24a9087c61c434
6.4.0	9210f7064a7692c8dff7a779043e97fc	f103763da687fef88db60ca6b395dc41
6.3.5	b61193ab28a601ec0dfaf4aa641a7834	9fbbf0f4cb865c95d919396d2af9a053
6.3.4	9cca998fde11c473e60bee3854f0c0da	c47a02177c28290ed8c934a6428dc0dc
6.3.2	c563e2b8ee4bf6647e496d1b0ad31285	5c474247d3ce607fca43af9c9faf1fbc
6.3.1	e04a567680676b3784079d35ca32b5fe	36b808db3952803c929188ca57fe88c6
6.3.0	baa5e6d82a363e636740d6c5494e107d	f2ebe86a93a2fd5122ad11224f17736c
6.2.6	9b989e131fe596b51223b6f47efac3c6	6396371abf0f66f0e6aeccd8303eeb0a
6.2.5	5b23262cb4b15230e262005b648aff0d	85ec7457b36de4402ce2c4b591fa87ab
6.2.4	f61648cd99d94c05d50a6e3213329779	3b20d45695f5e196e78d3db6c2bd738d
6.2.3	51eaa0654ec83db7da31511092312f00	d540bdc543a06ff5ccd40f90b2078557
6.2.2	9e5ceb08a3121f42b3315da87c698af3	08917804e4fe48bcb797f391d5a111f6
6.2.1	cbfe915e31bc06bb28227cb33ed22304	abfa9d9dc81fd90b0ca65de973fb1ab8
6.2.0	652ee1362af8c93119335a337deba1a5	91bb64493b344b010ebc277c849e9234
6.1.4	7e2e74d3cc186807d73c1fcf57f8b117	6c9b4ed760c9c1139681f61e6a508c8e
6.1.3	749e6c3de91afdfcddec91d290c46807	ab5884cb0c1ea00c3b3fe9a1d26a4511
6.1.2	940da06a6f8f7e3931a2a80f4e8defc9	4d39c9e6d46c49b5bde2c5ff19781957
6.1.1	7d259bd1cc5e5d2c3fea4909953375ba	09a273cf0300656ed995405e41eced58
6.1.0	e95e509d48e7b87e0213c7f12ea253e4	2c87f3a79c9318a4ed49ad8c377b007f
6.0.8	d903e6c145492488e126e46b3a233444	3237e91d12ee0871ceb0f6a0829dd43b
6.0.7	2d83f856d8d34c4f2e0e4e8561ddee05	bbb742ded1e49eae0622deb40c3becc3
6.0.6	1dd3bfc9919db8ccb7c0de8cf6505d47	5d5e5fe1624123f8316c6bdc020aa47b
6.0.5	e8afac7ef0bc7e38432bf5187fcbde7d	41966239e783ce0bbba852471a439caa
6.0.4	a88278fdb8c2f504ecb4406b8fbc1fe4	a7bba01c6484baf721f5be51242c492b
6.0.3	9f0cfed3c889ba3e334857c6d81e26be	13b07e2da8316759a8f84efb2476e854
6.0.2		13936cb4e05221e134ae1539971b9317
6.0.1 beta		6167276b56ac3b1fbdad2a4858b17bf3

V5 checksums

iOS SDK Version	Static Lib	Static Framework
5.4.4	47d90cbc4ed48dd1c5d6f42a8d419e8b	93716e13258fce87c81c0fc604bfd6fd
5.4.3	e5691c3ae1f20726168b4eb221937d98	dbfa30607f44fa2819191c7a8d7a3fe4
5.4.1	61564250f26ab0693255e002873d1674	fc86776f0ffcdf65cc49f33f7d943258
5.4.0	fa835b3577f389a12ef635eea0b000bb	0bd6a7b4441dc8f397831533e719a833
5.3.0	e787da7334e6c68e0098fd53ebea285e	2f160176b1c011f9aca558543cd63190
5.2.0	057c18bb7485e1c06f2b452d80ee5b22	736b50840b8c08093401f3bba2c4389b
5.1.0	f39819c11b06f98ff24e39cbd0f0f6ce	39889a253dafcfb2d53151523c1c1d80
5.0.0	5ac9e35af65fbfcaf81c1f63a36542b9	1727be9fa19906f0c1e1907b4b160086

V4 checksums

iOS SDK Version	Static Lib	Static Framework
4.11.2	f5415c2014402a03b8ca2c9901ddf12d	3fcf5afd6a20f353f7f88f1fbb4d4410
4.11.1	716394142df4d8e7a98e2c11cfe92ed1	e6521d8216d3aa8d681ac74e279dab34
4.11.0	e7238410372dfa7ca65e5839a31b1c2e	c6d3283bf69adb75aa9ed6c43195a3d6
4.10.0	4d5c01129b80d7ad182e32cf3b47faa4	da926eeb09d61f68f2076a9b31c30d7a
4.9.0	d283ace3237479d1aabc2a81271ea5ba	bad6d9b8c627d7450e7acc8165b05618
4.8.9	e9640a7f95257a89c3e99215df79f1df	fb0975064d2b93cedb71ce248cf3afb9
4.8.4	b7748ea6b86afbc295e17bac3d5bdda6	4cd7a95f49cfb79ecd9a0ce0c73750a3
4.8.3	51d38c4b77f39c75c5fc5734165fedc2	23096a32726a9def3e215a761bf7ad30
4.8.2	0908336d4e9bcf4de1d5f4f2e37ad0cb	a386cfadd76fd783e6a10d0cd8fcb685
4.8.1		3b8a7d70b96bd7c5718feafeb31296b9
4.8.0	bb1358226bd3ca70d70f4717b62ca38b	3d81144bb653e91cb624778c87641051
4.7.9	e9183f23954a3f42a9fa6ae3eeebb6df	03905309048e26e9be7ee02895532d11
4.7.8	5595fa7dfc4c13b4a955638ba1da062e	61c30629f3dcb5ae48da10a458e80d28
4.7.7	3a8d0be3b304de5e81c967ab8a465de3	b8dd0ee60c75aa30884f56569068f32e
4.7.6	6cc80a31cf9daae5709a22258f434c6d	3d4607b13b6f138264db703e36f5452e
4.7.3	73db4e0173fcfdb758644b08fdbbd7bf	06572392afe0ae28a814601642963469
4.7.2	14a79e4ecffad264bc62b307d2db23a7	0aae1d0ace09e5b092f9906747119cfd
4.7.11	27e228c921f560205c0ad2c7962e83b2	d94cdab5734a88598cfcc078573e5b21
4.7.10	5cb1275b488369fee4713d21812186a0
4.7.1	b121dfdf8d0dc53d031481114eba0c18	74ac06d17f167a0e22c361e06f4a2554
4.7.0	c3c0a453caa9971492ef8acd8bee04ae	cadeab0479c4a723173943d77d253051