概述
使用 Branch 管理您的广告主 SKAdNetwork 集成，并在 Branch 中显示 SKAdNetwork 数据，需要更新 Branch 操作后台并使用以下两种方法之一更新您的 iOS 应用：
哪个 SDKAdNetwork 实施选项更适合您？
要详细了解每种集成方法的优势，请阅读此常见问题解答篇。
服务器间 (server-to-server) 以及 TUNE SDK 集成
使用服务器间 (server-to-server) 集成，TUNE SDK，或任何不直接包含 Branch SDK 的集成方案/工具包的所有移动应用必须使用选项 2 或利用另一个第三方 SDK 来将事件发送到 SKAdNetwork
先决条件
- 应用已在 Branch 操作后台注册
- 帐户已启用 Branch Universal Ads
- 应用已经在 Apple App Store 上架
- 平台和发行商支持 SKAdNetwork 并将归因数据传递给 Branch。
操作后台 (Dashboard) 设置
1. Authenticate & Integrate with Apple SKAdNetwork
可能需要开发者
验证应用需要访问 Apple 的开发人员工具 App Store Connect，因为 Branch 需要多个 ID 和一个 key 才能完成身份验证并将正确的应用同步到您的 Branch 帐户。
- Issuer ID
- Key ID
- Private Key—了解如何生成 Private Key
要配置 SKAdNetwork 功能，您需要：
- 在左侧导航栏中的渠道和链接项下，点击广告。
- 在广告子菜单中，点击 SKAdNetwork。
- 在 SkAdNetwork 页面上，点击配置选项卡。
- 在身份验证选项卡上，请提供以下 App Store Connect 信息：
a. 发行者 ID
b.密钥 ID
c.私人密钥
-选择"Admin"或"App Manager"访问级 - 点击Save & Continue。
- 一旦您的 App Store Connect 帐户通过身份验证（用绿色的对号标记），请确认已同步正确的应用，然后点击集成。
App Store Connect 凭证
App Store Connect 凭证用于一次性检查以确认 App 所有权。在“App Integration（应用集成）”步骤完成后，可移除这些凭证（“应用集成”旁出现绿色复选标记）。选择“Reset App Store Credentials（重置 App Store 凭证）”可将凭证删除。只要完成了“应用集成”步骤，SKAdNetwork 集成即已完成且有效。
2.选择加入 Branch SDK 支持
在 Branch 操作后台 (Dashboard)的 SKAdNetwork Config 部分，选择 YES 单选按钮，允许 Branch SDK 处理对 SKAdNetwork 的所有调用。
如果您有如下计划，请不要选择加入:
- 直接集成 SKAdNetwork 并以原生方式调用 SKAdNetwork 函数。
- 使用另一个第三方库来处理应用与 SKAdNetwork 的交互。
3.为事件分配转化值
- In the
SKAdNetwork Configsection of the Branch dashboard, select all app events you want Branch use for triggering SKAdNetwork conversion value updates. - You may optionally select a Customer Event Alias and/or a Revenue Range to further distinguish the conversion value.
- Assign unique values to each event (SKAdNetwork accepts any number from 1 to 63, with 0 reserved by the system for the initial install) that represent their level of importance to you, where 63 is the highest priority and 0 is the lowest priority. SKAdNetwork will always use the event with the highest priority, regardless if an event with a lower priority was tracked afterward.
Revenue Range Guidance
- Revenue range is available for all Commerce Events where revenue is available on the event (Purchase, Add to Cart, Add to Wishlist, View Cart, Initiate Purchase, Add Payment Info, Click Ad, View Ad, Reserve, Spend Credits).
- Revenue must be entered as USD on the dashboard. Branch will convert revenue with different currencies on events to USD.
- Revenue ranges must not overlap for the same event (Ex: 1-100, 50-150).
- Lower Bound Revenue is inclusive, Upper Bound Revenue is exclusive.
- While not necessary, it is recommended to include both a lower + upper bound on every event.
APP 选项 1: 使用 Branch SDK 管理 SKAdNetwork
支持的平台
以下 Branch SDK 版本可自动处理 SKAdNetwork 应用内功能。如果您未在以下平台上集成 Branch，请直接与 SKAdNetwork 集成。
- iOS v0.35
- React Native v.5.0.0
- mParticle iOS v.8.0.0
- Adobe Launch iOS v.1.3.0
- Cordova v.4.2.0
- Capacitor v.2.0.0
- Xamarin v.7.0.6
- Unity v.0.6.6
- Flutter v.1.1.0
集成步骤
- 将 Branch SDK 更新到支持 SKAdNetwork 的版本
- 将 Apple 的 StoreKit 框架导入到您的 iOS build
- Confirm the Branch SDK initializes when the app opens. If the SDK is not initializing, have your mobile developer complete the basic Branch mobile integration. Behind the scenes, the Branch SDK will call registerAppForAdNetworkAttribution to ensure SKAdNetwork considers the install for attribution.
- 确认 Branch SDK 已经在追踪应用事件。如果想要添加新转化事件，您需要更新应用，以使用 Branch SDK 来追踪这些事件。
更改转化值
追踪事件时，Branch SDK 始终会调用 updateConversionValue 并使用 Branch 操作后台中映射的值。如果您在操作后台中更改值，Branch SDK 将开始使用新值。
更改 SKAdNetwork 标注的时间窗口
By default, Branch limits
updateConversionValue()calls to SKAdNetwork to within 24 hours after first install. Every timeupdateConversionValue()is called with a value greater than previous, this delays SKAdNetwork's attribution of the original Install event by a rolling 24 hour timer.但是，您可以使用以下 SDK 方法修改此时间窗口：
- Branch.getInstance().setSKAdNetworkCalloutMaxTimeSinceInstall(3600.0 * 24.0)
Facebook - 广告投放优化要求
Facebook 广告投放优化要求 SKAdNetwork 窗口的延迟不得超过 24 小时。我们的 SDK 默认支持24小时窗口。
追踪 SKAdNetwork 和 Branch SDK 之间的不同事件
Based on your SKAdNetwork strategy, it may not always make sense to have the Branch SDK automate the SKAdNetwork in-app integration. Because of SKAdNetwork's restrictions on conversion values (63 total values, no metadata, etc.), using the existing events you track with the Branch SDK may not be as effective as tracking custom values by integrating directly with SKAdNetwork. For example, if revenue is your most important metric, you can use conversion values to represent differences in revenue "basket size".
APP 选项 2: 直接与 SKAdNetwork 集成
如果您希望直接管理 SKAdNetwork，而不是通过 Branch SDK，则可以使用这一方式。
集成步骤
- 在操作后台设置中选择不使用 Branch SDK 管理 SKAdNetwork，并完成操作后台设置的剩余部分。
- 将 Apple 的 StoreKit 框架导入到您的 iOS build
- 在应用首次打开 (i.e., your "Install" session) 时，从 SKAdNetwork class 中调用registerAppForAdNetworkAttribution()
registerAppForAdNetworkAttribution() 只需调用一次
对这一方法的后续调用将不起作用。
报告转化
- 为您要发送给 Apple 的每个应用事件，从 SKAdNetwork 中调用updateConversionValue()，并在 Branch 操作后台中为每个事件使用相同的值。
- 安装 24 个小时后，停止调用 updateConversionValue()，与 Branch 的追踪方法保持一致。每次调用 updateConversionValue() 且数值大于前一个值时，Apple 的原始安装事件归因会以 24 小时为基础成倍延迟。
更新 updateConversionValue() 中的值
如果您更改某一事件的转化值，将会存在过渡期，在此期间，应用最新版本的用户将使用新值报告转化，而旧版本的应用将继续使用旧值报告转化（直到他们完成应用更新）。
请记得更新 Branch 操作后台中映射的值，以确保报告与 Branch 中的值一致。
Apple 没有提供可以报告转化的服务器端 API
SKAdNetwork 阻止将用户关联到转化，因此在服务器端追踪事件必须指示应用将转化报告给 SKAdNetwork。由于第一次转化必须发生在安装后的 24 小时内，因此有机会在服务器端追踪事件，但是没有在 24 小时窗口期内再次打开应用的用户，也就无法报告给 Apple。
为了缓解这一风险，始终追踪通常会导致服务器端事件的一系列应用内事件(例如 "add-to-cart" 通常是 "purchase" 之前发生的事件)。他们不能代替您的服务器端事件，但是可以作为评估广告 campaign 表现时的有效代理；而且还可以延迟 Apple 的 24 小时定时器，以提高在追踪服务器端事件后的时间内用户重新打开应用的概率。
Enable Direct Postbacks
With the release of iOS 15, advertiser apps can now receive the winning SKAdNetwork postback if they include the NSAdvertisingAttributionReportEndpoint in your app's Info.plist using the following endpoint:
问题排查常见问题解答
5 天前更新