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

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.0 - October 22, 2019

• Improved logging for better debug capabilities for the following:
  • ESP
  • Branded Links resolving
  • onInstallConversionData and onAppOpenAttribution.
• Bug fixes and maintenance

V4.10.3 - September 15, 2019

• Bug fixes and maintenance
• Support for Open Advertiser ID (OAID) 

V4.10.2 - July 14, 2019

• Bug fixes and maintenance

V4.10.1 - July 1, 2019

• Bug fixes and maintenance

V4.10.0 - May 14, 2019

• SDK improvements for developers using ProGuard.
• Bug fixes and maintenance

V4.9.0 - March 17, 2019

• setResolveDeepLinkURLs API for resolving OneLinks wrapped with another Universal Link
• Fix for push notification recording when the discarded push notification recording of the previous payload contained the same pid and was still in memory.
• Typo fix from af_county to af_country
• Bug fixes and maintenance

V4.8.20 - February 13, 2019

• Improved zero-rating capabilities for cellular providers
• Bug fixes and maintenance

V4.8.19 - December 26, 2018

• Fixed issue where the method waitForCustomerUserId() breaks generateLink
• Bug fixes and maintenance

V4.8.18 - November 11, 2018

• Fixed deep linking issues from trampoline activities
• Improved accuracy of re-engagement when moving between background and foreground
• Bug fixes and maintenance

V4.8.17 - November 2, 2018

• Fix for an issue related to conflicts in ProGuard causing loss of app launch data in some cases. This issue affected only SDK version 4.8.16

V4.8.16 - October 31, 2018

• Bug fixes and maintenance

V4.8.15 - August 27, 2018

• Additional SDK Events: Subscribe, Start Trial, Ad Click, Ad View
• Bug fixes and maintenance

V4.8.14 - July 31, 2018

• Added setOutOfStore and getOutOfStore APIs for dynamically setting the AF_STORE value
• Added onTrackingRequestFailure and onTrackingRequestSuccess APIs for receiving a confirmation that the tracking request was successfully received by the AppsFlyer servers

V4.8.13 - June 20, 2018

• Fixed bug in an edge case where IMEI was missing when passed explicitly through setImeiData API
• Bug fixes and maintenance

V4.8.12 - May 27, 2018

• Fixed app crashing when using JUnit test that uses Robolectric
• Bug fixes and maintenance

V4.8.11 - May 2, 2018

• Bug fixes and maintenance

V4.8.10 - April 26, 2018

• Added setPreinstallAttribution API
• Bug fixes and maintenance

V4.8.9 - April 2, 2018

• Collect IMEI only if GooglePlayServices doesn't exist on the device and it's not possible to retrieve GAID on that device
• Bug fixes and maintenance

V4.8.8 - March 11, 2018

• Added API for delaying SDK initialization until customerUserID is provided
• Bug fixes and maintenance.

V4.8.7 - January 25, 2018

• isStopTracking API to shut down all SDK activities
• af_content event parameter

V4.8.6 - December 5, 2017

• Fix for malformed JSON in Android API 18 and lower

V4.8.5 - November 29, 2017

• Support for new Google referrer API
• New init method which receives context

V4.8.4 - November 14, 2017

• Added a flag to getConversionData is_first_launch which indicates if this is the first launch of the application. This flag allows developers to identify the first launch of the app easily within the getConversionData callback response which is returned in every launch. Possible values for is_first_launch are "true" or "false"
• Bug fixes and maintenance

V4.8.3 - September 27, 2017

• Added support for http referrer data in getConversionData

V4.8.2 - September 19, 2017

• Fix in sendDeepLinkData(this) for apps that deep link to multiple activities

V4.8.1 - September 17, 2017

• Improved protection against in-app events called before SDK initialization

V4.8.0 - September 3, 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
• Additional init method introduced - AppsFlyerLib.getInstance().init(AF_DEV_KEY,conversionDataListener);

V4.7.4 - June 28, 2017

• Improved handling of multiple ScheduledExecutorService shutdowns
  

V4.7.3 - June 6, 2017

• Enhancements for mParticle integration

V4.7.2 - May 22, 2017

• Fixed minor memory leak issue
• Improved accuracy of uninstall measurement
• Fixed ProGaurd warning which affected uninstall measurement
• Bug fixes and maintenance

V4.7.1 - February 22, 2017

• Fixed warning triggered by ProGuard

V4.7.0 - February 13, 2017

• Additional Event Parameters
• Support for Firebase based uninstall measurement
• Bug fixes and maintenance