AppsFlyer安卓SDK版本说明

推荐用于

营销人员 开发商

最近更新： 2023年02月15日 15:06

概要：本文罗列了安卓SDK从V4.x以来的版本说明。

安卓SDK V6

版本	发布日期	是否为维护版	备注
6.10.0	2023-02-13		新增AppsFlyer域名，用于SDK和AppsFlyer服务器之间的数据传输。更改了发送空值或null值时的setHost API了解详情
6.9.4	2022-12-6		修复了从广告收入SDK连接器侧发送广告收入事件时触发转化监听器调用的问题。修复了从广告收入SDK连接器侧发送广告收入事件时出现应用卡死的问题。
6.9.3	2022-11-28		更新了Get Conversion Data（GCD）的内部请求结构。注意：响应数据保持不变。修复了应用将ConversionListener设为null时SDK触发GCD请求的问题。
6.9.2	2022-10-02		修复了使用validateAndLogInAppPurchase API请求购买验证时的延迟问题。
6.9.1	2022-09-19	是
6.9.0	2022-09-12		更新后支持Xiaomi GetApps Store Referrer。更新了内部的广告收入上报API。从该版本开始仅支持通用广告收入SDK接口。
6.8.2	2022-08-29		修复V6.7.0版SDK的缓存机制中出现的重大漏洞，该漏洞会致使缓存的事件被重复发送。
6.8.1 （弃用）	2022-08-24	是	以弃用。请使用V6.8.2。
6.8.1 （已弃用）	2022-07-18		以弃用。请使用V6.8.2。从SDK中移除了`enableLocationCollection` API。应用可以通过`logLocation` API直接将用户的位置数据传递给SDK，从而上报该信息。将`com.google.android.gms.permission.AD_ID`权限添加到SDK的`AndroidManifest.xml`中。详情请见此文档。修复了使用R8时的优化和混淆问题。
6.7.0 （已弃用）	2022-06-19		以弃用。请使用V6.8.2。更新了SDK对于发送到AppsFlyer服务器的请求的处理方式。更新后，上报首次应用打开（转化）的请求会比应用内事件和其他请求的优先级更高。详情请见此文档。新增API：`setDisableNetworkData`，用于关闭对蜂窝网络信息（网络和设备运营商的名称）的收集。
6.6.1	2022-05-16	是
6.6.0	2022-05-01		在UDL的`onDeepLinking`回调中添加了参数，用于直接深度链接（Direct Deep Linking）流程（针对现有用户）。详情请见此文档。
6.5.4	2022-03-23	是
6.5.3	2022-03-09		漏洞修复：修复了创建带有非英语字符的用户邀请链接时出现的问题。
6.5.2	2022-01-26		修复了解析UDL延迟深度链接的URL时出现的问题。升级到DexGuard 9.2 代码重构即内部更新。
6.5.1	2021-12-29		针对使用带Channel选项的第三方应用商店的应用，通过UDL实现深度链接解决方案。
6.5.0	2021-12-07		代码重构即内部更新。
6.4.3	2021-11-14		修复了`V6.4.2`中`LinkGenerator`导致创建链接时发生URL参数缺失的问题。
6.4.2	2021-10-24		修复了一下问题：由`LinkGenerator`生成的自定义URL中出现重复的`pid`参数。使用`LinkGenerator`创建自定义URI scheme时`af_dp`值中出现冗余的`/`。应用仅触发IMEI或AndroidID的收集时，SDK会同时收集这两种ID。
6.4.1	2021-10-17		修复了使用V3.5.4以前的Gradle版本时发生的编译错误。
6.4.0	2021-09-12		新增API：`setSharingFilterForPartners`，若您不想让SDK向某些渠道发送数据，可使用该API配置相关需求。从该版本开始弃用`setSharingFilter`和`setSharingFilterForAllPartners`。
6.3.2	2021-06-06		新增API：`setDisableAdvertisingIdentifiers`
6.3.1	2021-05-26		新增API：`performOnDeepLinking` 更新后可在调用`start`前/`stop`后触发User Invite API。修复漏洞：修复了调用`setCustomerUserId`后仍不释出`waitForCustomerUserId`的问题。
6.3.0	2021-04-29		修复漏洞：应用内事件发送请求失败时误调用`onConversionDataFail` 修复漏洞：动态感应指标的收集（用于识别作弊行为）修复漏洞：UDL的混淆相关问题修复完成了OneLink API的技术更新
6.2.3	2021-03-04	是
6.2.0	2021-02-07		新增API：`setPartnerData`
6.1.4	2021-01-12		更新后支持DexGuard V9
6.1.3	2020-12-24		新增API：`addPushNotificationDeepLinkPath`（支持Movable Ink）
6.1.1	2020-12-03		更新后支持三星Galaxy Store Referrer 轻微漏洞修正及性能优化。
6.1.0	2020-11-09		更新后支持Unified deep linking API
6.0.1	2020-10-28	是
6.0.0	2020-10-14		对SDK功能性和API做出了重大调整，包括方法弃用和方法名称变更。了解详情

安卓V6.0.0版本说明

已移除/弃用或重命名的方法

已移除/弃用的方法

下列方法已从SDK中移除：

sendDeepLinkData
trackAppLaunch
setPluginDeepLinkData
setConsumeAFDeepLinks
setHostName

名称已变更的方法

API名称（在V6之前）	当前的API名称（V6和更高版本）
stopTracking	stop
setCustomerIdAndTrack	setCustomerIdAndLogSession
startTracking	开始
trackLocation	logLocation
reportTrackSession	logSession
trackEvent	logEvent
setDeviceTrackingDisabled	anonymizeUser
validateAndTrackInAppPurchase	validateAndLogInAppPurchase
isStopTracking	isStopped
trackAndOpenStore	logAndOpenStore
trackCrossPromoteImpression	logCrossPromoteImpression
trackInvite	logInvite

名称已变更的接口

接口名称（V6以下版本）	当前接口名称（V6及以上版本）
AppsFlyerTrackingRequestListener	AppsFlyerRequestListener

安卓SDK V5

安卓SDK V5版本说明

版本	发布日期	是否为维护版	备注
5.4.6	2020-11-09		更新后支持Huawei AppGallery referrer
5.4.4	2020-10-01		更新后SDK可处理以ESP为起点的多重跳转。修复漏洞并维护
5.4.3	2020-07-30		扩展了日志和联调功能修复漏洞并维护支持Google install referrer V2
5.4.1	2020-06-30		可让广告主自行调整与对接渠道/平台之间的数据共享。了解详情修复漏洞并维护
5.4.0	2020-06-03		全面支持OAID的自动收集支持多个referrer：SDK可同时收集华为和Google的referrer SDK性能优化修复漏洞并维护
5.3.0	2020-04-27		可通过onAppOpenAttribution方法随时访问最新的直接深度链接转化数据。增加了用于交叉推广展示的参数修复漏洞：修复了Windows系统中的a.和b.文件名相关问题。当用户被深度链接到具体页面时，不再使用sendDeepLinkData方法来获取归因数据，而是以startTracking()方法取代。
5.2.0	2020-03-10		更新后，SDK初始化可在任何用户行为中进行扩展了安全、日志、联调功能修复漏洞并维护
5.1.2	2020-02-19	是
5.1.1	2020-01-23	是
5.1.0	2020-01-06		按照Google的目标API等级要求，针对性支持Android 9（API级别28）为Protect360客户优化了防作弊功能用于收集OAID（适用于中国国内流量）的可选模块——小米和华为（详情请见https://github.com/AppsFlyerSDK/appsflyer-oaid）。优化了针对ESP使用setOneLinkCustomDomain时的稳定性

安卓V5.0.0版本说明

优化了SDK的响应时间

V5.0.0及以上版本的SDK针对自然激活优化了GCD响应时间。

已移除或重命名的方法

方法名称变更

我们统一了安卓和iOS的激活转化数据方法名称。此次更新会影响以下方法：

发生激活时处理转化数据的方法
数据不可用时处理报错的方法

SDK V5以前的安卓方法名称	SDK V5以前的iOS方法名称	统一后的名称
`onInstallConversionDataLoaded`	`onConversionDataReceived`	`onConversionDataSuccess`
`onInstallConversionFailure`	`onConversionDataRequestFailure`	`onConversionDataFail`

已移除的方法

下列方法在先前版本的SDK中已弃用，我们在该版本的SDK中已将其移除。

安卓

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

获取转化数据（GCD）格式变更

该版本中，每当发生激活或应用打开时，SDK会返回一个映射对象（map object），其中包含媒体渠道、广告系列名称等转化数据（GCD）。在先前的SDK版本中，GCD仅返回带有值的参数。

从该版本开始，GCD会返回所有参数，包括不带值的参数。没有值的参数会以null值表达。

示例

用户点击以下链接后激活应用：

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都会返回相同的结构。如果某个参数为空，则在GCD中会以null值表达。该机制便于开发人员处理GCD数据，无论数据中是否包含特定的参数，都无需调整GCD的处理逻辑。如需进一步了解不同场景中的转化数据，请参考此文档。

已弃用的版本

相关文档：AppsFlyer SDK版本管理规定

版本	发布日期	备注
5.0.2	2019-12-23
5.0.1	2019-12-12
5.0.0	2019-11-12	修复漏洞并维护对SDK功能性和API做出了重大调整，包括方法弃用和方法名称变更。了解详情
4.11.0	10-22-2019	优化了日志功能，以改善以下各方面的联调能力： ESP（邮件营销服务商）品牌链接解析 onInstallConversionData以及onAppOpenAttribution 修复漏洞并维护
4.10.3	09-15-2019	修复漏洞并维护更新后支持Open Advertiser ID（OAID） 4.10.2
4.10.1	07-01-2019	修复漏洞并维护
4.10.0	05-14-2019	针对使用ProGuard的开发人员优化了SDK 修复漏洞并维护
4.9.0	03-17-2019	添加了setResolveDeepLinkURLs API，用于解析嵌套在其他Universal Link中的OneLink 修复了推送通知记录的相关漏洞：上一个payload的推送通知记录在丢弃后上报与之前相同的pid，且仍保留在存储器中。修正了af_county中的拼写错误，改为af_country 修复漏洞并维护
4.8.20	02-13-2019	优化了蜂窝网络服务商的免流量功能。修复漏洞并维护
4.8.19	12-26-2018	修复了`waitForCustomerUserId()`方法导致`generateLink`中断的问题修复漏洞并维护
4.8.18	11-11-2018	修复了深度链接中的来回跳转问题优化了前后台切换时的再互动准确性修复漏洞并维护
4.8.17	11-02-2018	修复了ProGuard中的冲突问题，该问题会导致部分情况下应用打开数据丢失。该问题仅对4.8.16版的SDK有影响。
4.8.16	10-31-2018	修复漏洞并维护
4.8.15	08-27-2018	添加了SDK事件：Subscribe（订阅）、Start Trial（开始试用）、Ad Click（广告点击）、Ad View（广告浏览）修复漏洞并维护
4.8.14	07-31-2018	Added setOutOfStore and getOutOfStore APIs for dynamically setting the AF_STORE value 新增API：`onTrackingRequestFailure`和`onTrackingRequestSuccess`，用于接收确认消息，确认AppsFlyer服务器已成功接收到追踪请求。
4.8.13	06-20-2018	修复了边缘场景中通过setImeiData API显式传递IMEI时，出现IMEI缺失的问题修复漏洞并维护
4.8.12	05-27-2018	修复了通过Robolectric进行JUnit测试时的应用程序崩溃问题修复漏洞并维护
4.8.11	05-02-2018	修复漏洞并维护
4.8.10	04-26-2018	添加了`setPreinstallAttribution` API 修复漏洞并维护
4.8.9	04-02-2018	仅在设备中没有GooglePlayServices且无法获取该设备的GAID时收集IMEI 修复漏洞并维护
4.8.8	03-11-2018	新增API，可将SDK初始化延迟到customerUserID设置完毕之后修复漏洞并维护
4.8.7	01-25-2018	新增`isStopTracking` API，用于终止所有的SDK行为新增`af_content`事件参数
4.8.5	11-29-2017	更新后支持新的Google referrer API 上线新的初始化方式，可接收上下文信息
4.8.4	11-14-2017	在getConversionData `is_first_launch`中添加了一个标签，用于标识首次应用打开。该标签便于开发人员在getConversionData的回调响应（每次打开时返回）中识别出应用首次打开。is_first_launch可能出现的值为“true”或“false” 修复漏洞并维护
4.8.3	09-27-2017	更新后getConersionData支持HTTP referrer数据
4.8.2	09-19-2017	针对通过深度链接跳转到多个页面的应用，修复了sendDeepLinkData(this)
4.8.1	09-17-2017	对在SDK初始化之前调用的应用内事件加强了防护
4.8.0	09-03-2017	用户邀请API（User Invite APIs）交叉推广API（Cross-promotion APIs）设定两个session之间的间隔更新后支持蜂窝网络服务商的免流量功能添加了事件参数af_projected_revenue 修复漏洞并维护引入了新的初始化方法 - AppsFlyerLib.getInstance().init(AF_DEV_KEY,conversionDataListener);
4.7.4	06-28-2017	优化了同时关闭多个ScheduledExecutorService时的处理方式
4.7.3	06-06-2017	优化了mParticle的对接
4.7.2	05-22-2017	修复了轻微的内存泄漏问题优化了卸载衡量的准确性修复了影响卸载衡量的ProGaurd警告修复漏洞并维护
4.7.1	02-22-2017	修复了ProGuard触发的警告
4.7.0	02-13-2019	新增事件参数更新后支持基于Firebase的鞋在衡量修复漏洞并维护

安卓SDK校验和

AppsFlyer使用md5计算校验和：

V6校验和

安卓SDK版本	校验和
6.6.1	1ec98047f8cb4145137f3c97459d052c
6.6.0	6f5aef27ea407c7fc1691b52ff800c61
6.5.4	c71aacbf201449dd5ef1158b55bd2ad0
6.5.3	7db44f0852be1c94fe36cc535b7c61f7
6.5.2	71e3a16c4278f857cd86b7b05aedd066
6.5.1	261928cfc55b27a6c2ab19cf9081d705
6.5.0	2a6d500fd4939a8faa47bbbba97288b6
6.4.3	c62f9359d6b5497d54e248c526c5f547
6.4.2	dc385fb62eaf68aff2e7f9c1c0ed19ea
6.4.1	94945db2c0e81baab79535393f210f1b
6.4.0	d7910a35901d4299b54259f1c1bbe2d6
6.3.2	46bc92bb2eed1416de28ccccb3a28620
6.3.1	ca47af77ffbcd7525e82d0bdaaef5b91
6.3.0	f969bb5a62885e8084794d5334787275
6.2.3	bab1309f77acd1f0453372150c82694a
6.2.0	fc727698c7b8bfb1ca448726492931b4
6.1.4	983785b1c30a15e8fac029e370bb3b73
6.1.3	c0392a091659dc445a1014e14da6a31a
6.1.1	0a18fafb2826c90b3388b371a3cbdeec
6.1.0	e8d6df04ac2642b2d7b16efb57f315e9
6.0.1	9ebeb6f4f49476667c07d0e8eb1aa2e8
6.0.0	cff3d453ea94e67182f5b1b023aeb1c1

V5校验和

安卓SDK版本	校验和
5.4.6	4f1bdc33ac0d6dd3f9b75411c3c0a06c
5.4.4	13a04913cf61276238f54e5e2d73e88d
5.4.3	7b1caef46942c70edcd2e59cad69e439
5.4.1	e4eb21c0030f376857b53e2e30022fc8
5.4.0	8c0270f6c3e7e58b1db42be82cc341d8
5.3.0	d602dd28d9ee807855e5426d6a9b7ebf
5.2.0	64fe94447def6d99549d3274ce908f09
5.1.2	1a7dbb23aad32d697835f3ec29337ca9
5.1.1	dfea6a49e6ae57fc2c700f6dcd904bc1
5.1.0	89cc7e08a0430180e64f3cccf955768f
5.0.2	c113618ea379531cba6ce42bc4c79d72
5.0.1	db0502faa5b02102dd99ac6cec666d04
5.0.0	98f1f78ae5f63cb4f40ba838d3d1be22

V4校验和

安卓SDK版本	校验和
4.10.3	855186d68912810fa47897262a9ba0a0
4.10.2	13ed5716d5a8583eeee527f01bd2a69d
4.10.1	ab3e49bb4640990267466b7852cd3de7
4.10.0	b5fb55ee76cd6a742d9bd25b910745a1
4.9.0	afa49524ddceda28ca1648946489a6b0
4.8.20	2f59d0f8db09b92f8261475a1d0807d0
4.8.19	baf8fa419f38de52cef6091de32aca86
4.8.18	3a0641720811a25542449f1927daf13e
4.8.17	3a0641720811a25542449f1927daf13e
4.8.16	501be427b0c2a831e148649131ce3fc0
4.8.15	7b6759a006d72d3a7c78ec80160c3502
4.8.14	bc4facd80958d0600b4d000104e524d9
4.8.13	bc4facd80958d0600b4d000104e524d9
4.8.12	171569002d93fb8d49787b363192973f
4.8.11	4419af159a42e4ee7a218ef8615e2abb
4.8.10	468ad04e4a2088ba7af9c45d42f4ed6d
4.8.9	9a923bbbf3f6c7cc19b900e49644da2c
4.8.8	6dee4814986061a0723cc9f844796e2e
4.8.7	ca13997ccb781a5935e91983b7be81ea
4.8.6	da117a3e9e05df7dd28297df762cfbfa
4.8.5	f8ea07b8a60d664541686ba7064730f5
4.8.4	b10f185c1094cf283b11339810a47c87
4.8.3	7f94ec175b948c5009bfbfe2fb25b2b0
4.8.2	3e34b55e13cd3f8d387b1a33c20105eb
4.8.1	6c2930d2997a7b2b6ab7b3ecf0e3135b
4.8.1	468ad04e4a2088ba7af9c45d42f4ed6d
4.8.1	4419af159a42e4ee7a218ef8615e2abb latest
4.8.0	32d67577ce59b2072475e509579baece
4.7.4	7e649e6a1cf8999ca39b05402946b3d6
4.7.3	e30c020f8ee5dd3af274fa94ef414a38
4.7.2	945aaaca554aa8b2f96219f25eed9777
4.7.1	862c349025e4725d4e5044a190c60337
4.7.0	b060ad140ffd0c8f2b3febb26122d173