配置タグ パラメーター
注:
Microsoft Advertising では、要求時にブラウザー Cookie の送受信を行わないドメイン adnxs-simple.com がサポートされるようになりました。 クライアントは、個人データの使用に同意がない場合に、この Cookie を使用しないドメインを利用できます。 Microsoft Advertising によって開始された関連する呼び出しは、同意がない場合、または関数に Cookie が必要ない場合に、このドメインを自動的に使用します。 詳細については、「 サービス ポリシーの一部」を参照してください。
配置タグをエクスポートするときに、プレースホルダーを含め、広告呼び出し中に追加のクエリ文字列パラメーターを Microsoft Advertising プラットフォームに渡すことができます。 このドキュメントでは、許可されるパラメーターについて説明します。 ビデオの配置に使用されるパラメーターについては、「 クエリ文字列パラメーターを使用したターゲット ビデオ属性」を参照してください。
配置タグ
注:
- 現在、Microsoft Advertising のクリック追跡マクロ (
${CLICK_URL}または${CLICK_URL_ENC}) とキャッシュ バスター マクロは、${CACHEBUSTER}配置タグでは機能 しません 。 発行元が提供するサード パーティ製のクリック トラッカーやサード パーティ製のキャッシュ バスター/タイム スタンプを使用する必要があります。 - Microsoft Advertising プラットフォームによって処理される 1 つの配置 (キャンペーンでのクエリ文字列のターゲット設定に使用される) ごとに、最大 5 つのカスタム ターゲティング パラメーターがあります。
- 配置タグ のパラメーター (年齢や性別など)、または追加する一意のパラメーターをタグに含めて、マネージド インベントリを操作するときによりきめ細かいターゲット設定を可能にすることができます。 この種のターゲット設定のしくみの詳細については、「 配置タグとセグメントを使用したクエリ文字列のターゲット設定」を参照してください。
パラメーター
| パラメーター | 説明 |
|---|---|
| 年齢 | ユーザーの年齢、生年月日、ハイフンで区切られた年齢範囲の数値。 例: age=56、、 age=1974。 age=25-35 |
| cb | パブリッシャーが提供するキャッシュ バスター。 これは、パブリッシャーが独自のキャッシュ バスターを挿入できるプレースホルダーにすぎません。 |
| custom_pub_data | 非推奨。 の custom_pub_data 内容は 70 文字以下にする必要があります (その後、切り捨てられます)。 70 文字を超える文字を渡すことができますが、最初の 70 文字のみがログに記録されます。 改行、 ("\n")タブ ("\t")、円記号 ("\") は使用できません。 それ以外の場合は、標準の C ライブラリ関数 isprint で表示できるすべての文字が許可されます。 |
| ext_inv_code | レポートで使用できるクエリ文字列に渡される定義済みの値。 この値は、ログに記録される前にシステムに入力する必要があります。 詳細については、「 外部インベントリ コード サービス」を参照してください。 例: ext_inv_code=10039 |
| 性別 | ユーザーの性別。 使用できる値: m 男性の場合、 f 女性の場合例: gender=m |
| id、 ID | 配置に属する識別番号 (整数)。 例: id=5202 |
| inv_code | 配置に入力されたコード。 これは、配置 ID の代わりに使用できますが、と共に member_id 使用する必要があります。 例: inv_code=ABC&member=1 |
| loc | 緯度と経度で表されるユーザーの場所。形式は snnn.ddddddddddddd,snnn.dddddddddddddです。 小数点以下 13 桁までの有効桁数を使用できます。 |
| position | ページ上のタグの位置。 above (フォールドの上) または を指定belowできます。 注: このオプションは UI からは使用できませんが、配置タグに追加できます。 また、 above は below 小文字にする必要があります。 例: position=above |
| private_sizes | プライベート サイズが取引またはパッケージによって許可されている場合にのみ、カスタム取引またはパッケージに対してのみ提供できる追加のサイズ。 例: private_sizes=150x300,320x480 |
| promo_alignment | 許可される値: none または center。 例: promo_alignment=center |
| promo_sizes | この配置を使用するには、追加のサイズを許可します。 注: 配置は に sizeless 設定する必要があり、実際のサイズは以下のパラメーターで size 渡す必要があります。 例: promo_sizes=728x90,150x300 |
| Psa | の場合 true、オークションに勝者がいない場合は PSA が配信されます。 それ以外の場合は、空 200 OK の HTTP 応答が返されます。 これは、別の在庫ソースからの売れ残りのインプレッションを埋めようとするクライアントに役立つ可能性があります。 静的タグを既定のクリエイティブとして提供する代わりに、空の応答を使用すると、売れ残りのインプレッションをより柔軟に処理できます。 使用できる値: true、、false1、または 0。 例: psa=0 |
| pt1、 pt2、 pt3、 pt4、 pt5、 pt6、 pt7、 pt8、 pt9 | これらは、マネージド プレースメントを通じてカスタム データをマネージド サード パーティのクリエイティブに渡すために使用できます。 詳細については、「 配置タグ マクロを作成する」を参照してください。 例: pt1=products:ipad,ios,iphone |
| pubclick | サード パーティ製のクリック追跡用の発行元提供の URL。 これは、パブリッシャーが独自のクリック トラッカーを挿入できるプレースホルダーにすぎません。 このパラメーターは、 エンコードされていない トラッカーに使用する必要があります。 このパラメーターは、URL の最後のパラメーターであると予想されます。 このパラメーターに配置されたクリック トラッカーは、オークションに勝ったクリエイティブが Microsoft Advertising のクリックトラッキングを適切に使用している場合にのみ発生します。 例: pubclick=https://click.adserver.com |
| pubclickenc | サード パーティ製のクリック追跡用の発行元提供の URL。 これは、パブリッシャーが独自のクリック トラッカーを挿入できるプレースホルダーにすぎません。 このパラメーターは、 エンコードされた トラッカーに使用する必要があります。 このパラメーターは、URL の最後のパラメーターである必要はありません。 このパラメーターに配置されたクリック トラッカーは、オークションに勝ったクリエイティブが Microsoft Advertising のクリックトラッキングを適切に使用している場合にのみ発生します。 例: pubclickenc=https%3A%2F%2Fclick.adserver.com |
| リファラー | 非推奨。 Microsoft Advertising では、ドメイン検出が自動的に実行されます。 |
| 予約 | この在庫の予約価格。これは、クリエイティブを配置するために配置が受け入れる最小正味額です。 このパラメーターは、事前設定された価格をオーバーライドし、Yield Management が使用されていない場合、または予約価格が YM フロアよりも値が大きい場合は、フロア ルールのオーバーライド設定がオンになっている場合に、ハード フロア (および関連するソフト フロア) を設定します。 注: このオプションは UI からは使用できません。配置タグには手動で追加する必要があります。 例: reserve=5.00 |
| size | 配置のサイズ - サイズレスの場合は必須です。 このパラメーターは、事前設定されたサイズ形式をオーバーライドしません。 許可される形式: widthXheight。 例: size=300x250 |
| truncate_ip | または trueの場合1、ユーザーの IP アドレスの最後のオクテットが入札要求で切り捨てられます。 IP アドレスが個人を特定できる情報と見なされる管轄区域の広告タグには、このフラグを使用します。 もちろん、完全な IP アドレスは、運用目的とセキュリティのために引き続き使用されます。 プライバシーの詳細については、「 サービス ポリシーの一部」を参照してください。 例: truncate_ip=1 |
| use_cookies | の場合 0は、Microsoft Advertising がユーザーに保存するデータをこのインプレッションに使用しないでください。 これには、セグメントのターゲット設定、フリークエンシー キャップ、コンバージョン属性に使用されるデータが含まれます。 Cookie 関連の設定の詳細については、「 Publisher Service と Creative マクロ」を参照してください。 例: use_cookies=0 |
例
<!-- BEGIN IFRAME TAG - Fancy Cracker Homepage < - DO NOT MODIFY -->
<IFRAME SRC="https://ib.sand-08.adnxs.net/tt?id=5202&cb=[CACHEBUSTER]&age=[AGE]&pubclick=[INSERT_CLICK_TAG]" FRAMEBORDER="0" SCROLLING="no" MARGINHEIGHT="0" MARGINWIDTH="0" TOPMARGIN="0" LEFTMARGIN="0" ALLOWTRANSPARENCY="true" WIDTH="728" HEIGHT="90"></IFRAME>
<!-- END TAG -->