SKAdNetwork—广告平台规范

概述

Branch 正积极为我们的共同广告主定制 SKAdNetwork 解决方案。其目标是让广告平台通过链接将 Apple 回传转给 Branch。Branch 将使用 Apple 提供的加密签名来验证回传，并在操作后台 (Dashboard) 汇总数据。

要求

Send Apple SKAdNetwork postbacks to our Branch endpoint: curl -X POST https://api2.branch.io/v1/skadnetwork
发送以下 SKAdNetwork 数据：
a.必需发送最初从 Apple 收到的 Apple 回传，例如：

{
  "version": "2.0",
  "ad-network-id": "com.example",
  "campaign-id": 42,
  "transaction-id": "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
  "app-id": 525463029,
  "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
  "redownload": True/False,
  "source-app-id": 1234567891,
  "fidelity-type": 1,
  "conversion-value": 20
}

可选：包括以下附加数据以及上述数据
a.partner-campaign- name-与广告活动 ID（字符串）相对应的广告活动名称
b. partner-campaign-id-与广告活动 ID（字符串）相对应的广告活动名称 ID
c. partner-ad-set-id- （字符串）
d. partner-ad-set-name- （字符串）
e. partner-ad-id- （字符串）
F.partner-ad-name- （字符串）
G. partner-creative-id- （字符串）
H. partner-creative-name- （字符串）
i.测试-如果出于测试目的而发送 ping，则发送真实值（布尔值）
j. ip- address-接收回传的设备的 IP 地址（字符串）
k.用户代理-接收回传的设备的 UA（字符串）
请向 Branch 提供 Apple 广告平台 ID
a.您可以通过电子邮件发送给 Branch 的 BD Tech[电子邮件保护]

职责

广告平台的职责是：

Register and provide its ad network ID to developers. See Registering an Ad Network.
Provide signed ads to the source app. See Generating the Signature to Validate an Installation.
通过注册期间建立的 URL 接收安装验证回传。
Verify the postbacks. See Verifying an Install Validation Postback.

发行商应用程序的职责是：

Add the ad network’s ID to its Info.plist. See Configuring the Participating Apps.
Display ads that the ad network signs. See Ad Network Install Validation Keys.

测试应用程序的职责（在 Branch 测试应用程序中实施）是：

Provide app install validation information by calling registerAppForAdNetworkAttribution() or updateConversionValue(_:).
Optionally, update a conversion value by calling updateConversionValue(_:).

测试

下载测试配置文件
To reduce the time window for receiving ad attribution postbacks during testing, install the SKAdNetwork profile on your test device. Downloading the profile requires you to log in to your Apple Developer account.

通过此配置文件，安装的应用程序在最初注册后有 5 分钟的时间更新转化值。在计时器滚动转化更新 5 分钟后，设备将在另外 5 分钟内发送回传。使用此配置文件可以将转化值更新和回传窗口从 24-48 小时减少到 5-10 分钟。

此配置文件将在两周后过期。要继续测试，请重新安装配置文件。

生成测试事件