# カスタムインテグレーションのポストバックリクエストパラメーターリファレンス

> カスタムのサーバー間インテグレーション ポストバック要求のパラメーターを確認します。

カスタム統合のポストバックリクエストを正しく形式設定するために、以下のパラメーターを確認してください。

## 必須のアトリビューションポストバックパラメーター##required-attribution-postback-parameters

カスタム統合の [ポストバックリクエスト](/user-acquisition/data-sharing/custom-integration/custom-integration-attribution-links.md) では、以下の識別パラメーターを引き渡す必要があります。

| `advertisingTrackingId` (iOS)        | 大文字の形式で表される広告識別子 (IDFA)。                                                                                                         | `1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P` | IDFA は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。                                                                                                                                     |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `advertisingTrackingIdMD5` (iOS)     | ハッシュされた小文字の形式で表される広告識別子 (IDFA)。                                                                                                  | `fce1e02f2ca0498021ec67f2f22dfcea`     | IDFA は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。                                                                                                                                     |
| `advertisingTrackingId` (Android)    | 小文字の形式で表される Google [広告 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en)。                        | `a1b2-c3d4-e5f6-g7h8`                  | 広告 ID は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。                                                                                                                                    |
| `advertisingTrackingIdMD5` (Android) | MD5 でハッシュされた小文字の形式で表される Google [広告 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en)。            | `6fbff11856d5f0200d473af3cabd346d`     | 広告 ID は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。                                                                                                                                    |
| `gamerId`                            | 追跡型広告制限 (LAT) がオンになっているユーザーをトラッキングするうえで必須となる一意の Unity 識別子。                                                                       | `00000000-0000-0000-0000-000000000000` | `gamer_id` パラメーターの値は、トラッキングのために送信された開始、視聴、クリックから取得されます。`gamerID` の形式が正しくない場合、`malformed` エラーが表示され、応答コード 400: `Malformed or missing input data` となります。                                      |
| `installTimeEpoch`                   | エポック以降のインストール時間 (秒)。                                                                                                             | `1615973128`                           | このパラメーターは一部のキャンペーン目標で必須です。                                                                                                                                                                 |
| `rawAndroidId`                       | 元の小文字の形式で表される [Android ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#a-n-d-r-o-i-d_-i-d)。    | `3f4a92b6c1d8e90f`                     | `rawAndroidID` パラメーターは、Android デバイスに Google Play Services が正しく統合され、Google Play がインストールされている場合は不要であるため、非推奨です。ただし、Google Advertising ID を持たないすべての Android インストールでは必須です。                      |
| `androidId`                          | [Android ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#a-n-d-r-o-i-d_-i-d) (MD5 でハッシュされた形式)。 | `4a969d593d2a3e1d602fefe8e75a4d80`     | これは、Android デバイスに Google Play Services が正しく統合され、Google Play がインストールされている場合は不要であるため、非推奨です。ただし、Google Advertising ID を持たないすべての Android インストールでは必須です。                                         |
| `attributed`                         | このインストールが Unity にアトリビュートしていて、課金対象になるかどうかを示すフラグ。                                                                                  | * `attributed=1`
* `attributed=0`      | デフォルト値 (`attributed=1`) は、条件が true であることを示します。この条件が false (`attributed=0`) の場合、インストールはアトリビュートせず、課金対象になりません。このパラメーターは、Unity にアトリビュートするインストールだけを送信するのではなく、すべてのインストールのイベントデータを送信する場合にのみ使用します。 |

## 必須のインストール後イベントポストバックのパラメーター##required-post-install-event-postback-parameters

カスタム統合の [ポストバックリクエスト](/user-acquisition/data-sharing/custom-integration/custom-integration-secondary-postbacks.md) では、以下の識別パラメーターを引き渡します。

| `gamer_id=`                                                       | インストールしているユーザーを表す Unity の一意のゲーム ID                                                                                    | `gamer_id=00000000-0000-0000-0000-000000000000`                                     |                                                                                                                                                                                                 |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| * `ifa=` (iOS)
* `idfa=`                                          | 大文字の形式で表されるデバイスの Apple 広告 ID (IDFA)。                                                                                  | `ifa=1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P`                                          | IDFA は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。                                                                                                                                          |
| `aid=` (Android)                                                  | 小文字の形式で表される Google Play [広告 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en)         | `aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9`                                          |                                                                                                                                                                                                 |
| `android_id_md5=` (Android)                                       | 小文字の形式で表される MD5 でハッシュされた Google [広告 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) | `android_id_md5=6fbff11856d5f0200d473af3cabd346d`                                   |                                                                                                                                                                                                 |
| - `tracking_enabled=`
- `tracking_limited=`                       | ユーザーの追跡型広告制限が有効になっているかどうかを示すフラグ                                                                                       | * `tracking_enabled=1`
* `tracking_limited=0`                                       |                                                                                                                                                                                                 |
| `campaign_id=`                                                    | Unity キャンペーン識別子                                                                                                       | `campaign_id=546b9257365339e0031572bd`                                              | **Campaign ID** (キャンペーン ID) は、User Acquisition (ユーザー獲得) ダッシュボードの **Campaigns** (キャンペーン) ページから取得できます。                                                                                            |
| `game_id=`                                                        | Unity [ゲーム ID](/user-acquisition/getting-started/locate-advertiser-credentials.md#game-id)                            | `game_id=500009999`                                                                 | 広告主の **Game ID** (ゲーム ID) は必ず [User Acquisition (ユーザー獲得) ダッシュボード](https://cloud.unity.com/acquire) から取得してください。Monetization (収益化) ダッシュボードの SDK 統合で使用するパブリッシャーの **Game ID** (ゲーム ID) は使用しないでください。 |
| `platform={ios or android}&store_id={itunes id or googleplay id}` | プラットフォーム + ストア ID                                                                                                     | - `platform=ios&store_id=123456789`
- `platform=android&store_id=com.example.store` | iOS には以下の値を使用できます。- `ios`
- `itunes`
- `iOS`
- `iTunes`                                                                                                                                         |
| `platform={ios or android}&bundle_id={bundle id}`                 | プラットフォーム + バンドル ID                                                                                                    | `platform=ios&bundle_id=com.example.myapp`                                          | Android には以下の値を使用できます。- `android`
- `google`
- `Android`
- `Google`
- `gplay`
- `GooglePlay`                                                                                                    |
| `platform={ios or android}&project_id={Unity Project ID}`         | プラットフォーム + Unity プロジェクト ID                                                                                            | `platform=android&project_id=2ff453g1-8d49-2p06-n22f-9m833592113f2`                 | **Project ID** (プロジェクト ID) は、Unity Dashboard の任意の **Projects** (プロジェクト) の **Settings** (設定) タブから取得できます。                                                                                         |
| `install_ts={unix time in seconds or milliseconds}`               | Unix 形式で表される元のインストールのタイムスタンプ                                                                                          | `install_ts=1466637800175`                                                          | 推奨されるベストプラクティスは、タイムスタンプにミリ秒を使用することです。                                                                                                                                                           |
| `event=session`                                                   | ユーザーがゲームプレイセッションを開始したことを示すセッションイベントフラグ                                                                                | `event=session`                                                                     |                                                                                                                                                                                                 |
| `event=purchase&value{amount}&currency={currency}`                | ユーザーがアプリ内課金を完了したこと + トランザクション額を示す購入イベントフラグ                                                                            | `event=purchase&value=1.0&currency=USD`                                             | 推奨されるベストプラクティスは、通貨に USD を使用することです。                                                                                                                                                              |
| `event=ad_revenue&value{amount}&currency={currency}`              | ユーザーに広告収益が発生したこと + 収益額を示す広告収益イベントフラグ                                                                                  | * `event=ad_revenue&value=1.23&currency=EUR`
* `event=ad_revenue&revenue_usd=1.23`  | - 収益の値は、小数形式で表します。例えば `1.05` などです。
- 通貨に USD を使用する場合は、`revenue_usd={amount}` を `value{amount}&currency={currency}` の代わりに送信できます                                                                  |
| `was_conversion_attributed=`                                      | 元のインストールが Unity にアトリビュートされたかどうかを示すフラグ                                                                                 | `was_conversion_attributed=1`                                                       | * `1` を使用して、元のインストールが Unity にアトリビュートされたことを示します。
* `0` を使用して、元のインストールが非アトリビュートである (Unity にアトリビュートされない) ことを示します。                                                                                  |

## 任意のセカンダリポストバックパラメーター##optional-secondary-postback-parameters

インストール後のイベントに関する以下のパラメーターは、必須ではありません。GET リクエストでこれらのパラメーターを使用して、アプリのインストール後イベントに関する追加情報を取得します。

| `ts=`               | Unix 形式で表されるインストール後イベントのタイムスタンプ                            | `ts=1466637800123`                                                                                                                                                                                           | すべてのタイムスタンプに Unix の形式を使用してください。推奨ベストプラクティスはミリ秒ですが、Unity では秒単位のタイムスタンプもサポートされています。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ip=`               | ユーザーの IP アドレス                                              | `ip=123.456.78.90`                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `ad_network=`       | 広告ネットワーク名                                                  | `ad_network=UnityAds`                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `country=`          | ユーザーの ISO 3166-1 alpha 2 国コード                              | `country=US`                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `app_version=`      | アプリのバージョン番号                                                | `app_version=1.2.3`                                                                                                                                                                                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `device_type=`      | デバイスのモデル名                                                  | `device_type=iPhone6,2 device_type=samsung+GT-S7582`                                                                                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `os_version=`       | デバイスの OS バージョン                                             | `os_version=14.4.2`                                                                                                                                                                                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `language=`         | ユーザーの ISO 639-1 言語コード                                      | `language=en_US`                                                                                                                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `ad_format=`        | 表示される広告の種類。例: インタースティシャル、リワード、プレイアブル、バナー                   | `ad_format=interstitial`                                                                                                                                                                                     | このパラメーターは `ad_revenue` イベントにのみ関連し、表示される広告のフォーマットを示します。以下は最も一般的な広告フォーマットの例です。- `interstitial`
- `rewarded`
- `playable`
- `video banner`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `event=`            | `session`、`purchase`、または `ad_revenue` 以外のインストール後イベントのイベント名 | * `event=ad_view`
* `event=registration`
* `event=spent_credits`
* `event=invite`
* `event=share`
* `event=level_complete`
* `event=tutorial_complete`
* `event=achievement_unlocked`
* `event=custom_event` | `event={event name}` で、以下のサポートされるイベント名のうちのいずれかを使用します。* `registration`:ユーザーがアプリに登録した。
* `spent_credits`:ユーザーがゲーム内アイテムを購入するためにゲーム内通貨を支払った。オプションで以下の `spent_credits` パラメーターも指定できます。
  * `value={how many credits}`
  * `type={what type credits}`
* `invite`:ユーザーがゲームに友達を招待した。
* `share`:ユーザーが友達とゲームを共有した。
* `level_complete`:ユーザーがレベルを完了した。オプションで次の `level complete` パラメーターも指定できます。
  * `value={level name}`
* `tutorial_complete`:ユーザーがチュートリアルを完了した。
* `achievement_unlocked`:ユーザーが実績を解除した。
* `custom`:カスタムイベントが発生した。オプションで次の `custom` イベントパラメーターも指定できます。
  * `custom_event={custom_event_name}`
  * `value={value}&type={type}` |
| `tracking_partner=` | トラッキングサービスまたはモバイル計測パートナー (MMP) の名前                         | `tracking_partner=AppsFlyer`                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `app_name=`         | アプリ名                                                       | `app_name=Game+Name`                                                                                                                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `advertiser_name=`  | 広告主の名前                                                     | `advertiser_name=Advertiser+Name+In+Here`                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `impression_ts=`    | アドインプレッションが発生したときのタイムスタンプ (Unix 形式)                        | `impression_ts=1466637800123`                                                                                                                                                                                | すべてのタイムスタンプに Unix 形式を使用してください。推奨されるベストプラクティスはミリ秒ですが、Unity では秒単位のタイムスタンプもサポートされています。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `click_ts=`         | 広告クリックが発生したときのタイムスタンプ (Unix 形式)                            | `click_ts=1466637800456`                                                                                                                                                                                     | すべてのタイムスタンプに Unix 形式を使用してください。推奨されるベストプラクティスはミリ秒ですが、Unity では秒単位のタイムスタンプもサポートされています。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `test=`             | エンドユーザーからの実際のイベントとしてカウントされない、サーバーからのテストポストバック              | `test=1`                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
