AppsFlyer iOS SDK版本说明

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

iOS SDK V6 

开发人员的iOS SDK对接指南

版本 发布日期 说明

6.13.1

2024-03-05
  • 修复了CMP授权流程(DMA)中发送非GDPR用户授权数据的问题

6.13.0 
(已弃用)

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

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

6.6.0

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

6.5.4

2022-03-23 SDK维护

6.5.3

2022-03-02

修复漏洞:修复了基于URI scheme的链接中重复调用didResolveDeepLink的问题

6.5.2

2022-01-26 SDK维护

6.5.1

2022-01-03 SDK维护

6.5.0

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

6.4.4

2021-12-12 SDK维护

6.4.3

2021-11-30

通过xcframework修复了MacOS 10.14.6的稳定性问题

6.4.2

2021-10-28

SDK维护

6.4.1

2021-10-24

解决了Unity应用中的稳定性问题

6.4.0

2021-09-12

新增API:setSharingFilterForPartners,若您不想让SDK向某些渠道发送数据,可使用该API配置相关需求。

从该版本开始弃用setSharingFiltersetSharingFilterForAllPartners

6.3.5
下线日期:2024年8月31日

2021-08-19

新增APIsetCurrentDeviceLanguage

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

6.3.4
下线日期:2024年8月31日

2021-07-21
  • 修复漏洞:修复了在XCode 12.5 Simulators上运行SDK时出现的问题
  • 轻微问题修复及更新

6.3.2
下线日期:2024年8月31日

2021-06-17 优化了联调日志

6.3.1
下线日期:2024年8月31日

2021-06-02 SDK维护

6.3.0
下线日期:2024年8月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年8月31日

2021-04-25
  • 修复漏洞:SDK在didFinishLaunchingWithOptions之后初始化时,SKAN规则加载失败
  • 修复漏洞:waitForATTUserAuthorization边缘场景导致SDK发送应用打开事件时不含IDFA(即使用户已授权)
  • 支持SDK在iOS 8设备中运行
  • 清理并移除了未使用的代码和数据

6.2.5
下线日期:2024年8月31日

2021-04-06

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

从该版本开始:

  • 弃用了setShouldCollectDeviceName方法,不再返回设备名称
  • SDK发送的wifi参数值设为False

6.2.4
下线日期:2024年8月31日

2021-03-15

修复了SKAdNetwork收入衡量模式以及含AF_REVENUE参数的应用内事件中出现的问题

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

请注意:您必须将SDK更新到此版本后才能使用SKAdNetwork收入衡量。

6.2.3
下线日期:2024年8月31日

2021-03-07

修复了SKAdNetwork的updateConversionValue调用相关问题

 

6.2.2
下线日期:2024年8月31日

2021-02-18

SDK维护

6.2.1
下线日期:2024年8月31日

2021-02-15

更新后支持S2S事件上报

6.2.0
下线日期:2024年8月31日

2021-02-07

新增API:setPartnerData

6.1.4
下线日期:2024年8月31日

2021-01-12

SDK维护

6.1.3
下线日期:2024年8月31日

2020-12-24

6.1.2
下线日期:2024年8月31日

2020-12-03

SDK维护

6.1.1
下线日期:2024年8月31日

2020-11-17

引入Strict mode SDK(严格模式)

6.1.0
下线日期:2024年8月31日

2020-11-09

更新后支持Unified deep linking API

6.0.8
下线日期:2024年8月31日

2020-10-28

更新后支持Apple App Clips归因

6.0.7
下线日期:2024年8月31日

2020-10-21 SDK维护

6.0.6
下线日期:2024年8月31日

2020-10-20

SDK维护

6.0.5
下线日期:2024年8月31日

2020-10-08

SDK维护

6.0.4
下线日期:2024年8月31日

2020-09-30

更新后支持以ESP为起点的多重跳转

6.0.3
下线日期:2024年8月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

start

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

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
  

响应内容如下:

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

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事件参数