我们能为您提供什么帮助?

搜索

AppsFlyer 安卓 SDK 版本说明

  • 更新

概览：查看 SDK 版本说明，快速了解 Android SDK 的最新变更。如需了解更全面的详情，开发者请参阅开发者中心的 Android 版本说明。

旧版 iOS 和 Android SDK 将按固定的六个月周期停止支持。此周期旨在提前发出通知，帮助团队提前规划，并在不中断的情况下保持应用完整功能。升级到最新版本的 SDK 可确保您使用最新功能、提升稳定性，并获得持续支持。

重要提示！

为确保平稳过渡，建议应用开发者在停止支持日期前升级至最新版本的 SDK。 

停止支持与已弃用的区别

AppsFlyer 将 SDK 版本区分为已弃用和已停止支持，以明确其支持层级及对数据衡量的影响。

  •  已弃用版本：由于存在严重错误等已知问题，不再建议使用的 SDK 版本。这些版本仍可向 AppsFlyer 发送数据，但不建议继续使用。并强烈建议升级至受支持的版本。
  • 已停止支持版本：在所有平台上已完全停止衡量的 SDK 版本。在 Android 和 iOS 平台上，激活、应用打开和应用内事件均不再被衡量。来自这些版本的所有流量（产品团队明确豁免的除外）都将收到 400 状态码。这意味着 SDK 仍会照常尝试发起 API 调用，但 AppsFlyer 服务器会拒绝这些调用，数据也不会得到处理。

Android SDK 版本说明

下表提供受支持的 Android SDK 版本的版本说明，包括发布日期和面向开发者的重要更新。如需了解开发者相关信息，请参阅 Android SDK 开发者对接指南。

版本 发布日期 注意事项
7.0.4 2026-10-26
  • 改进了 setUserEmail API 对 Gmail email 地址的处理
7.0.2 2026-10-19

  • 新增对 Google Ad Manager 和 CloudX 这两家广告聚合合作伙伴的广告收入报告支持。

  • 新增用于报告净收入的事件参数。

  • 稳定性和性能改进。
7.0.1 2026-07-22
  • 应用现在可向 SDK 提供已进行哈希处理的客户 email、电话号码、姓名和 Facebook 登录 ID，以便与广告平台合作伙伴共享。 SDK 本身不会收集这些信息。由应用提供，且仅发送已进行哈希处理的值，绝不发送明文。 
  • 已移除 setUserEmails 和 setPhoneNumber 方法。使用这些方法的开发者必须改用 setUserEmail 和 setUserPhone

6.18.1

 2026-05-25

  • 修复了 Purchase Connector 中的一个问题：因连接问题而失败的购买验证请求会被缓存，且不会重试，可能导致购买数据缺失。
6.18.0 2026-03-17
  • 改善了稳定性并修复相关问题。
6.17.6 2026-03-11
  • 修复了 SDK 未发送由应用设置的 AF_STORE 值的问题。
6.17.5 2025-11-26
  • 改善了稳定性并修复相关问题。
  • 新的购买验证 API（验证并记录购买）现已正式可用。
6.17.4 2025-10-15
  • 更新了 SDK 与高级安全模块之间的对接。该版本兼容 Security Module v2.0.0 及以上版本。
  • 如果您正在使用高级安全模块，并希望将 SDK 升级至 v6.17.4，请务必同时将 Security Module 升级至 v2.0.0。
6.17.3 2025-08-18
  • 技术更新：提升了稳定性和性能。
6.17.2 2025-08-05
  • 技术更新：更新为 targetSDKVersion 35
6.17.1 2025-07-28
  • 更新了用于应用内购买验证的 validateAndLogInAppPurchase API（当前处于 beta 阶段）
  • 新增对 Google Play Integrity API 的对接，可通过 Google Play 进行设备完整性验证
6.17.0 2025-04-24
6.16.2 2025-03-02
  • 修复了对接 SDK 时可能导致构建错误的问题。
6.16.1 2025-02-17
  • 更新了 API，支持将 DMA 同意数据手动发送到 AppsFlyer。
6.16.0 2024-12-17
  • 增加了对三星预装归因的支持。了解详情。
  • 在 Privacy Sandbox attribution API（用于隐私沙盒归因）中增加了对收入衡量的支持（封闭 Beta 测试中）。
  • Dexguard 已更新到 v9.8.12，解决了稳定性问题并强化数据安。
6.15.2 2024-10-10
  • 改善了稳定性并修复相关问题
  • 与 Privacy Sandbox Attribution API 相关的内部更新
6.15.1 2024-08-28

版本升级：

  • targetSDKVersion：v34
  • Gradle：v8.7
  • Java：v17
6.15.0 2024-07-31
  • 新增了 logAdRevenue 方法，用于向 AppsFlyer 发送广告收入数据。注意：从此版本开始，不应再使用 AdRevenue Connector，必须改用 logAdRevenue 方法。了解详情。
6.14.2
停止支持：
2027-03-08 		2024-06-10
  • 针对使用 Unity 搭建的应用，修复了在抓取 Meta Install Referrer 时发生的问题。
6.14.1
停止支持：
2027-03-08 		2024-05-29 SDK 维护
6.14.0
停止支持：
2027-03-08 		2024-04-18
  • 新增对更新后的购买验证流程的支持。该功能目前处于封闭 beta 测试阶段。了解更多。
  • 更新了华为 referrer 对接。了解更多。
6.13.1
停止支持：
2027-03-08 		2024-04-03 SDK 维护
6.13.0
停止支持：
2027-03-08 		2024-02-08
  • 新增对 Google 新欧盟用户同意政策（DMA）的支持

不再支持的 SDK 版本

以下 SDK 版本已进入 停止支持 状态。这些版本无法再向 AppsFlyer 发送数据，来自这些版本的任何流量都将被拒绝。

版本 发布日期 注意事项
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.2【已弃用】

 

   已弃用
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
停止支持：
2025-09-08 		2022-12-6
  • 修复了从广告收入 SDK 连接器侧发送广告收入事件时触发转化监听器调用的问题。
  • 修复了从广告收入 SDK 连接器侧发送广告收入事件时出现应用卡死的问题。
6.9.3
停止支持：
2025-09-08 		2022-11-28
  • 更新了 Get Conversion Data（GCD）的内部请求结构。注意：响应数据保持不变。
  • 修复了应用将 ConversionListener 设为 null 时 SDK 触发 GCD 请求的问题。
6.9.2
停止支持：
2025-09-08 		2022-10-02
  • 修复了使用 validateAndLogInAppPurchase API 请求购买验证时的延迟问题。
6.9.1
停止支持：
2025-09-08 		2022-09-19 SDK 维护
6.9.0
停止支持：
2025-09-08 		2022-09-12
  • 更新后支持 Xiaomi GetApps Store Referrer。
  • 更新了内部的广告收入上报 API。从该版本开始，仅支持通用广告收入 SDK 连接器。
6.8.2
停止支持：
2025-09-08 		2022-08-29
  • 修复 V6.7.0 版 SDK 的缓存机制中出现的重大漏洞，该漏洞会致使缓存的事件被重复发送。
6.8.1
（已弃用）
停止支持：
2025-09-08 		2022-08-24
  • 已弃用。 Deprecated. Please use V6.8.2.
6.8.0
（已弃用）
停止支持：
2025-09-08 		2022-07-18
  • 已弃用。 Deprecated. Please use V6.8.2.
  • 从 SDK 中移除了 enableLocationCollection API。应用仍可通过 logLocation API 将用户的位置数据直接传递给 SDK，从而上报该数据。
  • 将 com.google.android.gms.permission.AD_ID 权限添加到了 SDK 的 AndroidManifest.xml 中。详情请见此文档。
  • 修复了使用 R8 时的优化和混淆问题。
6.7.0
（已弃用）
停止支持：
2025-09-08 		2022-06-19
  • 已弃用。 Deprecated. Please use V6.8.2.
  • 更新了 SDK 对于发送到 AppsFlyer 服务器的请求的处理方式。更新后，上报首次应用打开（转化）的请求会比应用内事件和其他请求的优先级更高。详情请见此文档。
  • 新增 API： setDisableNetworkData，用于拒绝收集蜂窝网络信息（运营商名称、网络运营商名称）。
6.6.1
停止支持：
2025-03-03 		2022-05-16 SDK 维护
6.6.0
停止支持：
2025-03-03 		2022-05-01
  • 在 UDL 的 onDeepLinking 回调中新增了更多参数，用于支持现有用户的直接深度链接（Direct Deep Linking）流程。了解更多。
6.5.4
停止支持：
2025-03-03 		2022-03-23 SDK 维护
6.5.3
停止支持：
2025-03-03 		2022-03-09
  • 漏洞修复：修复了创建带有非英语字符的用户邀请链接时出现的问题。
6.5.2
停止支持：
2025-03-03 		2022-01-26
  • 修复了解析 UDL 延迟深度链接的 URL 时出现的问题。
  • 升级到 DexGuard 9.2
  • 代码重构及内部更新。
6.5.1
停止支持：
2025-03-03 		2021-12-29
6.5.0
停止支持：
2025-03-03 		2021-12-07
  • 代码重构及内部更新。
6.4.3
停止支持：
2025-03-03 		2021-11-14
  • 修复了  V6.4.2中 LinkGenerator 导致创建链接时缺少 URL 参数的问题。
6.4.2
停止支持：
2025-03-03 		2021-10-24

修复了以下问题：

  • 由 LinkGenerator 生成的自定义 URL 中出现重复的 pid 参数。
  • 使用 LinkGenerator 创建自定义 URI scheme 时，af_dp 值中出现多余的 /。
  • 应用仅触发 IMEI 或 AndroidID 的收集时，SDK 会同时收集这两种 ID。
6.4.1
停止支持：
2025-03-03 		2021-10-17 修复了使用 V3.5.4 以前的 Gradle 版本时发生的编译错误。
6.4.0
停止支持：
2025-03-03 		2021-09-12

新增 API：setSharingFilterForPartners 可让您配置 SDK 应从哪些合作伙伴中排除数据共享。

从此版本开始，setSharingFilter 和 setSharingFilterForAllPartners 已弃用。

6.3.2

支持截止日期：2024-08-31

 2021-06-06 新增 API：setDisableAdvertisingIdentifiers
6.3.1
停止支持：2024-08-31 		2021-05-26
  • 新增 API：performOnDeepLinking
  • 新增了在调用 start 之前/调用 stop 之后触发 User Invite API 的能力
  • Bugfix：修复了调用 setCustomerUserId 后，waitForCustomerUserId 调用仍未解除阻塞的问题
6.3.0
停止支持：2024-08-31 		2021-04-29
  • Bugfix：应用内事件发送请求失败时误调用 onConversionDataFail
  • Bugfix：运动传感器指标采集（用于检测作弊）
  • 修复漏洞：修复了 UDL 中与代码混淆相关的问题
  • 完成了 OneLink API 的技术更新
6.2.3
停止支持：2024-08-31 		2021-03-04 SDK 维护
6.2.0
停止支持：2024-08-31 		2021-02-07
6.1.4
停止支持：2024-08-31 		2021-01-12
  • 更新后支持 DexGuard V9
6.1.3
停止支持：2024-08-31 		2020-12-24
6.1.1
停止支持：2024-08-31 		2020-12-03
  • 更新后支持三星 Galaxy Store Referrer
  • 轻微漏洞修正及性能优化。
6.1.0
停止支持：2024-08-31 		2020-11-09
6.0.1
停止支持：2024-08-31 		2020-10-28 SDK 维护
6.0.0
停止支持：2024-08-31 		2020-10-14
  • 对 SDK 功能性和 API 做出了重大调整，包括方法弃用和方法名称变更。了解详情。

另请参阅

Tags