SKAdNetwork 介绍

SKAdnetwork 是苹果针对 iOS 14 引入新的归因方式。这里有苹果的官方文档。 使用 SKAdnetwork 时，每个广告点击都会附加一个签名。当用户首次打开您的 App 时，苹果将验证广告来源及其签名。然后发送回调到广告网络来归因此次激活。集成 SKAdnetworks，您必须在 SDK 中同时调用以下这两种 method。我们已经更新了 iOS 和 Unity 的 SDK 来支持这两种 method。

• registerAppForAdNetworkAttribution(): 此 method 应在用户首次打开 App 时调用，登记用户以进行归因。 如果用户是来自已经签名的广告，在接下来的几个小时内，会有一个回调发送至广告网络，通知此次转换。
• updateConversionValue(_:): 此 method 需每次您想要更新用户的 conversion value 时进行调用。调用的次数没有限制，但 conversion value 仅在比上次的值更高时才会更新。

同时，请同时和广告网络确认他们是否已经可以支持 SKAdnetwork 的广告计划。

Conversion Value

Conversion value （转化价值）是介于 0 到 63 之间的数字值，您可以将其分配给某个具体的安装。 在不识别出这个具体用户的前提下，Conversion value 依旧可以帮助您了解该具体用户价值的“信号”。 广告网络可以使用此信息来了解每次安装对您业务的价值。 Conversion value 可以帮助广告网络确定更好的受众群体来投放您的广告，并改善广告计划的效果。

以下是 Conversion value 的重要特征。

• 您只能使用比上一次调用更高的值来更新 Conversion value（比如可以从 1 更新为 2，但不可以从 3 更新到 2）
• 取值范围在 0-63 之间
• 您可以在用户生命周期内的任何时间范围内测量 conversion value，但是等待时间越长，广告网络就越晚从 Apple获得回调。 因此，Tenjin 建议您使用 24 小时为时间窗口。
• 根据苹果的隐私权阈值描述，仅当安装有足够的安装量时，conversion value 才会显示。

Tenjin 为开发团队提供了极大的灵活性，您可以将任意 Conversion value 映射到特定的用户事件上。 Tenjin 的客户成功团队非常乐意协助您找出最适合您方案，以下是一些针对靠应用内广告变现产品的基本建议。

方案 1. 将广告收入映射到 conversion value

• 使用安装后 24 个小时内的数据，计算出设备上每个广告的累计收入，与 conversion value buckets 进行关联。
• 在 SDK 中实施 conversion value buckets：将累积的广告收入映射到 conversion value。

• 在安装后的 24 小时内，每次当有广告展示发生时，在 Tenjin 的 SDK 上通过 updateConversionValue(_:) method 向 Tenjin（和苹果）发送对应的 conversion value。

  注意：广告收入到 conversion value 的映射可能会随着时间而改变，并且需要在 App 中进行更新。 您需要 Mediation SDK 中集成 Impression Level Revenue Data(ILRD)，目前，只有 MoPub 和 ironSource 具备此功能。

方案 2. 将广告展示映射到 conversion value

• 使用安装后 24 个小时内的数据，计算出设备上每个累计的广告展示，与 conversion value bucket 进行关联。
• 将累积的广告展示映射到 conversion value。

• 在安装后的 24 小时内，每次当有广告展示发生时，在 Tenjin 的 SDK 上通过 updateConversionValue(_:) method 向 Tenjin（和苹果）发送对应的 conversion value，即广告展示计数（impression counts）。

  注意：广告展示与 conversion value 的映射可能会随着时间而改变，并且需要在 App 中进行更新。

方案 3. 会话（Session）

• 统计自安装后 24 小时内累计会话数。
• 在安装后的 24 小时内，每次当有会话发生时，在 Tenjin 的 SDK 上通过 updateConversionValue(_:) method 向 Tenjin（和苹果）发送对应的 conversion value，即累计会话数（accumulated session count）。

这里有 Tenjin 客户分享他们实现 conversion value 映射的示例。

• Examples for IAP based games
• Examples for Ad revenue based games

SKAdnetwork 回调计时器

从苹果发送到广告网络的回调中，有两种不同类型的计时器（Timer）：

• 24 小时计时器：可以多次重置，定义时间维度为 24 小时。
• 随机计时器：一旦启动，便无法重置。 持续时间为介于 0-24 小时之间的随机值。

当您触发 registerAppForAdNetworkAttribution() 时，24小时计时器将启动。 如果您决定触发 updateConversionValue(_:)，则24小时计时器将重置为 0，然后重新启动。 每次您触发 updateConversionValue(_:) 时，都会重置24小时计时器。 假设您在 24 小时计时器到期之前没有触发 updateConversionValue(_:)，一个随机计时器将会启动。 一旦随机计时器启动后，您将无法再更新 conversion value。 在随机计时器结束时，回调将发送到广告网络。 此回调可以包含（或不包含） conversion value （它将是您为此特定用户设置的最后的值）。

如果您有任何特定问题，请随时发送电子邮件至 support@tenjin.com。

已经支持的渠道清单

下面是已经支持 SKAdnetwork 的渠道清单，我们会每2周更新一次。

*: 广告投放渠道是选择通过 postback 还是 reporting API 发送 SKAdnetwork 转换

常见问题 FAQ

某归因合作伙伴告诉我，他们已通过 SKAdNetwork 认证。您是否已通过 SKAdNetwork 认证？

• 根本就没有 SKAdNetwork 认证这回事。在苹果的官方文档中，没有任何关于归因合作伙伴的内容。

作为应用开发者，我需要为 iOS 14 做什么准备？

• 您需要使用最新的 Tenjin SDK 更新您的产品，并确保您向我们发送了 conversion value。开发者可以非常灵活地使用 conversion value。如果您需要一些关于如何映射 conversion value 的建议，Tenjin 可以为您提供培训。

我还能在 Tenjin 面板上查看我在 App + Country 级别上的所有指标吗？

• 可以，在我们的归因建模方案第3阶段结束前，您仍然仍然可以使用 App + Country 级别的数据。

由于 Tenjin 不是 FB MMP，在 iOS 14 中，Tenjin 将完全不可能归因于 FB 安装吗？

• 相反，在 iOS 14 下，MMP 并不具有数据访问的排他性，带有 SKAN 的 Facebook API 向所有人开放。 MMP 的唯一好处是同步 FB 和 MMP 面板之间的转换值映射。而您也可以自行完成相同操作，Tenjin 可以为您提供相关的培训。

开发者可以在 ATT 同意弹窗之前添加自定义弹出窗口（以鼓励用户接受同意）吗？

• 可以的，您可以自行决定显示弹出窗口的时间，但是在归因需要的前提下，我们只能在弹窗同意后才能开始收集 IDFA，因此，尽早弹出窗口可以提高基于 IDFA 的归因成功率。

我需要在广告变现上什么才能使 SkAdnetwork 正常工作？

• 如果您通过广告进行变现，按照苹果的说法，则您的应用为“source-app”，并且您需要将与您合作的每个变现渠道的 SKADnetwork ID 添加到列表文件中。详情点击这里查看

为什么会有一些 SKAdnetwork 回调的 conversion value 为 NULL？

• 有两种情况
• 如果 App 提供了 conversion value， 调用了 registerAppForAdNetworkAttribution 但从未调用 updateConversionValue，则 conversion value 将为 NULL。任何对 updateConversionValue 的调用都会将 CV 设置为非 null（0 到 63）。可能是用户留存很低，并且从未生成 conversion value，或者 App 调用 updateConversionValue 的频率不够。
• 达到 Apple 的隐私阈值。无论在 1 中发生什么情况，Apple 都可以决定在 Postback 中设置 conversion value = NULL。最开始，一个 App + 广告计划将的所有 postback 中 conversion value 都为 null 。在对该 App + 广告计划进行约 50 至 100 次 Postback 后，conversion value 可以为非 NULL。此时，满足了隐私阈值，并且上述第 1 点是此广告计划将来的 conversion value 可能为 NULL 的唯一原因。

Tenjin 面板首页上 User Acquisition 标签页的数据中 reported / tracked installs（报告/追踪到的安装激活） 和 Data Exporter 中的 SKAdNetwork 的 conversion value 计数是什么关系？我应该在日常运营中应该使用这些数据？

Data Exporter 中的 SKAdNetwork 的 conversion value 计数反映的是 SKAdnetwork 中被归因的安装激活数量。SK Adnetwork 的安装激活数据不能直接和报告/追踪到的安装激活直接对比，因为：

• 并非所有广告网络（投放渠道）都在同时使用 SKAd 归因和传统的点击/展示归因。
• 由于 Apple 计时器限制，SKAd 的安装激活报告有延迟，因此 Tenjin Data Exporter 中的 SK Ad Network 标签页中的日期是收到来自 Apple 的 SKAdnetwork 回调的日期，而不是实际的安装日期。在 Tenjin 面板上的 User Acquisition 标签页中，日期为实际的安装日期。

目前您唯一可以进行比较的纬度是按广告网络（投放渠道）的激活安装数据，即同时进行 SKAdnetwork 和 URL 归因，来判断安装激活的差异。且一定程度的差异是正常的：

• 如果您在 10 个不同的广告投放渠道上进行用户获取，但其中只有 3 个运行 SKAd 的广告计划，SKAd 安装激活会将更多被安装归因于这 3 个渠道上，原因是竞争比较少。
• 将 SK 回调收据的日期与实际的安装激活日期对齐，将永远都会是近似值，不会完全相同。

Data Exporter

目前, SKAdnetwork 数据需要在Data Exporter 中进行查询.在控制面板上 ANALYZE -> Data Exporter. 您可以使用以下的应用及渠道来筛选数据。

您可以使用下面多纬度进行 group-by 分组查询:

• Required dimensions
  • App
• Tenjin dimensions
  • Channel
• SK Adnetwork dimensions
  • Conversion Value
  • Fidelity Type
  • SK Campaign
  • SK Channel
  • SK Source app

同时, 您可以从下拉菜单中选择以下多个数据进行查询:

• Conversion Value Count (Default)
• Conversion Value Average (Default)
• Conversion Value Total
• First Download Count
• First Download Conversion Value Average
• First Download Conversion Value Total
• Redownload Count
• Redownload Conversion Value Average
• Redownload Conversion Value Total

您可以在 这里 进一步了解各类数据的定义。