中文

App Tracking Transparency (ATT) 框架

根据 Apple 的规则指南,任何出于跟踪或广告相关目的收集最终用户数据并与第三方分享的应用,都必须使用 AppTrackingTransparency (ATT) 框架。这要求应用发行商先获得用户的明确许可,才能访问用户的 iOS 广告 ID (即 IDFA)。

为获得用户许可,ATT 框架会向用户显示应用跟踪授权请求弹窗。用户可以从应用层级上控制隐私设定,也可以从整体层面阻止所有应用的跟踪。

在这里,您将了解到如何通过 Adjust 设置 ATT 许可管理,并查看您的原始数据。

重要提示:
iOS 14.5iPadOS 14.5tvOS 14.5 及之后的操作系统版本都必须采用 AppTrackingTransparency。

操作前须知

要使用该功能,请先为您的平台下载并设置对应的 Adjust SDK。按照下方链接中的说明操作,开始使用功能。

此功能需要 Adjust SDK v4.23.0 或更新版本。

⚙️ iOS / Unity / Cordova / Flutter / Titanium / Corona / Cocos2d-x / React Native

安装并配置 Adjust SDK 后,请按照下方链接中的指南使用该功能:

📖 iOS / Unity / Cordova / Flutter / Titanium / Corona / Cocos2d-x / React Native

提示:
我们推荐您使用最新稳定版本的 Xcode 来构建应用。

工作原理

默认状态下,应用启动时,用户处于退出数据跟踪的状态。ATT 框架被触发后,用户会收到一个许可弹窗,请求在应用内跟踪用户。ATT 许可请求是应用层级上的,也就是说,用户可以选择为某些应用授予许可,但拒绝另一些应用的许可请求。

如果用户拒绝数据跟踪,IDFA 就会返回一串 0。对于同意跟踪的用户,其 IDFA 可以被读取并用于归因。

ATT 状态

在 ATT 框架下,用户许可有 4 种状态。该些状态代表是否能访问应用相关数据,用于用户或设备跟踪。要进一步了解应用跟踪授权的每种状态值,请查看 Apple 的开发者文档

状态描述
0Not Determined (待定)返回该值即代表用户尚未收到请求,未决定是否允许应用出于跟踪用户或设备的目的访问应用相关数据。
1Restricted (受限)返回该值即代表用户对应用弹出许可请求的行为作出了限制,因此,应用无法请求用户分享可用于跟踪的应用相关数据。
2Denied (拒绝)返回该值即代表用户拒绝授权,不分享可用于用户或设备跟踪的应用相关数据。这包括在全局层面上将 “允许应用请求跟踪“ 调整为关闭的情况。
3Authorized (授权)返回该值即代表用户已授权,选择分享可用于用户或设备跟踪的应用相关数据。

"Restricted" (受限) 究竟意味着什么?

全局设置

iPhone 中有一项设置,可让用户在全局层面上控制应用跟踪请求。该设置的默认状态为允许应用显示数据跟踪请求。当该选项被设置为关时,用户的 ATT 状态将返回Denied (拒绝)

通过 Adjust 启用 ATT 许可请求弹窗

您可以使用 Adjust SDK 包装器功能,向用户弹出应用跟踪授权请求。

借助 Adjust 针对 ATT 框架的 SDK 包装器,您无需额外安装 Apple 的 ATT API。第一次调用包装器时,会启用 iOS 弹窗。此后每次调用时,包装器会读取跟踪授权状态,然后将该信息发送给 Adjust 后端,而 Adjust 则将这一信息直接传递给您。

导出原始数据

借助 Adjust SDK,您可以在用户采取应用内行动时收到 ATT 状态信息,并在 IDFA 可用时获得更详实的数据。

Adjust 透过 ATT update (iOS) 这一活动类型,在回传中发送关于用户 ATT 状态的信息。您的统一回传中会默认加入此类活动,进而提供所有 Adjust 跟踪活动的完整数据点列表。

如果您使用的是统一回传,且用户的授权状态发生变化,那么在 Adjust 跟踪事件的几秒钟后,用户层级的数据就会被直接发送到您的服务器。要快速查找这些事件,请在{activity_kind}中筛选 att_update​ 。

要完整了解创建统一回传 URL 的方法,请参阅 Adjust 的实时回传指南

所有原始数据导出仍旧沿用我们当前的瀑布模型归因方法。如果用户尚未选择加入,您可以通过{att_status}查看其状态。

iOS 14.5+ 归因更新

如果设备的 ATT 状态变为 Authorized (已授权),Adjust 就可以访问 IDFA,检查交互匹配,进行归因。如果归因来源发生变化,Adjust 会在下一次事件或会话发生时在您的原始数据和应用内归因回传中发送更新后的归因信息。

ATT 状态变更归因更新仅适用于:

  • iOS 14.5+ 设备。
  • 设备当前被归因为自然流量。

我该如何接收归因更新?

常见问题

占位符

通过 Adjust 占位符 {att_status} ,您可以收到用户授权相关信息,了解 iOS 14+ 用户在数据分享方面如何选择。您可以将此占位符附加到回传 URL 或 CSV 定义中,之后即可在原始数据中获知 ATT 状态。用户授权状态有四种可能的整数值。

示例:att_status=2

{tracking_enabled} 和 {tracking_limited} 占位符变更

为了帮助您顺利过渡到 ATT 跟踪,我们对现有的两个占位符进行了调整。该调整仅适用于受支持的 SDK 版本和 iOS 14+​ 。用户。

{tracking_enabled} {tracking_limited}占位符的行为发生了如下变化:

占位符行为
{tracking_enabled}
  • 用户选择加入状态为 授权 时,返回的值为 1
  • 用户选择加入状态为 拒绝待定受限时,返回的值为 0
{tracking_limited}
  • 用户选择加入状态为拒绝待定受限时,返回的值为 1
  • 用户选择加入状态为 授权 时,返回的值为 0

对于 iOS 14.0-14.4 用户

限制广告跟踪 (LAT) KPI 变更

Apple 计划弃用限制广告跟踪 (LAT) 设置。也就是说,如果您不更新到受支持的最低 SDK 版本,Adjust 将根据 IDFA 是否可用而设置 LAT 值。如果 IDFA 是一串零,LAT 则被视为 启用​ 。

此外,Adjust 还调整了 LAT KPI 在控制面板中的行为。在您切换到{att_status}之前,请注意这些变化。该调整仅适用于受支持的 SDK 版本和 iOS 14+ 用户。

LAT KPI 按照下列方式填充:

  • 如果 att_status受限 拒绝​ ,则值为 1
  • 如果 att_status授权待定​ ,则值为 0