ドキュメント

サポート

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

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

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

前提条件

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

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

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ゲーム 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 とすべてのリダイレクトでは、HTTPS を使用します。
  • {ifa}
    動的カスタムトークンを使用します。サポートされているトークンを確認するには、動的カスタムトークン に関するリファレンスを参照してください。
  • HTTP 3XX リダイレクトコードを使用します。HTML や JavaScript のリダイレクトは使用しません。
  • URL が Apple App Store または Google Play ストアにリダイレクトしないようにします。
トラッキング URL を保存するときに、ダッシュボードでエラーチェックが行われ、その URL の構文が正しいことが検証されます。