Languages 
  • English
  • 中文
  • 日本語

SKAdNetwork 设置

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

借助 Adjust 的 SKAdNetwork 框架支持,您可以直接在 Adjust 中轻松设置 SKA 转化和事件映射。您也可以收集 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 转化值事件映射,请按照下列步骤操作。 

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

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

查看 SKAdNetwork 聚合数据

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

设置 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_redownload}

布尔类型 (Boolean flag),显示用户是否重新下载并安装了应用

[true/false]

{sk_source_app_id}

展示广告应用的物品标识符

请注意:只有已安装应用提供来源应用 ID 且参数满足 Apple 的隐私要求时,才会显示来源应用 ID。

{sk_conversion_value}

已安装应用提供的未签名 6 比特位值

请注意:只有已安装应用提供转化值且参数满足 Apple 的隐私要求时,才会显示转化值。

{campaign_name}SKA 扩展回调中显示的推广活动名称
{adgroup_name}SKA 扩展回调中显示的广告组名称
{creative_name}SKA 扩展回调中显示的素材名称
{tracker}6 个字符的 Adjust 跟踪码

不使用 Adjust 管理 SKAdNetwork

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

  1. 您的应用开发者需要在应用打开时调用 SKAdNetwork registerAppForAdNetworkAttribution() 方法 
  2. 开发者需要定义每个转化值在应用中意味着什么
  3. Adjust 收到广告渠道发来的数据后,仅会在报告中按原样显示转化值。转化值在 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
}