AppsFlyer iOS SDK 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

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.

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

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. 

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

 {
    "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.

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

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