ドキュメント

サポート

Unity Ads User Acquisition

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

Send server-to-server postback requests to Unity Ads to report installs and post-install events for accurate attribution in a custom integration.
読み終わるまでの所要時間 1 分最終更新 a day ago

カスタム統合を使用して、アプリのサーバーからポストバックを送信する際は、以下のパラメーターを確認して、リクエストを適切な形式にしてください。 カスタム統合の ポストバックリクエスト では、以下の識別パラメーターを引き渡す必要があります。

パラメーター

説明

ノート

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 にアトリビュートするインストールだけを送信するのではなく、すべてのインストールのイベントデータを送信する場合にのみ使用します。