AppsFlyer iOS SDK版本说明

推荐用于

营销人员 开发商

最近更新： 2023年07月03日 08:21

概要：本文罗列了iOS SDK V4+的版本说明。

iOS SDK V6

版本	发布日期	是否为维护版	备注
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	是
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.1 （已弃用）	2022-07-19		如需重装激活识别（Reinstall Detection）功能，请使用SDK V6.8.1+
6.7.0	2022-06-19		更新了SKAdNetwork的启用方式，使用iOS 15.4中新引入的Apple API `updatePostbackConversionValue` 这对SKAdNetwork发送的数据没有影响，且无需对应用代码做任何修改
6.6.1	2022-05-16	是
6.6.0	2022-05-01		在UDL的`didResolveDeepLink`回调中添加了参数，用于直接深度链接（Direct Deep Linking）流程（针对现有用户）。详情请见此文档。
6.5.4	2022-03-23	是
6.5.3	2022-03-02		修复漏洞：修复了基于URI scheme的链接中重复调用`didResolveDeepLink`的问题
6.5.2	2022-01-26	是
6.5.1	2022-01-03	是
6.5.0	2021-12-12		代码重构即内部更新。
6.4.4	2021-12-12	是
6.4.3	2021-11-30		通过xcframework修复了MacOS 10.14.6的稳定性问题
6.4.2	2021-10-28	是
6.4.1	2021-10-24		解决了Unity应用中的稳定性问题
6.4.0	2021-09-12		新增API：`setSharingFilterForPartners`，若您不想让SDK向某些渠道发送数据，可使用该API配置相关需求。从该版本开始弃用`setSharingFilter`和`setSharingFilterForAllPartners`。
6.3.5	2021-08-19		新增API：`setCurrentDeviceLanguage` 从该版本开始，SDK不再自动收集语言信息
6.3.4	2021-07-21		修复漏洞：修复了在XCode 12.5 Simulators上运行SDK时出现的问题轻微问题修复及更新
6.3.2	2021-06-17		优化了联调日志
6.3.1	2021-06-02	是	改善了Unity插件中的稳定性
6.3.0	2021-05-13		更新后支持Apple Silicon：该SDK可在搭载M1芯片组的Mac设备模拟器上运行从该版SDK开始支持iOS `9`+，不再支持iOS `8` iOS Strict Mode SDK（严格模式）：更新后支持Carthage依赖管理器完成了OneLink API的技术更新
6.2.6	2021-04-25		修复漏洞：SDK在`didFinishLaunchingWithOptions`之后初始化时，SKAN规则加载失败修复漏洞：`waitForATTUserAuthorization`边缘场景导致SDK发送应用打开事件时不含IDFA（即使用户已授权）支持SDK在iOS 8设备中运行清理并移除了未使用的代码和数据
6.2.5	2021-04-06		对SDK中未使用的数据进行了重构、清理和移除从该版本开始：弃用了`setShouldCollectDeviceName`方法，不再返回设备名称 SDK发送的`wifi`参数设为`False`
6.2.4	2021-03-15		修复了SKAdNetwork收入衡量模式以及含`AF_REVENUE`参数的应用内事件中出现的问题从该版本开始，进行收入衡量时：任何包含`AF_REVENUE`参数的事件都会影响转化值。在此之前，必须在`AF_PURCHASE`事件框架中才能设置转化值。注意：您必须将SDK更新到此版本后才能使用SKAdNetwork收入衡量。
6.2.3	2021-03-07		修复了SKAdNetwork的`updateConversionValue`调用相关问题
6.2.2	2021-02-18	是
6.2.1	2021-02-15		更新后支持S2S事件上报
6.2.0	2021-02-07		新增API：setPartnerData
6.1.4	2021-01-12	是
6.1.3	2020-12-24		新增API：`addPushNotificationDeepLinkPath`（支持Movable Ink）更新后支持Apple AdServices Framework
6.1.2	2020-12-03	是
6.1.1	2020-11-17		引入Strict mode SDK（严格模式）
6.1.0	2020-11-09		更新后支持Unified deep linking API
6.0.8	2020-10-28		支持 Apple App Clips归因
6.0.7	2020-10-21	是
6.0.6	2020-10-20	是
6.0.5	2020-10-08	是
6.0.4	2020-09-30		更新支持以ESP为起点的多重跳转
6.0.3	2020-09-06		API名称变更： waitForAdvertisingIdentifier --> waitForATTUserAuthorization 在iOS 14及之前版本中，SDK默认收集IDFA
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

名称已变更的方法

API名称（在V6之前）	当前的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

支持App Tracking Transparency（应用追踪透明度，ATT）

iOS SDK可在iOS 14及以上版本中通过ATT框架收集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互通性修复漏洞并维护

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

已弃用的版本

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

版本	发布日期	备注
5.0.0	2019-11-12	修复漏洞并维护对SDK功能性和API做了重大调整。了解详情
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 SDK校验和

AppsFlyer使用md5计算校验和：

V6校验和

iOS SDK版本	Static Lib	Static Framework
6.6.1	ff41a3dfeb9fe7579f8f706f3c62bbbc	7acf1f10de7602b363a70d4a710b050d
6.6.0	ba2d2d0b64f3b0f6476b818c1b8faf5f	544c7c7e4af29afa4100b6c43affcf8f
6.5.4	5a1146a95abc84b20940b43cacc8b42a	3a0a22a28b4082a5b2f0931104b0a9c8
6.5.3	b33008f83f5eafa864902db97c003c06	3ff6754c8c238dd13e4c6251ffb4aedf
6.5.2	3083df065d14553fb1b4e34f3f7fb381	3ce0ea75e4fe3cf6313fde27d57d20ed
6.5.1	8d91f52cc2df073d1bca9919b44aeeeb	c9353bdfa71ff9b4acc9097eee83d35e
6.5.0	4b72dcf125430d3d374967df5e084c6a	5d6ac0e9f7a1430e106685da117a7716
6.4.4	86586acda674d95f5661a613dccea3dd	7f4c431de13b84fd0926132c2154f0a8
6.4.3	dd5fcf42065ba2ad28f6311153fd4752	178274e63a6aa604682a3095ddf59ac5
6.4.2	2341911e4f34d17560b85409b86528c4	46df5badc29ee983a872d7859cedd59a
6.4.1	4ef6e6d424bc9b95a1ee8ebda0d5c639	0efc4140b47cbaf65b24a9087c61c434
6.4.0	9210f7064a7692c8dff7a779043e97fc	f103763da687fef88db60ca6b395dc41
6.3.5	b61193ab28a601ec0dfaf4aa641a7834	9fbbf0f4cb865c95d919396d2af9a053
6.3.4	9cca998fde11c473e60bee3854f0c0da	c47a02177c28290ed8c934a6428dc0dc
6.3.2	c563e2b8ee4bf6647e496d1b0ad31285	5c474247d3ce607fca43af9c9faf1fbc
6.3.1	e04a567680676b3784079d35ca32b5fe	36b808db3952803c929188ca57fe88c6
6.3.0	baa5e6d82a363e636740d6c5494e107d	f2ebe86a93a2fd5122ad11224f17736c
6.2.6	9b989e131fe596b51223b6f47efac3c6	6396371abf0f66f0e6aeccd8303eeb0a
6.2.5	5b23262cb4b15230e262005b648aff0d	85ec7457b36de4402ce2c4b591fa87ab
6.2.4	f61648cd99d94c05d50a6e3213329779	3b20d45695f5e196e78d3db6c2bd738d
6.2.3	51eaa0654ec83db7da31511092312f00	d540bdc543a06ff5ccd40f90b2078557
6.2.2	9e5ceb08a3121f42b3315da87c698af3	08917804e4fe48bcb797f391d5a111f6
6.2.1	cbfe915e31bc06bb28227cb33ed22304	abfa9d9dc81fd90b0ca65de973fb1ab8
6.2.0	652ee1362af8c93119335a337deba1a5	91bb64493b344b010ebc277c849e9234
6.1.4	7e2e74d3cc186807d73c1fcf57f8b117	6c9b4ed760c9c1139681f61e6a508c8e
6.1.3	749e6c3de91afdfcddec91d290c46807	ab5884cb0c1ea00c3b3fe9a1d26a4511
6.1.2	940da06a6f8f7e3931a2a80f4e8defc9	4d39c9e6d46c49b5bde2c5ff19781957
6.1.1	7d259bd1cc5e5d2c3fea4909953375ba	09a273cf0300656ed995405e41eced58
6.1.0	e95e509d48e7b87e0213c7f12ea253e4	2c87f3a79c9318a4ed49ad8c377b007f
6.0.8	d903e6c145492488e126e46b3a233444	3237e91d12ee0871ceb0f6a0829dd43b
6.0.7	2d83f856d8d34c4f2e0e4e8561ddee05	bbb742ded1e49eae0622deb40c3becc3
6.0.6	1dd3bfc9919db8ccb7c0de8cf6505d47	5d5e5fe1624123f8316c6bdc020aa47b
6.0.5	e8afac7ef0bc7e38432bf5187fcbde7d	41966239e783ce0bbba852471a439caa
6.0.4	a88278fdb8c2f504ecb4406b8fbc1fe4	a7bba01c6484baf721f5be51242c492b
6.0.3	9f0cfed3c889ba3e334857c6d81e26be	13b07e2da8316759a8f84efb2476e854
6.0.2		13936cb4e05221e134ae1539971b9317
6.0.1 beta		6167276b56ac3b1fbdad2a4858b17bf3

V5校验和

iOS SDK版本	Static Lib	Static Framework
5.4.4	47d90cbc4ed48dd1c5d6f42a8d419e8b	93716e13258fce87c81c0fc604bfd6fd
5.4.3	e5691c3ae1f20726168b4eb221937d98	dbfa30607f44fa2819191c7a8d7a3fe4
5.4.1	61564250f26ab0693255e002873d1674	fc86776f0ffcdf65cc49f33f7d943258
5.4.0	fa835b3577f389a12ef635eea0b000bb	0bd6a7b4441dc8f397831533e719a833
5.3.0	e787da7334e6c68e0098fd53ebea285e	2f160176b1c011f9aca558543cd63190
5.2.0	057c18bb7485e1c06f2b452d80ee5b22	736b50840b8c08093401f3bba2c4389b
5.1.0	f39819c11b06f98ff24e39cbd0f0f6ce	39889a253dafcfb2d53151523c1c1d80
5.0.0	5ac9e35af65fbfcaf81c1f63a36542b9	1727be9fa19906f0c1e1907b4b160086

V4校验和

iOS SDK版本	Static Lib	Static Framework
4.11.2	f5415c2014402a03b8ca2c9901ddf12d	3fcf5afd6a20f353f7f88f1fbb4d4410
4.11.1	716394142df4d8e7a98e2c11cfe92ed1	e6521d8216d3aa8d681ac74e279dab34
4.11.0	e7238410372dfa7ca65e5839a31b1c2e	c6d3283bf69adb75aa9ed6c43195a3d6
4.10.0	4d5c01129b80d7ad182e32cf3b47faa4	da926eeb09d61f68f2076a9b31c30d7a
4.9.0	d283ace3237479d1aabc2a81271ea5ba	bad6d9b8c627d7450e7acc8165b05618
4.8.9	e9640a7f95257a89c3e99215df79f1df	fb0975064d2b93cedb71ce248cf3afb9
4.8.4	b7748ea6b86afbc295e17bac3d5bdda6	4cd7a95f49cfb79ecd9a0ce0c73750a3
4.8.3	51d38c4b77f39c75c5fc5734165fedc2	23096a32726a9def3e215a761bf7ad30
4.8.2	0908336d4e9bcf4de1d5f4f2e37ad0cb	a386cfadd76fd783e6a10d0cd8fcb685
4.8.1		3b8a7d70b96bd7c5718feafeb31296b9
4.8.0	bb1358226bd3ca70d70f4717b62ca38b	3d81144bb653e91cb624778c87641051
4.7.9	e9183f23954a3f42a9fa6ae3eeebb6df	03905309048e26e9be7ee02895532d11
4.7.8	5595fa7dfc4c13b4a955638ba1da062e	61c30629f3dcb5ae48da10a458e80d28
4.7.7	3a8d0be3b304de5e81c967ab8a465de3	b8dd0ee60c75aa30884f56569068f32e
4.7.6	6cc80a31cf9daae5709a22258f434c6d	3d4607b13b6f138264db703e36f5452e
4.7.3	73db4e0173fcfdb758644b08fdbbd7bf	06572392afe0ae28a814601642963469
4.7.2	14a79e4ecffad264bc62b307d2db23a7	0aae1d0ace09e5b092f9906747119cfd
4.7.11	27e228c921f560205c0ad2c7962e83b2	d94cdab5734a88598cfcc078573e5b21
4.7.10	5cb1275b488369fee4713d21812186a0
4.7.1	b121dfdf8d0dc53d031481114eba0c18	74ac06d17f167a0e22c361e06f4a2554
4.7.0	c3c0a453caa9971492ef8acd8bee04ae	cadeab0479c4a723173943d77d253051