SKAdNetwork

SKAdNetwork 是 Apple 自有的归因框架，可针对应用安装和重装进行归因。也就是说，Apple 会进行归因并通知相关广告渠道，然后广告渠道会通过回传将数据传输给 Adjust。Adjust 则聚合并报告所有广告渠道的数据。也就是说，Apple 会进行归因并通知相关广告渠道，然后广告渠道会通过回传将数据传输给 Adjust。Adjust 则聚合并报告所有广告渠道的数据。

借助 Adjust 的 SKAdNetwork 框架支持，您可以直接在 Adjust 中轻松设置 SKA 转化和事件映射。您也可以收集 SKAdNetwork 原始数据进行分析，实现推广活动优化。

操作前须知

以下是您在操作前需要了解的内容。

要求

将您的 Adjust SDK 更新至 v4.23.0+ 版本
管理员、编辑员或自定义编辑员权限
通过support@adjust.com或直接联系您的技术客户经理或代表，确认您的应用已经通过内部 SKAdNetwork 验证。

实用信息

您可以独立进行 SKAdNetwork 设置，也可以借助 Adjust 设置。如果选择借助 Adjust 设置，只要您的 SDK 版本为 4.23.0 或以上，并对接好当中的 SKA 接口，您就能从控制面板中进行全部设置，无需更新应用代码。您的设置方法也会决定在 Adjust 中查看转化值数据的方式。

工作原理

SKAdNetwork 在进行归因时使用的是 App Store 的下载数据，也就意味着不会跟踪或分享设备层级数据，且您的 SKAdNetwork 数据是独立于 Adjust 跟踪数据的。

在发生安装或重装后，Apple 会允许您使用 转化值 ，确定用户触发的应用内事件，例如完成关卡或进行支付等。

什么是转化值？

转化值是一种 6 比特位值，其中包含 6 个数字字符，字符只能为 0 或 1。6 位值可以有从 0 至 63 的 64 种不同值。

最小: 000000 [0]
最大：111111 [63]

应用打开时，registerAppForAdNetworkAttribution()方法会被调用，同时，一个可重置的 24 小时计时器开始计时。如果 updateConversionValue(_:) 方法在计时结束之前被调用，例如用户触发了特定事件，那么转化值就会发生更新，变为一个更大的值。此时计时器就会被重置，开启新的 24 小时窗口。

如果 24 小时内无转化值更新，那么另一个随机计时器就会开始计时，时限最高为 24 小时。该随机计时器结束后，Apple 会通过回调，将最终转化值发送给获得归因的广告渠道。

重要提示：SKAdNetwork 归因数据绝不会实时分享。由于调用方法会激活计时器，所以在安装和获归因广告渠道收到回调之间，始终会有至少 24 小时的时间差。

使用 Adjust 管理 SKAdNetwork

借助 Adjust，您最多可以选择 6 个能触发转化值更新的事件。这些事件可自定义，且只能被映射一次。

当用户触发映射事件时，Adjust SDK 会进行跟踪，并将数据发送至 Adjust 后端。后端会读取控制面板事件映射，然后返回相应的转化值，SDK 则使用该值调用 updateConversionValue(_:)方法。

Adjust 从广告渠道那里收到 Apple 的回调数据，然后我们会对转化值进行解码，并在报告中显示实际事件。

其流程如下。

向您的应用添加 Adjust 事件识别码

选择您想使用 SKAdNetwork 跟踪的唯一事件，最多 6 个。Adjust 会报告触发每个事件的用户人数，但我们无法跟踪单个用户触发某一个事件的次数。

重要提示： 只有在已安装应用提供转化值且达到 Apple 隐私要求的情况下，SKAdNetwork 才会分享事件的转化值。

您应当选择已经在控制面板中设置好的事件。您可以使用现有事件，也可以参照基本事件设置说明，创建新的事件。设置新事件后，请别忘了让开发者将事件识别码加入您的应用。

设置转化值事件映射

要在 Adjust 中设置您的 SKA 转化值事件映射，请按照下列步骤操作。

查找应用并点击应用选项插入符号 (^)
选择 所有设置 > iOS 14 支持 > SKAdNetwork 设置
将转化值管理开关设为开
最多添加 6 个事件
选择保存

很好！Adjust 现在可以管理 SKA 转化值并将其映射到事件了。

查看 SKAdNetwork 聚合数据

您可以在 Adjust Data Canvas 中查看自己的 SKAdNetwork 聚合数据。要进一步了解如何使用该功能，请参阅我们专门的 Adjust Data Canvas 指南。

设置 SKAdNetwork 原始数据导出

要在原始数据中接收 SKAdNetwork 归因更新，请选择专用活动类型： SKAdNetwork 。请注意，全局回传在默认状态下不包含该活动。

请根据您的数据导出方法，使用下方列出的受支持占位符更新 CSV 定义或回传 URL。请注意，Apple 使用的安装验证回调分两个版本。

如果来源应用 (即用于展示广告的应用) 使用的是早于 iOS 14 的 SDK，或目标应用运行的操作系统版本早于 iOS 14，就会使用版本 1

要进一步了解 Apple 通过回调发送给广告渠道的参数，以及参数在不同版本中的可用性，请参阅 Apple 的文档。

占位符	定义
`{sk_ts}`	UNIX 时间戳（以秒计），显示广告渠道收到原始回调的时间
`{sk_payload}`	从 Apple 收到的完整 SKA payload（URL 已编码）
`{sk_version}`	发送给广告渠道的回调版本
`{sk_network_id}`	广告渠道标识符
`{sk_campaign_id}`	展示广告时所提供的推广活动 ID
`{sk_transaction_id}`	针对该验证的唯一值；用于安装验证信息去重
`{sk_app_id}`	被推广产品的物品标识符
`{sk_attribution_signature}`	Apple 的归因签名
`{sk_invalid_signature}`	来自广告渠道的 SKAdNetwork 安装回调验证如果回调无效，那么返回的值为 `1`.如果回调有效，那么返回的值为 `0`。
`{sk_redownload}`	布尔类型 (Boolean flag)，显示用户是否重新下载并安装了应用 [true/false]
`{sk_source_app_id}`	展示广告应用的物品标识符请注意：只有已安装应用提供来源应用 ID 且参数满足 Apple 的隐私要求时，才会显示来源应用 ID。
`{sk_conversion_value}`	已安装应用提供的未签名 6 比特位值请注意：只有已安装应用提供转化值且参数满足 Apple 的隐私要求时，才会显示转化值。
`{network_name}`	SKAdNetwork 扩展回调中显示的渠道名称
`{campaign_name}`	SKA 扩展回调中显示的推广活动名称
`{adgroup_name}`	SKA 扩展回调中显示的广告组名称
`{creative_name}`	SKA 扩展回调中显示的素材名称
`{tracker}`	6 个字符的 Adjust 跟踪码
`{ip_address}`	在 SKA 回调中显示的设备 IP 地址
`{user_agent}`	SKA 回调中显示的传入原始用户代理

合作伙伴集成

Adjust 支持针对 SKAdNetwork 数据的合作伙伴集成。有些合作伙伴由于自身内部限制，无法向 Adjust 发送全套的 SKAdNetwork 数据。也就是说，Adjust Data Canvas 和原始数据中会缺失部分数据。

支持的合作伙伴集成：

Appier
IronSource
Lifestreet
Liftoff
Smadex
Tapjoy
Unicorn
Vungle

不使用 Adjust 管理 SKAdNetwork

如果您选择自行管理 SKAdNetwork 设置，请注意以下事项。

您的应用开发者需要在应用打开时调用 SKAdNetwork registerAppForAdNetworkAttribution() 方法
开发者需要定义每个转化值在应用中意味着什么
Adjust 收到广告渠道发来的数据后，仅会在报告中按原样显示转化值。转化值在 0 至 63 之间，与渠道 payload 中显示的无异。转化值在 0 至 63 之间，与渠道 payload 中显示的无异。

广告渠道 payload 示例：

"version" : "2.0","ad-network-id" : "com.example","campaign-id" : 42,
 "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
 "app-id" : 525463029,
 "attribution-signature" : "MDYCGQD0AdGn5gUnSuVGk8Wi0IgxzWiKdBzwJrQCGQCJfkrI5bda93EC4Xm1H+MtNxstFmnVBn0="
 "redownload": true,
 "source-app-id": 1234567891
 "conversion-value: 20
}