> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/ja/guang-gao-zhu/open-rtb/adv-open-rtb-2.4-response.md).

# Open RTB 2.4 Bidレスポンス

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

## Bid Response Object

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

{% hint style="info" %}
**注:** idはリクエストで指定されたものと一致する必要があります
{% endhint %}

### 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固有の拡張（オブジェクト）                               |

{% hint style="info" %}
**注:**

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

### 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構造の詳細な例は、当社の [**例ページ**](/rtb/ja/guang-gao-zhu/open-rtb/open-rtb-advertiser-code-examples.md)

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は **必ず** 当社の [例](/rtb/ja/guang-gao-zhu/open-rtb/open-rtb-advertiser-code-examples.md) と同じ構造に従う必要があります。

* オプションのパラメータとして、 **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アンカーポイント](/files/6814b49969365cacf2257dc081dbab0c918dd442)

* また、 **Native Ads**に関しては、 **eventtrackers** を [最新のネイティブ仕様](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf)

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

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

## 例

Bid responseとADM構造の詳細な例は、当社の [Advertiser Response example page](/rtb/ja/guang-gao-zhu/open-rtb/open-rtb-advertiser-code-examples.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/rtb/ja/guang-gao-zhu/open-rtb/adv-open-rtb-2.4-response.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.