文档

支持

Unity Ads 用户获取

广告系列

归因

打开 User Acquisition（用户获取）后台

Unity Ads 用户获取

SKAdNetwork 回传数据集成参考

通过将 MMP 终端配置为从 Unity Ads 接收详细的 JSON 事件数据来集成 SKAdNetwork 回传数据，从而为 iOS 应用安装实现准确的广告系列归因和衡量。
阅读时间3 分钟最后更新于 7 天前
请参阅下表以了解 SKAdNetwork 回传数据集成中使用的 JSON 字段，适用于已在 Unity 中注册终端的移动端成效衡量合作伙伴 (MMP)。 从设备收到回传数据时，Unity 采用以下回传数据集成流程：
  1. Unity 确保签名有效，然后将 SKAdNetwork 
    campaign-id
    字段转换回内部广告系列 ID。
  2. Unity 在 POST HTTP 请求中将一个 JSON 文档发送给相应的 MMP，其中引用下表中的字段。

JSON 文档字段

Unity 在 SKAdNetowrk 回传数据 JSON 文档中将以下信息发送给 MMP：

JSON 字段名称

类型

描述

ip
字符串发送回传数据的设备的 IPv4 或 IPv6 地址。请参阅以下示例：
"ip" : "198.51.100.1"
version
字符串SKAdNetwork 版本。请参阅以下示例：
"version" : "2.0"
app-id
整数目标 App ID
campaign-id
整数SKAdNetwork 广告系列 ID。请参阅以下示例：
"campaign-id" : 23
source-identifier
字符串SKAdNetwork 子渠道 ID。注意：在 SKAdNetwork 4.0 及更高版本中，
source-identifier
字段取代了 
campaign-id
字段。
coarse-conversion-value
字符串在推广的应用中设置的 SKAdNetwork 粗略转化价值。注意：由于隐私要求，此字段可能不会显示。
postback-sequence-index
整数表示发送回传数据的转化窗口。
ad-network-campaign-id
字符串Unity 的内部广告系列 ID。
ad-network-campaign-name
字符串Unity 的内部广告系列名称。
ad-network-id
字符串广告网络 ID。请参阅以下示例：
"ad-network-id" : "1232"
ad-network-source-app-id
字符串Unity 的内部子渠道 ID。注意：基于隐私要求，此字段仅在原始回传数据中存在 
source-app-id
的情况下才可用。
source-app-id
整数发行商子渠道 ID。注意：基于隐私要求，此字段仅在原始回传数据中存在 
source-app-id
的情况下才可用。
transaction-id
字符串SKAdNetwork 回传数据交易 ID。
fidelity-type
整数SKAdNetwork 回传保真度类型。注意：此回传数据适用于 SKAd 2.2 及更高版本。对于 
fidelity_type
，使用以下值：
0
：浏览型广告展示 
1
：StoreKit 渲染式广告
attribution-signature
字符串归因签名。
redownload
布尔值当为 
true
时，表示用户再次从应用商店下载了该应用
conversion-value
整数在推广的应用中设置的 SKAdNetwork 转化价值 (CV)。重要：根据隐私要求，此字段可能不显示。
timestamp
字符串Unity 收到 SKAdNetwork 回传数据的时间。重要：所有时间戳均使用 10 位 Unix 格式。请参阅以下示例，了解正确的 Unix 格式：August 4, 2020, 07:25 UTC: 
"timestamp": "1596525944"

SKAdNetwork 回传示例

以下 HTTP 示例展示了向一个注册到“
https://mmp.example.com/skadnetwork-postback
”终端的 MMP 发送的请求： 
POST /skadnetwork-postback HTTP/1.1Host: mmp.example.comContent-Type: application/jsonContent-Length: 577{  "ip": "198.51.100.1",  "version": "4.0",  "app-id": 1234567890,  "campaign-id": 23,  "source-identifier": "2a3b",  "coarse-conversion-value": "medium",  "postback-sequence-index": 0,  "ad-network-campaign-id": "546b9257365399e0031572bd",  "ad-network-campaign-name": "Summer Launch Campaign",  "ad-network-id": "1232",  "ad-network-source-app-id": "com.unity.source.app",  "source-app-id": 987654321,  "transaction-id": "abcd1234-ef56-7890-gh12-ijkl3456mnop",  "fidelity-type": 1,  "attribution-signature": "MEYCIQDW...snip...i7XjFg==",  "redownload": false,  "conversion-value": 5,  "timestamp":"1596525944"}
SKAdNetwork 回传数据集成参考 • Unity Grow • Unity Docs