カスタム統合によるセカンダリポストバックの送信
カスタムのサーバー間ポストバックを使用して、各アプリイベントに必要なユーザー、キャンペーン、ゲーム、イベント、アトリビューションパラメーターを含むリクエストを作成し、インストール後のイベントデータを Unity Ads に送信します。
カスタムのサーバー間統合を使用して Unity に インストール後イベントデータ を送信するには、サーバーリクエストを使用してポストバックを生成します。サーバーから取得できるポストバックの例については、この記事を参照してください。
ベース URL
以下のベース URL を使用して、インストール後のイベントのポストバックを Unity に送信します:
https://ads-secondary-conversion.unityads.unity3d.com/v1/events
必須イベントパラメーター
イベントクエリに以下のコンポーネントを追加して、インストール後のイベントデータを Unity に渡します。
ユーザー ID
セカンダリポストバック URL には以下のユーザー識別パラメーターを加える必要があります。
パラメーター | 説明 | 例 | ノート | | インストールしているユーザーを表す Unity Ads の一意のゲーム ID | gamer_id=00000000-0000-0000-0000-000000000000
| |
| 大文字の形式で表されるデバイスの Apple 広告 ID (IDFA)。 | ifa=1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P
| IDFA は、すべてのインストールに必須です。Raw 形式またはハッシュされた形式の ID を使用できます。 |
| (Android) | 小文字の形式で表される Google Play 広告 ID | aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9
| |
| (Android) | 小文字の形式で表される MD5 でハッシュされた Google 広告 ID | android_id_md5=6fbff11856d5f0200d473af3cabd346d
| |
広告トラッキングの設定
セカンダリポストバック URL には以下の広告トラッキングパラメーターを加える必要があります。
パラメーター | 説明 | 例 | ノート | | ユーザーの追跡型広告制限が有効になっているかどうかを示すフラグ | | |
キャンペーン ID
セカンダリポストバック URL には以下のキャンペーン識別パラメーターを必ず加える必要があります。
パラメーター | 説明 | 例 | ノート | | Unity Ads キャンペーン識別子 | | Campaign ID (キャンペーン ID) は、User Acquisition (ユーザー獲得) ダッシュボードの Campaigns (キャンペーン) ページから取得できます。 |
ゲーム ID
セカンダリポストバック URL には以下のゲーム識別パラメーターを加える必要があります。
基本ゲーム ID
URL に以下のゲーム ID パラメーターを加えます。
以下のプラットフォームパラメーターのどれかとゲーム 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 には以下の値を使用できます。 |
platform={ios or android}&bundle_id={bundle id}
| プラットフォーム + バンドル ID | platform=ios&bundle_id=com.example.myapp
| Android には以下の値を使用できます。 |
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 (設定) タブから取得できます。 |
インストールのタイムスタンプ
セカンダリポストバック URL には以下のタイムスタンプパラメーターを加える必要があります。
パラメーター | 説明 | 例 | ノート | install_ts={unix time in seconds or milliseconds}
| Unix 形式で表される元のインストールのタイムスタンプ | | 推奨されるベストプラクティスは、タイムスタンプにミリ秒を使用することです。 |
イベント ID
セカンダリポストバック URL に以下のイベントパラメーターのどれかを加えます。
パラメーター | 説明 | 例 | ノート | | ユーザーがゲームプレイセッションを開始したことを示すセッションイベントフラグ | | |
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
|
- 収益の値は、小数形式で表します。例えば などです。
- 通貨に USD を使用する場合は、 を
value{amount}¤cy={currency}
|
コンバージョンアトリビューション
セカンダリポストバック URL には以下のコンバージョンアトリビューションパラメーターを加える必要があります。
パラメーター | 説明 | 例 | ノート | was_conversion_attributed=
| 元のインストールが Unity にアトリビュートされたかどうかを示すフラグ | was_conversion_attributed=1
| を使用して、元のインストールが Unity にアトリビュートされたことを示します。 を使用して、元のインストールが非アトリビュートである (Unity にアトリビュートされない) ことを示します。 |
サンプルクエリ
Unity にインストール後のイベントデータを送信するには、以下のセカンダリポストバック文字列の例を参照してください。
セッションイベント
セッションイベントデータを渡すためのポストバック文字列の例として、以下を参照してください。
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
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
購入イベント
購入イベントデータを渡すためのポストバック文字列の例として、以下を参照してください。
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
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
広告収益イベント
広告収益データを渡すためのポストバック文字列の例として、以下を参照にしてください。
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
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