Advertising DSP マクロ

最終更新日： 2025年2月11日

作成対象：

  • ユーザー

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

広告サーバーマクロは、DSPまたはサードパーティの広告サーバーに重要な情報を渡す場合に役立ちます。 マクロは、サードパーティおよびカスタムクリエイティブコードやメタデータ（サードパーティのピクセルなど）のトラフィック処理時に最も一般的に使用されます。

マクロは、VAST タグ、URL、DSPまたはサードパーティのイベントピクセルなど、任意の場所に手動で挿入できます。 ただし、DSP クライアントとパートナーによって広告タグの形式が異なるので、それに応じてマクロをタグの異なる場所に挿入する必要があります。 新しいクライアントまたはパートナーと仕事をするたびに、DSP トラフィックを実行する広告タグにマクロを挿入する場所に関するドキュメントを求めます。

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

必要に応じて、すべての広告タイプおよびタグタイプで一般的なトラッキングマクロを使用して、特定のデータを返します。

マクロ置き換えの説明タイプ
${TM_ACCOUNT_ID}アカウント ID。整数
${TM_AD_ID}広告キー（adKey）。string
${TM_AD_ID_NUM}広告 ID。整数
${TM_ADVERTISER_ID}広告主 ID。整数
${TM_CAMPAIGN_ID}キャンペーンキーstring
${TM_CAMPAIGN_ID_NUM}キャンペーン ID。整数
${TM_CLICK_URL}リダイレクト URL は、広告サーバーが広告クリックを追跡およびカウントできるようにします。 広告が配信されると、ユーザーがクリックすると、マクロがアクティブ化され、クリックが記録され、レポート目的でカウントされます。string
${TM_CLICK_URL_URLENC}エンコードされたリダイレクト URL により、広告サーバーは広告の追跡およびクリック数のカウントが可能になります。 広告が配信されると、ユーザーがクリックすると、マクロがアクティブ化され、クリックが記録され、レポート目的でカウントされます。 サードパーティの広告を作成し、ベンダーが URL エンコーディングを必要とする場合以外は、このマクロを使用しないでください。string
${TM_FEED_ID}メディアプレースメントのキー（feedKey）。string
${TM_FEED_ID_NUM}メディアプレースメントの ID。整数
${TM_MACRO_PLACEMENT_SITE_KEYプレースメントのサイトキー。 モバイルアプリインストール広告の AppsFlyer クリックトラッカーに必要です。string
${TM_PLACEMENT_ID}配置キー（cpKey）。string
${TM_PLACEMENT_ID_NUM}プレースメント ID。整数
${TM_RANDOM}Cachebuster: 1 から 1000000 の間の乱数。long
${TM_SESSION_ID}セッションの ID。広告タグの 1 回の取得に対応します。string
${TM_SITE_DOMAIN_URLENC}入札要求内の URL から解析されるページサブドメイン。URL はエンコードされます。 バナー内、クリックして再生する広告には対応していません。string
${TM_SITE_NAME}プレースメントのサイト名。string
${TM_SITE_URL_URLENC}入札要求で渡される URL。URL はエンコードされます。 バナー内、クリックして再生する広告には対応していません。string
${TM_SITE_ID_NUM}プレースメントのサイト ID。整数
${TM_TIMESTAMP}1970 年 1 月 1 日の午前 0 時（00:00 UTC）からの経過秒数を示す Unix タイムスタンプ。long
${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 エンコード）。string
${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 行
string
${NS_DEVICE_GROUPING}

（Nielsen）広告が閲覧者だったデバイスの種類：

  • TAB = タブレット
  • PHN = モバイル
  • computer = コンピュータ
string
${UOO}

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

  • 1 （DNT flag = 1） = ユーザーは広告トラッキングをオプトアウトしました
  • 0 （DNT flag = 0） = ユーザーが広告トラッキングをオプトインしました
整数（0 または 1）
${TM_BUNDLE}iOS または Android App Store バンドル ID。 例：com.zynga.wwf2.free または id804379658string
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 =同意
デイジー・ビットまたは整数