# SKAdNetwork ポストバックインテグレーションに関するリファレンス

> Unity Ads から詳細な JSON イベントデータを受信するように MMP エンドポイントを設定することで SKAdNetwork ポストバックを統合し、iOS アプリのインストールに関するキャンペーンの正確なアトリビューションと測定を可能にします。

Unity にエンドポイントを登録したモバイル測定パートナー (MMP) 向けの SKAdNetwork ポストバックインテグレーションで使用される JSON フィールドについては、以下の表を参照してください。

デバイスからのポストバックを受け取った後、Unity では以下のポストバック実装プロセスが使用されます。

1. Unity は、署名が有効であることを確認し、SKAdNetwork の `campaign-id` フィールドを内部のキャンペーン ID に変換します。
2. Unity はその後、JSON ドキュメントを、以下に示すテーブルで参照されているフィールドとともに、POST HTTP リクエストで各 MMP に送信します。

## JSON ドキュメントのフィールド##json-document-fields

Unity は、SKAdNetowrk ポストバック JSON ドキュメントで以下の情報を MMP に送信します。

| **JSON フィールド名**            | **型**   | **説明**                                                                                                                                                   |
| -------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ip`                       | String  | ポストバックを送信するデバイスの IPv4 または IPv6 アドレス。以下の例を参照してください: `"ip" : "198.51.100.1"`                                                                               |
| `version`                  | String  | SKAdNetwork バージョン。以下の例を参照してください: `"version" : "2.0"`                                                                                                     |
| `app-id`                   | 整数      | ターゲットアプリ ID                                                                                                                                              |
| `campaign-id`              | 整数      | SKAdNetwork キャンペーン ID。以下の例を参照してください: `"campaign-id" : 23`                                                                                                |
| `source-identifier`        | String  | SKAdNetwork ソース識別子。ノート: SKAdNetwork バージョン 4.0 以降では、`source-identifier` フィールドは `campaign-id` フィールドよりも優先されます。                                              |
| `coarse-conversion-value`  | String  | 宣伝対象のアプリで設定されたおおよその SKAdNetwork コンバージョン値ノート:このフィールドは、プライバシー要件によっては表示されない場合があります。                                                                         |
| `postback-sequence-index`  | 整数      | ポストバックが送信されたコンバージョン期間を示します。                                                                                                                              |
| `ad-network-campaign-id`   | String  | Unity の内部キャンペーン ID。                                                                                                                                      |
| `ad-network-campaign-name` | String  | Unity の内部キャンペーン名。                                                                                                                                        |
| `ad-network-id`            | String  | 広告ネットワーク ID。以下の例を参照してください: `"ad-network-id" : "1232"`                                                                                                    |
| `ad-network-source-app-id` | String  | Unity の内部ソースアプリ ID。ノート:これは、元のポストバックに `source-app-id` が存在する場合にのみ利用可能です (プライバシー要件に基づく)。                                                                    |
| `source-app-id`            | 整数      | 配信面のソースアプリ ID。ノート: これは、元のポストバックに `source-app-id` が存在する場合にのみ利用可能です (プライバシー要件に基づく)。                                                                        |
| `transaction-id`           | String  | SKAdNetwork ポストバックトランザクション ID。                                                                                                                           |
| `fidelity-type`            | 整数      | SKAdNetwork ポストバックのフィデリティタイプ。ノート: このポストバックは SKAd バージョン 2.2 以降で利用できます。`fidelity_type` には以下の値を使用します: `0`: ビュースルーによる広告表示 `1`:StoreKit により提示された広告            |
| `attribution-signature`    | String  | アトリビューション署名。                                                                                                                                             |
| `redownload`               | Boolean | `true` の場合、これはユーザーがアプリストアからアプリを再ダウンロードしたことを示します。                                                                                                         |
| `conversion-value`         | 整数      | 宣伝対象のアプリで設定された SKAdNetwork コンバージョン値 (CV)。重要: このフィールドは、プライバシー要件によっては表示されない場合があります。                                                                        |
| `timestamp`                | String  | Unity が SKAdNetwork ポストバックを受信した時刻。重要: すべてのタイムスタンプに 10 桁の Unix 形式を使用してください。以下の正しい Unix 形式の例を参照してください。2020 年 8 月 4 日、7: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"
}
```