統合プロセス

このドキュメントには、供給パートナーが新しい OpenRTB 統合を確認、計画、実行したり、カスタム SSP プロトコル統合から OpenRTB 標準にマイペースで移行したりするために必要な情報が含まれています。

前提条件のチェックリスト

1. 次の情報を確認するには、アカウント マネージャーにお問い合わせください (または、サポート チームとチケットを開きます)。
   • メンバー シート ID と、まだ要求されていない場合は、Xandr の API の新しいメンバー シートの作成と API ログイン資格情報。
   • 受信入札要求のエンドポイント。まだ要求されていない場合は、Xandr での新しいエンドポイントの作成。
2. 以下に記載されているドキュメントを確認し、開いている質問について説明します。
   • OpenRTB 仕様
   • FAQ - 統合プロセス
   • オブジェクト階層
   • インベントリ マッピング
   • ユーザー同期
   • /App-Ads.txtのAds.txt
   • 取引 (該当する場合)

• エンゲージメントには 3 ~ 4 週間かかると予想されます。
• クライアントは前提条件チェックリスト (このドキュメント) を完全に確認し、以下の手順に従う前にすべての情報を収集する必要があります。

手順 1: セルフガイド付き API/UI トレーニングと発行元と配置オブジェクトの作成 (推定時間: 7 日から 10 日)

1. Xandr オブジェクト階層 と API/UI のドキュメントを参照してください。

2. 最初のテストに必要なオブジェクトを、 または API を介してプロビジョニングします。 詳細については 、「API ドキュメント」を 参照してください。

3. UI/API を使用してインベントリを同期する販売側オブジェクトを作成する (少なくとも初期機能テストに必要なもの)

   • Xandr オブジェクト階層を確認する: メンバー → Publisher → Placement Group → Placement
   • テストの発行元と配置を作成する
     • 各オブジェクト内で、SSP が 入札要求で渡す外部識別子をコード値に設定する必要があります。
   • 関連する API ドキュメント
     • メンバー サービス
     • Publisher Service
     • 配置グループ サービス (サイト サービス)
     • Placement Service

4. パブリッシャー レベルとメンバー レベルで既定の配置を設定します。 (入札リクエストから広告枠を特定できない場合、インプレッションはその既定の配置にログインされます)。

5. フィールドを code 使用して、入札要求を発行元とプレースメントにマップします。 詳細と例については、「統合に関する FAQ」を参照してください。

   注:

   購入者に透明性を提供し、最適化を改善するために、パートナーはパブリッシャーによる在庫を分割する必要があります。 インベントリ構造標準の詳細については、Wiki ページ「 API を使用してインベントリ構造を同期する」を参照してください。

6. パブリッシャー サービスを使用して、インベントリにマップされるパブリッシャーを作成します。

   注:

   • この code フィールドは、発行元と配置レベルの両方のすべての外部販売者に必要であり、品質の問題、特にドメイン検出可能性のために正確に調査できるように、他のすべての販売者に対して可能な限り詳細な在庫を確保することを強くお勧めします。 この手順は、インベントリを非常に検出可能で検出しにくいタグに分割するのに役立ちます。これにより、検出できないドメインがインベントリの残りの実行可能性に与える影響を分離できます。
   • または API でパブリッシャーを作成または編集するには、 インベントリリレーションシップを宣言する必要があります。 要求された情報は、インベントリへのアクセス方法に関する基本的なビジネス情報であり、Xandr の在庫品質の取り組みをサポートするために使用されます。 フィールドとその使用要件の完全な一覧については、 Publisher Service のドキュメントを参照してください。

7. ユーザー同期のセットアップ
   getUID サービスを使用して、Xandr と yours の間にユーザー マッピング テーブルを格納します。 詳細については、「 ユーザー ID マッピング」を参照してください。

手順 2: OpenRTB 入札要求エンドポイント テスト (推定時間: 3 日から 4 日)

Xandr では、すべてのメディア タイプのインプレッションを受信するための OpenRTB 2.4 プロトコルがサポートされています。 IAB の OpenRTB 2.4 仕様に従ってください。

サーバー間 OpenRTB 入札要求を Xandr に送信するには、次のエンドポイントを使用します。

• http://MEMBER_ALIAS-useast..com/openrtb2member_id=MEMBER_ID&test=1
• http://MEMBER_ALIAS-uswest..com/openrtb2member_id=MEMBER_ID&test=1
• http://MEMBER_ALIAS-emea..com/openrtb2?member_id=MEMBER_ID&test=1
• http://MEMBER_ALIAS-apac..com/openrtb2?member_id=MEMBER_ID&test=1

SSP からの入札要求の受信ページの入札要求の例を自由に使用し、発行元とプレースメントの在庫マッピングに合わせてコード フィールドを調整してください。

テストインプレッションを識別するには、 "test=1" 呼び出しでクエリ文字列パラメーターを使用する必要があります。 レポートにはログインされません。

手順 3: 手動テスト

1. Xandr に入札要求のサンプルを指定します。

2. Xandr プラットフォームで テスト 配置を設定し、インベントリが正しくマップされていることを確認します。

3. テスト配置のすべての要件を満たすサンプル クリエイティブを提供します。

4. Xandr テスト 購入者のみがテストプレースメントでインプレッションを購入できるようにする広告品質ルールを設定します。

5. テストの開始時にエンドポイント クエリ文字列から削除 "&test=1" します。

   注:

   を削除 "&test=1"しない場合、imps は Xandr 側ではログに記録 されません 。

6. テスト配置からトラフィックを手動で起動して、入札応答の受信、クリエイティブの配信、および自分の側でログに記録されたインプレッションを確認します。

7. Xandr は、専用の購入側メンバー シートから配信テストを実行し、インベントリをさらにスケーリングする前に不一致を通知します。

8. Xandr は OpenRTB の入札要求を検証し、形式を修正する必要がある場合に通知します。  

手順 4: プログラムによる機能テスト (ライブ トラフィック)

1. 確立された エンドポイント (少なくとも 1 日あたり数千の imps) で Xandr へのトラフィックのごく一部を開きます。 Xandr は、送信されるトラフィックの量を確認し、インプレッションがレポートに流れ込み、内部レポートと一致していることを確認します。
2. 1 日ほどテストを実行し、数値を比較して、レポートと Xandr レポートの不一致が許容されることを確認します。

手順 5: ライブに移動する

1. 100% トラフィックで稼働する前に、Xandr プラットフォーム上のすべてのインベントリをマップします。
2. 在庫マッピングが完了したら、トラフィックを増やし、国の事前ターゲティング、デバイスの事前ターゲット設定、入札量の調整など、テスト中に適用される可能性があるフィルターを削除します。

手順 6: 完了/フォローアップ (推定時間: 2 日から 3 日)

インベントリの個別の部分が Xandr に送信されている場合は、トラフィックが段階的に増加することをお勧めします。 一般的な推奨事項は、トラフィックの小さなチャンク (100 から 200 QPS) から開始することです。

マイペースの統合/移行の完了について Xandr 連絡先に通知します。連絡先は最終的な OpenRTB 要件検証テストを開始し、最終的な結果とフィードバックを提供します。