インベントリ構造は、プログラムによって定期的に Xandr と同期する必要があります。
インベントリが適切に分類されておらず、ドメイン検出によって検出不能になった場合、インベントリのグループ化と分類が適切でないと、Xandr は サービス ポリシーの一部を確実に適用できないため、Xandr を介してインベントリを販売できなくなります。
UI を使用してインベントリ構造を同期し、API を使用してインベントリ構造ページを同期して、基本的な販売側オブジェクト階層を紹介し、Xandr UI または API を使用してこれらの Xandr オブジェクトに供給をマッピングするプロセスについて説明します。
インベントリ マッピング
Publisher、Placement Group、Placement オブジェクトには、一意の id と一意の code フィールドがあります。
idはオブジェクトの作成時に自動的に生成される整数ですが、codeでは、外部パートナーはidを特定のオブジェクトに関連付けることができます。 たとえば、発行元の'VeryCreativePublisherName'に8675309の ID と'123vcpubnname'のコードがある場合、site.publisher.id フィールドに'123vcpubnname'を渡すと、要求とトランザクション情報がシステムの参照シーケンスの発行元8675309に関連付けられます。
注:
[ code ] フィールドを使用して、入札要求をパブリッシャーとプレースメントにマップします。 [ code ] フィールドは、発行元レベルと配置レベルの両方のすべての外部販売者に必要です。 また、他のすべての販売者は、できるだけ細かい在庫を作成することを強くお勧めします。 これにより、特にドメインの検出可能性のために、品質の問題を正確に調査できます。 詳細と例については、「 入札要求 と 統合に関する FAQ」を参照してください。
[ code ] フィールドの要件:
- 同じ型の 2 つのオブジェクトに同じコードを含めることもできます。
- フィールドでは大文字と小文字が区別されます (例: 00071a ≠ 00071A)。
- フィールドは 100 文字に制限されています。
- 値にスペースを含めることはできません。
- 値にはピリオド (.)、アンダースコア (_)、ハイフン (-)、アスタリスク (*) を含めることができます。
参照シーケンス
要求を受け取ると、関連付けられている配置 ID を確認するためのチェックが行われます。 販売メンバー ID は、要求が送信されたエンドポイントのクエリ文字列から決定されます。 たとえば、「 https://Xample-useast.adnxs.com/openrtb2?member_id=1234 」のように入力します。
入札要求の例:
{
"imp":
[
{
"tagid": "8675309"
}
],
"site":
{
"id": "90210-8675309",
"publisher":
{
"id": "abc123xyz"
}
}
}
前の例の参照シーケンスの手順は次のとおりです。
-
bidrequest.imp.ext.appnexus.placement_idが存在しない場合は、手順 2 に進みます。 -
member_id"1234"の下の配置を、"8675309"のimp.tagid値と一致するcodeで確認します。 そのcodeに配置が存在する場合は、要求をこの配置 ID に関連付けます。member_idとcodeに一致する配置がない場合は、手順 3 に進みます。 -
member_id"1234"の下の配置を、"90210-8675309"のsite.id値と一致するcodeで確認します。 そのcodeに配置が存在する場合は、要求をこの配置 ID に関連付けます。member_idとcodeに一致する配置がない場合は、手順 4 に進みます。 -
member_id"1234"の下の発行元に、"abc123xyz"のsite.publisher.id値と一致するcodeを確認します。 そのcodeに配置が存在する場合は、要求をパブリッシャーの既定の配置 ID に関連付けます。 そうでない場合は、手順 5 に進みます。 -
member_id"1234"の既定の配置 ID を確認します。 見つかった場合は、この配置 ID に要求を関連付けます。 そうでない場合は、手順 6 に進みます。 - 参照シーケンスが使い果たされ、要求は破棄され、顧客に対するエラーは記録されません。
インベントリを調整する最適な方法は、手順 1 から 3 で配置を識別する際にルックアップ シーケンスが成功する方法です。 これにより次のことが可能です。
- Xandr とシステムの不一致を分析します。
- 発行元またはドメインのパフォーマンスを調べる。
- パブリッシャーをブロックするための広告品質基準と設定を実装して、Xandr から許容される入札を確保します。
- 検出可能な在庫と検出できない在庫を区別し、検出できない在庫が全体的な売上に与える影響を軽減します。