ドキュメント

サポート

Unity Ads User Acquisition

キャンペーン

アトリビューション

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

Unity Ads User Acquisition

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

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

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

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

パラメーター

説明

例

ノート

advertisingTrackingId
(iOS)		大文字の形式で表される広告識別子 (IDFA)。
1A2B3C4D-5E6F-7G8H-9I10-J9K8L7M65N4P
IDFA は、すべてのインストールに必須です。raw 形式またはハッシュされた形式の ID を使用できます。
advertisingTrackingIdMD5
(iOS)		ハッシュされた小文字の形式で表される広告識別子 (IDFA)。
fce1e02f2ca0498021ec67f2f22dfcea
IDFA は、すべてのインストールに必須です。raw 形式またはハッシュされた形式の ID を使用できます。
advertisingTrackingId
(Android)		小文字の形式で表される Google Advertising ID。
a1b2-c3d4-e5f6-g7h8
Advertising ID は、すべてのインストールに必須です。raw 形式またはハッシュされた形式の ID を使用できます。
advertisingTrackingIdMD5
(Android)		MD5 ハッシュされた小文字の形式で表される Google Advertising ID。
6fbff11856d5f0200d473af3cabd346d
Advertising ID は、すべてのインストールに必須です。raw 形式またはハッシュされた形式の ID を使用できます。
gamerId
追跡型広告制限 (LAT) がオンになっているユーザーをトラッキングするうえで必須となる一意の Unity Ads 識別子。
00000000-0000-0000-0000-000000000000
gamer_id
パラメーターの値は、トラッキングのために送信された開始、視聴、クリックから取得されます。
gamerID
の形式が適切でない場合、レスポンスコード 400: 
Malformed or missing input data
の 
malformed
エラーが表示されます。
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)		小文字の形式で表される Google 広告 ID の MD5 ハッシュ
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 (キャンペーン) ページから取得できます。
gameId=
Unity Ads ゲーム ID
gameId=500009999
Game ID (ゲーム ID) は、User Acquisition ダッシュボードの Apps (アプリ) ページから取得できます。
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 (設定) タブから取得できます。
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
推奨されるベストプラクティスは、通貨に米ドルを使用することです。
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}
    を送信できます。
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
カスタム統合のポストバックリクエストに関するリファレンス • Unity Grow • Unity Docs