MMP 的 SKAdNetwork 回传集成参考
本节介绍与 Unity 注册了端点的 MMP 的 SKAdNetwork 回传集成。在从设备接收回传后，Unity 使用以下回传集成流程
- Unity 确保签名有效，然后将 SKAdNetwork 的
campaign-id字段转换回内部活动 ID。 - Unity 通过 POST HTTP 请求向相应的 MMP 发送一个 JSON 文档，其中包含下表中引用的字段。
| JSON 字段名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
ip | 字符串 | 发送回传的设备的 IPv4 或 IPv6 地址 参考以下示例
| |
version | 字符串 | SKAdNetwork 版本 参考以下示例
| |
app-id | 整数 | 目标应用 ID | |
campaign-id | 整数 | SKAdNetwork 活动 ID 参考以下示例
| |
source-identifier | 字符串 | SKAdNetwork 源标识符 | 在 SKAdNetwork 4.0 及更高版本中，source-identifier 字段将取代 campaign-id 字段。 |
coarse-conversion-value | 字符串 | 在广告应用中设置的 SKAdNetwork 粗略转化值。 | 此字段可能由于隐私要求而不会出现。有关如何设置 SKAdNetwork 转化值的更多信息，请查看 隐私指南 文档。 |
postback-sequence-index | 整数 | 指示发送回传的转化窗口。 | 要查看在多个转化窗口中接收回传，请参阅 Apple 的 SKAdNetwork 文档。 |
ad-network-campaign-id | 字符串 | Unity 的内部活动 ID。 | |
ad-network-campaign-name | 字符串 | Unity 的内部活动名称。 | |
ad-network-id | 字符串 | 广告网络 ID。 参考以下示例
| |
ad-network-source-app-id | 字符串 | Unity 的内部源应用 ID。 | 仅当原始回传中存在 source-app-id 时，此信息才可用，基于隐私要求。 |
source-app-id | 整数 | 发布商源应用 ID。 | <注意：仅当原始回传中存在 source-app-id 时，此信息才可用，基于隐私要求。 |
transaction-id | 字符串 | SKAdNetwork 回传交易 ID。 | |
fidelity-type | 整数 | SKAdNetwork 回传保真度类型 使用以下值作为 fidelity_type
| 此回传适用于 SKAd 版本 2.2 及更高版本。 |
attribution-signature | 字符串 | 归因签名。 | |
redownload | 布尔值 | 当为 true 时，表示用户从应用商店重新下载了应用 | |
conversion-value | 整数 | 在广告应用中设置的 SKAdNetwork 转化值 (CV) | 重要：此字段可能根据隐私要求而不会出现。有关更多信息，请参阅 SKAdNetwork 文档，了解如何设置转化值。 |
timestamp | 字符串 | Unity 接收 SKAdNetwork 回传的时间 | 重要：所有时间戳都使用 10 位 Unix 格式。 请参考以下正确 Unix 格式示例
|
SKAdNetwork 回传示例
以下 HTTP 示例说明了为已在 “https://mmp.example.com/skadnetwork-postback” 注册端点的 MMP 发送的请求
POST /skadnetwork-postback
HTTP/1.1 Host: mmp.example.com
Content-Type: application/json
{
"attribution-signature" : "MEYCIQD3y3EyGS0VHWU\/aniKNdPVg+oBnuxPtO\/Nmb\/Csly4UwIhAMzJrfQUEu2lsR79PIPReHzQHHqLERgHZDlydHKH61ul",
"source-app-id" : 0,
"conversion-value" : 0,
"app-id" : 123456789,
"transaction-id" : "6f3cfb40-4274-4dc0-be4d-df1410184a61",
"version" : "4.0",
"ad-network-id" : "4dzt52r2t5.skadnetwork",
"timestamp": "1597156649200",
"ip": "1.1.1.1",
"ad-network-campaign-name": "skadnetwork_campaign_1",
"ad-network-source-app-id": "h4sH3d",
"did-win" : true,
"source-identifier" : "0003",
"fidelity-type" : 1,
"postback-sequence-index" : 0,
"coarse-conversion-value": "high",
"redownload" : false
}