AppsFlyer iOS SDK版本说明

推荐用于

营销人员 开发商

最近更新： 2025年04月18日 03:09

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

iOS SDK V6

版本	发布日期	说明
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	2024-07-24	修复了新session开启时SDK对 API（GCD）进行不必要调用的问题；该问题不影响数据监测。
6.14.5	2024-07-03	问题修复：SDK在发送手动授权的代码已移除的情况下，仍发送用户在应用中设置的手动授权数据。
6.14.4	2024-06-10	更新了严格模式SDK的隐私清单（Privacy Manifest）。
6.14.3	2024-04-26	修复了使用Cocoapods自动化合并应用隐私清单（Privacy Manifest）的功能。
6.14.2	2024-04-19	SDK维护
6.14.1	2024-04-18	更新后支持最新的购买验证（Purchase Validation）链路。该功能目前处于Beta测试阶段。了解详情
6.14.0	2024-04-07	更新后支持隐私清单（Privacy Manifest）如需进一步了解AppsFlyer的隐私清单（Privacy Manifest），请参考此文档。在SDK中添加了XCFramework签名，允许开发人员使用Xcode 15验证SDK的来源（origin）及真实性（authenticity）。
6.13.2	2024-03-26	对于Xcode 15.3中使用SPM的应用，修复了导致其发布失败的问题。详情请见开发人员的版本说明。
6.13.1	2024-03-05	修复了CMP授权流程（DMA）中发送非GDPR用户授权数据的问题
6.13.0 Deprecated	2024-02-08	更新后支持Google最新的欧洲用户意见征集政策
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.0`或`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有效信息（payload）中添加了`link`参数
6.10.0	2023-02-15	支持SKAdNetwork 4.0。进一步了解AppsFlyer的SKAN解决方案
6.9.2	2023-01-31	更新了Get Conversion Data（GCD）的内部请求结构。请注意：响应数据保持不变。
6.9.1	2022-11-28	更新了Get Conversion Data（GCD）的内部请求结构。请注意：响应数据保持不变。
6.9.0	2022-11-06	更新了内部的广告收入（AdRevenue）上报API。从该版本开始仅支持通用的广告收入（AdRevenue）连接器（Connector）。该版SDK兼容AdRevenue Connector `V6.9.0`。
6.8.1	2022-08-09	重装激活识别：对于使用本机存储的应用，优化了识别及上报其重装激活的能力。您可以在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-12	代码重构及内部更新。
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向某些渠道发送数据，可使用该API配置相关需求。从该版本开始弃用`setSharingFilter`setSharingFilter和`setSharingFilterForAllPartners`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在之后初始化时，SKAN规则加载失败`didFinishLaunchingWithOptions` 修复漏洞：`waitForATTUserAuthorization`边缘场景导致SDK发送应用打开事件时不含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`事件框架中设置转化值。请注意：您必须将SDK更新到此版本后才能使用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	新增API：`addPushNotificationDeepLinkPath`（支持Movable Ink）更新后支持Apple AdServices Framework
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	更新后支持Unified deep linking 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 【已弃用】	2020-08-27	API名称变更： deviceLoggingDisabled --> anonymizeUser 在iOS 14中，需要用户在AppTrackingTransparency（ATT）弹窗中授权后才能收集IDFA 更新后支持IDFV交叉推广归因
6.0.1 beta 【已弃用】	2020-08-06	更新后支持SKAdNetwork归因，帮助广告主在保护用户隐私的前提下衡量投放效果
6.0.0 beta 【已弃用】	2020-08-04	扩展了联调功能对SDK功能性和API做了重大调整。了解详情

iOS V6.0.0版本说明

新增、已移除或重命名的方法

新增方法

我们在SDK中添加了下列方法：

waitForAdvertisingIdentifier

已移除的方法

下列方法已从SDK中移除：

disableAppleAdSupportTracking

名称已变更的方法

V6之前的API名称	当前的API名称（V6和更高版本）
AppsFlyerTracker	AppsFlyerLib
disableIAdTracking	disableCollectASA
trackAppLaunchWithCompletionHandler	startWithCompletionHandler
trackLocation	logLocationEvent
trackAppLaunch	开始
trackEvent	logEvent
disableAppleAdSupportTracking	disableAdvertiserIdentifier
validateAndTrackInAppPurchase	validateAndLogInAppPurchase
isStopTracking	isStopped
deviceTrackingDisabled	deviceLoggingDisabled
sharedTracker (Objective C)	shared

对ATT的支持

iOS SDK可在iOS 14及以上版本中通过ATT框架（App Tracking Transparency，应用追踪透明度）收集IDFA。详情请见以下文档：

已弃用的版本

iOS SDK V5

版本	发布日期	说明
5.4.4	2020-08-23	修复漏洞并维护
5.4.3	2020-07-30	扩展了日志和调试功能修复漏洞并维护
5.4.1	2020-06-30	可让广告主自行调整与对接渠道/平台之间的数据共享。了解详情优化了Universal Link长链的onAppOpenAttribution方法：返回解析完毕的链接参数修复漏洞并维护
5.4.0	2020-06-03	支持MAC Catalyst项目
5.3.0	2020-04-27	可通过onAppOpenAttribution方法随时访问最新的直接深度链接转化数据。增加了用于交叉推广展示的参数主应用和扩展应用可得到一致的AppsFlyer ID，从而形成相同的应用内事件分组修复漏洞并维护
5.2.0	2020-03-10	扩展了日志和调试功能修复漏洞并维护
5.1.0	2019-12-23	改善了Obj-C - Swift互通性修复漏洞并维护
5.0.0	2019-11-12	修复漏洞并维护对SDK功能性和API做了重大调整。详情请见此处说明。

iOS 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的处理逻辑。如需进一步了解不同场景中的转化数据，请参考此文档。

iOS V4.0.0版本说明

相关文档：AppsFlyer SDK版本管理政策

版本	发布日期	说明
4.11.2	2019-11-07	修复漏洞并维护
4.11.1	2019-10-31	修复漏洞并维护
4.11.0	2019-10-17	不再支持iOS 7。此次更新后，iOS 8是最低的支持版本。优化了日志，以改善联调功能、ESP和品牌链接解析以及onInstallConversionData和onAppOpenAttribution 优化了Apple Search Ads数据的抓取
4.10.4	2019-09-12	更新了iOS 13 push token的获取，用于卸载衡量修复漏洞并维护
4.10.3	2019-07-16	修复漏洞并维护
4.10.2	2019-07-02	修复漏洞并维护
4.10.1	2019-07-01	修复漏洞并维护
4.10.0	2019-05-14	trackAppLaunchWithCompletionHandler API，用于处理应用打开追踪成功或失败的消息 completionHandler API，用于处理应用内事件记录成功或失败的消息修复漏洞并维护
4.9.0	2019-03-18	添加了setResolveDeepLinkURLs API，用于解析嵌套在其他Universal Link中的OneLink 移除了iOS 7及以下版本的Meta ads归因中使用的UIPasteboard 修复漏洞并维护
4.8.12	2019-02-13	优化了蜂窝网络服务商的免流量功能。优化了蜂窝网络服务商的免流量功能。修复漏洞并维护
4.8.11	2019-01-09	修复了waitForCustomerUserId() API导致generateLink中断的问题
4.8.10	2018-10-31	修复了竞态条件（race condition）问题：在applicationDidBecomeActive之后调用continueUserActivity导致onAppOpenAttribution不被调用修复了validateAndTrackInAppPurchase忽略额外参数的问题修复漏洞并维护
4.8.9	2018-08-27	新增SDK事件：Subscribe（订阅）、Start Trial（开始试用）、Ad Click（广告点击）、Ad View（广告浏览）修复漏洞并维护
4.8.8	2018-07-30	修复了通过JSONSerialiser使用is_first_launch时返回整数值而非布尔值的问题修复并维护了4.8.7
4.8.7	2018-07-22	修复漏洞并维护
4.8.6	2018-06-18	修复漏洞并维护
4.8.5	2018-05-29	修复漏洞并维护
4.8.4	2018-05-03	修复漏洞并维护
4.8.3	2018-01-25	修复漏洞并维护 shouldCollectDeviceName API 新增af_content事件参数 shouldCollectDeviceName API 新增af_content事件参数

另请参见

iOS 14、ATT及SKAN的快速入门指南