> 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/zh/guang-gao-zhu/kai-fang-rtb/adv-open-rtb-2.5-request.md).

# Open RTB 2.5 出价请求

本页描述您将接收到的 RTB 请求的各个组成部分，以便出价。

## 竞价请求头

* **OpenRTB 版本 HTTP 头：** x-openrtb-version: 2.5
* **Keep-Alive HTTP 头：** Connection: Keep-Alive
* **内容 JSON：内容类型：** application/json
* **数据编码头：** Accept-Encoding

## 出价请求 2.5

当针对特定场景请求出价时，平台将发起一个 HTTP 请求，超时时间为 **300ms** 并在请求正文中发送以下以 JSON 编码的对象。 **HTTP** 由于使用 HTTPS 会增加额外延迟，建议使用。

| 属性     | 描述                            |
| ------ | ----------------------------- |
| id     | 唯一竞价请求 ID（字符串）                |
| site   | 通过 Site 对象提供的有关发布商网站的详细信息（对象） |
| device | 将投放该展示的用户设备详细信息（对象）           |
| user   | 设备的人类用户；广告受众的详细信息（对象）         |
| imp    | 正在拍卖的广告位或展示的详细信息（对象）          |
| regs   | 本请求适用的任何行业、法律或政府法规的详细信息（对象）   |
| ext    | OpenRTB 扩展的占位符（对象）            |

## site

| 属性       | 描述                                    |
| -------- | ------------------------------------- |
| id       | 唯一站点 ID（字符串）                          |
| domain   | 站点的域名（字符串）                            |
| cat      | IAB 类别 ID（字符串数组）                      |
| page     | 将展示广告的页面完整 URL（字符串）                   |
| keywords | 关键词可用于确保广告位获得正确类型的广告。关键词应为以逗号分隔的单词字符串 |
| ext      | 交易所特定扩展的占位符（对象）                       |

### site.ext

| 属性          | 描述                      |
| ----------- | ----------------------- |
| exchangecat | 自定义 ExoClick 类别 ID（整数）  |
| idzone      | 自定义 ExoClick 广告位 ID（整数） |
| keyword     | 匹配关键词（如有）（字符串）          |

## device

| 属性       | 描述                                                 |
| -------- | -------------------------------------------------- |
| ua       | 浏览器用户代理（字符串）                                       |
| sua      | 结构化的用户代理信息，可在客户端支持 User-Agent Client Hints 时使用（对象） |
| geo      | 设备的位置，假定为由 Geo 对象定义的用户当前位置                         |
| ip       | 用户的 IPv4 地址（字符串）\*                                 |
| ipv6     | 用户的 IPv6 地址（字符串）\*                                 |
| language | 浏览器语言（字符串）                                         |
| os       | 操作系统（字符串）                                          |
| js       | 是否支持 JavaScript，其中 0 = 否，1 = 是（整数）                 |
| ext      | 用于 OpenRTB 交换方特定扩展的占位符（对象）                         |

\*竞价请求中只会出现 ip 或 ipv6 中的一个。

### device.geo

| 属性        | 描述                              |
| --------- | ------------------------------- |
| country   | 国家 ISO3                         |
| ipservice | 如适用，用于根据 IP 地址确定地理位置的服务或提供商（整数） |

### device.ext

| 属性                | 描述                                     |
| ----------------- | -------------------------------------- |
| remote\_addr      | 用户的主 IP 地址（字符串）                        |
| x\_forwarded\_for | 用户的 X-FORWARDED-FOR IP 地址；若未设置则为空（字符串） |

### device.sua

结构化用户代理信息。 `device.sua` 被认为是设备属性更准确的表示。

| 属性           | 描述                                                                                                                                                                          |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| browsers     | 发送从 Sec-CH-UA-Full-Version-List 头部派生的品牌和版本。（ `BrandVersion` BrandVersion 对象数组）                                                                                              |
| platform     | 发送从 Sec-CH-UA-Platform 头部派生的品牌，以及从 Sec-CH-UA-Platform-Version 头部派生的版本。（`BrandVersion` 对象）                                                                                   |
| mobile       | 从 Sec-CH-UA-Mobile 头部派生此值。（整数）                                                                                                                                              |
| architecture | 从 Sec-CH-UA-Arch 头部获取此值。（字符串）                                                                                                                                               |
| bitness      | 从 Sec-CH-UA-Bitness 头部获取此值。（字符串）                                                                                                                                            |
| model        | 从 Sec-CH-UA-Model 头部获取此值。（字符串）                                                                                                                                              |
| source       | 用于创建此对象的数据来源， [列表：User-Agent 来源](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) 在 AdCOM 1.0 中（整数；默认 0） |

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

| 属性      | 描述                                                                                                            |
| ------- | ------------------------------------------------------------------------------------------------------------- |
| brand   | 该值可能来自 User-Agent Client Hints 头部，表示用户代理品牌（来自 Sec-CH-UA-Full-Version 头部）或平台品牌（来自 Sec-CH-UA-Platform 头部）。（字符串） |
| version | 版本组件序列，按降序层级顺序 \[主版本、次版本、微版本、…]（字符串数组）                                                                        |

## user

| 属性 | 描述           |
| -- | ------------ |
| id | 唯一用户 ID（字符串） |

### user.ext

| 属性 | 描述                               |
| -- | -------------------------------- |
| 同意 | 这是 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 = 是（整数） |
| 位置            | 屏幕上的广告位置（整数）                                     |
| h             | 视频播放器宽度，单位为设备无关像素（DIPS）（整数）                      |
| w             | 视频播放器高度，单位为设备无关像素（DIPS）（整数）                      |
| ext           | 用于 OpenRTB 交换方特定扩展的占位符（对象）                       |

### imp.video.ext

| 属性   | 描述                                    |
| ---- | ------------------------------------- |
| 区域类型 | 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/zh/guang-gao-zhu/kai-fang-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.