カスタム統合でのトラッキング URL の送信

読み取り時間 1 分

カスタムのサーバー間統合を使用して Unity にインストールデータを送信するには、サーバーリクエストを使用してトラッキング URL を生成します。トラッキング URL を Unity に送信するために使用できる GET リクエストについては、この記事を参照してください。

前提条件
前提条件

Unity にインストールデータを送信するには、1 つ以上のアプリを Unity Ads の User Acquisition (ユーザー獲得) ダッシュボード に 追加 する必要があります。

ポストバック送信 URL のリクエスト
ポストバック送信 URL のリクエスト

Unity にインストールポストバックを送信するには、以下の HTTP GET リクエストを使用します。必須パラメーターを確実に設定するために、カスタム統合のポストバックリクエストに関するリファレンス の表を参照してください。

iOS
iOS

iOS ポストバックを送信するには、以下のポストバックリクエスト URL を使用します。

https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_IDFA]&gamerId=[unity_gamer_id]&attributed=[attributed]

Android
Android

Android ポストバックを送信するには、以下のポストバックリクエスト URL を使用します。

https://postback.unityads.unity3d.com/games/[GAME_ID]/install?advertisingTrackingId=[YOUR_MACRO_FOR_GOOGLE_AD_ID]&gamerId=[GAMER_ID]&attributed=[ATTRIBUTED]

以下のポストバックパラメーターを確認して、Android ポストバックリクエストを適切な形式にしてください。

パラメーター名要件形式説明ノート
GAME_ID
必須String

Unity Ads ゲーム ID。

ゲーム ID は、User Acquisition ダッシュボード の選択したアプリの Campaigns (キャンペーン) ページ上部にあります。

GAMER_ID
任意String

追跡型広告制限 (LAT) がオンになっているユーザーをトラッキングするうえで必須となる一意の Unity Ads 識別子。

トラッキングのために送信された、開始、視聴、クリックの gamer_id パラメーター値を確認できます。

GAMER_ID パラメーターはインストールを正常にアトリビュートするには必須です。

非アトリビュートインストールの場合、このパラメーターは任意です。

ATTRIBUTED
任意

Integer (0 または 1)

このインストールが Unity Ads にアトリビュートしていて、課金対象になるかどうかを示すフラグ。

初期値 (attributed=1) は、この条件が true であることを示します。この条件が false (attributed=0) の場合、インストールはアトリビュートせず、課金対象になりません。

URL フォーマット
URL フォーマット

適切にトラッキングを機能させるためには、以下の要件に従った URL フォーマットにする必要があります。

  • URL とすべてのリダイレクトでは、HTTPS を使用します。
  • {ifa} 動的カスタムトークンを使用します。サポートされているトークンを確認するには、動的カスタムトークン に関するリファレンスを参照してください。
  • HTTP 3XX リダイレクトコードを使用します。HTML や JavaScript のリダイレクトは使用しません。
  • URL が Apple App Store または Google Play ストアにリダイレクトしないようにします。

トラッキング URL を保存するときに、ダッシュボードでエラーチェックが行われ、その URL の構文が正しいことが検証されます。