AppsFlyer iOS SDK release notes

At a glance: Check out the SDK release notes for a quick overview of the latest changes to the iOS SDK. Developers looking for more comprehensive details should review the iOS Release Notes on the Dev Hub.

iOS SDK V6 

iOS SDK integration guides for developers

Version Release date Notes

6.14.4

2024-06-10

6.14.3

2024-04-26
  • Fixed automated merging of the Privacy Manifest for apps utilizing Cocoapods.

6.14.2

2024-04-19 SDK Maintenance

6.14.1

2024-04-18
  • Added support for the updated Purchase Validation flow. This feature is currently in closed beta. Learn more.

6.14.0

2024-04-07

6.13.2

2024-03-26
  • Fixed an issue that was causing the release of apps using SPM in Xcode 15.3 to fail. See the developer release notes for more information.

6.13.1

2024-03-05
  • Fixed an issue with sending consent data for non-GDPR users in a CMP consent flow (DMA).

6.13.0 
(Deprecated)

2024-02-08
  • Added support for Google's new EU consent policy 

6.12.3

2024-01-04
  • A new original_link parameter has been added to the Deep Linking callback within the Email Service Provider (ESP) resolving flow.
  • All references to the iAd Framework have been removed.

6.12.2

2023-08-24 SDK Maintenance

6.12.1

2023-07-20
  • Fixed an issue in SKAdNetwork 4.0 causing the Coarse conversion value to be reported as "None"
  • Fixed a crash in the tvOS implementation

6.12.0

2023-06-28

Removed bitcode support from the SDK

6.11.2

2023-06-13

Fixed an issue introduced in v6.11.0, wherby calling  validateAndLogInAppPurchase  (the legacy API for Purchase Validation and logging) does not log the purchase event.

Important: If you are using v6.11.0or v6.11.1, and the validateAndLogInAppPurchase API please upgrade to this version.

6.11.1

2023-05-24

SDK Maintenance

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

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

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

6.5.1

2022-01-03 SDK Maintenance

6.5.0

2021-12-22 Refactoring and internal changes.

6.4.4

2021-12-12 SDK Maintenance

6.4.3

2021-11-30

Stability fix for MacOS 10.14.6 with xcframework.

6.4.2

2021-10-28

SDK Maintenance

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
Deprecation: 31/08/2024

2021-08-19

Added API: setCurrentDeviceLanguage

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

6.3.4
Deprecation: 31/08/2024

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

6.3.2
Deprecation: 31/08/2024

2021-06-17 Improved debug logs.

6.3.1
Deprecation: 31/08/2024

2021-06-02 SDK Maintenance

6.3.0
Deprecation: 31/08/2024

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
Deprecation: 31/08/2024

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
Deprecation: 31/08/2024

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
Deprecation: 31/08/2024

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

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

6.2.3
Deprecation: 31/08/2024

2021-03-07

Bugfix related to calling SKAdNetwork's updateConversionValue.

 

6.2.2
Deprecation: 31/08/2024

2021-02-18

SDK Maintenance

6.2.1
Deprecation: 31/08/2024

2021-02-15

Support Event reporting by S2S

6.2.0
Deprecation: 31/08/2024

2021-02-07

Additional API: setPartnerData

6.1.4
Deprecation: 31/08/2024

2021-01-12

SDK Maintenance

6.1.3
Deprecation: 31/08/2024

2020-12-24

6.1.2
Deprecation: 31/08/2024

2020-12-03

SDK Maintenance

6.1.1
Deprecation: 31/08/2024

2020-11-17

Introduce Strict mode SDK

6.1.0
Deprecation: 31/08/2024

2020-11-09

Support Unified deep linking API

6.0.8
Deprecation: 31/08/2024

2020-10-28

Support Apple App Clips attribution

6.0.7
Deprecation: 31/08/2024

2020-10-21 SDK Maintenance

6.0.6
Deprecation: 31/08/2024

2020-10-20

SDK Maintenance

6.0.5
Deprecation: 31/08/2024

2020-10-08

SDK Maintenance

6.0.4
Deprecation: 31/08/2024

2020-09-30

Supports multiple redirects from ESPs

6.0.3
Deprecation: 31/08/2024

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:

Deprecated Versions

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

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:

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

Related reading: AppsFlyer SDK version control policy
Version Release Date Notes
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