语言 

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 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 设置,请注意以下事项。

  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
}