Advertising DSP マクロ

Last update: Fri May 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
DSP Ads

作成対象：

User

マクロは、命令の短いコマンドまたは略記法で、通常は形式に従います ${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 サイト

string （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 アプリストアのバンドル ID。例：com.zynga.wwf2.free または id804379658

string

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 =同意

デイジー・ビットまたは整数

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

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

マクロ

置き換えの説明

タイプ

${TM_CLICK_URL}

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

string

${TM_CLICK_URL_URLENC}

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

string

DSPは、次の場合に、表示クリックマクロをサードパーティの表示タグに自動的に挿入します。

広告サーバーパートナーからの広告タグの書き出し
バルクアップロード Flashtalking または Google DoubleClick for Advertisers 広告タグをDSPで直接配信

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

Analytics for Advertising マクロ

専用の追加マクロの場合 Analytics for Advertising のお客様は、「」を参照してくださいAppend Analytics for Advertising マクロ先 Flashtalking 広告タグ「」と「」に対して検査する値Append Analytics for Advertising マクロ先 Google Campaign Manager 360 広告タグ.」と入力します。

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

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

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

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

recommendation-more-help

9ff4800f-94be-45f0-a5bf-09d0d7e96baa