ドキュメント

サポート

Unity Ads User Acquisition

キャンペーン

アトリビューション

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

Unity Ads User Acquisition

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

カスタムのサーバー間ポストバックを使用して、各アプリイベントに必要なユーザー、キャンペーン、ゲーム、イベント、アトリビューションパラメーターを含むリクエストを作成し、インストール後のイベントデータを Unity Ads に送信します。
読み終わるまでの所要時間 3 分最終更新 21日前
カスタムのサーバー間統合を使用して 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)		小文字の形式で表される Google 広告 ID の MD5 ハッシュ
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 ダッシュボードの Apps (アプリ) ページから取得できます。

プラットフォーム 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 の任意の プロジェクト の 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
推奨されるベストプラクティスは、通貨に米ドルを使用することです。
event=ad_revenue&value{amount}&currency={currency}
ユーザーに広告収益が発生したこと + 収益額を示す広告収益イベントフラグ
  • event=ad_revenue&value=1.23&currency=EUR
  • event=ad_revenue&revenue_usd=1.23
  • 収益の値は、小数で表します。例えば 
    1.05
    などです。
  • 通貨に米ドルを使用する場合は、
    value{amount}&currency={currency}
    の代わりに 
    revenue_usd={amount}
    を送信できます。

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

以下のコンバージョンアトリビューションパラメーターは、セカンダリポストバック 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