外部販売者のトラブルシューティング

[アーティクル]
02/23/2024

このページでは、外部販売者が直面する一般的な問題と、それらの問題の解決に役立つ手順について説明します。詳細については、「統合プロセスに関する FAQ」を参照してください。

取引のトラブルシューティング

特定の取引の配信不能が発生している場合は、次の手順を実行します。

取引が Xandr システムに存在することを確認します。取引サービスを使用して、取引が存在し、アクティブであり、正しい Xandr 購入者メンバーに提供されていることを確認します。取引を作成する方法の詳細については、「 Xandr での取引の販売」を参照してください。
この取引に対して要求が送信されていることを確認します。 Xandr deal オブジェクトのコードフィールドは、OpenRTB 要求 (pmp.deals.id) で送信される取引 ID と一致する必要があります。例については、「 Xandr での取引の販売」を参照してください。
この取引の要求は、一般的な仕様を満たし、システム内の有効でアクティブなオブジェクトを指す必要があります。 以下の「一般的な配信のトラブルシューティング」を参照してください。
買い手が取引をターゲットにしていることを確認します。

手順 1 ~ 3 を確認した場合、次のアクションは、購入者に連絡し、取引を積極的にターゲットにしていることを確認することです。その場合、購入者はカスタマーポータルからサポートチケットを送信し、購入側サポートチームがトラブルシューティングを行う必要があります。

一般的な配信のトラブルシューティング

最も一般的に、一般的な配信の問題は、特定のインベントリに対する需要の欠如を指しています。オープンマーケットプレースでの配信に関する問題が発生している場合は、在庫を収益化するために特定の購入者との取引を設定することを検討できます。また、Xandrオープンエクスチェンジで販売された供給は分析され、在庫が買い手にとって最も直接的で透明で効率的な購入パスを表していることを確認するために分析および審査されることに注意してください。これらの要件を満たしていないインプレッションは、RTB の販売には不適格ですが、取引を通じて販売される場合があります。これらの標準の詳細については、サプライパートナーのベストプラクティスに関するページを参照してください。取引の資格がない場合は、取引適格性要件に関するページを参照してください。

次の手順では、オープンマーケットプレースでの配信不能のトラブルシューティングについて説明します。

要求が Xandr 仕様に従って有効であることを確認します。

送信されるすべての要求は、Xandr OpenRTB 仕様に従う必要があります。
送信された要求に有効なサイト/アプリ ID と発行元 ID が含まれるようにします。

要求には、Xandr システムの既存の配置オブジェクトに対応するサイト ID (tagid、site.id) またはアプリ ID (app.id) が含まれている必要があります。これらの ID を含める場所の具体的な例については、Xandr OpenRTB 仕様を参照してください。要求で送信される ID は、配置オブジェクトの ID か、配置オブジェクトのフィールドに設定されたcode値のいずれかです。要求にサイト ID またはアプリ ID が含まれていない場合、または要求で送信された ID が Xandr システムに存在しない場合、要求は有効とは見なされません。パブリッシャーについても同様です。要求に含まれる ID は、Xandr システムの有効でアクティブな発行元にマップする必要があります。発行元 ID が要求に含まれていない場合でも、含まれているサイト/アプリは、システム内のアクティブな発行元とサイト (配置グループ) の下に存在する配置にマップする必要があります。オブジェクト階層の詳細と、インベントリマッピングに関する手順とベストプラクティスについては、「インベントリ構造の同期」を参照してください。次の API サービスを使用して、階層内の各オブジェクトがアクティブであり、要求で送信されたコードにマップされているかどうかをチェックします。
対応する配置が非アクティブになっていることを確認します。

在庫の品質に関連する理由により、当社のシステムによって配置が非アクティブ化される場合があります。要求で送信されたサイトまたはアプリ ID が非アクティブな配置にマップされている場合、この要求は有効ではなく、400 の形式の HTTP エラーを受け取ります。在庫品質の非アクティブ化の詳細については、「在庫品質の非アクティブ化」を参照してください。
サポートチケットを送信するように購入者に指示します。

上記の手順で問題が解決されず、インベントリで取引できない特定の購入者が関与している場合、次のアクションは、購入側サポートチームがトラブルシューティングを行えるように、購入者にカスタマーポータル経由でサポートチケットを送信してもらう方法です。

マルウェアまたはポリシー違反のエスカレーション

マルウェアまたはサービスポリシー違反に関するエスカレーションは、お客様ポータルのアンチマルバーティジングカテゴリの下にある、マルウェア対策チームに送信できます。このチームは、プラットフォームブロックリストの目的で問題のあるクリエイティブとドメインを確認できます。

ドメイン: エスカレーションに特定のドメインまたはドメインの一覧が含まれる場合は、ドメインにフラグを設定する理由と、該当する場合はサードパーティのスキャンベンダー ( The Media Trust や RiskIQ など) からのレポートを必ず含めます。
クリエイティブ: エスカレーションに特定のクリエイティブが含まれる場合は、次の 1 つ以上がサポートリクエストに含まれていることを確認します (重要度の高い順にここに記載されています)。
- 該当する場合は、サードパーティのスキャンベンダー ( The Media Trust や RiskIQ など) からの対応するレポート。
- クリエイティブ ID は、最終的なページコンテンツ (たとえば) または入札応答の crid パラメーターから取得されます。
- 次のいずれかの URL:
  - ib.adnxs.com/if?
  - ib.adnxs.com/click?
  - ib.adnxs.com/ab?
  - ib.adnxs.com/vevent?
- インシデント発生時にページに対して行われたネットワーク呼び出しの完全な一覧。

広告品質によって & エスカレーションがブロックされる

悪意のある要素を含まない、またはプラットフォーム購入ポリシーに違反しているクリエイティブは、ブランドの競合、互換性のないビデオなどの問題に対して、販売者全体または特定の発行元でブロックされる可能性があります。これらの広告品質ブロックは、主に OpenRTB を介して動的に処理されます。具体的には次のパラメーターを使用します。

badv: Xandr システムのブランド URL に対応する最上位の広告主ドメイン
bcat: コンテンツカテゴリ
btype: クリエイティブメディアの種類
battr: 技術属性

Xandr システムで特定のクリエイティブをブロックしたり、上記の広告品質設定を設定したりするには、広告プロファイルサービスを使用します。広告品質の使用に関するベストプラクティスについては、「広告品質ルールの定義」を参照してください。 Xandr システムで適用される設定は、OpenRTB 要求で動的に送信される設定と組み合わせて機能します。2 つの間の最も制限の厳しいブロックは常に適用されます。購入者のクリエイティブをプレビューするには、入札応答の iurl フィールドに存在する URL を使用します。

これらの広告品質設定を満たしていないクリエイティブ (OpenRTB 要求に渡されるか、広告プロファイルサービスで設定) を満たしていないクリエイティブがインベントリで配信されている場合は、カスタマーポータルのアンチマルバーティジングカテゴリの下で、アンチ マルバーティジングチームにエスカレートできます。

HTTP 応答

入札要求に対する予想される HTTP 応答を次に示します。

200 OK: 有効な入札応答が返されました。
204 コンテンツなし: 入札は返されていません。
400 MALFORMED: 受信入札要求には、Xandr システムの非アクティブな発行元または配置オブジェクトにマップされるサイト ID (tagid、site.id)、アプリ ID (app.id)、または発行元 ID (app.publisher、id、または site.publisher.id) が含まれています。詳細については、上記の「一般的な配信のトラブルシューティング手順 2 」を参照してください。

応答をまったく受け取っていない場合や、要求がタイムアウトしている場合は、チェック、初期統合中に指定されたグローバルオークションタイムアウト設定が正しいことを確認します。これらの設定が変更された場合、または最初に送信されたタイムアウト設定がわからない場合は、カスタマーポータルからサポートチケットを送信して、チームに正しい設定を確認して提供してください。

不一致

複数のシステムが広告予約に関与する場合は、これらのシステム間のレポートにある程度の不一致が予想されます。従来、業界標準では、最大 10% の不一致が合理的に許容されると見なされています。より大きな不一致が発生している場合は、次のいずれかのシナリオが根本原因である可能性があります。

キャッシュされた広告のタイムアウトの違い

外部販売者のインプレッションカウントは、Win 通知呼び出し (/ab、/it、/openrtb_win、/vast_track) を受け取るシステムに依存します。外部システムのタイムアウトの違いにより、インプレッション数の不一致が発生する可能性があります。 Xandr プラットフォームでは、各メディアの種類 (OpenRTB 要求によって生成されたオークションの時間を基準とする) のタイムアウトは次のとおりです。

バナー: 5 分
native: 360 分
ビデオ: 360 分

クリック追跡に関しては、同様のタイミングの違いによって不一致も考慮されます。クリック追跡 URL (/クリック) の有効期限は、ログに記録されたインプレッションの時間を基準にして 120 分です。このウィンドウの外部で発生したクリックはカウントされません。

さまざまなイベントの追跡

前述のように、Xandr は、インプレッションをカウントするために win 通知呼び出しに依存しています。表示の不一致は、外部システムが広告通話チェーンでこの通話の発生とは異なるタイミングでインプレッションを追跡している場合に発生する可能性があります (たとえば、クリエイティブレンダリングとクリエイティブコンテンツのページへの配信など)。

同様に、ビデオの不一致は、最も一般的に、印象をカウントするために使用される VAST 追跡イベントの違いが原因で発生します。 Xandr は、VAST ラッパーのインプレッション追跡 URL が発生したときに VAST インプレッションをカウントします。これは、IAB 仕様に従って、ビデオの最初のフレームがレンダリングされたらプレイヤーから送信されます。外部システムが広告コンテンツの配信、開始イベント、またはその他の VAST 追跡イベントに関するインプレッションを追跡している場合、このシステムに記録されたインプレッション数は Xandr によって記録されたものと一緒に並び合わない可能性があります。

オークション価格マクロの不適切な処理

OpenRTB 仕様に示すように、外部システムからのオークション価格はマクロ ${AUCTION_PRICE}を使用して Xandr に渡されます。このマクロが有効な勝ち価格で満たされていない場合、システムはこの価格を記録できず、財務上の不一致につながる可能性があります。

在庫品質の非アクティブ化

インベントリの品質に関連する理由で配置オブジェクトが非アクティブ化されると、オブジェクト ID や非アクティブ化の理由を含む通知が、メンバーサービスのフィールドでaudit_notify_email指定された電子メールに送信されます。

/ab URL を読み込むクリエイティブスキャンを使用していて、これらのスキャナーエンドポイントがインベントリ品質の非アクティブ化を引き起こしている場合は、これらのエンドポイントからの /ab URL の各呼び出しにヘッダー "X-is-test: 1" が含まれていることを確認します。このヘッダーは、/ab URL への対応する呼び出しがテストであることを示し、システムがログに記録できないようにします。このヘッダーに関する問題が解決しない場合は、スキャナーのエンドポイントが DNS 名に解決されることを確認します。DNS 名に解決されない IP を使用すると、テストヘッダーが使用されているかどうかに関係なく非アクティブ化が発生します。

注:

test=1 クエリ文字列パラメーター (テスト要求に使用) は、/ab URL では機能しません。

オブジェクトの制限

現在のオブジェクト制限を表示するには、オブジェクト制限サービスを使用します。アクティブなオブジェクトと非アクティブなオブジェクトの両方が、オブジェクトの制限カウントにカウントされます。オブジェクト制限通知は、メンバーサービスの下のフィールドでsherlock_notify_email指定された電子メールに送信されます。オブジェクトの制限に近い場合は、削除されたオブジェクトがこの制限に対してカウントされないため、対応する API サービスを使用して未使用のオブジェクトを削除できます。

予期しない動作

ドキュメントや仕様に沿わない動作が発生している場合は、問題や再現手順を示す関連ログを含むカスタマーポータルからサポートチケットを送信してください。

次の方法で共有