ドキュメント

サポート

Unity Ads User Acquisition

キャンペーン

アトリビューション

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

Unity Ads User Acquisition

カスタム統合のポストバックリクエストに関するリファレンス

Unity Ads にサーバー間のポストバックリクエストを送信して、インストールとインストール後のイベントをレポートし、カスタム統合での正確なアトリビューションを実現します。
読み終わるまでの所要時間 4 分最終更新 5日前
カスタム統合のポストバックリクエストを正しく形式設定するために、以下のパラメーターを確認してください。

必須のアトリビューションポストバックパラメーター

カスタム統合の ポストバックリクエスト では、以下の識別パラメーターを引き渡す必要があります。

パラメーター

説明

例

ノート

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

必須のインストール後イベントポストバックのパラメーター

カスタム統合の ポストバックリクエスト では、以下の識別パラメーターを引き渡します。

パラメーター

説明

例

ノート

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
  • tracking_enabled=
  • tracking_limited=
ユーザーの追跡型広告制限が有効になっているかどうかを示すフラグ
  • tracking_enabled=1
  • tracking_limited=0
campaign_id=
Unity Ads キャンペーン識別子
campaign_id=546b9257365339e0031572bd
Campaign ID (キャンペーン ID) は、User Acquisition (ユーザー獲得) ダッシュボードの Campaigns (キャンペーン) ページから取得できます。
game_id=
Unity Ads ゲーム ID
game_id=500009999
広告主の Game ID (ゲーム ID) は必ず User Acquisition (ユーザー獲得) ダッシュボード から取得してください。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 にアトリビュートされない) ことを示します。

任意のセカンダリポストバックパラメーター

インストール後のイベントに関する以下のパラメーターは、必須ではありません。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