Apple Search Ads 归因 API 完整方案

☞点击下载：ASA 上线开发者必看

一、概要

Apple Search Ads 的归因 API 包括两个，分别是 iAd Framework 和AdServices Framework。ASA的广告主需实现两个归因 API，充分准确地归因来自 ASA 广告的安装。

两个方案对于 iOS 的版本支持以及用户隐私相关的限制：

• iOS 14.3 （含）以及更高版本的设备，优先使用 AdServices API 获取归因，该方案不涉及用户隐私限制，理论上归因成功率超过 90%。

• iAd API 可支持所有版本的设备（iOS 4.0+），但仅限于【允许跟踪】的设备：

  • 在 iOS 13 以及更低版本的设备中，隐私设置中的【限制广告跟踪】为关闭状态
  • 在 iOS 14 以及更高版本的设备中，隐私设置中的【允许应用程序请求跟踪】为开启状态
  • 在 iOS 14.5 以及更高版本的设备中，还要求 app 通过 App Tracking Transparency框架，征求到用户的跟踪许可。

两个方案的版本支持及成功率示意：

注：上图中的 50%、90% 数值的归因成功率，需排除复杂归因逻辑的场景，例如多渠道归因、新老用户、网络异常等。

二、方案实施

1、将框架添加到您的项目

• AdServices.framework 这个框架是用于 ASA 归因的，不受 ATT 约束，就是无论用户是否允许跟踪，都可以归因，仅支持 14.3 及更高版本系统，需XCode 12.3及更高版本支持。
• iAd.framework 这个框架是用于 ASA 归因的，受 ATT 以及 LAT 约束，如果用户允许跟踪，就可以归因。目前支持所有iOS版本，但未来可能失效，被 AdServices 替代。
• AppTrackingTransparency.framework 在iOS 14 及更高版本用于征求用户跟踪许可的框架，就是弹窗询问用户是否同意跟踪；在 iOS 14.5 上苹果将强制要求开发者实施，也是获取 IDFA 的前提。
• AdSupport.framework 这个框架用于获取 IDFA，以及在低于 iOS 14 的版本中获取 LAT 信息。

以上framework，在添加到项目中后，均设置为 optional

2、获取归因数据

示意代码，仅供参考

3、归因数据包格式说明

注：

• convertionType，经当前API实际测试，取值为 Download 和 Redownload。
• clickDate, 经当前API实际测试，取值为 2020-01-04T17:17，时间格式只到分钟。

4、存储示例

假设我们使用一个关系型数据库表来存储的激活设备明细，如下示意

attribution 1表示true，conversion_type d表示Download, r表示Redownload

5、统计使用示例

按关键词粒度统计每日激活设备数

输出结果

三、注意事项

• 随着 iOS 14.3 及更高版本的覆盖率不断提升，需重点支持 AdServices 方案，此方案不涉及用户隐私的限制
• XCode 版本必需 12.3 以上
• 项目中添加的 Frameworks，均设置为 Optional
• 如果开发者采用三方 SDK，如 AppsFlyer、Adjust 等，请与提供商的客户经理沟通确认其 SDK 版本。集成其最新版本后，可使用上述示意代码做基本测试。
• AdServices 的归因 API，获得 token 后，可在客户端也可在 Server 端完成归因数据包的获取，但注意 token 会在 24 小时后失效
• 在客户端获取的归因数据包，建议直接上传到 Server 端，在 Server 端做格式解析，处理入库。

微信扫码

钉钉