オークション中にバックグラウンドで何が起こっているかを理解するには、デバッグ オークションを実行します。 このページでは、デバッグ オークションを実行する方法と、受け取った出力を読み取る方法について説明します。
デバッグ オークションの実行
デバッグ オークションは、実際には何も記録または提供せずに実際のオークションをシミュレートし、結果をブラウザーに表示します。 ログには、すべてのアクティブな入札者 (Microsoft 広告を含む) と通信するインプレッション バスが表示され、メンバー固有の決定が表示されます。
デバッグ オークションは、次の呼び出しを使用して実行できます。
注:
すべてのデバッグ オークションとブラウザーの Cookie オーバーライド呼び出しでは、安全な https プロトコルを使用する必要があります。 HTTP を使用して行われた要求では、有効な結果は生成されません。
実稼働/ベータ環境:
https://ib.adnxs.com/tt?id=[TAG_ID]&size=[WIDTH]x[HEIGHT]&debug_member=[BUYER_MEMBER_ID]&dongle=[PASSWORD]クライアント テスト環境:
https://ib-test.adnxs.com/tt?id=[TAG_ID]&size=[WIDTH]x[HEIGHT]&debug_member=[BUYER_MEMBER_ID]&dongle=[PASSWORD]ビデオ クリエイティブ:
ビデオ クリエイティブのデバッグ オークションを実行するときは、tt タグの代わりに ptv タグを使用してください。
https://ib.adnxs.com/ptv?id=[TAG_ID]&debug_member=[BUYER_MEMBER_ID]&dongle=[PASSWORD]
パラメーター構文
| パラメーター | 定義 |
|---|---|
id |
デバッグ オークションを実行する配置タグの ID。 |
size |
実行する配置のサイズ。サイズレス タグに使用されます。 |
dongle |
メンバーの一意のデバッグ パスワード。 |
debug_member |
デバッグ オークションを実行しているメンバーの ID。 |
オプションのパラメーター
| パラメーター | 定義 |
|---|---|
bidder |
入札者 ID。 Microsoft Monetize は、運用環境で入札者 ID 2 を使用します。 |
referrer |
広告呼び出しの元となる参照 URL をシミュレートします。 |
prefer_learn |
優先学習オークションを強制するには、"true" に設定します。 |
position |
フォールド位置をオーバーライドします。 "above" または "below" に設定できます。 |
age |
年齢 (整数) をオーバーライドします。 |
gender |
性別 ("male" または "female") をオーバーライドします。 |
debug_json |
"1" に設定されていて "&bidder_only=1" が追加されている場合、オークションの HTML 出力を JSON 形式に変換します。 |
kw_prefix |
ターゲット設定目的で キーワード (keyword) パラメーターを追加します (例: "kw_keyname=value1")。 |
オプションの地域コード パラメーター
| パラメーター | 定義 |
|---|---|
country |
値として渡される内容で、Cookie の現在の国名コードを上書きします。 たとえば、"country=US" です。 国の地理コードの完全なリストについては 、こちら を参照してください。 |
region |
値として渡されるもので、Cookie の現在の範囲 (州) 地理コードを上書きします。 たとえば、"region=NY" です。 地域 (州) ジオコードの完全な一覧については 、こちら を参照してください。 |
city |
値として渡される内容で、Cookie の現在の都市地理コードで上書きします。 たとえば、"city=New York" です。 |
postal |
値として渡される内容で、Cookie の現在の郵便番号を上書きします。 たとえば、"postal=10010" です。 特定の郵便番号を確認するには 、こちら を参照してください。 |
DMA |
値として渡される内容で、Cookie の現在の指定マーケット エリア (DMA) 地域コードを上書きします。 たとえば、"DMA=501" です。 DMA は、テレビとラジオの市場によって地理的地域を分割します。 |
注:
特定の地域または都市を偽装しようとしている場合は、最も一般的なものから最も詳細な地理的なものを含める必要があります。 都市ターゲティングの場合は、国、地域 (州)、市区町村を含める必要があります。 例: &country=US®ion=NY&city=New York。 都市名の正式な入力を忘れないでください。
例
https://ib.adnxs.com/tt?id=3457&debug_member=999&dongle=MyDongle
https://ib.adnxs.com/tt?id=3457&size=728x90&dongle=MyPassWord&debug_member=999&referrer=https://www.appnexus.com
注意事項
プレースメント タグ ID はダイレクト インベントリの UI にありますが、リアルタイム インベントリの場合は使用できません。
アイテムが予算不足、非アクティブ、またはペーシング スリープ状態 (つまり、1 日を通して均等に費やされている) 場合、ログに表示されません。 一般的に、リフレッシュすると、ペーシングしたオブジェクトが表示されます (スリープ状態から覚醒するため)。 ただし、テンポの強いオブジェクト (例: ターゲティングなしで 5 ドルを均等に費やすために、入札と入札の間に多くのスリープが生じる) は、入札キャンペーンの最終リストに表示されない場合があります。
Microsoft Advertising ブラウザーの Cookie を上書きする
特定の広告キャンペーンをデバッグするときに、ブラウザーの Cookie が対象となる特定のユーザー条件 (国やセグメントなど) を含めたり除外したりすると役立つ場合があります。 Cookie を表示/変更する方法については、以下の表を参照してください。
重要
Cookie ビューアーを使用する場合は、メンバー ID とドングルを含める必要があります。 これにより、メンバーに属するセグメントのみが表示されるようになります。 任意の配置の [デバッグ ] ボタンをクリックすると、クエリ文字列にメンバー ID とドングルが表示されます。
| アクション | URL |
|---|---|
| Microsoft Advertising Cookie の表示 | https://ib.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE ここで、 MEMBER_ID はメンバー ID、 DONGLE はメンバー固有のドングルです |
| セグメントに自分を挿入/セグメントから削除する | https://ib.adnxs.com/seg?add=SEGMENT_ID https://ib.adnxs.com/seg?remove=SEGMENT_ID ここで、 SEGMENT_ID は対象セグメントの ID です |
| Cookie の地理データを上書きする | https://ib.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE&country=COUNTRY®ion=REGION&dma=DMA&city=CITY&postal=POSTAL MEMBER_ID はメンバー ID、DONGLE はメンバー固有のドングル、COUNTRY は対象の国コード、REGION は対象の地域コード、DMA は対象の数値の大都市コード、CITY は対象の都市名、POSTAL は対象の郵便番号です 注: 都市地域を設定するには、国、地域を追加で設定する必要があります。 |
デバッグ オークション ログの解釈
- これは、再販の対象として公開されたプレースメントに対して広告ネットワークが実行するデバッグ ログのサンプルです。
- この特定のデバッグ ログは非推奨のサンドボックス環境で実行されたため、URL は運用サーバーにあるものとは若干異なります。
- すべてのIDが乱数に変更されました。
Microsoft Advertising のビッダーは、"ビッダー 2 からのデバッグ テキスト" (ライブ) から始まる、より詳細なデバッグ テキストを提供します。 この出力には、入札者のバージョン、地域情報、ユーザー情報などの情報が含まれます。 ライブ デバッグ オークションからの抜粋を以下に示します。
このデバッグ情報は続行されます。これには、ユーザーがいるセグメントやその他の関連オブジェクトなどの情報が含まれます。
注:
このセクションでは、入札者が行った決定について説明します。
その後、デバッグ オークションでは、[広告主]、[ライン アイテム]、[キャンペーン] (該当する場合)、詳細、結果の見出しを含むテーブルが出力されます。 これは、このタグのインプレッションに入札しない理由を示すため、デバッグ オークション出力の最も重要な部分です。あるいは、もしそうなら、いくら入札するか。
すべての広告キャンペーンが評価されると、サマリー テーブルが表示されます。
パフォーマンスの概要も表示されます。
すべての入札単価と最終入札単価の出力を受け取ります。 RTB 購入者には、入札額の値、ブランド ID、学習の種類が表示されます。
注:
このデバッグ ログでは、Microsoft 広告の入札者の結果と、オークションに参加している他のすべての入札者の結果を比較し、落札者と 2 番目に高い価格 (Microsoft 広告は第 2 価格オークションを使用しているため) を探します。
最後に、最高入札単価と、これがデバッグ オークションでなかった場合は配信できたであろうメンバーとクリエイティブを表示します。
デバッグ オークションの結果の表示
| 結果 | 説明 | レポートのインプレッション タイプ |
|---|---|---|
| 排他 | このプレースメントは再販が有効になっていませんが、オークションは管理された入札によって落札されました | 保持 |
| 予約が満たされていない | プレースメントは再販が有効になっており、オークションは管理入札によって落札された | 保持 |
| Sold | プレースメントは再販が有効になっており、オークションはサード パーティの入札によって落札されました | Sold |
| PSA | オークションには落札者はおらず、広告の代わりに PSA が表示されました | PSA |
| 既定値 | オークションには落札者がおらず、広告の代わりに既定のクリエイティブが表示されました | 既定値 |
クイック リファレンス: オークション データのデバッグ
| デバッグ データ | 出品者および直接オークションに表示されます | RTB 購入者に表示 |
|---|---|---|
| 広告プロファイル | はい | 不要 |
| 価格の確認 | はい | 不要 |
| オークション ID | はい | はい |
| オーディエンス ターゲティング キャンペーン | はい | はい |
| 入札要求 | はい | はい |
| Bidder hostport | はい | はい |
| 入札者のバージョン | はい | はい |
| ブラウザー | はい | はい |
| 通信事業者 | はい | はい |
| 都市 | はい | はい |
| 都市のインデックス | はい | はい |
| 国 | はい | はい |
| 国別インデックス | はい | はい |
| デバッグ レベル | はい | はい |
| デバッグ メンバー | はい | はい |
| 既定の表示プロファイル | はい | 不要 |
| デバイス メーカー | はい | はい |
| デバイスのモデル | はい | はい |
| デバイス タイプ | はい | はい |
| ドメイン ID | はい | はい |
| 推定平均価格 | はい | 不要 |
| 推定クリア価格 | はい | はい |
| 最終入札単価 | はい | はい |
| 折りたたみ位置 | はい | はい |
| Giveup Price | はい | 不要 |
| Hour of Week ID | はい | はい |
| インベントリ クラス - 非推奨 | -- | -- |
| インベントリ グループ - 非推奨 | -- | -- |
| インベントリ ソース - 非推奨 | -- | -- |
| インベントリ ソース ID - 非推奨 | -- | -- |
| IP | はい | はい |
| IP の切り捨て | はい | はい |
| 言語 | はい | はい |
| Latitude | はい | はい |
| Longitude | はい | はい |
| メディア サブタイプ | はい | はい |
| 純優勝価格 | はい | はい |
| オーディエンス ターゲティング以外のキャンペーン | はい | はい |
| タグの数 | はい | はい |
| UTC からのオフセット | はい | はい |
| オペレーティング システム | はい | はい |
| オペレーティング システム (拡張) | はい | はい |
| オペレーティング システム ファミリ | はい | はい |
| 支払ルール | はい | 不要 |
| 支払いルール ID | はい | 不要 |
| パフォーマンスの概要 | はい | はい |
| 優先 学習 | はい | はい |
| 処理の優先順位 | はい | 不要 |
| パブリッシャー ID | はい | はい |
| QS データ | はい | はい |
| クエリ文字列 | はい | はい |
| 参照 | はい | はい |
| Region | はい | はい |
| リージョン インデックス | はい | はい |
| 予約価格 | はい | 不要 |
| RTB とアフィリエイト キャンペーン | はい | はい |
| RTB メンバー | はい | はい |
| 2 回目の入札 | はい | はい |
| 安全な要求 | はい | はい |
| 2 番目の純価格 | はい | はい |
| セグメント | はい | はい |
| 選択した支払いルール | はい | 不要 |
| 販売側のページ上限が有効 | はい | 不要 |
| ソフト フロア | はい | はい |
| サプライの種類 | はい | はい |
| タグ データ | はい | はい |
| タグ ID | はい | はい |
| タイムゾーン | はい | はい |
| tinytag | はい | はい |
| URL | はい | はい |
| User | はい | はい |
| ユーザー グループ | はい | はい |
| ユーザー ID | はい | はい |
| 会場 ID | はい | はい |
| 表示範囲プロファイル ID | はい | はい |
| 落札 | はい | はい |
テスト オークションの実行
デバッグ オークション (広告のログや配信を行わずに実際のオークションをシミュレートする) に加えて、テスト オークションを実行することもできます。 テスト オークションは、クライアントが広告が期待どおりに配信されているかどうかをテストし、すべてが正しく構成されていることを確認できるように設計されています。
デバッグ オークションと同様に、テスト オークションでは、Microsoft Advertising はインプレッションを処理しません。支払いや請求は行われず、何も記録されず、広告も配信されません。 さらに、テスト オークションでは、送信される広告の実際の内容は無視されます。禁止されたクリエイティブが送信された場合でも、テスト オークションで IP アドレスがブロックされることはありません。
テスト オークションを実行するには、広告呼び出しに test=1 パラメーターを追加します。たとえば、次のようになります。
https://ib.adnxs.com/tt?id=1234&test=1
広告がブラウザーに表示されている場合、構成は有効です。