Microsoft 収益化 - デバッグ オークションについて
オークション中にバックグラウンドで何が起こっているのかを理解するために、デバッグ オークションを実行できます。 このページでは、デバッグ オークションを実行する方法と、受信した出力を読み取る方法について説明します。
デバッグ オークションの実行
デバッグ オークションは、実際にログを記録したり、何も提供したりすることなく、実際のオークションをシミュレートし、結果をブラウザーに表示します。 ログには、アクティブなすべての入札者 (Microsoft Advertising を含む) と通信しているインプレッション バスが表示され、メンバー固有の決定が表示されます。
デバッグ オークションは、次の呼び出しを使用して実行できます。
注:
すべてのデバッグ オークションとブラウザー 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 収益化では、運用環境で入札者 ID が 2 使用されます。 |
referrer |
広告通話の発信元となる参照 URL をシミュレートします。 |
prefer_learn |
[Learn auction] を強制的に優先するには、"true" に設定します。 |
position |
フォールド位置をオーバーライドします。 "" またはbelow "above" に設定できます。 |
age |
age (integer) をオーバーライドします。 |
gender |
性別 ("male" または "female") をオーバーライドします。 |
debug_json |
オークションの HTML 出力を "" と "1"&bidder_only=1 に設定すると JSON フォームに変換されます。 |
kw_prefix |
ターゲット設定の目的キーワード (keyword)パラメーター (例: ") をkw_keyname=value1追加します。 |
オプションの geo コード パラメーター
| パラメーター | 定義 |
|---|---|
country |
Cookie の現在の国の地域コードを値として渡されたものでオーバーライドします。 例: "country=US" 国の地域コードの完全な一覧については、 こちらを 参照してください。 |
region |
Cookie の現在のリージョン (状態) geo コードを値として渡されたものでオーバーライドします。 例: "region=NY" 地域 (状態) 地域コードの完全な一覧については、 こちらを参照してください 。 |
city |
Cookie の現在の市区町村地域コードを値として渡されたものでオーバーライドします。 例: "city=New York" |
postal |
Cookie の現在の郵便番号を値として渡されたものでオーバーライドします。 例: "postal=10010" 特定の郵便番号については、 こちらを参照してください 。 |
DMA |
Cookie の現在の指定市場領域 (DMA) geo コードを、値として渡されたものでオーバーライドします。 例: "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 where 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 およびターゲット郵便番号です注: 市区町村地域を設定するには、国、地域を追加で設定する必要があります。 |
デバッグ オークション ログの解釈
- これは、再販売のために公開された配置に対して Ad Network によって実行されるサンプル デバッグ ログです。
- この特定のデバッグ ログは非推奨のサンドボックス環境で実行されたため、URL は運用サーバーとは若干異なります。
- すべての ID が乱数に変更されました。
Microsoft Advertising の入札者は、"bidder 2 からのテキストのデバッグ" (ライブ) から始まる、より詳細なデバッグ テキストを提供します。 この出力には、bidder のバージョン、地域情報、ユーザー情報などの情報が含まれます。 ライブ デバッグ オークションからの抜粋を次に示します。
このデバッグ情報は、ユーザーが存在するセグメントや他の関連オブジェクトなどの情報を含め、続行されます。
注:
このセクションでは、入札者による決定について説明します。
次に、デバッグ オークションによって、広告主、広告申込情報、キャンペーン (該当する場合)、詳細、結果の見出しを含むテーブルが出力されます。 これは、このタグのインプレッションに入札しない理由を示す、デバッグ オークション出力の最も重要な部分です。または、入札額を指定します。
すべての広告キャンペーンが評価されると、概要表が表示されます。
パフォーマンスの概要も表示されます。
すべての入札と最終入札の出力が表示されます。 RTB 購入者には、入札額、ブランド ID、学習の種類が表示されます。
注:
このデバッグ ログでは、Microsoft Advertising の入札者の結果と、オークションに参加している他の入札者が勝者と 2 番目に高い価格を探した結果も比較されます (Microsoft Advertising では 2 番目の価格のオークションが使用されているため)。
最後に、最高額の純入札を示し、メンバーとクリエイティブは、これがデバッグ オークションでなかったことを示します。
可能なデバッグ オークションの結果
| 結果 | 説明 | レポートのインプレッションの種類 |
|---|---|---|
| 排他 | プレースメントは再販が有効ではなく、オークションはマネージド入札で落札されました | 保持 |
| 予約が満たされていません | プレースメントは再販可能で、オークションはマネージド入札で落札されました | 保持 |
| 販売 | プレースメントは再販可能で、オークションはサードパーティの入札で落札されました | 販売 |
| Psa | オークションには勝者がいなかったし、広告の代わりにPSAが表示された | Psa |
| 既定値 | オークションには勝者がいませんでした。広告の代わりに既定のクリエイティブが表示されました | 既定値 |
クイック リファレンス: オークション データをデバッグする
| データのデバッグ | 販売者と直接オークションで表示 | RTB 購入者に表示 |
|---|---|---|
| 広告プロファイル | はい | 不要 |
| 価格を尋ねる | はい | 不要 |
| オークション ID | はい | はい |
| 対象ユーザーターゲティング キャンペーン | はい | はい |
| Bid Request | はい | はい |
| Bidder hostport | はい | はい |
| Bidder バージョン | はい | はい |
| ブラウザー | はい | はい |
| キャリア | はい | はい |
| 市区町村 | はい | はい |
| 市区町村のインデックス | はい | はい |
| 国 | はい | はい |
| 国のインデックス | はい | はい |
| デバッグ レベル | はい | はい |
| デバッグ メンバー | はい | はい |
| 既定の可視性プロファイル | はい | 不要 |
| デバイスの作成 | はい | はい |
| デバイス モデル | はい | はい |
| デバイスの種類 | はい | はい |
| ドメイン ID | はい | はい |
| 推定平均価格 | はい | 不要 |
| 見積もりクリア価格 | はい | はい |
| 最終入札 | はい | はい |
| フォールド位置 | はい | はい |
| ギブアップ価格 | はい | 不要 |
| 時間 ID | はい | はい |
| インベントリ クラス - 非推奨 | -- | -- |
| インベントリ グループ - 非推奨 | -- | -- |
| インベントリ ソース - 非推奨 | -- | -- |
| インベントリ ソース ID - 非推奨 | -- | -- |
| IP | はい | はい |
| IP 切り捨て | はい | はい |
| 言語 | はい | はい |
| Latitude | はい | はい |
| Longitude | はい | はい |
| メディア サブタイプ | はい | はい |
| 純当選価格 | はい | はい |
| 対象ユーザー以外のターゲット 設定キャンペーン | はい | はい |
| タグの数 | はい | はい |
| UTC からのオフセット | はい | はい |
| オペレーティング システム | はい | はい |
| オペレーティング システム (拡張) | はい | はい |
| オペレーティング システム ファミリ | はい | はい |
| 支払いルール | はい | 不要 |
| 支払ルール ID | はい | 不要 |
| パフォーマンスの概要 | はい | はい |
| 学習を好む | はい | はい |
| 処理の優先順位 | はい | 不要 |
| パブリッシャー ID | はい | はい |
| QS データ | はい | はい |
| Querystring | はい | はい |
| リファラー | はい | はい |
| 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
ブラウザーで広告が表示される場合、構成は有効です。