ドキュメント

ユーザー獲得

広告管理 API

広告統計 API

ユーザー獲得

トラッキングリンクパラメーターリファレンス

トラッキング URL 内に値を指定して、Unity ユーザー獲得キャンペーンのトラッキング URL パラメーターを定義します。
読み終わるまでの所要時間 13 分最終更新 9日前
トラッキング URL を使用して、エンゲージメントデータをアプリサーバーから Unity Ads のユーザー獲得キャンペーンに送信できます。トラッキング URL に関する以下の要件を参照してください。
トラッキング URL の取得方法については、ご希望のパートナーの パートナー統合 ドキュメントまたは カスタム統合 ドキュメントを参照してください。

URL 要件

トラッキング URL が以下の要件を満たしていることを確認してください。
  • URL とリダイレクトでは、HTTPS を使用します。
  • {ifa}
    動的カスタムトークンを使用します。詳細については、 動的カスタムトークン の表を参照してください。
  • HTTP 3XX リダイレクトコードを使用します。HTML や JavaScript のリダイレクトは使用しません。
  • URL が Apple App Store または Google Play ストアにリダイレクトしないようにします。
MMP が HTTPS をサポートしていない場合は、Unity にお問い合わせください。

動的カスタム 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。MD5 ハッシュ形式です。これは、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 キャンペーン ID。
12345678abcdefgh9012ijkl
{campaign_name}
Unity キャンペーン名。
my_ad_campaign
{game_id}
宣伝対象のゲームの Unity ゲーム ID。
1234567
{gamer_id}
追跡型広告制限（LAT）がオンになっているユーザーをトラッキングするために必須の一意の Unity 識別子。この場合、広告識別子の値は です 
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; Mac OS X のような CPU iPhone OS 9_3_5)
  • AppleWebKit/601.1.46
    (Gecko のような KHTML)
  • Mobile/13G36
    (iOS)
  • Mozilla/5.0
    (Linux、Android 6.0.1、SM-G920V Build/MMB29K)
  • AppleWebKit/537.36
    (Gecko のような KHTML)
  • 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}
デバイスターゲティング に基づく画面密度。(/user-acquisition/targeting/intro-to-campaign-targeting#device-targeting)
  • ldpi
  • mdpi
  • hdpi
  • xhdpi
  • xxhdpi
  • xxxhdpi
このフィールドは、Android デバイスに対してのみ使用できます。