# カスタムインテグレーションセカンダリポストバック > カスタムのサーバー間インテグレーションのセカンダリ ポストバックの形式とパラメーターを確認します。 カスタムのサーバー間統合を使用して Unity に [インストール後イベントデータ](/user-acquisition/data-sharing/post-install-event-data-sharing.md) を送信するには、サーバーリクエストを使用してポストバックを生成します。サーバーから取得できるポストバックの例については、この記事を参照してください。 ## ベース URL##base-url 以下のベース URL を使用して、インストール後のイベントのポストバックを Unity に送信します: ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events ``` ## 必須イベントパラメーター##required-event-parameters イベントクエリに以下のコンポーネントを追加して、インストール後のイベントデータを Unity に渡します。 ### ユーザー ID##user-identification セカンダリポストバック URL には以下のユーザー識別パラメーターを加える必要があります。 | `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` | | ### 広告トラッキングの設定##ad-tracking-setting セカンダリポストバック URL には以下の広告トラッキングパラメーターを加える必要があります。 | * `tracking_enabled=` * `tracking_limited=` | ユーザーの追跡型広告制限が有効になっているかどうかを示すフラグ | - `tracking_enabled=1` - `tracking_limited=0` | | | ------------------------------------------- | ------------------------------- | --------------------------------------------- | - | ### キャンペーン ID##campaign-identification セカンダリポストバック URL には以下のキャンペーン識別パラメーターを必ず加える必要があります。 | `campaign_id` | Unity キャンペーン識別子 | `546b9257365339e0031572bd` | **Campaign ID** (キャンペーン ID) は、User Acquisition (ユーザー獲得) ダッシュボードの **Campaigns** (キャンペーン) ページから取得できます。 | | ------------- | --------------- | -------------------------- | ---------------------------------------------------------------------------------------------------- | ### ゲーム ID##game-identification セカンダリポストバック URL には以下のゲーム識別パラメーターを加える必要があります。 #### 基本ゲーム ID##base-game-identification URL に以下のゲーム ID パラメーターを加えます。 | `game_id` | Unity 広告主 [ゲーム ID](/user-acquisition/getting-started/locate-advertiser-credentials.md#game-id) | `500009999` | 広告主の **Game ID** (ゲーム ID) は必ず [User Acquisition (ユーザー獲得) ダッシュボード](https://cloud.unity.com/acquire) から取得してください。Monetization (収益化) ダッシュボードの SDK 統合で使用するパブリッシャーの **Game ID** (ゲーム ID) は使用しないでください。 | | --------- | ---------------------------------------------------------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | #### プラットフォーム ID##platform-identification 以下のプラットフォームパラメーターのどれかとゲーム ID を URL に加えます。 | `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-timestamp セカンダリポストバック URL には以下のタイムスタンプパラメーターを加える必要があります。 | `install_ts={unix time in seconds or milliseconds}` | Unix 形式で表される元のインストールのタイムスタンプ | `install_ts=1466637800175` | 推奨されるベストプラクティスは、タイムスタンプにミリ秒を使用することです。 | | --------------------------------------------------- | ---------------------------- | -------------------------- | ------------------------------------- | ### イベント ID##event-identification セカンダリポストバック URL に以下のイベントパラメーターのどれかを加えます。 | `event=session` | ユーザーがゲームプレイセッションを開始したことを示すセッションイベントフラグ | `event=session` | | | ---------------------------------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `event=purchase&value{amount}¤cy={currency}` | ユーザーがアプリ内課金を完了したこと + トランザクション額を示す購入イベントフラグ | `event=purchase&value=1.0¤cy=USD` | 推奨されるベストプラクティスは、通貨に USD を使用することです。 | | `event=ad_revenue&value{amount}¤cy={currency}` | ユーザーに広告収益が発生したこと + 収益額を示す広告収益イベントフラグ | * `event=ad_revenue&value=1.23¤cy=EUR` * `event=ad_revenue&revenue_usd=1.23` | - 収益の値は、小数形式で表します。例えば `1.05` などです。 - 通貨に USD を使用する場合は、`revenue_usd={amount}` を `value{amount}¤cy={currency}` の代わりに送信できます | ### コンバージョンアトリビューション##conversion-attribution セカンダリポストバック URL には以下のコンバージョンアトリビューションパラメーターを加える必要があります。 | `was_conversion_attributed=` | 元のインストールが Unity にアトリビュートされたかどうかを示すフラグ | `was_conversion_attributed=1` | `1` を使用して、元のインストールが Unity にアトリビュートされたことを示します。`0` を使用して、元のインストールが非アトリビュートである (Unity にアトリビュートされない) ことを示します。 | | ---------------------------- | ------------------------------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------- | ## サンプルクエリ##example-queries Unity にインストール後のイベントデータを送信するには、以下のセカンダリポストバック文字列の例を参照してください。 ### セッションイベント##session-event セッションイベントデータを渡すためのポストバック文字列の例として、以下を参照してください。 1. **iOS** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` 2. **Android** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=session&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` ### 購入イベント##purchase-event 購入イベントデータを渡すためのポストバック文字列の例として、以下を参照してください。 1. **iOS** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` 2. **Android** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=purchase&value=1.0&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` ### 広告収益イベント##ad-revenue-event 広告収益データを渡すためのポストバック文字列の例として、以下を参照にしてください。 1. **iOS** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?ifa=AE06DF78-CA5A-46C3-BD44-1D3B6AA4D6E9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=ios&store_id=123456789&event=ad_revenue&revenue_usd=1.23&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ``` 2. **Android** ```http https://ads-secondary-conversion.unityads.unity3d.com/v1/events?aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9&tracking_enabled=1&campaign_id=546b9257365339e0031572bd&game_id=500009999&platform=android&store_id=com.example.store&event=ad_revenue&value=1.23&currency=USD&ts=1466637860812&install_ts=1466637800175&was_conversion_attributed=1&gamer_id=88b48a1c94822c47b3458da3dd7aa42e9d0138a9d7036f05986fe9f763784d6887a215b69a83ca45e7b007399db6ccef20fe910b3758dd23d1cb318029d636e76428b0296d3f046f098eea964a4a711a1ce9559bcd159de21182d9f3 ```