> 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.5-request.md).

# Open RTB 2.5 Bidリクエスト

このページでは、入札を行うために受け取る RTB リクエストのさまざまな構成要素について説明します。

## 入札リクエストヘッダー

* **OpenRTBバージョンのHTTPヘッダー:** x-openrtb-version: 2.5
* **Keep-Alive HTTPヘッダー:** Connection: Keep-Alive
* **コンテンツ JSON: Content-Type:** application/json
* **データエンコーディングヘッダー:** Accept-Encoding

## 入札リクエスト 2.5

特定のコンテキストで入札を要求する場合、プラットフォームはタイムアウト **300ms** で HTTP リクエストを実行し、次のオブジェクトを JSON としてエンコードしてリクエスト本文に送信します。 **HTTP** HTTPS を使用すると追加の遅延が発生するため推奨されます。

| 属性     | 説明                                             |
| ------ | ---------------------------------------------- |
| id     | 一意の入札リクエストID（string）                           |
| site   | 配信者のWebサイトに関する Site オブジェクトを通じた詳細（オブジェクト）       |
| device | インプレッションが配信されるユーザーのデバイスの詳細（オブジェクト）             |
| user   | デバイスを利用する人間のユーザー、つまり広告の対象となるオーディエンスの詳細（オブジェクト） |
| imp    | オークションにかけられる広告枠またはインプレッションの詳細（オブジェクト）          |
| regs   | このリクエストに適用される業界・法令・政府規制の詳細（オブジェクト）             |
| ext    | OpenRTB 拡張用のプレースホルダー（オブジェクト）                   |

## site

| 属性       | 説明                                                                 |
| -------- | ------------------------------------------------------------------ |
| id       | 一意の Site ID（string）                                                |
| domain   | サイトのドメイン名（string）                                                  |
| cat      | IAB カテゴリ ID（文字列配列）                                                 |
| page     | 広告が表示されるページの完全な URL（string）                                        |
| keywords | キーワードを使用すると、広告ゾーンに適切な種類の広告を表示させることができます。キーワードはカンマ区切りの単語列である必要があります |
| ext      | 取引所固有の拡張のためのプレースホルダー（object）                                       |

### site.ext

| 属性          | 説明                              |
| ----------- | ------------------------------- |
| exchangecat | カスタム ExoClick カテゴリ ID（integer）  |
| idzone      | カスタム ExoClick 広告ゾーン ID（integer） |
| keyword     | 一致するキーワードがある場合（string）          |

## device

| 属性       | 説明                                                                            |
| -------- | ----------------------------------------------------------------------------- |
| ua       | ブラウザーのユーザーエージェント（string）                                                      |
| sua      | 構造化されたユーザーエージェント情報。クライアントが User-Agent Client Hints をサポートしている場合に使用できます（object） |
| geo      | Geo オブジェクトで定義される、ユーザーの現在位置と見なされるデバイスの所在地                                      |
| ip       | ユーザーのIPv4アドレス（文字列）\*                                                          |
| ipv6     | ユーザーの IPv6 アドレス（string）\*                                                     |
| language | ブラウザの言語（文字列）                                                                  |
| os       | オペレーティングシステム（string）                                                          |
| js       | JavaScript のサポート。0 = いいえ、1 = はい（integer）                                      |
| ext      | OpenRTBへの交換事業者固有の拡張のためのプレースホルダー（オブジェクト）                                       |

\*入札リクエストには ip または ipv6 のどちらか一方のみが含まれます。

### device.geo

| 属性        | 説明                                                    |
| --------- | ----------------------------------------------------- |
| country   | 国の ISO3 コード                                           |
| ipservice | 必要に応じて IP アドレスからジオロケーションを特定するために使用するサービスまたはプロバイダー（整数） |

### device.ext

| 属性                | 説明                                             |
| ----------------- | ---------------------------------------------- |
| remote\_addr      | ユーザーのメイン IP アドレス（string）                       |
| x\_forwarded\_for | ユーザーの X-FORWARDED-FOR IP アドレス。未設定の場合は空（string） |

### device.sua

構造化された User Agent 情報。 `device.sua` デバイス属性をより正確に表すものと見なされます。

| 属性           | 説明                                                                                                                                                                                                 |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| browsers     | Sec-CH-UA-Full-Version-List ヘッダーから取得したブランドとバージョンを送信します。（ `BrandVersion` オブジェクトの配列）                                                                                                                 |
| platform     | Sec-CH-UA-Platform ヘッダーから取得したブランドと、Sec-CH-UA-Platform-Version ヘッダーから取得したバージョンを送信します。(`BrandVersion` オブジェクト）                                                                                        |
| mobile       | この値は Sec-CH-UA-Mobile ヘッダーから取得します。（integer）                                                                                                                                                        |
| architecture | この値は Sec-CH-UA-Arch ヘッダーから取得します。（string）                                                                                                                                                           |
| bitness      | この値は Sec-CH-UA-Bitness ヘッダーから取得します。（string）                                                                                                                                                        |
| model        | この値は Sec-CH-UA-Model ヘッダーから取得します。（string）                                                                                                                                                          |
| source       | このオブジェクトの作成に使用されたデータのソース、 [一覧: User-Agent ソース](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) AdCOM 1.0 の中で（integer; デフォルト 0） |

### device.sua.browsers | device.sua.platform

| 属性      | 説明                                                                                                                                                         |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| brand   | この値は User-Agent Client Hints ヘッダーから取得される場合があり、ユーザーエージェントのブランド（Sec-CH-UA-Full-Version ヘッダー由来）またはプラットフォームのブランド（Sec-CH-UA-Platform ヘッダー由来）のいずれかを表します。（string） |
| version | バージョン要素の並び。階層の降順 \[major, minor, micro, …]（文字列配列）                                                                                                          |

## user

| 属性 | 説明                 |
| -- | ------------------ |
| id | 一意のユーザー ID（string） |

### user.ext

| 属性      | 説明                                        |
| ------- | ----------------------------------------- |
| consent | これはIAB標準で要求される同意文字列です。現時点ではネガティブ同意のみ（文字列） |

## regs

| 属性  | 説明                         |
| --- | -------------------------- |
| ext | OpenRTB の取引所固有拡張用プレースホルダー。 |

### regs.ext

| 属性   | 説明                                                                                  |
| ---- | ----------------------------------------------------------------------------------- |
| gdpr | これは、呼び出し元がユーザーがGDPR対象ではないと判断した場合は0、ユーザーがGDPR対象である場合は1です。どちらでもない場合、このパラメータは未定義になります。 |

## imp

| 属性     | 説明                                                 |
| ------ | -------------------------------------------------- |
| id     | 入札リクエストの文脈におけるこのインプレッションの一意の識別子（文字列）               |
| instl  | 1 = 広告はインタースティシャルまたはフルスクリーン、0 = インタースティシャルではない（整数） |
| video  | インストリーム動画インプレッションを表す Video オブジェクトを通じた詳細            |
| secure | インプレッションに安全な HTTPS URL が必要かどうかを示すフラグ（整数）           |
| ext    | OpenRTBへの交換事業者固有の拡張のためのプレースホルダー（オブジェクト）            |

### imp.video

| 属性            | 説明                                                                 |
| ------------- | ------------------------------------------------------------------ |
| mimes         | サポートされるコンテンツの MIME タイプ（例: "video/mp4"）（文字列配列）                      |
| minduration   | 最小動画広告再生時間（秒）（整数）                                                  |
| maxduration   | 最大動画広告再生時間（秒）（整数）                                                  |
| protocols     | サポートされる動画プロトコルの配列（整数）                                              |
| linearity     | インプレッションがリニア、ノンリニアなどである必要があるかを示します。指定がない場合は、すべて許可されているものと見なします（整数） |
| boxingallowed | 4:3コンテンツを16:9ウィンドウにレターボックス表示することが許可されるかを示します。0 = いいえ、1 = はい（整数）    |
| pos           | 画面上の広告位置（整数）                                                       |
| h             | デバイス非依存ピクセル（DIPS）単位の動画プレーヤーの幅（整数）                                  |
| w             | デバイス非依存ピクセル（DIPS）単位の動画プレーヤーの高さ（整数）                                 |
| ext           | OpenRTBへの交換事業者固有の拡張のためのプレースホルダー（オブジェクト）                            |

### imp.video.ext

| 属性         | 説明                                          |
| ---------- | ------------------------------------------- |
| zone\_type | ExoClickの広告フォーマット内のゾーンタイプ（例: video\_slider） |


---

# 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.5-request.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.