トラッキング URL パラメーターに関するリファレンス

読み取り時間 3 分

トラッキング URL を使用して、エンゲージメントデータをアプリサーバーから Unity Ads のユーザー獲得キャンペーンに送信できます。トラッキング URL に関する以下の要件を参照してください。

トラッキング URL の取得方法については、ご希望のパートナーの パートナー統合 ドキュメントまたは カスタム統合 ドキュメントを参照してください。

URL 要件
URL 要件

トラッキング URL が以下の要件を満たしていることを確認してください。

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

MMP が HTTPS をサポートしていない場合は、Unity にお問い合わせください。

動的カスタム URL トークン
動的カスタム URL トークン

Unity では、トラッキング URL で以下の動的置換トークンをサポートしています。

トークン説明例ノート

{ifa} (iOS)

平文でオリジナルの大文字の形式で表される iOS の広告識別子 (IDFA)。
1234ABCD-1234-5678-ABCD-1A2B3C4D5E6F

{ifa} (Android)

オリジナルの小文字の形式で表される Google Advertising ID。これは将来、Android ID に代わって、Android における主要な識別手段となります。移行期間中は、両方の識別子を併用する必要があります。

1234abcd-1234-5678-abcd-1a2b3c4d5e6f

{ifa_md5} (iOS)

オリジナルの大文字の形式から MD5 ハッシュされた iOS の広告識別子 (IDFA)。
9dd6df49d764d6ada0b250a6376d7b44

{ifa_md5} (Android)

オリジナルの小文字の形式から MD5 ハッシュされた Google Advertising ID。

9a6a0a84bd8003a97a2109f6c4
{android_id_md5}

Android デバイスの MD5 ハッシュされた Android ID。これは、Google Advertising ID {ifa} が使用できない場合、例えば、Google Play Services が Android デバイスにインストールされていない場合などにのみ使用してください。

MD5 12345678ABCDEFGH = 5756ae9022b2ea1e47d84fead75220c8

{mmp}
モバイル計測パートナーの名前。
  • appsflyer
  • adjust
  • branch
  • tenjin
  • singular
{platform}
インストールが行われたプラットフォーム。
  • ios
  • android
{ip}
エンドユーザーの IP アドレス。
123.123.123.123
これは情報提供の目的でのみ提供されるもので、インストールトラッキングにおけるユーザー識別には適していません。
{organic}

インストールがオーガニックトラフィックにアトリビュートされるかどうかを示すフラグ。フラグの値については、以下を参照してください。

  • organic=1 はインストールが広告ネットワークや Unity Ads などで配信された広告にアトリビュートされていないことを示します。
  • organic=0 はインストールが広告ネットワークにアトリビュートされていることを示します。

  • organic=1 (true)
  • organic=0 (false)
{country_code}
ユーザーの ISO 3166-1 alpha-2 国コード (大文字)。
GB

GB は英国 (グレートブリテンおよび北アイルランド連合王国) を表します。

{campaign_id}
Unity Ads キャンペーン ID。
12345678abcdefgh9012ijkl
{campaign_name}
Unity Ads キャンペーン名。
my_ad_campaign
{game_id}
宣伝対象のゲームの Unity Ads の Game ID。
1234567
{gamer_id}

追跡型広告制限 (LAT) がオンになっているユーザーをトラッキングするうえで必須となる一意の Unity Ads 識別子。この場合、広告識別子の値は 00000000-0000-0000-0000-000000000000 になります。この場合に Gamer ID が見つからなかったときは、レスポンスコード 400 の malformed エラーを受信します。

Malformed または missing input data

{source_app_id}
広告を表示しているアプリのユニバーサルソース ID。これは、大文字と小文字が区別される英数字の文字列です。
9g74cAw7WM1L

2020 年 5 月の移行前は、これは source_game_id で表されていました。

{source_game_id}

このフィールドは 2020 年 5 月をもって非推奨になりました。
>
>{source_app_id} トークンが {source_game_id} の後継です。

7654321

{source_app_id} がこのトークンの後継です。

{os}
エンドユーザーのデバイスの OS。
  • 9.2.1 (iOS)
  • 4.4.0 (Android)
{device_type}
エンドユーザーのデバイスタイプ。
  • iPad4,1
  • motorola XT1254
  • samsung SM-G900F
{creative_pack}
広告で使用されているクリエイティブパックの名前。
Video Creatives Pack - EN - 15s
{creative_pack_id}
広告で使用されているクリエイティブパックの ID。
5beafbce74ed83001acb258c
{language}
エンドユーザーのデバイスの言語。
en-GB
{user_agent}
エンドユーザーのデバイスのユーザーエージェント。
  • Mozilla/5.0 (iPhone; CPU iPhone OS 9_3_5 like Mac OS X)
  • AppleWebKit/601.1.46 (KHTML, like Gecko)
  • Mobile/13G36 (iOS)
  • Mozilla/5.0 (Linux; Android 6.0.1; SM-G920V Build/MMB29K)
  • AppleWebKit/537.36 (KHTML, like Gecko)
  • Chrome/52.0.2743.98 Mobile Safari/537.36 (Android)
{device_make}
エンドユーザーのデバイスのメーカー。
  • Apple (iOS)
  • samsung (Android)
{device_model}
エンドユーザーのデバイスのモデル。
  • iPhone7,2 (iOS)
  • SM-G900F (Android)
{is_skadnetwork_supported}

SKAdNetwork のサポート状況。

true または空。

このフィールドは、iOS デバイスに対してのみ使用できます。
{video_orientation}
広告に表示されているクリエイティブの向き。
  • portrait
  • landscape
{screen_size}

デバイスターゲティング に基づく画面サイズ。

  • small
  • normal
  • large
  • xlarge
このフィールドは、Android デバイスに対してのみ使用できます。
{screen_density}

デバイスターゲティング に基づく画面密度。

  • ldpi
  • mdpi
  • hdpi
  • xhdpi
  • xxhdpi
  • xxxhdpi
このフィールドは、Android デバイスに対してのみ使用できます。