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
Version | Release date | Maintenance only | Notes |
---|---|---|---|
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 |
|
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 |
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 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 | Yes | |
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 | Yes | |
6.5.3 |
2022-03-02 |
Bugfix: Fixed an issue with a double invocation of |
|
6.5.2 |
2022-01-26 | Yes | |
6.5.1 |
2022-01-03 | Yes | |
6.5.0 |
2021-12-22 | Refactoring and internal changes. | |
6.4.4 |
2021-12-12 | Yes | |
6.4.3 |
2021-11-30 |
Stability fix for MacOS 10.14.6 with xcframework. |
|
6.4.2 |
2021-10-28 | Yes |
|
6.4.1 |
2021-10-24 |
Resolved stability in Unity apps. |
|
6.4.0 |
2021-09-12 |
Added API: As of this version, |
|
6.3.5 |
2021-08-19 |
Added API: Starting this version the language is no longer collected automatically by the SDK. |
|
6.3.4 |
2021-07-21 |
|
|
6.3.2 |
2021-06-17 | Improved debug logs. | |
6.3.1 |
2021-06-02 | Yes | Improved stability in Unity plugin. |
6.3.0 |
2021-05-13 |
|
|
6.2.6 |
2021-04-25 |
|
|
6.2.5 |
2021-04-06 |
Refactoring, cleanup, removal of unused data from the SDK. Starting this version:
|
|
6.2.4 |
2021-03-15 |
Bugfix related to SKAdNetwork revenue measurement mode and in-app events that contain Starting this version, in the case of revenue measurement: any event containing Note: If you implement SKAdNetwork Revenue measurement, you must upgrade to this version. |
|
6.2.3 |
2021-03-07 |
Bugfix related to calling SKAdNetwork's
|
|
6.2.2 |
2021-02-18 | Yes |
|
6.2.1 |
2021-02-15 |
Support Event reporting by S2S |
|
6.2.0 |
2021-02-07 |
Additional API: setPartnerData |
|
6.1.4 |
2021-01-12 | Yes |
|
6.1.3 |
2020-12-24 |
|
|
6.1.2 |
2020-12-03 | Yes |
|
6.1.1 |
2020-11-17 |
Introduce Strict mode SDK |
|
6.1.0 |
2020-11-09 |
Support Unified deep linking API |
|
6.0.8 |
2020-10-28 |
Support Apple App Clips attribution |
|
6.0.7 |
2020-10-21 | Yes | |
6.0.6 |
2020-10-20 | Yes |
|
6.0.5 |
2020-10-08 | Yes |
|
6.0.4 |
2020-09-30 |
Supports multiple redirects from ESPs |
|
6.0.3 |
2020-09-06 |
|
|
6.0.2 [deprecated] |
2020-08-27 |
|
|
6.0.1 beta [deprecated] |
2020-08-06 |
|
|
6.0.0 beta [deprecated] |
2020-08-04 |
|
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:
iOS SDK V5 release notes
Version | Release date | Notes |
---|---|---|
5.4.4 |
2020-08-23 | Bug fixes and maintenance |
5.4.3 |
2020-07-30 |
|
5.4.1 |
2020-06-30 |
|
5.4.0 |
2020-06-03 | MAC Catalyst project support |
5.3.0 |
2020-04-27 |
|
5.2.0 | 2020-03-10 |
|
5.1.0 | 2019-12-23 |
|
5.0.0 | 2019-11-12 |
|
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:
{
"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.
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
- 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 breakinggenerateLink
- 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
- 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.6.1 | ff41a3dfeb9fe7579f8f706f3c62bbbc | 7acf1f10de7602b363a70d4a710b050d |
6.6.0 | ba2d2d0b64f3b0f6476b818c1b8faf5f | 544c7c7e4af29afa4100b6c43affcf8f |
6.5.4 | 5a1146a95abc84b20940b43cacc8b42a | 3a0a22a28b4082a5b2f0931104b0a9c8 |
6.5.3 | b33008f83f5eafa864902db97c003c06 | 3ff6754c8c238dd13e4c6251ffb4aedf |
6.5.2 | 3083df065d14553fb1b4e34f3f7fb381 | 3ce0ea75e4fe3cf6313fde27d57d20ed |
6.5.1 | 8d91f52cc2df073d1bca9919b44aeeeb | c9353bdfa71ff9b4acc9097eee83d35e |
6.5.0 | 4b72dcf125430d3d374967df5e084c6a | 5d6ac0e9f7a1430e106685da117a7716 |
6.4.4 | 86586acda674d95f5661a613dccea3dd | 7f4c431de13b84fd0926132c2154f0a8 |
6.4.3 | dd5fcf42065ba2ad28f6311153fd4752 | 178274e63a6aa604682a3095ddf59ac5 |
6.4.2 | 2341911e4f34d17560b85409b86528c4 | 46df5badc29ee983a872d7859cedd59a |
6.4.1 | 4ef6e6d424bc9b95a1ee8ebda0d5c639 | 0efc4140b47cbaf65b24a9087c61c434 |
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 |
08917804e4fe48bcb797f391d5a111f6 |
6.2.1 | cbfe915e31bc06bb28227cb33ed22304 |
abfa9d9dc81fd90b0ca65de973fb1ab8 |
6.2.0 | 652ee1362af8c93119335a337deba1a5 |
91bb64493b344b010ebc277c849e9234 |
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 |
3237e91d12ee0871ceb0f6a0829dd43b |
6.0.7 | 2d83f856d8d34c4f2e0e4e8561ddee05 | bbb742ded1e49eae0622deb40c3becc3 |
6.0.6 | 1dd3bfc9919db8ccb7c0de8cf6505d47 | 5d5e5fe1624123f8316c6bdc020aa47b |
6.0.5 | e8afac7ef0bc7e38432bf5187fcbde7d | 41966239e783ce0bbba852471a439caa |
6.0.4 | a88278fdb8c2f504ecb4406b8fbc1fe4 | a7bba01c6484baf721f5be51242c492b |
6.0.3 | 9f0cfed3c889ba3e334857c6d81e26be |
13b07e2da8316759a8f84efb2476e854 |
6.0.2 | 13936cb4e05221e134ae1539971b9317 | |
6.0.1 beta | 6167276b56ac3b1fbdad2a4858b17bf3 |
V5 checksums
iOS SDK Version | Static Lib | Static Framework |
---|---|---|
5.4.4 | 47d90cbc4ed48dd1c5d6f42a8d419e8b |
93716e13258fce87c81c0fc604bfd6fd |
5.4.3 | e5691c3ae1f20726168b4eb221937d98 |
dbfa30607f44fa2819191c7a8d7a3fe4 |
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 |