次の方法で共有

保証された結果の入札者統合ガイド

  • [アーティクル]

このページでは、Xandr によって Bidder が入札を行い、結果 (表示および/または完了) と一般的な配信インプレッションに対して課金される方法を定義する仕様について説明します。 さらに、異なる購入者は"表示可能な印象"を構成するものに対して異なる基準を持っているため、仕様は、さまざまな定義 (IAB と GroupM など) と異なる測定テクノロジ ベンダー (DoubleVerify など) を含むさまざまな標準をサポートするように設計されています。 将来的には、仕様を使用して、追加のトランザクション イベント (デモの印象など) をサポートすることもできます。

詳細については、「 保証された結果」を参照してください。

実装

大まかに言うと、実装に対するアプローチは、OpenRTB 仕様 2.4、セクション 7.2 から、OpenRTB 仕様で"課金通知" として説明されているものに従います。

"しかし、オークションに勝つことは、広告が正常にクライアントに配信されること、または広告が正常に配信されることを保証するものではありませんか? は、視認性の期待に応えます。 さらに、ポリシーは、請求の基準に関して交換によって異なります。 ほとんどの場合、何らかの形式の配信またはレンダリング時に課金される広告と、オークションでの勝利のみを考慮します。 これは、支払うインプレッションが実際に表示されるようにするというバイヤーの明らかな目標と一致します。概念を抽象化するために、インプレッションのクリアリング価格が支出として予約される時点での通知 URL の発生として、"課金通知" を参照します。 これは、実際の OpenRTB Win 通知 URL が起動のためにクライアントに委任されているか、他の追跡 URL が使用されているかどうかに関係なく行われます。

課金通知の概念は、OpenRTB 仕様 2.5 でさらに開発されました。 セクション 4.2.3 からの関連コンテンツの強調表示。

ベスト プラクティス: 当選通知の重要な機能は、入札者にオークションに落札したことを通知することです。 広告配信、クリエイティブな視認性、請求可能性を意味するものではありません。 取引所は、入札者、イベントトリガー、課金ポリシー、および勝利通知に添付するその他の意味に公開することを強くお勧めします。

ベスト プラクティス: 請求通知の発砲は、交換人と入札者の間の不一致を最小限に抑えるために、サーバー側で、可能な限り Exchange 書籍の収益に対して "近い" ようにする必要があります。

プロトコルの概要

入札と購入の結果を有効にするために必要なコンポーネントの概要は次のとおりです。

入札要求

Xandr は、入札要求で、結果ベースの入札を受け入れること、どの結果 (ビューまたは完了) を受け入れるか、および取引所が順位付けに eCPM 値を生成するために使用するレートを示します。

入札応答

Bidder は、入札が結果ベースの入札であることを示し、結果 (payment_type) を指定し、結果ベースの入札価格 (ビューの場合は vCPM、完了の場合は CPCV) を指定し、課金通知 URL を指定します。

Win notify

Xandr は、落札が結果に対する入札であることを示し、結果を指定し、広告が配信後に望ましい結果を達成した場合に入札者に請求される、当選した結果に基づく価格を見積もります。 この時点で、入札者はオークションに落札したことを通知され、インプレッションが配信されたことが通知されますが、結果が確認されるまで課金されません。

課金通知

クリエイティブが配信され、Xandr が目的の結果が発生したことを示す肯定的なシグナルを受け取った後、Xandr は請求通知 URL を呼び出して結果が発生したことを示し、Bidder に勝った結果ベースの価格が課金されます。

仕様

入札要求

Impression AppNexus オブジェクト

Xandr では、 オブジェクトの拡張オブジェクトで appnexus 次のフィールドが imp サポートされています。

フィールド 種類 説明
allowed_payment_types オブジェクトの配列 このインプレッションに対して許容される支払いの種類を指定します。 このフィールドが存在しない場合、許可される支払の種類は 'impression'のみです。

許可される支払タイプ オブジェクト

Xandr では、インプレッション ext オブジェクトのオブジェクトでallowed_payment_type次のフィールドがサポートされています。

フィールド 種類 説明
payment_type integer このインプレッションで許容される支払いタイプの ID を指定します。 以下の「 現在サポートされている支払いの種類 」を参照してください。
conversion_rate double 省略可能です。 Xandr が結果ベースの入札をオークションの順位付けにインプレッションベースの eCPM 価格に変換するために使用するレートを指定します。 Bidder は、内部入札の順位付けや予算設定/ペーシングにこれを使用できます。

現在サポートされている支払いの種類

ID 説明 入札の種類
1 印象 インプレッション 単価
2 ビュー - 標準表示 vCPM
6 ビュー - カスタム ディスプレイ - 100pv1s vCPM
8 ビュー - 標準ビデオ vCPM
9 ビュー - カスタム ビデオ - 100pv50pd vCPM
10 Complete – Standard Video CPCV

入札応答

Bid オブジェクト

フィールド 種類 説明
price 浮動小数点数 (必須)CPM で表された入札価格。
が bid_payment_type 省略されるか、または 'インプレッション' に設定されている場合、価格はオークションで使用され、マクロが設定されます ${AUCTION_PRICE} 。
がインプレッション以外の bid_payment_type 場合は、価格を設定する必要があります。ただし、フィールドはオークションで使用され、 payment_type_price マクロを ${AUCTION_PRICE} 設定するために使用されます。
nurl string win 通知 URL。 Xandr サーバーは、デバイスからクライアント側の通知を受信すると、この URL を呼び出します。これは、Xandr がオークションに勝ったことを示します。 これは、Xandr がインプレッションを記録するのと同時に発生し、Bidder が配信されたインプレッションも記録する必要がある場合です。

注: Win 通知はトランザクションを示すものではありません。インプレッションが配信されただけです。 課金通知によってトランザクションが通知されます。
HTTPS として送信された Win 通知 URL はサポートされず、HTTP 要求として扱われます。

通知 URL では、次のマクロがサポートされています。
${AUCTION_ID} - Xandr auction_id_64
${AUCTION_BID_ID} - 入札応答のフィールドで bidid 指定された入札の ID
${AUCTION_IMP_ID}- オブジェクトのオブジェクト内bidのimpidフィールドからのインプレッションの seatbid ID
${AUCTION_SEAT_ID} - オブジェクト内のフィールドからの seat 当選シートの seatbid ID
${AUCTION_AD_ID} - 購入者のクリエイティブの ID。オブジェクトの adid オブジェクト内 bid の seatbid フィールドから
${AUCTION_PRICE} - 入札応答のフィールドで指定された通貨での cur インプレッションのクリア価格。 が存在し、インプレッション以外の場合 bid_payment_type は、 AUCTION_PRICE 課金通知が呼び出された場合にのみ支払われる価格が反映されます。
${AUCTION_CURRENCY} - 入札応答のフィールドで cur 指定された決済価格の通貨
${CREATIVE_CODE}code- クリエイティブをcreative登録するときに API を介してオブジェクトに設定されたフィールド
${AN_PAYMENT_TYPE}payment_type- 入札応答のフィールドでbid_payment_type指定された入札の
burl string 課金通知 URL。 Xandr サーバーは、インプレッションが課金可能であると判断すると、この URL を呼び出します。 このイベントは、Xandr がインプレッションの購入者コストを記録すると同時に発生します。 この時点で、Bidder はコストを発生させ、トランザクションを記録する必要があります。
課金通知 URL は、インプレッション以外を指定 bid_payment_type した入札にのみ関連します。

HTTPS として送信された課金通知 URL はサポートされず、HTTP 要求として扱われます。

課金通知 URL では、次のマクロがサポートされています。
${AUCTION_ID} - Xandr auction_id_64
${AUCTION_BID_ID} - 入札応答のフィールドで bidid 指定された入札の ID
${AUCTION_IMP_ID}- オブジェクトのオブジェクト内bidのimpidフィールドからのインプレッションの seatbid ID
${AUCTION_SEAT_ID} - オブジェクト内のフィールドからの seat 当選シートの seatbid ID
${AUCTION_AD_ID}- オブジェクトのオブジェクト内bidのフィールドからadid購入者のクリエイティブの seatbid ID
${AUCTION_PRICE} - 入札応答の payment_type フィールドで bid_payment_type 指定された 、入札応答のフィールドで指定された通貨での cur 決済価格。
${AUCTION_CURRENCY} - 入札応答のフィールドで cur 指定された決済価格の通貨
${CREATIVE_CODE}code- クリエイティブをcreative登録するときに API を介してオブジェクトに設定されたフィールド
${AN_PAYMENT_TYPE}payment_type- 入札応答のフィールドでbid_payment_type指定された入札の

入札応答 AppNexus オブジェクト

Xandr では、bid オブジェクトの拡張オブジェクトで appnexus 次のフィールドがサポートされています。

フィールド 種類 説明
bid_payment_type object 保証された結果の入札を送信するために必要です。 Bidder が入札する支払いの種類を指定します。 省略した場合、Xandr は標準インプレッションの入札であると見なします。

入札支払いタイプ オブジェクト

Xandr では、入札応答extオブジェクトのオブジェクトでbid_payment_type次のフィールドがサポートされています。

フィールド 種類 説明
payment_type integer Bidder が入札を行い、課金される支払いの種類を指定します。 支払いの種類が でない 'impression'場合は、bid オブジェクトに課金通知 URL を設定する必要があります。 以下の「 入札支払いタイプ オブジェクトで現在サポートされている値 」を参照してください。
price double 支払いタイプの入札価格を指定します(下記の「現在サポートされている入札金額」オブジェクトの「 入札タイプ」を参照)。
たとえば、 が 2 ('Views - Standard Display') price に設定されている場合payment_type、vCPM 値として解釈されます。 また、IAB 定義と Xandr 視認性測定スクリプトに従って、クリエイティブが提供され、測定された表示可能な場合にのみ発生する最大料金です。

注: インプレッション以外の支払いタイプでは、USD の入札のみがサポートされます。

入札支払いタイプ オブジェクトで現在サポートされている値

ID 説明 入札の種類
1 印象 インプレッション 単価
2 ビュー - 標準表示 vCPM
6 ビュー - カスタム ディスプレイ - 100pv1s vCPM
8 ビュー - 標準ビデオ vCPM
9 ビュー - カスタム ビデオ - 100pv50pd vCPM
10 Complete – Standard Video CPCV