AppsFlyer iOS SDK release notes

At a glance: iOS SDK release notes starting from V4.x.

iOS SDK V6 release notes

iOS SDK V6.X integration guide for developers

iOS SDK V6 release notes
Version Release date Notes


  • Bug fixes and maintenance


  • Bug fixes and maintenance


  • Bug fixes and maintenance


  • Added support for SDK to handle multiple redirects from ESPs
  • Bug fixes and maintenance


  • 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
  • Bug fixes and maintenance
  • AppTrackingTransparency (ATT) dialog is required to collect IDFA for iOS 14

6.0.1 beta


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

6.0.0 beta


  • Extended debugging capabilities
  • Bug fixes and maintenance
  • 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

Support added for AppTrackingTransparency (ATT)

For iOS 14 and later, if you want to access app-related data for recording the user or the device (for example, IDFA), you will need to request user authorization via a popup. In the iOS 14 beta 7, you can still collect IDFA, but you have the option to request user permission and if the user opts-out, the IDFA will be not be passed to the SDK. See full instructions for setting up the popup.

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

  • Bug fix for missing event values.

V4.7.1 - March 9, 2017

  • Bug fix related to deep linking relevant only in version 4.7.0. If you were using that version please 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.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.