ドキュメント

サポート

Unity Ads User Acquisition

キャンペーン

アトリビューション

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

Unity Ads User Acquisition

カスタム統合によるセカンダリポストバックの送信

カスタムのサーバー間ポストバックを使用して、各アプリイベントに必要なユーザー、キャンペーン、ゲーム、イベント、アトリビューションパラメーターを含むリクエストを作成し、インストール後のイベントデータを Unity Ads に送信します。
読み終わるまでの所要時間 3 分最終更新 5日前
カスタムのサーバー間統合を使用して Unity に インストール後イベントデータ を送信するには、サーバーリクエストを使用してポストバックを生成します。サーバーから取得できるポストバックの例については、この記事を参照してください。

ベース URL

以下のベース URL を使用して、インストール後のイベントのポストバックを Unity に送信します: 
https://ads-secondary-conversion.unityads.unity3d.com/v1/events

必須イベントパラメーター

イベントクエリに以下のコンポーネントを追加して、インストール後のイベントデータを Unity に渡します。

ユーザー ID

セカンダリポストバック URL には以下のユーザー識別パラメーターを加える必要があります。

パラメーター

説明

例

ノート

gamer_id=
インストールしているユーザーを表す Unity Ads の一意のゲーム 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
aid=ae06df78-ca5a-46c3-bd44-1d3b6aa4d6e9
android_id_md5
(Android)		小文字の形式で表される MD5 でハッシュされた Google 広告 ID
android_id_md5=6fbff11856d5f0200d473af3cabd346d

広告トラッキングの設定

セカンダリポストバック URL には以下の広告トラッキングパラメーターを加える必要があります。

パラメーター

説明

例

ノート

  • tracking_enabled=
  • tracking_limited=
ユーザーの追跡型広告制限が有効になっているかどうかを示すフラグ
  • tracking_enabled=1
  • tracking_limited=0

キャンペーン ID

セカンダリポストバック URL には以下のキャンペーン識別パラメーターを必ず加える必要があります。

パラメーター

説明

例

ノート

campaign_id
Unity Ads キャンペーン識別子
546b9257365339e0031572bd
Campaign ID (キャンペーン ID) は、User Acquisition (ユーザー獲得) ダッシュボードの Campaigns (キャンペーン) ページから取得できます。

ゲーム ID

セカンダリポストバック URL には以下のゲーム識別パラメーターを加える必要があります。

基本ゲーム ID

URL に以下のゲーム ID パラメーターを加えます。

パラメーター

説明

例

ノート

game_id
Unity Ads 広告主の ゲーム ID
500009999
広告主の Game ID (ゲーム ID) は必ず User Acquisition (ユーザー獲得) ダッシュボード から取得してください。Monetization (収益化) ダッシュボードの SDK 統合で使用するパブリッシャーの Game ID (ゲーム ID) は使用しないでください。

プラットフォーム 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 には以下の値を使用できます。
  • 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 (設定) タブから取得できます。

インストールのタイムスタンプ

セカンダリポストバック URL には以下のタイムスタンプパラメーターを加える必要があります。

パラメーター

説明

例

ノート

install_ts={unix time in seconds or milliseconds}
Unix 形式で表される元のインストールのタイムスタンプ
install_ts=1466637800175
推奨されるベストプラクティスは、タイムスタンプにミリ秒を使用することです。

イベント ID

セカンダリポストバック URL に以下のイベントパラメーターのどれかを加えます。

パラメーター

説明

例

ノート

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}
    の代わりに送信できます

コンバージョンアトリビューション

セカンダリポストバック URL には以下のコンバージョンアトリビューションパラメーターを加える必要があります。

パラメーター

説明

例

ノート

was_conversion_attributed=
元のインストールが Unity にアトリビュートされたかどうかを示すフラグ
was_conversion_attributed=1
1
を使用して、元のインストールが Unity にアトリビュートされたことを示します。
0
を使用して、元のインストールが非アトリビュートである (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?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?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