Open RTB 2.4 入札レスポンス

入札リクエストへの応答は、次の構造である必要があります:

Bid Response Object

属性	必須?	説明
id	はい	これが応答となる入札リクエストのID（文字列）
seatbid	はい	特定のシートの代理として入札者が行った入札のコレクション（配列）

注: idはリクエストで指定されたものと一致する必要があります

seatbid

属性	必須?	説明
bid	はい	対象インプレッションに関連するbidオブジェクトの配列

seatbid.bid

属性	必須?	説明
id	はい	追跡用に使用されるbidオブジェクトのID（文字列）
impid	はい	関連する入札リクエスト内のインプレッションオブジェクトのID。
price	はい	CPMまたはCPCでの入札価格（浮動小数点数）
adm	はい	XML/JSON広告マークアップ（文字列）
nurl	はい	勝利通知URL。 HTTP nurlではHTTPSよりもHTTPの使用が推奨されます（文字列）
burl	いいえ	請求通知URL。 HTTP burlではHTTPSよりもHTTPの使用が推奨されます（文字列）
crid	推奨	広告品質チェックを支援するためのクリエイティブID（文字列）
iurl	推奨	クリエイティブのURL
ext	いいえ	ExoClick固有の拡張（オブジェクト）

注:

• バナーおよびインタースティシャルの両方の掲載枠で動画をサポートしています。
• impidは、リクエストで指定されたものと一致する必要があります。
• admは、対象の広告フォーマットに応じてJSONまたはXMLで提供する必要があります。Native、In-Stream、Push NotificationではJSON、それ以外のフォーマットではXMLです。
• キャンペーンの上限管理を確実にし、毎回同じ応答が返るのを避けるために、nURLは通知される必要があります。
• bURLは、btypeフィールドからのCPMまたはCPCに応じて、インプレッションまたはクリックが配信されたときに呼び出されます（デフォルトはCPM）。

seatbid.bid.ext

属性	必須?	説明
btype	推奨	価格モデル。値: 1 = CPM、2 = CPC。デフォルト = 1（整数）。応答がEmail Clicksゾーンのリクエストの場合、1 = Smart CPC。
		注: CPC価格モデルで入札できるのは、Push Notification、Native ads、Direct Link、Email Clicksのみです。

seatbid.bid.ext.dsa

属性	必須?	説明
behalf	はい	広告主透明性: 広告が誰の代理で表示されているかを示す自由なUNICODEテキスト文字列。最大100文字。（文字列）
paid	はい	広告主透明性: 広告費を支払った者を示す自由なUNICODEテキスト文字列。behalf属性と同じ内容であっても必ず含める必要があります。最大100文字（文字列）
adrender	はい	購入者/広告主がクリエイティブ内に独自のDSA透明性情報を表示することを示すフラグ。0 = 購入者/広告主は表示しない、1 = 購入者/広告主は表示する（整数）

seatbid.bid.dsa.transparency

属性	必須?	説明
domain	はい	ユーザーパラメータを適用したエンティティのドメイン（文字列）
params	はい	買い手側で適用されたユーザーパラメータターゲティングの配列（DSA Transparency Taskforceが提供するリストを使用）。独自のユーザーターゲティングパラメータを追加する複数ベンダーのサポートを含めます。（整数配列）

入札なし応答

実際の入札を行わずに入札リクエストへ応答するには、HTTPレスポンスコード204「No Content」を送信してください。

勝利通知および請求通知URL

もし nURL または bURL が入札応答に含まれており、有効なURLであれば、ExoClickプラットフォームはそれらにGETリクエストを送信します。 これらのURLには、GETを実行する前にExoClickによって置き換えられるいくつかのトークンを含めることができます:

${AUCTION_ID} - 入札リクエストのID。「Bid Request Object -> id」属性より。
${AUCTION_BID_ID} - 入札のID。「Bid Response Object -> bidid」属性より。
${AUCTION_IMP_ID} - ちょうど獲得したインプレッションのID。「Bid Request Object -> Impression Object -> id」属性より。
${AUCTION_SEAT_ID} - 入札が行われた入札者シートのID。「Bid Response Object -> Seat Bid Object -> Bid Object -> id」属性より。
${AUCTION_AD_ID} - 入札者が配信したい広告マークアップのID。「Bid Response Object -> Seat Bid Object -> Bid Object -> adid」属性より。
${AUCTION_PRICE} - アカウントと同じ通貨および単位を使用した決済価格。「Bid Response Object -> Seat Bid Object -> Bid Object -> price」属性より。
${AUCTION_CURRENCY} - 入札で使用された通貨（明示的または暗黙的）。確認用のみ。

例:

https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}

もし両方を使用する場合は nURL と bURL、ExoClickは両方に呼び出しを行います。

ADM構造

広告フォーマットによって、 adm パラメータにはXMLまたはJSONの一部を含めることができます。adm構造の詳細な例は、当社の 例ページ

ADMを作成する際は、次の点に留意してください:

• iFrameマークアップ （Banner、Fullpage Interstitial）は、それらを使用できるようにするために、ExoClickアカウントで有効にする必要があります。
• In-Stream、Native と Push Notification広告 はadm内にJSONエンコードされた文字列を含める必要があります。
• からのadmパラメータは In-Stream は次の2つの構造のいずれかに従うことができます: リモートVAST または ローカルVAST。リモートVASTでは、VAST Wrapperが配置されているURLを宣言するだけで済みますが、ローカルVASTでは、 "trackingEvents" に加えて追跡したい任意の項目を、"videoURL"および"clickURL"とともに宣言する必要があります。

現在サポートしているのは impression, progress と complete イベントです。impressionとprogressイベントは 必須であり、completeはLocal VASTを使用している場合にのみ追加できます。

ADMは 必ず 当社の 例 と同じ構造に従う必要があります。

• オプションのパラメータとして、 crop_anchor_point を Native Ads のadm内のJSON文字列に含めて、ネイティブ画像のアンカーポイントがどこにあるかを指定できます。利用可能な値は次のとおりです:

  • MIDDLE_CENTER = 0,
  • TOP_LEFT = 1,
  • TOP_CENTER = 2,
  • TOP_RIGHT = 3,
  • MIDDLE_LEFT = 4,
  • MIDDLE_RIGHT = 5,
  • BOTTOM_LEFT = 6,
  • BOTTOM_CENTER = 7,
  • BOTTOM_RIGHT= 8

利用可能なアンカーポイントの図は次のとおりです:

cropアンカーポイント

• また、 Native Adsに関しては、 eventtrackers を 最新のネイティブ仕様

に従って追加していることを確認してください。 imptrackers をNative Adsでも許可していますが、 eventtrackers の使用を強く推奨します。

• Push Notification 広告では、通知ごとに1つの画像アセットのみが許可されます。幅と高さはリクエストから取得される内容によって異なり、192x192または720x480のいずれかになります。リクエストはNativeオブジェクトから来るため、admもJSONエンコードされた文字列でなければならない点に注意してください。
• 最後に、 Push Notification 広告では1つの "imptracker" URL

例

Bid responseとADM構造の詳細な例は、当社の Advertiser Response example page