AppsFlyer iOS SDK Release Notes

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

iOS SDK V5 release notes

iOS SDK V5 release notes
Version Release date Notes

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

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

V4.8.3-V4.11.2

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

V5 checksums

iOS SDK Version Static Lib Static Framework
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
Was this article helpful?

Comments

0 comments

Please sign in to leave a comment.