次の方法で共有


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

私たちは、すべての、モバイル、およびビデオのインプレッションに使用できる創造的なマクロを持っています。 また、プライバシーと関数マクロもサポートしています。

注:

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

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

次のマクロは、すべてのインプレッションに使用できます。

マクロ 説明
${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 ビットの文字列。
${BID_PRICE} 価格引き下げ後に支払われた価格とは対照的に、このインプレッションの最初の価格入札。
${BIDPRICE} このマクロは、 ${BID_PRICE}のエイリアスであり、同じ方法で動作します。
${CACHEBUSTER} URL のキャッシュを制限するために使用される乱数文字列。

: このマクロを使用すると、タグが呼び出されるたびに広告サーバーに対して新しい呼び出しが行われ、すべてのインプレッションが正確にカウントされます。 このマクロをタグに追加しないと、インプレッションの合計が不正確になる可能性があります。
${CP_CODE} 配信されたインプレッションのキャンペーン コード。
${CP_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 Alpha Test クライアントでのみ機能します。
${CUSTOM_MODEL_LAST_MODIFIED} オークションで使用されたカスタム モデルが最後に変更されてからの日付と時刻 (Unix エポック時間)。 モデルが使用されなかった場合、このマクロは 0を返します。

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

: このカスタム マクロは、APB Alpha Test クライアントでのみ機能します。
${DATACENTER} データ センター ID (1 = NYM、2 = LAX、3 = AMS、4 = FRA、5 = SIN)。
${DEAL_ID} 該当する場合は、落札に関連付けられた Microsoft Advertising Deal ID。 取引がない場合、このマクロは 0を返します。
${ECP} オークションの発行元側の見積もりクリア価格 (ECP)。
${EXTENDED_IDS} 販売者が渡すユニバーサル ID 値。購入者が表示するアクセス許可を持っています。
${GENDER} 使用可能な場合は、ユーザーの性別。 次の値を指定できます。
- f (女性)
- m (男性)
- 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 はい
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 Advertising 生成) が続くエンコードされた URL。
たとえば、Riva を囲む領域、ラトビアは 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 広告 ID/Google)
- IDFA (Advertising/Apple の識別子)
- AFAI (Amazon Fire ID)
- RIDA (Roku ID)
- OPENUDID
- TIFA (Tizen Identifier for Advertising (Samsung Ad ID))
- VIDA (Vizio Advertising ID)
- LGUDID (LG 固有のデバイス ID)

${DEVICE_IFA_TYPE}${DEVICE_IFA}と組み合わせて使用する必要があります。この設定は、各 IFA の種類に固有の個々のデバイス マクロよりも推奨されます。 これらのマクロは、モバイルおよび CTV デバイスの種類の両方に適用できます。
${DEVICE_IFA} デバイスを表す一意の識別子。
${DEVICE_MAKE_ID} 26などのモバイル デバイスのメイクの ID を表す Microsoft Advertising 整数。 モバイル デバイスの ID の完全な一覧については、「 Device Make Service」を参照してください。
${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形式を使用して表されます。 この例では、South は負の値として表されます。 プライバシー標準に準拠するために、小数点以下 5 桁の有効桁数が最大値になります。
${GEO_LON} モバイル デバイスから GPS データを利用できる場合のユーザーの位置情報の経度。 形式 snn.ddd,snn.dddを使用して表されます。 例: +12.345 または -45.123。 この例では、West は負の値として表されます。 プライバシー標準に準拠するために、小数点以下 5 桁の有効桁数が最大値になります。
${IS_PREVIEW} クリエイティブをプレビューする際に、広告のインプレッションの総数にカウントされないように、サード パーティのサーバーにフラグを渡すことができます。 次の値を指定できます。
- 0 いいえの場合
- 1 はい
${SUPPLY_TYPE} このマクロには、インプレッションの供給の種類を示す数値が設定されます。 許可される値は次のとおりです。
- 0:ウェブ
- 1: モバイル Web
- 2: モバイル アプリ
- 4:ツールバー

プライバシー マクロ

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

マクロ 説明
${GDPR_APPLIES} GDPR 規制を適用するかどうかを指定します。 具体的には、ユーザーが GDPR の影響を受ける国にいるか、要求で GDPR が必要なシグナルが渡されているかを示します。 次の値を指定できます。
- 0 いいえの場合
- 1 はい
: 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 Advertising では現在、エンコードに関連するさまざまな目的で使用できる {$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 というカスタム マクロを 1 回エンコードする 次の形式を使用します。
${URL_ENC(#{ADFORMAT},1)}

Digital Services Act (DSA) マクロ

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

  1. 情報が広告であることを明確に識別します。
  2. 広告が提示された個人または法人の身元を開示する。
  3. 広告主と異なる場合、広告の支払いを行った個人または法人の身元を示します。
  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 メートルです。

クリエイティブ マクロ