ドキュメント

サポート

Unity Ads User Acquisition

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

Define attribution link parameters for Unity Ads campaigns by specifying values within your tracking URLs.
読み終わるまでの所要時間 3 分最終更新 a day ago

トラッキング 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。これは、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 デバイスに対してのみ使用できます。