カスタムインテグレーションのポストバックリクエストパラメーターリファレンス
カスタムのサーバー間インテグレーション ポストバック要求のパラメーターを確認します。
読み終わるまでの所要時間 4 分最終更新 1ヶ月前
カスタム統合のポストバックリクエストを正しく形式設定するために、以下のパラメーターを確認してください。
必須のアトリビューションポストバックパラメーター
カスタム統合の ポストバックリクエスト では、以下の識別パラメーターを引き渡す必要があります。
パラメーター | 説明 | 例 | ノート |
|---|---|---|---|
| 大文字の形式で表される広告識別子 (IDFA)。 | | IDFA は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。 |
| ハッシュされた小文字の形式で表される広告識別子 (IDFA)。 | | IDFA は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。 |
| 小文字の形式で表される Google 広告 ID。 | | 広告 ID は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。 |
| MD5 でハッシュされた小文字の形式で表される Google 広告 ID。 | | 広告 ID は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。 |
|
追跡型広告制限 (LAT) がオンになっているユーザーをトラッキングするうえで必須となる一意の Unity Ads 識別子。
|
| |
| エポック以降のインストール時間 (秒)。 | | このパラメーターは一部のキャンペーン目標で必須です。 |
| 元の小文字の形式で表される Android ID。 | | |
| Android ID (MD5 でハッシュされた形式)。 | | これは、Android デバイスに Google Play Services が正しく統合され、Google Play がインストールされている場合は不要であるため、非推奨です。ただし、Google Advertising ID を持たないすべての Android インストールでは必須です。 |
|
このインストールが Unity Ads にアトリビュートしていて、課金対象になるかどうかを示すフラグ。
| デフォルト値 ( |
必須のインストール後イベントポストバックのパラメーター
カスタム統合の ポストバックリクエスト では、以下の識別パラメーターを引き渡します。
パラメーター | 説明 | 例 | ノート |
|---|---|---|---|
| インストールしているユーザーを表す Unity の一意のゲーム ID | | |
| 大文字の形式で表されるデバイスの Apple 広告 ID (IDFA)。 | | IDFA は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。 |
| 小文字の形式で表される Google Play 広告 ID | | |
| 小文字の形式で表される MD5 でハッシュされた Google 広告 ID | | |
| ユーザーの追跡型広告制限が有効になっているかどうかを示すフラグ |
| |
| Unity キャンペーン識別子 | | Campaign ID (キャンペーン ID) は、User Acquisition (ユーザー獲得) ダッシュボードの Campaigns (キャンペーン) ページから取得できます。 |
| Unity ゲーム ID | | 広告主の Game ID (ゲーム ID) は必ず User Acquisition (ユーザー獲得) ダッシュボード から取得してください。Monetization (収益化) ダッシュボードの SDK 統合で使用するパブリッシャーの Game ID (ゲーム ID) は使用しないでください。 |
| プラットフォーム + ストア ID |
| iOS には以下の値を使用できます。
|
| プラットフォーム + バンドル ID | | Android には以下の値を使用できます。
|
| プラットフォーム + Unity プロジェクト ID | | Project ID (プロジェクト ID) は、Unity Dashboard の任意の Projects (プロジェクト) の Settings (設定) タブから取得できます。 |
| Unix 形式で表される元のインストールのタイムスタンプ | | 推奨されるベストプラクティスは、タイムスタンプにミリ秒を使用することです。 |
| ユーザーがゲームプレイセッションを開始したことを示すセッションイベントフラグ | | |
| ユーザーがアプリ内課金を完了したこと + トランザクション額を示す購入イベントフラグ | | 推奨されるベストプラクティスは、通貨に USD を使用することです。 |
| ユーザーに広告収益が発生したこと + 収益額を示す広告収益イベントフラグ |
|
|
| 元のインストールが Unity にアトリビュートされたかどうかを示すフラグ | |
|
任意のセカンダリポストバックパラメーター
インストール後のイベントに関する以下のパラメーターは、必須ではありません。GET リクエストでこれらのパラメーターを使用して、アプリのインストール後イベントに関する追加情報を取得します。
パラメーター | 説明 | 例 | ノート |
|---|---|---|---|
| Unix 形式で表されるインストール後イベントのタイムスタンプ | | すべてのタイムスタンプに Unix の形式を使用してください。推奨ベストプラクティスはミリ秒ですが、Unity では秒単位のタイムスタンプもサポートされています。 |
| ユーザーの IP アドレス | | |
| 広告ネットワーク名 | | |
| ユーザーの ISO 3166-1 alpha 2 国コード | | |
| アプリのバージョン番号 | | |
| デバイスのモデル名 | | |
| デバイスの OS バージョン | | |
| ユーザーの ISO 639-1 言語コード | | |
| 表示される広告の種類。例: インタースティシャル、リワード、プレイアブル、バナー | | このパラメーターは
|
| |
|
|
| トラッキングサービスまたはモバイル計測パートナー (MMP) の名前 | | |
| アプリ名 | | |
| 広告主の名前 | | |
| アドインプレッションが発生したときのタイムスタンプ (Unix 形式) | | すべてのタイムスタンプに Unix 形式を使用してください。推奨されるベストプラクティスはミリ秒ですが、Unity では秒単位のタイムスタンプもサポートされています。 |
| 広告クリックが発生したときのタイムスタンプ (Unix 形式) | | すべてのタイムスタンプに Unix 形式を使用してください。推奨されるベストプラクティスはミリ秒ですが、Unity では秒単位のタイムスタンプもサポートされています。 |
| エンドユーザーからの実際のイベントとしてカウントされない、サーバーからのテストポストバック | |