AppsFlyer iOS SDK release notes

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

Related reading: Quickstart guide to iOS 14, ATT, and SKAdNetwork

iOS SDK V6 release notes 

iOS SDK integration guides for developers

iOS SDK V6.0+ release notes
Version Release date Maintenance only  Notes



Added API: setSharingFilterForPartners lets you configure which partners the SDK should exclude from data-sharing.

As of this version, setSharingFilter and setSharingFilterForAllPartners are deprecated.



Added API: setCurrentDeviceLanguage

Starting this version the language is no longer collected automatically by the SDK.


  • Bugfix: Fixed issue with running the SDK on XCode 12.5 Simulators
  • Minor fixes and updates.


2021-06-17   Improved debug logs.


2021-06-02 Yes Bugfix: Fixed an issue that caused potential crashes in the Unity plugin.


  • 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


  • 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



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



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 theAF_PURCHASE event. 

Note: If you implement SKAdNetwork Revenue measurement, you must upgrade to this version.



Bugfix related to calling SKAdNetwork's updateConversionValue.



2021-02-18 Yes




Support Event reporting by S2S



Additional API: setPartnerData


2021-01-12 Yes





2020-12-03 Yes




Introduce Strict mode SDK



Support Unified deep linking API



Support Apple App Clips attribution


2020-10-21 Yes  


2020-10-20 Yes



2020-10-08 Yes




Supports multiple redirects from ESPs


  • API name change:
    waitForAdvertisingIdentifier --> waitForATTUserAuthorization
  • SDK collects IDFA by default for iOS 14 (as for earlier iOS versions)

6.0.2 [deprecated]

  • 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


  • Support added for SKAdNetwork attribution, to help advertisers measure campaign success while maintaining user privacy

6.0.0 beta


  • 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
















sharedTracker (Objective C) shared
API name changes

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 release notes

iOS SDK V5 release notes
Version Release date Notes


2020-08-23 Bug fixes and maintenance


  • Extended logging and debugging capabilities
  • Bug fixes and maintenance


  • 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


2020-06-03 MAC Catalyst project support


  • 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
5.0.0 2019-11-12
  • Bug fixes and maintenance
  • Major changes to SDK functionality and API. Learn more

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
Conversion data method name changes

Methods removed

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


  • 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)


  • 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. 


An install follows a click on the following URL:

The responses are as follows:

GCD response prior to SDK V5 GCD response starting SDK V5

    "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",

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.

iOS SDK V4 release notes


V4.11.2 - November 7, 2019

  • Bug fixes and maintenance

V4.11.1 - October 31, 2019

  • Bug fixes and maintenance

V4.11.0 - October 17, 2019

  • 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.

V4.10.4 - September 12, 2019

  • Update for iOS 13 push token retrieval needed for Uninstall Measurement
  • Bug fixes and maintenance

V4.10.3 - July 16, 2019

  • Bug fixes and maintenance

V4.10.2 - July 2, 2019

  • Bug fixes and maintenance

V4.10.1 - July 1, 2019

  • Bug fixes and maintenance

V4.10.0 - May 14, 2019

  • 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

V4.9.0 - March 18, 2019

  • setResolveDeepLinkURLs API for resolving OneLinks wrapped with another Universal Link
  • Removed UIPasteboard usage for Facebook attribution for iOS 7 and below
  • Bug fixes and maintenance

V4.8.12 - February 13, 2019

  • Improved zero-rating capabilities for cellular providers
  • Bug fixes and maintenance

V4.8.11 - January 9, 2019

  • waitForCustomerUserId() API is breaking generateLink - fixed
  • Bug fixes and maintenance

V4.8.10 - October 31, 2018

  • 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

V4.8.9 - August 27, 2018

  • New SDK events: Subscribe, Start Trial, Ad Click, Ad View
  • Bug fixes and maintenance

V4.8.8 - July 30, 2018

  • Fixed an issue when using is_first_launch through JSONSerialiser was returned as an integer rather than boolean
  • Bug fixes and maintenance

V4.8.7 - July 22, 2018

  • Bug fixes and maintenance

V4.8.6 - June 18, 2018

  • Fixed a crash when calling NSUserDefaults on a background thread.
  • Bug fixes and maintenance

V4.8.5 - May 29, 2018

  • Bug fixes and maintenance

V4.8.4 - May 03, 2018

  • Bug fixes and maintenance

V4.8.3 - January 25, 2018

  • isStopTracking API to shut down all SDK activities.
  • shouldCollectDeviceName API - opt in.
  • af_content event parameter

Until V4.8.2 (deprecated versions)

V4.8.2 - December 25, 2017

  • Added is_first_launch flag to conversionData.
  • Bug fixes and maintenance

V4.8.1 - October 25, 2017

  • Fixed data race crash, occurring when simultaneously calling setAppsFlyerDevKey and trackEvent.

V4.8.0 - September 24, 2017

  • User Invite APIs
  • Cross Promotion APIs
  • Custom time between sessions
  • Support for Zero Rating for Cellular Providers
  • Additional event parameter af_projected_revenue
  • Bug fixes and maintenance
  • Improved encoding for non-Unicode characters

V4.7.11 - May 31, 2017

  • Enhancements for mParticle

V4.7.9 - May 22, 2017

  • Additional improvements to iAd collection
  • Changed backgroundSession behavior for iOS 9
  • Added weak property to AppsFlyerTrackerDelagate
  • Bug fixes and maintenance

V4.7.6 - May 11, 2017

  • Improved iAd collection during permission dialog (Push Notification / Geo-location etc.)

V4.7.3 - March 22, 2017

  • Bug fixes and maintenance

V4.7.2 - March 14, 2017

  • Bugfix for missing event values.

V4.7.1 - March 9, 2017

  • Bugfix related to deep linking relevant only in version 4.7.0. If you were using that version, make sure to update to this latest SDK version.

V4.7.0 - March 6, 2017

  • Additional Event Parameters
  • Supporting testing of receipt validation in Sandbox mode
  • Bug fixes and Maintenance

iOS SDK checksums

AppsFlyer uses md5 checksums:

V6 checksums

iOS SDK Version Static Lib Static Framework
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
6.2.1 cbfe915e31bc06bb28227cb33ed22304
6.2.0 652ee1362af8c93119335a337deba1a5
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
6.0.7 2d83f856d8d34c4f2e0e4e8561ddee05 bbb742ded1e49eae0622deb40c3becc3
6.0.6 1dd3bfc9919db8ccb7c0de8cf6505d47 5d5e5fe1624123f8316c6bdc020aa47b
6.0.5 e8afac7ef0bc7e38432bf5187fcbde7d 41966239e783ce0bbba852471a439caa
6.0.4 a88278fdb8c2f504ecb4406b8fbc1fe4 a7bba01c6484baf721f5be51242c492b
6.0.3 9f0cfed3c889ba3e334857c6d81e26be
6.0.2   13936cb4e05221e134ae1539971b9317
6.0.1 beta   6167276b56ac3b1fbdad2a4858b17bf3

V5 checksums

iOS SDK Version Static Lib Static Framework
5.4.4 47d90cbc4ed48dd1c5d6f42a8d419e8b
5.4.3 e5691c3ae1f20726168b4eb221937d98
5.4.1 61564250f26ab0693255e002873d1674
5.4.0 fa835b3577f389a12ef635eea0b000bb
5.3.0 e787da7334e6c68e0098fd53ebea285e
5.2.0 057c18bb7485e1c06f2b452d80ee5b22
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
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
Was this article helpful?



Please sign in to leave a comment.