# SKAdNetwork 回传数据集成参考

> 通过将 MMP 终端配置为从 Unity Ads 接收详细的 JSON 事件数据来集成 SKAdNetwork 回传数据，从而为 iOS 应用安装实现准确的广告系列归因和衡量。

请参阅下表以了解 SKAdNetwork 回传数据集成中使用的 JSON 字段，适用于已在 Unity 中注册终端的移动端成效衡量合作伙伴 (MMP)。

从设备收到回传数据时，Unity 采用以下回传数据集成流程：

1. Unity 确保签名有效，然后将 SKAdNetwork `campaign-id` 字段转换回内部广告系列 ID。
2. Unity 在 POST HTTP 请求中将一个 JSON 文档发送给相应的 MMP，其中引用下表中的字段。

## JSON 文档字段##json-document-fields

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 回传示例##skadnetwork-postback-example

以下 HTTP 示例展示了向一个注册到“`https://mmp.example.com/skadnetwork-postback`”终端的 MMP 发送的请求：

```text
POST /skadnetwork-postback HTTP/1.1
Host: mmp.example.com
Content-Type: application/json
Content-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"
}
```