语言 

SKAdNetwork

SKAdNetwork 是 Apple 自有的归因框架,可针对应用安装和重装进行归因。也就是说,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. 设置转化值窗口 (可选)
  6. 选择 保存

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

使用转化值窗口

渠道回调 URL 收到安装通知的时间并不确定。由于此通知是在 24 小时之后被触发的,因此转化值数据有可能会因更新而改变。为了让您更好地控制自己的数据,Adjust 现允许用户在设置事件映射的同时设置一个转化值窗口 (comversion value window)。

通过转化值窗口,您可以设定一个应用安装或重装之后的时间段,在此时间段内,Adjust 会根据用户活动持续更新转化值。自定义窗口过期后,Apple 会在最后跟踪事件后的随机 24 - 48 小时内,通过回调 URL 发送归因数据。

我们建议您根据自身需求选择最短的转化值窗口 (最短为 1 小时)。此操作将优化推广活动,让您更好地捕捉用户活动。

请注意:
在转化值窗口内,事件跟踪将视乎情况记录。窗口取决于终端用户触发首个应用会话后发送的活动情况。

查看 SKAdNetwork 聚合数据

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

设置 SKAdNetwork 原始数据导出

要在原始数据中接收 SKAdNetwork 归因更新,请选择专用活动类型: SKAdNetwork​ 。统一回传在默认状态下不包含该活动。 

请根据您的数据导出方法,使用下方列出的受支持占位符更新 CSV 定义回传 URL

重要提示:
在您的回传中,并非所有 SKAd 相关占位符都会被填充。相关数据完全取决于合作伙伴发送给我们的内容。

受支持的占位符

占位符定义示例值
{sk_ts}UNIX 时间戳(以秒计),显示广告渠道收到原始回调的时间1403568849
{sk_payload}从 Apple 收到的完整 SKA payload。

注意:在您的回传中,URL 会进行编码,但在 CSV 上传中则不会。
已编码 URL:%7B%22version%22%20%3A%20%222.0%22%2C%22ad-network-id%22%20%3A%20%225UX5ZH24HU.skadnetwork%22%2C%22campaign-id%22%20%3A%2042%2C%22transaction-id%22%20%3A%20%226aafb7a5-0170-41b5-bbe4-fe71dedf1e28%22%2C%22app-id%22%20%3A%20525463029%2C%22attribution-signature%22%20%3A%20%22MDYCGQD0AdGn5gUnSuVGk8Wi0IgxzWiKdBzwJrQCGQCJfkrI5bda93EC4Xm1H%2BMtNxstFmnVBn0%3D%22%0A%22redownload%22%3A%20true%2C%22source-app-id%22%3A%201234567891%2C%22conversion-value%3A%2020%22%7D
{sk_version}发送给广告渠道的回调版本2.0
{sk_network_id}广告渠道标识符com.example
{sk_campaign_id}展示广告时所提供的推广活动 ID42
{sk_transaction_id}针对该验证的唯一值;用于安装验证信息去重6aafb7a5-0170-41b5-bbe4-fe71dedf1e28
{sk_app_id}被推广产品的物品标识符525463029
{sk_attribution_signature}Apple 的归因签名ABCDGBdK%2BUupx6rZA2XO%2B6c0nYUhEg3dm%2BXIFAIZALqlLLnCh7ZFhI2fFPG4PF9wlVGJpKAL%2Fw%3D%3D
{sk_invalid_signature}来自广告渠道的 SKAdNetwork 安装回调验证

如果回调无效,那么返回的值为 1.如果回调有效,那么返回的值为 0
0
{sk_redownload}布尔类型 (Boolean flag),显示用户是否重新下载并安装了应用

[true/false]
true
{sk_fidelity_type}该值为 0 时表示展示广告;为 1时表示 StoreKit 提交的 (点击) 广告。0
{sk_source_app_id}展示广告应用的物品标识符

请注意:只有已安装应用提供来源应用 ID 且参数满足 Apple 的隐私要求时,才会显示来源应用 ID。
1234567891
{sk_conversion_value}0 - 63 之间的整数转化数值

请注意:只有已安装应用提供转化值且参数满足 Apple 的隐私要求时,才会显示转化值。
20
{network_name}SKAdNetwork 扩展回调中显示的渠道名称
  • 该占位符当前针对 Snapchat 填充
{campaign_name}SKA 扩展回调中显示的推广活动名称Christmas
{adgroup_name}SKA 扩展回调中显示的广告组名称Reindeers
{creative_name}SKA 扩展回调中显示的素材名称320x70_en
{tracker}6 个字符的 Adjust 跟踪码abc123
{ip_address}在 SKA 回调中显示的设备 IP 地址192.168.0.50
{user_agent}SKA 回调中显示的传入原始用户代理
Mozilla%2F5.0+%28Linux%3B+U%3B+iOS...

请注意,Apple 使用的安装验证回调分两个版本。 

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

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

不使用 Adjust 管理 SKAdNetwork

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

  1. 您的应用开发者需要在应用打开时调用 SKAdNetwork registerAppForAdNetworkAttribution() 方法 
  2. 开发者需要定义每个转化值在应用中意味着什么
  3. 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
}