Microsoft Monetize - サポートされているクリエイティブ マクロ

すべての人、モバイル、動画のインプレッションに使用できるクリエイティブ マクロがあります。 また、プライバシー マクロと関数マクロもサポートされています。

注:

クリエイティブ マクロは大文字と小文字が区別され、ピギーバック変換ピクセルには使用できません。

すべてのインプレッションに対応するクリエイティブ マクロ

すべてのインプレッションに使用できるマクロは以下のとおりです。

マクロ 説明
${CLICK_URL} クリック トラッキング URL。 例: https://xandr.com
${CLICK_URL_ENC} エンコードされたクリック トラッキング URL (一部のサードパーティ広告サーバーでのみ必要)。 例: https%3A%2F%2Fxandr.com

クリエイティブな第三者タグやランディング ページ URL では、次のマクロを使用できます。

マクロ 説明
${ADV_CODE} クリエイティブが属する広告主のコード。
${ADV_FREQ} すべての広告主キャンペーンでユーザーが表示したインプレッションの合計数。
${ADV_ID} クリエイティブが属する広告主の ID。
${AGE} ユーザーの年齢 (使用可能な場合)。 サポートされている値は、整数または 0 です。
${APPNEXUS_AUCTION_ID} このマクロは ${AUCTION_ID} のエイリアスであり、同じように動作します。
${AUCTION_ID} インプレッションにつながった特定のオークションの一意の 64 ビット識別子。 入札要求の各 placement_id には独自の一意のオークション ID があり、この ID はそのプレースメントの対応する入札応答とも一致します。
このマクロは、調整と不一致の追跡に推奨されます。
${BID_PRICE} 値下げ後に支払われた価格とは対照的に、このインプレッションに対する最初の価格の入札単価。
${BIDPRICE} このマクロは ${BID_PRICE} のエイリアスであり、同じように動作します。
${CACHEBUSTER} URL キャッシュを防ぐために、ランダムに生成される文字列。 この値は入札応答ごとに 1 回生成されるため、入札要求に複数の placement_id 値が含まれている場合は、それら全体で同じキャッシュバスター値が使用されます。
調整と不一致の追跡には、代わりに ${AUCTION_ID} を使用することをお勧めします。
${CP_CODE} 配信されたインプレッションのキャンペーン コード。
${CP_ID} 配信されたインプレッションのキャンペーン ID または分割 ID。
${CPG_CODE} 配信されたインプレッションの広告申込情報コード。
${CPG_ID} 配信されたインプレッションの広告申込情報 ID。
${CREATIVE_CODE} 提供されるクリエイティブのコード (利用可能な場合)。
${CREATIVE_HEIGHT} 提供されるクリエイティブの高さ。
${HEIGHT} これは ${CREATIVE_HEIGHT} のエイリアスであり、同じように動作します。
${CREATIVE_ID} インプレッションを獲得したクリエイティブ ID。
${CREATIVE_SIZE} クリエイティブの幅と高さ。 例: 300x250。
${CREATIVE_WIDTH} クリエイティブの幅。
${WIDTH} このマクロは ${CREATIVE_WIDTH} のエイリアスであり、同じように動作します。
${CUSTOM_MODEL_ID} オークションで使用されるカスタム モデルの id 。 カスタム モデルが使用されていない場合、このマクロは 0 を返します。

: このカスタム マクロは、APB アルファ テスト クライアントでのみ機能します。
${CUSTOM_MODEL_LAST_MODIFIED} オークションで使用されたカスタム モデルが最後に変更されてからの日付と時刻 (Unix エポック時間)。 モデルが使用されていない場合、このマクロは 0 を返します。

: このカスタム マクロは、APB アルファ テスト クライアントでのみ機能します。
${CUSTOM_MODEL_LEAF_NAME} 落札を決定したリーフで指定された leaf_name 。 名前が指定されていない場合、またはモデルが使用されていない場合、このマクロは --- を返します。 これは、ログ レベル データの [Standard フィード] の [leaf_name] フィールドに合わせて配置されます。 詳細については、「Standard Feed」を参照してください。

: このカスタム マクロは、APB アルファ テスト クライアントでのみ機能します。
${DATACENTER} データセンター ID (1 = NYM、2 = LAX、3 = AMS、4 = FRA、5 = SIN)。
${DEAL_ID} 落札に関連付けられている Microsoft Advertising 取引 ID(該当する場合)。 取引がない場合、このマクロは 0 を返します。
${ECP} パブリッシャー側のオークションの見積もりクリア価格 (ECP)。
${EXTENDED_IDS} 売り手によって渡されたユニバーサル ID 値。買い手は表示権限を持っています。
${GENDER} ユーザーの性別 (使用可能な場合)。 次の値を指定できます。
- f (female)
- m (male)
- u (不明)
${INV_SOURCE_ID} 非推奨
${IO_CODE} 配信されたインプレッションの広告掲載オーダー コード。
${IO_ID} 配信されたインプレッションの広告掲載オーダーの ID。
${OZONE_ID} 非推奨
${PMT_RULE_ID} インプレッションの価格設定に使用される支払いルールの ID。
${POSTAL_CODE} ユーザーの郵便番号。
${PRICE_PAID} 値下げ後のこのインプレッションに対して支払われた価格。 これは2番目の価格です。
${SECOND_PRICE} オークションで 2 番目に高い入札額を表す価格。
${PT1}, ${PT2}, ${PT3}, ${PT4}, ${PT5}, ${PT6}, ${PT7}, ${PT8}, ${PT9} これらのマクロには、以下の配置タグのクエリ文字列パラメーターを使用するときに送信する任意のカスタム データを設定できます。
- pt1
- pt2
- pt3
- pt4
- pt5
- pt6
- pt7
- pt8
- pt9
詳細については、 配置タグ マクロの作成を参照してください。
${PUBLISHER_CODE} インプレッションを販売しているパブリッシャーのコード。

: この ID は、発行元がコードを使用し、報告用に公開した場合にのみ使用できます。
${PUBLISHER_ID} インプレッションを販売しているパブリッシャーの ID。
: この ID は、発行元がレポートに公開されている場合にのみ使用できます。
${REFERER_URL} 非推奨

: 代わりに ${REFERER_URL_ENC} を使用してください。
${REFERER_URL_ENC} エンコードされた参照 URL (使用可能な場合)。
モバイル アプリのインプレッションの場合、このマクロはアプリ ストア URL を返します (使用可能な場合)。
${REM_USER} ユーザーがリマーケティングされているかどうかを示すブール値。
${RESERVE_PRICE} パブリッシャーが設定した予約価格。 予約価格がない場合、このマクロは 0 を返します。
${SCHEME} インベントリの種類に応じて、適切なアプリケーション プロトコル (HTTP または HTTPS) を設定します。
${SEG_CODES} 落札した購入者がこのユーザーの Cookie 内で所有またはアクセスできるセグメントのコード (最終表示時刻の順)。 ユーザーが 15 を超えるアクセス可能なセグメントにいる場合、このマクロは最初の 15 個のみを返します (最近表示されたセグメントから最も古いセグメントの順に並べ替え)。
${SEG_IDS} 勝った購入者がこのユーザーの Cookie 内で所有またはアクセスできるセグメントの ID (最終表示時刻の順)。 ユーザーが 15 を超えるアクセス可能なセグメントにいる場合、このマクロは最初の 15 個のみを返します (最近表示されたセグメントから最も古いセグメントの順に並べ替え)。
${SELLER_MEMBER_ID} インプレッションを販売しているメンバーのメンバー ID。
${SITE_ID} インプレッションが配信されているサイトの ID。
${SSP_DATA} サーバー側変換ピクセルに必要です。 詳細については、「 サーバー側変換ピクセル」を参照してください。
${TAG_CODE1} 配置に設定された統合コード。
${TAG_CODE2} 配置に設定された追加の統合コード。
${TAG_ID} 入札要求を開始した Microsoft Advertising のプレースメント ID。
${TIMESTAMP} オークションの UNIX タイムスタンプ。
${USE_COOKIES} これは、インプレッションを表示するユーザーに Cookie を設定する必要があるかどうかを示すために、サードパーティのクリエイティブに使用されます。 許可される値は次のとおりです。
- 0 対象 いいえ
- 1 for yes
Cookie 関連の設定の詳細については、「 Cookie のプライバシー設定発行者サービス」を参照してください。
${USER_AGENT} 要求の HTTP ヘッダーからのユーザー エージェント文字列。 ユーザーエージェントは、多くの場合、ユーザーに代わって動作しているアプリケーション、オペレーティングシステム、ソフトウェアベンダーなどの情報を識別します。 例: Mozilla/5.0 (Macintosh;U;Intel Mac OS X 10.5;en-US;rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4.
${USER_AGENT_ENC} 要求の HTTP ヘッダーからエンコードされたユーザー エージェント文字列。
${USER_CITY} ユーザーの市区町村の文字列。
${USER_COUNTRY} ユーザーの居住国の文字列。
${USER_ID} インプレッションのユーザーを表す Microsoft Advertising の 64 ビット文字列。
${USER_IP} ユーザーの IP アドレス。これは切り捨てられます。
${USER_LOCALE} ユーザーのデバイスによって報告された言語と方言 (aa-DD)。 たとえば、en-ZA は南アフリカ (ZA) で使用される英語 (en) を表します。
${USER_STATE} ユーザーの都道府県または地域の文字列。
- 米国: 2 文字の略語
- 米国外: ユーザーの国、その後にユーザーの地域 ID (FIPS 10-4 または Microsoft 広告が生成した) を含むエンコードされた URL。
たとえば、ラトビアのリーヴァ周辺地域は LV%3A25 (LV:A25 のエンコード) です。

コンテンツ ID クリエイティブのサポート

content_ID クリエイティブ マクロにより、広告のコンテンツ レベルのレポートが有効になります。 このマクロを使用すると、広告主はバンドル ID に依存するのではなく、広告が表示される場所を正確に追跡できます。

クリエイティブに content_ID マクロが含まれていると、クリエイティブに埋め込まれたサードパーティ (3P) タグがトリガーされます。 このタグは、マクロ データを処理してレポートを生成する Peer39 を呼び出します。 広告主は、広告が表示された特定のコンテンツを示す詳細なレポートを表示できます。

データ フローとレポート

データ フローは次のように機能します。

  • クリエイティブの content_ID マクロが 3P タグをトリガーします。
  • タグは、コンテンツ固有のレポートのためにマクロ データを処理する Peer39 と通信します。
  • マクロ データはコンテンツ レベルのレポートを生成するために使用され、広告主は広告が表示された場所を正確に表示できます。 このレベルのレポートは、従来のバンドル ID 追跡よりも詳細な洞察を提供し、広告主がコンテンツレベルのターゲティングとキャンペーンのパフォーマンスを最適化するのに役立ちます。

パブリッシャーとマーケット ターゲティング

次のパブリッシャーは、レポート用の content_ID シグナルを送信する対象となります。

  • DirecTV
  • フィロ
  • Xumo

GroupM Nexus ATV は、次の領域で Peer39 ピクセルをテストしました。

カナダ: キャンペーンの 100% がレポートに Peer39 ピクセルを使用しています。 米国: キャンペーンの約 30 - 40% がレポートに Peer39 ピクセルを使用しています。

次の段階では、カナダと米国での継続的なテストが含まれ、Peer39 ピクセルをすべてのキャンペーンに適用する方向で段階的に移行します。 メキシコも、コンテンツレベルのターゲティングとレポートに Peer39 ピクセルを使用することに関心を示しています。

グローバル展開計画

Finecast ( GroupM Nexus ATV の一部) は、Peer39 ピクセルの世界的なニーズを評価し、市場全体での使用を標準化する予定です。 現在、GroupMは世界 20の市場 で事業を展開しており、今後3〜6か月以内に英国を含む11の新しい市場に拡大する予定です。

内部評価によると、Peer39 ピクセルの使用により、世界中で 1,400 万ドル の追加成長に貢献する可能性があり、GroupM の現在の成長軌道とそのプログラマティック購入戦略をサポートすることができます。

使用状況と影響の更新プログラム

GroupM Nexus ATV は Peer39 ピクセルの使用を拡大する予定で、2024 年を通じてその影響を評価し続ける予定です。 ユーザーは、テストが進むにつれて、世界市場での入手可能性と採用に関する最新情報を期待できます。

動画インプレッションのためのクリエイティブ マクロ

以下のマクロは、特に動画インプレッションに使用できます。

マクロ 説明
${VIDEO_CONTEXT} 動画広告のコンテキスト。 許可される値は次のとおりです。
- 0: インストリーム不明
- 1: インストリーム プレロール
- 2: インストリーム ミッドロール
- 3: インストリーム ポストロール
- 4: アウトストリーム
${VIDEO_PLAYBACK_METHOD} ビデオの再生方法を指定します。 許可される値は次のとおりです。
- 0: 不明
- 1: 自動再生、サウンドオン
- 2: 自動再生、サウンドオフ
- 3: クイック再生
- 4: マウス オーバー
- 5: 自動再生、サウンドは不明です
${VIDEO_PLAYER_HEIGHT} ビデオ プレーヤーの高さ (ピクセル単位)。
${VIDEO_PLAYER_WIDTH} ビデオ プレーヤーの幅 (ピクセル単位)。

モバイル インプレッションのためのクリエイティブ マクロ

モバイル インプレッション専用に使用できるマクロは以下のとおりです。

マクロ 説明
${CARRIER_ID} モバイル キャリア ID を表す Microsoft Advertising の整数。 通信事業者 ID の一覧については、 通信事業者サービスに関するページを参照してください。
${DEVICE_AAID} インプレッションが Android デバイスから配信された場合の Android 広告識別子。
${DEVICE_APPLE_IDA} インプレッションが Apple デバイスから配信された場合の Apple の広告識別子。
${DEVICE_IFA_TYPE} ${DEVICE_IFA}によって表される識別子の種類。 次の値を指定できます。
- AAID (Android 広告識別子/Google)
- IDFA(広告/Appleの識別子)
- AFAI (Amazon Fire ID)
- RIDA (Roku ID)
- OPENUDID
- TIFA (Tizen Identifier for Advertising (Samsung Ad ID))
- VIDA (Vizio 広告 ID)
- LGUDID (LG 一意のデバイス ID)

${DEVICE_IFA_TYPE} ${DEVICE_IFA} と組み合わせて使用する必要があり、各 IFA タイプに固有の個々のデバイス マクロに対してこの設定をお勧めします。 これらのマクロは、モバイル デバイスと CTV デバイス タイプの両方に適用できます。
${DEVICE_IFA} デバイスを表す一意識別子。
${DEVICE_MAKE_ID} 26 など、モバイル デバイス製造元の ID を表す Microsoft Advertising 整数。 モバイル デバイスの製造 ID の完全な一覧については、 デバイス製造サービスを参照してください。
${DEVICE_MD5} モバイル デバイスを表す MD5 暗号化された一意の識別子。
${DEVICE_MODEL_ID} 301 など、モバイル デバイス モデルの ID を表す Microsoft Advertising 整数。 モバイル デバイス モデル ID の完全な一覧については、 デバイス モデル サービスを参照してください。
${DEVICE_ODIN} モバイル デバイスを表す ODIN で暗号化された一意の識別子。 詳細については、「 ODIN」を参照してください。
${DEVICE_OPENUDID} モバイル デバイスを表す OPENUDID で暗号化された一意の識別子。
${DEVICE_SHA1} モバイル デバイスを表す SHA1 で暗号化された一意の識別子。
${DEVICE_WIN_ID} このインプレッションが発生したデバイスの Windows 広告 ID (該当する場合)。
${EXT_APP_ID} インプレッションを要求するアプリケーションの外部識別子。 このマクロは、モバイル アプリのインプレッションにのみ役立ちます。
${GEO_LAT} モバイル デバイスから GPS データを利用できる場合のユーザーの位置の緯度。+12.345-45.123 などのsnn.ddd,snn.ddd形式を使用して表されます。 この例では、南は負として表されます。 プライバシー標準に準拠するため、精度は最大で小数点以下 5 桁です。
${GEO_LON} モバイル デバイスから GPS データを利用できる場合のユーザーの位置の経度。 フォーマット snn.ddd,snn.ddd を使用して表されます。 例: +12.345 または -45.123。 この例では、West は負として表されます。 プライバシー標準に準拠するため、精度は最大で小数点以下 5 桁です。
${IS_PREVIEW} フラグをサードパーティのサーバーに渡して、クリエイティブのプレビュー時に実稼働インプレッションがインプレッションの合計数にカウントされないようにすることができます。 次の値を指定できます。
- 0 対象 いいえ
- 1 for yes
${SUPPLY_TYPE} このマクロには、インプレッションのサプライ タイプを示す数値が設定されます。 許可される値は次のとおりです。
- 0: web
- 1: モバイル Web
- 2: モバイル アプリ
- 4: ツール バー

プライバシー マクロ

お客様が米国の州プライバシー法、GDPR、ePrivacy 指令に基づく透明性、通知、選択/同意の要件を満たすために、Microsoft Advertising はグローバル プライバシー プラットフォーム と IAB ヨーロッパ透明性 & 同意フレームワーク ("フレームワーク") をサポートしています。 詳細については、「 IAB Europe Transparency & Consent Framework」を参照してください。 パブリッシャーは、EEA に所在するエンド ユーザーへの通知、透明性、選択肢を明示し、承認されたベンダーにシグナルを通知し、Microsoft 広告プラットフォームを通じて Microsoft 広告とデマンド ソース、およびそのベンダーに同意を渡すために、以下の表に記載されているようなマクロを使用する場合は、 プライバシー規制の一部 を参照する必要があります。 詳細については、「 サービス ポリシーの一部」を参照してください。

マクロ 説明
${GDPR_APPLIES} GDPR 規制が適用されるかどうかを指定します。 ユーザーが GDPR の影響を受ける国にいるかどうか、または要求と共に渡された GDPR 必須のシグナルがあるかどうかが具体的に示されます。 次の値を指定できます。
- 0 対象 いいえ
- 1 for yes
: 0 は EEA の国から受け取る場合があります。 この方法で通知するかどうかはパブリッシャーの選択です。
${GDPR} これは ${GDPR_APPLIES} のエイリアスであり、同じように動作します。
${GDPR_CONSENT_STRING} このマクロは、IAB GDPR の同意文字列を指定します。 GDPR が適用される場合は、IAB GDPR の透明性と同意フレームワークに基づいて、ユーザーが承認したベンダーのリストが含まれます。 詳細については、「 IAB GDPR の透明性と同意フレームワーク」を参照してください。
${GDPR_CONSENT} このマクロは ${GDPR_CONSENT_STRING} のエイリアスであり、同じように動作します。
${GDPR_CONSENT_[0-9]+} たとえば、GDPR_CONSENT_1、GDPR_CONSENT_12345 などです。これらはすべて、前述の '${GDPR_CONSENT_STRING}' と同じ GDPR 同意文字列に解決されます。
${XANDR_DOMAIN} TCF 文字列に含まれる Cookie 同意設定に基づいて、適切な Microsoft Advertising ドメインを動的に取得します。 ユーザーがブラウザーの設定から Cookie を有効にしているが、以下の場合:
- Cookie を TCF 文字列に含めることに同意しない場合は、ブラウザーが後続の広告呼び出しに Cookie を添付できないようにするために adnxs-simple.com ドメインが使用されます。
- Cookie を TCF 文字列に含めることに同意すると、 adnxs.com ドメインを使用して、各広告呼び出しのヘッダーに Cookie を渡します。
: このマクロは、Cookie の同意が必要な国でインプレッションを提供する予定の場合にのみ使用する必要があります。
${GPP_SID} グローバル プライバシー プラットフォームのセクション (つまり、規制のフレームワーク) を適用する必要があるかどうかを指定します。 具体的には、ユーザーが GPP の対象となる法律の影響を受ける国に居住しているかどうかを示します。
${GPP_STRING_XXXXX*} これは、IAB グローバル プライバシー プラットフォーム (GPP) の文字列です。 GPP のセクションが適用される場合、これにはユーザーの同意の選択を反映するフレームワークに依存する情報が含まれます。
: * XXXXX は、任意の数値 ID を表します。

関数マクロ

関数マクロは、別のマクロで機能を実行します。 関数マクロは、カスタム マクロなど、他のクリエイティブ マクロと組み合わせて使用できます。 レンダリング時に認識されない場合、それらは変換されず、関数は呼び出されません。

Microsoft 広告では現在、エンコードに関連するさまざまな目的に使用できる {$URL_ENC} 関数マクロをサポートしています。 主なユース ケースは、クリエイティブ マクロを使用して広告サーバーから広告サーバーに URL を渡す必要がある場合です。 標準の URL フォーマットにはサポートされていない文字が存在するため、 {$URL_ENC} 関数マクロはプロセスのさまざまな段階でエンコードする必要があります。

この関数マクロは、次の形式になります。

${URL_ENC(${MACRO_NAME},#)}

${MACRO_NAME} はエンコードするマクロで、 # はコンテンツをエンコードする回数を表す整数です。 次の値を指定できます。

  • 1
  • 2
  • 3

それぞれのエンコーディングはリダイレクト チェーン内のステップに対応しており、サードパーティ製のクリック トラッカーがマクロとどのように連携しているかに対応しています。 通常、2 つ目の広告サーバーが関係している場合は最終ページ リンク先 URL にダブル エンコードが必要になり、3 つ目の広告サーバーの場合はトリプル エンコードが必要になります。

エンコードのどれがシングルか、ダブルか、トリプルかを判断するには、サードパーティのクリック トラッカーでチェックし、URL_ENC マクロが動作するかテストします。 マクロが機能しない場合、その結果としてリンクが壊れ、ユーザーが意図したリンク先 URL に到達できなくなる可能性があります。

エンコードの例 フォーマット
クリック URL の 1 回エンコード 次の形式を使用します。
${URL_ENC(${CLICK_URL},1)}

: https://xandr.com がクリック URL として渡された場合、 ${URL_ENC(${CLICK_URL},1)} を使用して URL をシングル エンコードすると、 https%3A%2F%2Fxandr.com がクリエイティブに設定されます。
メディア URL を 1 回エンコードする 次の形式を使用します。
${URL_ENC(${MEDIA_URL},1)}
メディア URL を 2 回エンコードする 次の形式を使用します。
${URL_ENC(${MEDIA_URL},2)}
ADFORMAT というカスタム マクロを一度エンコードする 次の形式を使用します。
${URL_ENC(#{ADFORMAT},1)}

デジタル サービス法 (DSA) マクロ

DSA の第 26 条によると、Microsoft 広告のパブリッシャー クライアントを含むオンライン プラットフォームは、2024 年 2 月 17 日までに広告に関する明確、簡潔、明確な情報を提供する必要があります。 重要な要件は次のとおりです:

  1. 情報が広告であることを明確に識別すること。
  2. 広告を掲載する個人または法人の身元を開示すること。
  3. 広告の料金を支払った個人または法人の ID を示す (広告主と異なる場合)。
  4. 広告受信者を決定するために使用される主要なパラメーターに関する情報と、該当する場合はそれらのパラメーターを変更する方法に関する情報を提供します。
マクロ 説明
${DSA_REQUIRED} DSA 情報を利用可能にする必要があるかどうかを示します。
次の値を指定できます。
- 0: 必須ではありません。
- 1: 必須です。 DSA オブジェクトの有無にかかわらず、入札応答が受け入れられます。
- 2: 必須です。 DSA オブジェクトのない入札応答は受け付けられません。
- 3: 必須です。 DSA オブジェクトのない入札応答は受け付けられません。 ここでは、パブリッシャーはオンライン プラットフォームです。
${DSA_BEHALF} 広告が表示される名前を持つ自由 UNICODE テキスト文字列。 このマクロは、DSA の入札応答から入力されます。
たとえば、「 Advertiser 」のように入力します。
${DSA_PAID} 広告の支払い者を示す無料の UNICODE テキスト文字列。 このマクロは、DSA の入札応答から入力されます。
たとえば、「 Advertiser 」のように入力します。
${DSA_PARAMS} アンダースコア "_" で区切られた、ユーザー パラメーターを表す整数値の組み合わせ。
たとえば、「 1_2_3 」のように入力します。
次の値を指定できます。
- 1: 広告主のターゲットとなるグループとの類似性を示すオンライン アクティビティに関する情報。 たとえば、年齢層、性別、教育レベル、興味などです。
- 2: 特定の広告を表示する設定に関する情報です。 たとえば、Web サイトのコンテンツ、デバイスの種類、IP アドレス、場所 (国または都市) などです。
- 3: 正確な地理的位置に関する情報 (約 500 メートルの精度)。

クリエイティブ マクロ