Advertising DSPマクロ

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

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

マクロは、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の乱数。
long
${TM_SESSION_ID}
広告タグの単一の取得に対応するセッションの 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 日の午前 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 エンコード済み)。
文字列
${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}
The iOS または Android app store バンドル 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 です(例: BN5lERiMYEdiAKAWXEND1HoSBE6CAFApAMgBkIDIgM0AgOJxAn)。qa)
  • 0 =同意なし
  • 1 =同意
dasybit または integer

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

サードパーティの表示タグを使用して広告のクリックを正確に追跡するには、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
9ff4800f-94be-45f0-a5bf-09d0d7e96baa