ドキュメント

サポート

Unity Ads User Acquisition

キャンペーン

アトリビューション

User Acquisition ダッシュボードを開く

Unity Ads User Acquisition

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

Unity Ads から詳細な JSON イベントデータを受信するように MMP エンドポイントを設定することで SKAdNetwork ポストバックを統合し、iOS アプリのインストールに関するキャンペーンの正確なアトリビューションと測定を可能にします。
読み終わるまでの所要時間 2 分最終更新 13日前
Unity にエンドポイントを登録したモバイル測定パートナー (MMP) 向けの SKAdNetwork ポストバックインテグレーションで使用される JSON フィールドについては、以下の表を参照してください。 デバイスからのポストバックを受け取った後、Unity では以下のポストバック実装プロセスが使用されます。
  1. Unity は、署名が有効であることを確認し、SKAdNetwork の 
    campaign-id
    フィールドを内部のキャンペーン ID に変換します。
  2. Unity はその後、JSON ドキュメントを、以下に示すテーブルで参照されているフィールドとともに、POST HTTP リクエストで各 MMP に送信します。

JSON ドキュメントのフィールド

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

JSON フィールド名

型

説明

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