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

AppsFlyer iOS SDK 版本说明

  • 更新

概览:SDK 版本说明将为您简要介绍 iOS SDK 的最新变更。如需了解更全面的详情,可参阅开发者中心的 iOS 版本说明。

iOS 和 Android 的旧版 SDK 将按每六个月一次的固定节奏逐步停止支持。这一安排旨在提前通知开发团队,以便团队预留充足时间做好升级准备,确保应用功能不受影响。升级到最新 SDK 版本,即可使用最新功能,获得更稳定的性能和持续的技术支持。

重要提示!

为了确保平稳过渡,建议应用开发者在停止支持日期前完成 SDK 升级。 

停止支持 vs. 弃用

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

  •  已弃用版本:由于存在严重错误等已知问题,不再建议使用的 SDK 版本。这些版本仍可向 AppsFlyer 发送数据,但不建议继续使用。并强烈建议升级至受支持的版本。
  • 停止支持版本:在所有平台上都已完全停止衡量的 SDK 版本。对于 Android 和 iOS,安装、应用打开和应用内事件将不再被衡量。除非 AppsFlyer 明确豁免,否则来自这些版本的所有流量都会收到 400 状态码(即 SDK 仍会照常尝试发起 API 调用,但 AppsFlyer 服务器会拒绝这些调用,相关数据不会得到处理)。

iOS SDK 版本说明

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

版本 发布日期 注意事项
7.0.4 2026-10-27
  • 改进了 setUserEmail API 对 Gmail 电子邮件地址的处理。
7.0.3 2026-10-12
  • SDK 现已支持 googleAdManager 和 cloudX 作为广告收入聚合合作伙伴。

  • 新增净收入字段,开发者可将其添加到应用内事件中,以更准确地报告收入。

  • 降低了 SDK 的内存占用。

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-04-21
  • 新增了对获取 AppTransaction 的支持。AppTransaction 表示一次应用下载,并由应用商店进行加密签名。

  • 修复问题并进行改进
6.17.9 2026-03-10
  • 修复了 SDK 在尝试获取 ODM 数据时可能卡住,导致请求无法发送至服务器的问题。
  • 修复了应用设置的客户用户 ID 未随安装事件发送的问题。
6.17.8 2025-12-03
  • 新的购买验证 API(验证并记录购买)现已正式发布。
6.17.7 2025-10-15
  • 修复了从 Google ICM 库获取数据的问题
6.17.6 2025-09-21
  • 修复了在 v6.17.3 中出现的问题,该问题可能导致 SDK 在尝试将 ICM 数据发送到 AppsFlyer 时崩溃。
6.17.5
已弃用
2025-09-03
  • 该版本已弃用,请勿使用。
6.17.4
已弃用
2025-08-27
  • 该版本已弃用,请勿使用。
  • 修复了在极少数情况下,SDK 初始化时应用程序崩溃的问题。
6.17.3
已弃用
2025-08-21
  • 该版本已弃用,请勿使用。
  • 更新了从 Google 的 ICM 库获取数据的逻辑,以提高准确性。
 
6.17.2 2025-07-15
  • 更新了 validateAndLogInAppPurchase API(beta)
  • 优化了 Apple Search Ads (ASA) 令牌的处理方式,适用于已获取 ATT(AppTrackingTransparency)授权的应用
6.17.1 2025-06-24
  • 新增对Google ICM(对接转化衡量)的支持。
  • 修复了在开发环境中运行 SDK 时可能弹出 App Store 登录窗口的问题
6.17.0 2025-04-23
  • 提升了稳定性和性能
6.16.2 2025-03-10
  • 进行了必要的技术更新,以支持在插件中发布该版本
6.16.1 2025-02-18
  • 更新了 API,支持将 DMA 同意数据手动发送到 AppsFlyer。
6.16.0 2025-01-19
  • 新增通过 Purchase Connector 上报苹果 StoreKit 2 API 的订阅和应用内购买数据。该功能目前处于 Beta 测试阶段。
6.15.3 2024-09-23 SDK 维护
6.15.2 2024-08-28
  • 修复了 Purchase Connector 中的事件传输问题。此次修复不会影响 Purchase Connector 的任何生产版本(Production Version),且与 Purchase Connector 更新到 6.15.x 版本有关。
6.15.1 2024-08-19
  • 修复了设备中同时安装同一厂商的多个应用时发生的重装激活检测问题。
6.15.0 2024-08-06
  • 新增了 logAdRevenue API,用于向 AppsFlyer 发送广告收入数据。 注意:从此版本开始,不再使用 AdRevenue Connector;改用 logAdRevenue 方法。详情请见此处说明。
  • 与 Purchase Connector 有关的内部更新。使用 Purchase Connector 的应用以及更新到此版本 SDK 的应用都必须将其 Purchase Connector 更新到 v6.15.0。
6.14.6
停止支持:
2027-03-08
2024-07-24
  • 修复了 SDK 在开始新的应用打开时重复调用 getConversionData API(GCD)的问题;该问题不影响衡量。
6.14.5
停止支持:
2027-03-08
2024-07-03
  • 问题修复:SDK 在发送手动授权的代码已移除的情况下,仍发送用户在应用中设置的手动授权数据。
6.14.4
停止支持:
2027-03-08
2024-06-10
6.14.3
停止支持:
2027-03-08
2024-04-26
  • 修复了使用 Cocoapods 自动化合并应用隐私清单(Privacy Manifest)的功能。
6.14.2
停止支持:
2027-03-08
2024-04-19 SDK 维护
6.14.1
停止支持:
2027-03-08
2024-04-18
  • 更新后支持最新的购买验证(Purchase Validation)链路。该功能目前处于 Beta 测试阶段。了解更多。
6.14.0
停止支持:
2027-03-08
2024-04-07
  • 更新后支持隐私清单(Privacy Manifest) 详细了解 AppsFlyer 中的隐私清单。
  • 在 SDK 中添加了 XCFramework 签名,允许开发人员使用 Xcode 15 验证 SDK 的来源(origin)及真实性(authenticity)。
6.13.2
停止支持:
2027-03-08
2024-03-26
6.13.1
停止支持:
2027-03-08
2024-03-05
  • 修复了 CMP 授权流程(DMA)中发送非 GDPR 用户授权数据的问题
6.13.0
停止支持:
2027-03-08
2024-02-08
  • 更新后支持 Google 最新的欧洲用户意见征集政策 

不再支持的 SDK 版本

以下 SDK 版本已进入停止支持状态。这些版本将无法再向 AppsFlyer 发送任何数据,来自这些版本的所有请求都会被拒绝处理。

版本 发布日期 注意事项
6.12.3 2024-01-04
  • 在电子邮件服务提供商(ESP)解析流程的深度链接回调中,新增了 original_link 参数。
  • 移除了所有提及 iAd Framework 的内容
6.12.2 2023-08-24 SDK 维护
6.12.1 2023-07-20
  • 修复了 SKAdNetwork 4.0 中导致粗粒度转化值上报为“None”的问题。
  • 修复了 tvOS 接入过程中的系统崩溃问题。
6.12.0 2023-06-28 从 SDK 中移除了对 bitcode 的支持。
6.11.2 2023-06-13 修复了 v6.11.0 中引入的一个问题:调用 validateAndLogInAppPurchase(用于购买验证和日志记录的历史 API)后不记录购买事件。 

重要提示:如果您同时使用 v6.11.0or v6.11.1,以及 validateAndLogInAppPurchase API,请升级到此版本。
6.11.1 2023-05-24 SDK 维护
6.11.0 2023-04-25
  • SDK 在 URL 中使用新的 AppsFlyer 域名向 AppsFlyer 服务器发送请求。
  • 更改了发送空值或 null 值时 setHost API 的行为。 了解详情
6.10.1 2023-04-02 在直接深度链接场景的 UDL 载荷中添加了 link 参数
6.10.0 2023-02-15 更新后支持 SKAdNetwork 4.0 进一步了解 AppsFlyer 的 SKAN 解决方案
6.9.2
停止支持:
2025-09-08
2023-01-31 更新了 Get Conversion Data(GCD)的内部请求结构。注意:响应数据保持不变。
6.9.1
停止支持:
2025-09-08
2022-11-28 更新了 Get Conversion Data(GCD)的内部请求结构。注意:响应数据保持不变。
6.9.0
停止支持:
2025-09-08
2022-11-06

更新了内部的广告收入(AdRevenue)上报 API。从该版本开始,仅支持通用广告收入(AdRevenue)连接器。

此版本的 SDK 兼容 AdRevenue Connector V6.9.0。

6.8.1
停止支持:
2025-09-08
2022-08-09 Reinstall Detection:优化了通过设备本地存储检测并上报应用重装激活的能力。您可以在 AppsFlyer 数据面板的应用设置页面控制此功能。
6.8.0
停止支持:
2025-03-03
2022-07-19 如需使用重装激活识别(Reinstall Detection)功能,请更新到 SDK V6.8.1+
6.7.0
停止支持:
2025-03-03
2022-06-19

更新了 SKAdNetwork 的实现方式,以使用 iOS 15.4 引入的新版 Apple API updatePostbackConversionValue。

这对 SKAdNetwork 发送的数据没有影响,且无需对应用代码做任何修改

6.6.1
停止支持:
2025-03-03
2022-05-16 SDK 维护
6.6.0
停止支持:
2025-03-03
2022-05-01 在 UDL 的 didResolveDeepLink 回调中新增了更多参数,用于支持现有用户的直接深度链接(Direct Deep Linking)流程。了解更多。
6.5.4
停止支持:
2025-03-03
2022-03-23 SDK 维护
6.5.3
停止支持:
2025-03-03
2022-03-02 问题修复:修复了基于 URI scheme 的链接中两次调用 didResolveDeepLink 的问题。
6.5.2
停止支持:
2025-03-03
2022-01-26 SDK 维护
6.5.1
停止支持:
2025-03-03
2022-01-03 SDK 维护
6.5.0
停止支持:
2025-03-03
2021-12-22 代码重构及内部更新。
6.4.4
停止支持:
2025-03-03
2021-12-12 SDK 维护
6.4.3
停止支持:
2025-03-03
2021-11-30 通过 xcframework 修复了 MacOS 10.14.6 的稳定性问题
6.4.2
停止支持:
2025-03-03
2021-10-28 SDK 维护
6.4.1
停止支持:
2025-03-03
2021-10-24 解决了 Unity 应用中的稳定性问题
6.4.0
停止支持:
2025-03-03
2021-09-12

新增 API: setSharingFilterForPartners 可让您配置 SDK 应排除哪些合作伙伴,不与其共享数据。

从该版本开始,setSharingFilter 和 setSharingFilterForAllPartners 已弃用。

6.3.5
停止支持:2024-08-31
2021-08-19

新增 API:setCurrentDeviceLanguage

从该版本开始,SDK 不再自动收集语言信息

6.3.4
停止支持:2024-08-31
2021-07-21
  • 修复漏洞:修复了在 XCode 12.5 Simulators 上运行 SDK 时出现的问题
  • 轻微问题修复及更新
6.3.2
停止支持:2024-08-31
2021-06-17 优化了联调日志
6.3.1
停止支持:2024-08-31
2021-06-02 SDK 维护
6.3.0
停止支持:2024-08-31
2021-05-13
  • 更新后支持 Apple Silicon:该 SDK 可在搭载 M1 芯片组的 Mac 设备模拟器上运行
  • 从该版本开始,SDK 支持 iOS 9+。不再支持 iOS 8。
  • iOS Strict Mode SDK(严格模式):更新后支持 Carthage 依赖管理器
  • 完成了 OneLink API 的技术更新
6.2.6
停止支持:2024-08-31
2021-04-25
  • 修复漏洞:SDK 在 didFinishLaunchingWithOptions 之后初始化时,SKAdNetwork 规则未加载
  • 修复漏洞:waitForATTUserAuthorization 在边缘场景下会导致发送的应用打开事件不包含 IDFA,即使用户已同意也是如此
  • 支持 SDK 在 iOS 8 设备中运行
  • 清理并移除了未使用的代码和数据
6.2.5
停止支持:2024-08-31
2021-04-06

对 SDK 中未使用的数据进行了重构、清理和移除

从该版本开始:

  • 弃用 setShouldCollectDeviceName 方法,且该方法不再返回设备名称
  • SDK 发送的 wifi 参数被设为 False
6.2.4
停止支持:2024-08-31
2021-03-15

修复了与 SKAdNetwork 收入衡量模式及包含 AF_REVENUE  参数的应用内事件相关的问题。

从该版本开始,进行收入衡量时:任何包含 AF_REVENUE 参数的事件都会影响转化值。在此之前,只有在 AF_PURCHASE 事件框架中才会设置转化值。 

注意:如果您实施 SKAdNetwork 收入衡量,则必须升级到此版本。

6.2.3
停止支持:2024-08-31
2021-03-07

修复了调用 SKAdNetwork 的 updateConversionValue 时出现的问题。

 

6.2.2
停止支持:2024-08-31
2021-02-18 SDK 维护
6.2.1
停止支持:2024-08-31
2021-02-15 支持 S2S 事件上报
6.2.0
停止支持:2024-08-31
2021-02-07 新增 API:setPartnerData
6.1.4
停止支持:2024-08-31
2021-01-12 SDK 维护
6.1.3
停止支持:2024-08-31
2020-12-24
6.1.2
停止支持:2024-08-31
2020-12-03 SDK 维护
6.1.1
停止支持:2024-08-31
2020-11-17 引入 Strict mode SDK
6.1.0
停止支持:2024-08-31
2020-11-09 支持 统一深度链接 API
6.0.8
停止支持:2024-08-31
2020-10-28 支持 Apple App Clips 归因
6.0.7
停止支持:2024-08-31
2020-10-21 SDK 维护
6.0.6
停止支持:2024-08-31
2020-10-20 SDK 维护
6.0.5
停止支持:2024-08-31
2020-10-08 SDK 维护
6.0.4
停止支持:2024-08-31
2020-09-30 更新后支持以 ESP 为起点的多重跳转
6.0.3
停止支持:2024-08-31
2020-09-06
  • API 名称变更: 
    waitForAdvertisingIdentifier --> waitForATTUserAuthorization
  • SDK 在 iOS 14 中默认收集 IDFA(与在先前版本 iOS 中的行为一致)
6.0.2
停止支持:2024-08-31
2020-08-27
  • API 名称变更:
    deviceLoggingDisabled --> anonymizeUser
  • 在 iOS 14 中,需要 AppTrackingTransparency(ATT)弹窗授权才能收集 IDFA
  • 更新后支持 IDFV 交叉推广归因
6.0.1 beta
停止支持:2024-08-31
2020-08-06
  • 更新后支持 SKAdNetwork 归因,帮助广告主在保护用户隐私的前提下衡量投放效果
6.0.0 beta
停止支持:2024-08-31
2020-08-04
  • 扩展了联调功能
  • 对 SDK 功能性和 API 做了重大调整。了解详情