AppsFlyer安卓SDK版本说明

概要:本文列出了安卓SDK的近期更新信息,便于您快速查看各版本的大致情况。对于开发人员,如果需要更全面的信息,请查看Dev Hub中的安卓版本说明

安卓SDK V6

市场人员的安卓SDK对接指南

版本 发布日期 说明
6.14.0 2024-04-18
  • 更新后支持最新的购买验证(Purchase Validation)链路。该验证功能目前处于Beta测试阶段(请注意:这一版本的SDK已全量上线)。了解详情
  • 更新了华为Referrer对接。了解详情
6.13.1 2024-04-03 SDK维护
6.13.0 2024-02-08
  • 更新后支持Google最新的欧洲用户意见征集政策(DMA)
6.12.6 2024-01-29

SDK维护

6.12.5 2023-12-18
  • 在ESP解析流程的深度链接回调中添加了original_link参数。
6.12.4 2023-10-25
  • 将Dexguard更新到9.4.16版本,以改善SDK稳定性。

6.12.3

2023-08-31 SDK维护

6.12.2

2023-08-02
  • 修复了在Android 8.1.0和Android 11中导致部分设备上应用崩溃的问题。

6.12.1

2023-06-29
  • 修复了跨平台推广场景中Play Store打开延迟的问题。
  • 修复了在部分设备中导致应用崩溃的问题。

6.12.0

2023-06-28
  • 已弃用——请使用6.12.1.版本。

6.11.2

2023-06-29
  • 修复了在部分设备中导致应用崩溃的问题。

6.11.1

2023-06-6
  • 已弃用——请使用6.12.1.版本。
  • 修复了部分情况下SDK初始化后应用闪退的问题。

6.11.0

2023-05-16
  • 修复了SKD试图获取Google Play Referrer时在部分设备上导致应用卡死的问题

6.10.3

2023-04-25 SDK维护

6.10.1

2023-03-01
  • 修复了SDK在三星设备中初始化时导致应用关闭的问题。该问题的影响范围为接入了SDK V6.6.0及以上版本的应用。

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 SDK维护

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.0
(已弃用)

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 SDK维护

6.6.0

2022-05-01
  • 在UDL的onDeepLinking回调中添加了参数,用于直接深度链接(Direct Deep Linking)流程(针对现有用户)。详情请见此文档

6.5.4

2022-03-23 SDK维护

6.5.3

2022-03-09
  • 修复漏洞:修复了创建带有非英语字符的用户邀请链接时出现的问题。

6.5.2

2022-01-26
  • 修复了解析UDL延迟深度链接的URL时出现的问题。
  • 升级到DexGuard 9.2
  • 代码重构及内部更新。

6.5.1

2021-12-29

6.5.0

2021-12-07
  • 代码重构及内部更新。

6.4.3

2021-11-14
  • 修复了V6.4.2LinkGenerator导致创建链接时发生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配置相关需求。

从该版本开始弃用setSharingFiltersetSharingFilterForAllPartners

6.3.2

下线日期:2024年8月31日

2021-06-06

新增API:setDisableAdvertisingIdentifiers

6.3.1

下线日期:2024年8月31日

2021-05-26
  • 新增API:performOnDeepLinking
  • 更新后可在调用start前/stop后触发User Invite API
  • 修复漏洞:修复了调用setCustomerUserId后仍不释出waitForCustomerUserId的问题。

6.3.0

下线日期:2024年8月31日

2021-04-29
  • 修复漏洞:应用内事件发送请求失败时误调用onConversionDataFail
  • 修复漏洞:动态感应指标的收集(用于识别作弊行为)
  • 修复漏洞:UDL的混淆相关问题修复
  • 完成了OneLink API的技术更新
6.2.3
下线日期:2024年8月31日
2021-03-04 SDK维护
6.2.0
下线日期:2024年8月31日
2021-02-07
6.1.4
下线日期:2024年8月31日
2021-01-12
  • 更新后支持DexGuard V9
6.1.3
下线日期:2024年8月31日
2020-12-24
6.1.1
下线日期:2024年8月31日
2020-12-03
  • 更新后支持三星Galaxy Store Referrer
  • 轻微漏洞修正及性能优化。
6.1.0
下线日期:2024年8月31日
2020-11-09
6.0.1
下线日期:2024年8月31日
2020-10-28

SDK维护

6.0.0
下线日期:2024年8月31日
2020-10-14
  • 对SDK功能性和API做出了重大调整,包括方法弃用和方法名称变更。了解详情

安卓V6.0.0版本说明

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

已移除/弃用的方法

下列方法已从SDK中移除:

  • sendDeepLinkData

  • trackAppLaunch

  • setPluginDeepLinkData

  • setConsumeAFDeepLinks

  • setHostName

名称已变更的方法

V6之前的API名称 当前的API名称(V6和更高版本)

stopTracking

stop

setCustomerIdAndTrack

setCustomerIdAndLogSession

startTracking

start

trackLocation

logLocation

reportTrackSession

logSession

trackEvent

logEvent

setDeviceTrackingDisabled

anonymizeUser

validateAndTrackInAppPurchase

validateAndLogInAppPurchase

isStopTracking

isStopped

trackAndOpenStore

logAndOpenStore

trackCrossPromoteImpression

logCrossPromoteImpression

trackInvite

logInvite

名称已变更的接口

V6以下版本中的接口名称 当前接口名称(V6及以上版本)

AppsFlyerTrackingRequestListener

AppsFlyerRequestListener

已弃用的版本

安卓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时的稳定性
5.0.2 2019-12-23     
5.0.1 2019-12-12     
5.0.0 2019-11-12
  • 修复漏洞并维护
  • 对SDK功能性和API做出了重大调整,包括方法弃用和方法名称变更。了解详情

安卓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
  

响应内容如下:

SDK V5之前的GCD响应 SDK V5及之后的GCD响应

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

安卓V4.0.0版本说明

版本 发布日期 说明
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
  • 添加了setOutOfStore和getOutOfStore API,用于动态设置AF_STORE值
  • 添加了onTrackingRequestFailureonTrackingRequestSuccess API,用于接收确认消息,确认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
  • 新增isStopTrackingisStopTrackingisStopTracking 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的卸载衡量
  • 修复漏洞并维护