Advertising DSP マクロ

最終更新日： 2026年4月3日

トピック：
DSP Ads

作成対象：

User

マクロは、命令の短いコマンドまたは略語であり、通常は${MACRO_NAME}形式に従います。クリエイティブコードまたはクリックスルーURLに含まれるマクロは、広告サーバーが理解できる長いコード文字列に展開されます。 DSP広告サーバーは、広告が配信またはクリックされたときにマクロを実行します。

Ad server マクロは、重要な情報をDSPまたはサードパーティのAd サーバーに渡すのに便利です。マクロは、サードパーティおよびカスタムのクリエイティブコードまたはメタデータ（サードパーティピクセルなど）の不正取引で最も一般的に使用されます。

VAST タグ、任意のURL、DSPまたはサードパーティのイベントピクセルなど、任意の場所にマクロを手動で挿入できます。ただし、DSPのクライアントとパートナーはそれぞれ異なる広告タグフォーマットを持っており、それに応じてマクロをタグ内の異なる場所に挿入する必要があります。新しいクライアントやパートナーと作業するたびに、DSPが送信する広告タグにマクロをどこに挿入するかについてドキュメントを求めます。

一般的なトラッキングマクロ

必要に応じて、あらゆる広告タイプとタグタイプで一般的なトラッキングマクロを使用し、特定のデータを渡します。

マクロ

置き換え説明

タイプ

${TM_ACCOUNT_ID}

アカウント ID。

整数

${TM_AD_ID}

広告キー（adKey）。

文字列

${TM_AD_ID_NUM}

広告ID。

整数

${TM_ADVERTISER_ID}

広告主ID。

整数

${TM_CAMPAIGN_ID}

キャンペーンキー。

文字列

${TM_CAMPAIGN_ID_NUM}

キャンペーン ID。

整数

${TM_CLICK_URL}

広告サーバーが広告クリックを追跡およびカウントできるようにするリダイレクト URL。広告が配信されると、ユーザーがクリックすると、マクロがアクティブになり、クリックはレポート用に記録され、カウントされます。

文字列

${TM_CLICK_URL_URLENC}

エンコードされたリダイレクト URL。広告サーバーは広告クリックを追跡およびカウントできます。広告が配信されると、ユーザーがクリックすると、マクロがアクティブになり、クリックはレポート用に記録され、カウントされます。サードパーティ広告を作成し、ベンダーがURL エンコーディングを必要とする場合を除き、このマクロを使用しないでください。

文字列

${TM_FEED_ID}

メディア配置のキー（feedKey）。

文字列

${TM_FEED_ID_NUM}

メディア配置のID。

整数

${TM_MACRO_PLACEMENT_SITE_KEY

プレースメントのサイトキー。モバイルアプリのインストール広告のAppsFlyer クリックトラッカーに必要です。

文字列

${TM_PLACEMENT_ID}

配置キー（cpKey）。

文字列

${TM_PLACEMENT_ID_NUM}

プレースメント ID。

整数

${TM_RANDOM}

Cachebuster: 1 ～ 1000000の間の乱数。

長い

${TM_SESSION_ID}

広告タグの1回の取得に対応するセッションのID。

文字列

${TM_SITE_DOMAIN_URLENC}

入札リクエストのURLから解析されたページサブドメイン。URLがエンコードされています。バナー内でクリックして再生する広告ではサポートされていません。

文字列

${TM_SITE_NAME}

プレースメントのサイト名。

文字列

${TM_SITE_URL_URLENC}

入札リクエストで渡されたURL。URL エンコードです。バナー内でクリックして再生する広告ではサポートされていません。

文字列

${TM_SITE_ID_NUM}

プレースメントのサイト ID。

整数

${TM_TIMESTAMP}

1970年1月1日の深夜（00:00 UTC）からの経過秒数を示すUnix タイムスタンプ。

長い

${TM_VIDEO_DURATION}

広告動画のデュレーション（秒単位）。

整数

モバイル固有のマクロ

マクロ

置き換え説明

タイプ

${CS_PLATFORM_ID}

（ComScore）デバイスのオペレーティングシステムに対応するプラットフォーム ID:

ios = Apple iOS
android = Google Android
windows = Windows Mobile
blackberry = Blackberry
other プラットフォームが上記のいずれでもない場合

varchar （50）

${CS_DEVICE_MODEL}

（ComScore）デバイスモデル名は、URL エンコードされています。

文字列

${CS_IMPLEMENTATION_TYPE}

（ComScore）広告が配信された環境：

a = モバイルアプリケーション
b = モバイル web サイト

文字列（aまたはb）

${NS_PLATFORM_ID}

（Nielsen）デバイスのオペレーティングシステムに対応するプラットフォーム ID:

ios= Apple iOS
android = Google Android
windows = Windows Mobile
blackberry = Blackberry
other プラットフォームが上記のいずれでもない場合

文字列

${NS_DEVICE_GROUPING}

（Nielsen）広告がビューアーだったデバイスの種類：

TAB = タブレット
PHN = モバイル
computer = コンピューター

文字列

${UOO}

（Nielsen）ユーザーが広告トラッキングをオプトアウトしたかどうかを示します：

1 （DNT フラグ = 1） = ユーザーは広告トラッキングをオプトアウトしました
0 （DNT フラグ = 0） = ユーザーが広告トラッキングにオプトインしました

整数（0または1）

${TM_BUNDLE}

iOSまたはAndroid アプリストアバンドル ID。例：com.zynga.wwf2.freeまたはid804379658

文字列

gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}

gdpr=${GDPR_ENFORCED}は、入札者が入札依頼が欧州連合（EU）の出所によるものであると判断し、GDPRの適用を必要とするかどうかを示します。

1 = GDPRを適用する必要があります
0 = GDPRは適用できません

gdpr_consent=${GDPR_CONSENT}は、インバウンド入札要求でサプライパートナーから渡された同意値です。

ほとんどの場合、これはbase64url エンコードされた同意文字列、またはdaisybitです（例：BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA）
0 =同意なし
1 =同意

daisybitまたは整数

サードパーティのディスプレイ広告のクリックマクロ

サードパーティのディスプレイタグを使用して広告のクリックを正確に追跡するには、DSPにディスプレイクリックマクロが必要です。必要なマクロのバージョンは1つのみです。関連するマクロは、タグのタイプによって異なります。

マクロ

置き換え説明

タイプ

${TM_CLICK_URL}

広告サーバーがプラットフォームでの広告クリックを追跡およびカウントできるようにするリダイレクト URL。

文字列

${TM_CLICK_URL_URLENC}

URL エンコーディングを必要とする広告サーバーが、プラットフォームでの広告クリックを追跡およびカウントできるようにするリダイレクト URL。

文字列

DSPでは、次の操作を行うと、サードパーティの表示タグに表示クリックマクロが自動的に挿入されます。

広告サーバーパートナーからの広告タグのエクスポート
FlashtalkingまたはGoogle DoubleClick for Advertisers個の広告タグをDSPに直接アップロードできます

ディスプレイ広告の作成時にクリックマクロが見つからない場合、DSPに警告メッセージが表示され、タグの正しい領域に適切な表示クリックマクロを手動で挿入するように求められます。

Analytics for Advertising個のマクロ

Analytics for Advertisingのお客様向けに特別に使用できる追加のマクロについては、「追加 Analytics for Advertising マクロを Flashtalking 広告タグ」および「追加 Analytics for Advertising マクロを Google Campaign Manager 360 広告タグ」を参照してください。

マクロエラーのトラブルシューティング

コードにマクロを追加する場合は、必ずマクロの正確な構文を使用してください。マクロを検証する際、DSPは、マクロが有効なマクロの1つと正確に一致することを確認します。

マクロ名の先頭または末尾に文字がない場合は、エラーが生成されます。例えば、次のような場合にエラーメッセージが表示されます。

マクロ名の先頭にある文字（${など）を1つ以上忘れた場合。完全な構文を含まない場合、エントリは有効なマクロとして認識されません。
マクロの末尾に}などの有効な文字セットが含まれていません。

recommendation-more-help

advertising-help-dsp