次の方法で共有

リアルタイム統合 (コンテキスト データ プロバイダー)

コンテキスト データ プロバイダーの場合、データはインベントリに直接関連します。 これには、参照元 URL に基づいてブランドの安全性と分類データに関する情報を取得するために、インプレッションごとにデータ プロバイダーにリアルタイム要求を行う必要があります。 リファラー URL がオークションのために (サーバー側でインベントリ パートナーまたは HTTP ヘッダーで) 渡されると、"ニュース" などのページの分類に対応するカテゴリ ("セグメント" と呼ばれます) で応答するコンテキスト データ プロバイダーに渡されます。

また、「リアルタイムのData Integration手順」も参照してください。

プロセス

リアルタイム データ プロバイダー統合の図。

  1. インプレッション は、ページ上の配置タグまたはサプライ パートナーからのサーバー側の呼び出しを介してインプレッション バスに送信されます。 インプレッションには、HTTP ヘッダー内、クエリ文字列パラメーター、または配置のdefault_referrer_urlから参照元 URL が必要です (ドメイン/URL の可視性が "非表示" に設定されている場合)。

  2. ユーザー データは、ユーザーのブラウザー Cookie の UID を検索のキーとして使用して、サーバー側の Cookie ストアで検索されます。

  3. ユーザー データは、サーバー側の Cookie ストアによって返されます。 このデータは、セグメント データと自由形式のユーザー データ JSON としてオークションに添付されます。

  4. 参照元 URL がある場合、クエリ文字列パラメーターとして参照元 URL を含むコンテキスト データ プロバイダーに要求が送信されます。

  5. データ プロバイダーは、ページの分類に対応するセグメント コードの改行区切りリスト (セグメント サービスのコード フィールドを参照) を返します。 これらの分類は、セグメント データとしてオークションに添付されます。

    1. 参照元 URL に分類をマップできない場合は、改行文字を含む空白の応答を返す必要があります。

  6. 入札要求は、UI だけでなく、他の DSP や Bidder に送信されます。 オークション データには、入札者またはその入札者に関連付けられているメンバーがそれらのセグメントにアクセスできる場合にのみ、特定のデータ プロバイダーに関連付けられたセグメントが含まれます。

    ヒント

    リアルタイムと動作セグメント

    リアルタイム (コンテキスト) セグメントと動作セグメントの重要な違いは、リアルタイム データ プロバイダーによって返されるリアルタイム セグメントは、インプレッションの有効期間中にのみ存在し、ユーザー セグメントのメンバーシップには影響を与えないということです。 動作セグメントはユーザーに関連付けられます。ユーザーがそのセグメントに関連付けられている限り存在します。

  7. DSP と Bidders は、各オークションに対する応答 (入札または参加を希望しないことを示す) を返します。

  8. 最後に、Xandr が最終的な意思決定者であるオークションでは、受賞したクリエイティブがユーザーのブラウザーに返されます。 サプライ パートナーからサーバー側の呼び出しを介してインプレッションを受け取った場合、獲得したクリエイティブと入札は、別のオークションに参加するためにそのサプライ パートナーに返されます。

技術的な詳細

インプレッション バスにインプレッションが入ると、使用可能なデータ プロバイダー インスタンスに HTTP GET 要求が送信され、マクロが Bidder サービスで構成されたパラメーターにbid_uri追加されます。 データ プロバイダー インスタンスは、新しい行 (\n) で区切られたセグメント コードの一覧 (セグメント ID ではなく、セグメント コードのみが受け入れられます) で応答する必要があります。 データ プロバイダー要求の現在のタイムアウト間隔は 10 ミリ秒です。

ヒント

に追加 bid_uriできる Xandr マクロの完全な一覧については、「 データ プロバイダーの Xandr マクロ」を参照してください。

要求と応答の例

要求

GET /data_provider/get_categories?url=http://www.mikeonads.com/2009/10/18/rtb-serving-speed/

応答

brand_safety_safe
brand_safety_not_adserver
brand_safety_general_audience
cat_computers
cat_real_time_bidding
cat_technology

セットアップ

リアルタイム統合を持つデータ プロバイダーは、実際に入札を行っていない場合でも、"bidders" として実装されます。 各データ センターに bidder インスタンスを 設定し、インプレッション バスと直接対話します。 この統合方法を使用する各データ プロバイダーには、入札者に関連付けられた 1 つのメンバーが必要であり、セグメントはメンバー内に配置されます。 メンバーを構成し、Xandr で技術的な連絡先に最初に相談せずにこれを変更しないことをお勧めします。

タイムアウト期間は 10 ミリ秒と短く、インプレッション バスから直接要求を受信するため、要求を表示する各データ センターに bidder インスタンスを登録する必要があります。

その他の考慮事項

  • データ プロバイダー フェーズは 10 ミリ秒です。つまり、すべてのデータ プロバイダーは、10 ミリ秒以下で何らかの分類で応答する必要があります。
  • データ プロバイダーは、インプレッションを処理するのと同じデータ センターで操作中のインスタンスがある場合にのみ呼び出されます。 たとえば、アムステルダム のデータ センターに印象があり、データ プロバイダーがニューヨークと LA のデータ センターにインスタンスを持っている場合、分類の要求は受け取りません。
  • 必要な応答時間が 10 ミリ秒以下である場合、リアルタイム データ プロバイダーは、待機時間を短縮し、応答時間が 10 ミリ秒以下になるように、Xandr で使用されるデータ センター内での併置を検討する必要があります。
  • リアルタイム データ プロバイダーの統合は、通常、完了するまでに数か月かかります。 将来のデータ プロバイダーは、Xandr との統合を開始する前に、そのことを考慮することをお勧めします。
  • インスタンスと受信した要求を管理するために、データ プロバイダーはインプレッション バス API で bidder、bidder インスタンス、プロファイル サービスを使用できます。