オープンRTB 2.4 ビッドレスポンスの仕様
入札依頼に対する回答は、以下のような構成でなければならない：
応答
| 属性 | 必要ですか？ | 説明 |
|---|---|---|
| アイドル | はい | このレスポンスの入札リクエストのID（文字列） |
| シートビッド | はい | 特定の座席（アレイ）を代表して入札者が行った入札の収集 |
**idはリクエストで提供されたものと一致しなければならない。
シートビッド
| 属性 | 必要ですか？ | 説明 |
|---|---|---|
| 入札 | はい | 対象となるインプレッションに関連する入札オブジェクトの配列。 |
シートビッド
| 属性 | 必要ですか？ | 説明 |
|---|---|---|
| アイドル | はい | トラッキングに使用される入札オブジェクトのID (文字列) |
| みにくい | はい | 関連する入札依頼のインプレッション・オブジェクトのID。 |
| 価格 | はい | CPMまたはCPCでの入札価格（フロート） |
| アド | はい | XML/JSON広告マークアップ（文字列） |
| ナール | はい | Win 通知 URL、nurl (文字列) には HTTPS 上の HTTP を使用することを推奨します。 |
| 梂 | いいえ | 課金通知URL、nurl (文字列)にはHTTPS上のHTTPを使用することをお勧めします。 |
| クリッド | おすすめ | 広告の品質チェックを支援するクリエイティブID（文字列） |
| アイウール | おすすめ | クリエイティブのURL |
| エクステンド | いいえ | ExoClick 固有の拡張機能 (オブジェクト) |
注：。
- バナーとインタースティシャルの両方で動画をサポートしています。
- impidはリクエストで提供されたものと一致しなければならない。
- admは、対象となる広告フォーマットに応じて、JSONまたはXMLで提供する必要があります：ネイティブ、インストリーム、プッシュ通知にはJSON、その他のフォーマットにはXMLを使用します。
- キャンペーンの上限を確実に設定し、毎回同じ応答を得ることを避けるために、nURLを通知する必要があります。
- bURLは、btypeフィールドからCPMまたはCPCに応じて、インプレッションまたはクリックが配信されたときに呼び出されます（デフォルトはCPM）。
シートビッド
| 属性 | 必要ですか？ | 説明 |
|---|---|---|
| btype | おすすめ | 価格設定モデル値：1 = cpm、2 = cpc。デフォルト = 1 (int)。レスポンスがEメールクリックゾーンリクエストの場合、1 = スマートCPC。 |
| 注：プッシュ通知、ネイティブ広告、ダイレクトリンク、メールクリックのみ、CPC価格モデルでの入札が可能です。 |
seatbid.bid.ext.dsa
| 属性 | 必要ですか？ | 説明 |
|---|---|---|
| 代理 | はい | 広告主の透明性：自由なUNICODEテキスト文字列。最大100文字。(文字列) |
| 支払い済み | はい | 広告主の透明性：誰が広告費を支払ったかを示す無料のUNICODEテキスト文字列。representative属性に記載されているものと同じであっても、必ず記載すること。最大100文字（文字列） |
| あたまをさげる | はい | 買い手/広告主がクリエイティブ内で独自のDSA透明性情報をレンダリングすることを示すフラグ。0 = 買い手/広告主はレンダリングしない、1 = 買い手/広告主はレンダリングする (int) |
シートビッド.ビッド.DSA.トランスペアレンシー
| 属性 | 必要ですか？ | 説明 |
|---|---|---|
| ドメイン | はい | ユーザーパラメータを適用したエンティティのドメイン (文字列) |
| パラメータ | はい | バイサイドが適用するユーザーパラメータのターゲティングの配列（DSA Transparency Taskforce が提供するリストを使用）。独自のユーザターゲティングパラメータを追加する可能性のある複数のベンダのサポートを含む。(int array) |
入札回答なし
実際の入札を行わずに入札リクエストに回答するには、HTTPレスポンスコード204「No Content」を送信する必要があります。
当選および課金通知URL
入札レスポンスに nURL または bURL が含まれ、有効な URL である場合、ExoClick プラットフォームはそれらに GET リクエストを送信します。これらの URL には、GET を実行する前に ExoClick が置き換えるいくつかのトークンを含めることができます：
${AUCTION_ID} - ID of the bid request; from "Bid Request Object -> id" attribute.
${AUCTION_BID_ID} - ID of the bid; from "Bid Response Object -> bidid" attribute.
${AUCTION_IMP_ID} - ID of the impression just won; from "Bid Request Object -> Impression Object -> id" attribute.
${AUCTION_SEAT_ID} - ID of the bidder seat for whom the bid was made; from "Bid Response Object -> Seat Bid Object -> Bid Object -> id" attribute.
${AUCTION_AD_ID} - ID of the ad markup the bidder wishes to serve; from "Bid Response Object -> Seat Bid Object -> Bid Object -> adid" attribute.
${AUCTION_PRICE} - Settlement price using the same currency and units as the account; from "Bid Response Object -> Seat Bid Object -> Bid Object -> price" attribute.
${AUCTION_CURRENCY} - The currency used in the bid (explicit or implied); for confirmation only.
例
https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}¤cy=${AUCTION_CURRENCY}
nURLとbURL**の両方を使用している場合、ExoClickはその両方に呼び出しを行います。
ADMの構造
広告フォーマットに応じて、adm パラメータには XML または JSON 形式が含まれます。adm 構造の詳細な例は、サンプルページ でご覧いただけます。
ADMを作成する際には、以下の点に留意してください：
- iFrameマークアップ（バナー、フルページ・インタースティシャル）を使用するには、ExoClickアカウントで有効にする必要があります。
- インストリーム、ネイティブおよびプッシュ通知広告は、admにJSONエンコードされた文字列を含める必要があります。
- In-Streamからのadmパラメータは、2つの構造のいずれかに従う： リモートVAST］または［ローカルVAST］です。リモートVASTでは、単純にVAST Wrapperが配置されているURLを宣言する必要があり、 一方、ローカルVASTでは、「videoURL」や「clickURL」に加えて、トラッキングしたい "trackingEvents " を宣言する必要があります。
現在、impression, progress, completeイベントをサポートしています。impressionとprogressイベントは必須ですが、completeはLocal VASTを使用している場合にのみ追加できます。
ADM は、上記の 例 に示されているのと同じ構造に従う必要があります。
オプションのパラメータとして、Native Ads admのJSON文字列にcrop_anchor_pointを含めることで、ネイティブ画像のアンカーポイントを決定することができます。使用可能な値は以下のとおりです：
- 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
これは、利用可能なアンカーポイントを視覚化したものである：
- また、ネイティブ広告に関しては、最新のネイティブ仕様に従ってイベントトラッカーを追加していることを確認してください。
ネイティブ広告ではインプトラッカーも許可していますが、代わりにイベントトラッカーを使用することを強くお勧めします。
- プッシュ通知広告では、1つの通知につき1つの画像アセットしか使用できません。幅と高さはリクエストに依存し、192x192または720x480になります。リクエストはNativeオブジェクトから来るので、admもJSONエンコードされた文字列でなければならないことに注意してください。
- 最後に、プッシュ通知広告は、1つの"imptracker "URLしか許可しません。
例
ビッドレスポンスとADM構造の詳細な例は、[広告主レスポンスの例]ページ(../open-rtb-advertiser-code-examples.md#open-rtb-advertiser-response)を参照してください。