Advertising DSPマクロ
マクロは、命令の短いコマンドまたは略記法で、通常は形式に従います ${MACRO_NAME}
. クリエイティブコードまたはクリックスルー URL に含まれるマクロは、広告サーバーが理解できる長いコード文字列に展開されます。 DSP広告サーバーは、広告が提供またはクリックされると、マクロを実行します。
広告サーバーマクロは、重要な情報をDSPまたはサードパーティの広告サーバーに渡すのに役立ちます。 マクロは、サードパーティとカスタムのクリエイティブコードまたはメタデータ(サードパーティのピクセルなど)のトラフィック指定時に最も一般的に使用されます。
マクロは、VAST タグ、URL、DSPまたはサードパーティのイベントピクセルなど、任意の場所に手動で挿入できます。 ただし、DSPクライアントとパートナーは広告タグの形式が異なるので、それに応じてタグ内の別の場所にマクロを挿入する必要があります。 新しいクライアントまたはパートナーと連携するたびに、DSPトラフィックの広告タグにマクロを挿入する場所に関するドキュメントをユーザーに問い合わせます。
一般的なトラッキングマクロ
必要に応じて、すべての広告およびタグタイプで一般的なトラッキングマクロを使用して、特定のデータを返します。
${TM_ACCOUNT_ID}
${TM_AD_ID}
${TM_AD_ID_NUM}
${TM_ADVERTISER_ID}
${TM_CAMPAIGN_ID}
${TM_CAMPAIGN_ID_NUM}
${TM_CLICK_URL}
${TM_CLICK_URL_URLENC}
${TM_FEED_ID}
${TM_FEED_ID_NUM}
${TM_MACRO_PLACEMENT_SITE_KEY
${TM_PLACEMENT_ID}
${TM_PLACEMENT_ID_NUM}
${TM_RANDOM}
${TM_SESSION_ID}
${TM_SITE_DOMAIN_URLENC}
${TM_SITE_NAME}
${TM_SITE_URL_URLENC}
${TM_SITE_ID_NUM}
${TM_TIMESTAMP}
${TM_VIDEO_DURATION}
モバイル固有のマクロ
${CS_PLATFORM_ID}
(ComScore) デバイスのオペレーティングシステムに対応するプラットフォーム ID。
ios
= Apple iOSandroid
= Google Androidwindows
= Windows Mobileblackberry
= Blackberryother
プラットフォームが上記のいずれでもない場合
${CS_DEVICE_MODEL}
${CS_IMPLEMENTATION_TYPE}
(ComScore) 広告が提供された環境:
a
=モバイルアプリケーションb
=モバイル web サイト
a
または b
)${NS_PLATFORM_ID}
(Nielsen) デバイスのオペレーティングシステムに対応するプラットフォーム ID。
ios
= Apple iOSandroid
= Google Androidwindows
= Windows Mobileblackberry
= Blackberryother
プラットフォームが上記のいずれでもない場合
${NS_DEVICE_GROUPING}
(Nielsen) 広告が閲覧されたデバイスのタイプ。
TAB
=タブレットPHN
=モバイルcomputer
=コンピュータ
${UOO}
(Nielsen) ユーザーが広告トラッキングをオプトアウトしたかどうかを示します。
1
(DNT フラグ= 1) =ユーザーが広告トラッキングをオプトアウトしました0
(DNT フラグ= 0) =ユーザーが広告トラッキングをオプトインした
0
または 1
)${TM_BUNDLE}
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
=同意
サードパーティのディスプレイ広告のマクロをクリックする
サードパーティの表示タグを使用して広告のクリックを正確に追跡するには、DSPにディスプレイクリックマクロが必要です。 必要なマクロのバージョンは 1 つだけです。関連するマクロは、タグの種類に応じて異なります。
${TM_CLICK_URL}
${TM_CLICK_URL_URLENC}
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 つ以上の文字 ( 例:
${
. 完全な構文を含めない場合、エントリは有効なマクロとして認識されません。 - マクロは、次のような有効な文字セットで終わりません。
}
.