ドキュメント

サポート

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

サーバーから Unity Ads にトラッキング URL を送信してユーザーインタラクションを追跡し、MMP なしのカスタムインストールアトリビューションをサポートします。
読み終わるまでの所要時間 1 分最終更新 5日前

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

前提条件

Unity にインストールデータを送信するには、1 つ以上のアプリを Unity Ads の User Acquisition (ユーザー獲得) ダッシュボード追加 する必要があります。 Unity にインストールポストバックを送信するには、以下の HTTP GET リクエストを使用します。必須パラメーターを確実に設定するために、カスタム統合のポストバックリクエストに関するリファレンス の表を参照してください。

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 ポストバックを送信するには、以下のポストバックリクエスト 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
必須StringUnity Ads 広告主の ゲーム ID広告主の Game ID (ゲーム ID) は必ず User Acquisition (ユーザー獲得) ダッシュボード から取得してください。Monetization (収益化) ダッシュボードの SDK 統合で使用するパブリッシャーの Game ID (ゲーム ID) は使用しないでください。
GAMER_ID
任意String追跡型広告制限 (LAT) がオンになっているユーザーをトラッキングするうえで必須となる一意の Unity Ads 識別子。トラッキングのために送信された、開始、視聴、クリックの
gamer_id
パラメーター値を確認できます。
GAMER_ID
パラメーターはインストールを正常にアトリビュートするために必須です。非アトリビュートインストールの場合、このパラメーターは任意です。
ATTRIBUTED
任意整数 (
0
または
1
)
このインストールが Unity Ads にアトリビュートしていて、課金対象になるかどうかを示すフラグ。デフォルト値 (
attributed=1
) は、条件が true であることを示します。この条件が false の場合 (
attributed=0
)、インストールはアトリビュートされず、課金対象になりません。

URL フォーマット

適切にトラッキングを機能させるためには、以下の要件に従ってリンクを形式設定してください。
  • URL とすべてのリダイレクトでは、HTTPS を使用します。
  • {ifa}
    動的カスタムトークンを使用します。サポートされているトークンを確認するには、動的カスタムトークン に関するリファレンスを参照してください。
  • HTTP 3XX リダイレクトコードを使用します。HTML や JavaScript のリダイレクトは使用しません。
  • URL が Apple App Store または Google Play ストアにリダイレクトしないようにします。
トラッキング URL を保存するときに、ダッシュボードでエラーチェックが行われ、その URL の構文が正しいことが検証されます。