> 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/exoclick-rtb/bid-request.md).

# ExoClick RTB 出价请求

本页介绍您为参与竞价而会收到的 RTB 请求所包含的各个组成部分。

## 竞价请求标头

* **Keep-Alive HTTP 标头**: `Connection: Keep-Alive`
* **JSON 内容**: `Content-Type: application/json`
* **数据编码标头**: `Accept-Encoding`

## 竞价请求对象

针对特定上下文请求竞价时，平台会发起一个 HTTP 请求，超时时间为 **300ms**。请求正文中会以 POST 方式发送以下 JSON 编码对象：

| 属性                | 说明                                                         |
| ----------------- | ---------------------------------------------------------- |
| id                | 唯一的竞价请求 ID（字符串）\*                                          |
| ip                | 用户的 IP 地址（字符串）\*                                           |
| language          | 使用 ISO-639-1-alpha-2 表示的浏览器语言（字符串）\*                       |
| remote\_addr      | 用户的主要 IP 地址（字符串）                                           |
| x\_forwarded\_for | 用户的 X-FORWARDED-FOR IP 地址；若未设置则为空（字符串）                     |
| type              | 请求类型。可以是 "banner"、"popunder" 或 "push\_notification"（字符串）\* |
| ua                | 浏览器 User-Agent（字符串）\*                                      |
| url               | 将展示广告的页面完整 URL（字符串）\*                                      |
| user\_id          | 唯一的用户 ID（字符串）\*                                            |
| export            | 响应类型。可以是 "json" 或 "xml"（字符串）\*                             |
| keyword           | 关键字（字符串）                                                   |
| size              | 发布商广告类型尺寸（字符串）\*\*                                         |
| sub               | sub 为整数，表示请求来源区域的 ID（请勿与 {zone\_id} 令牌混淆）                  |

\*必填字段

\*\*仅当 type 为 banner 时必填。对于 Push Notification，如果该字段为空，则默认使用 192x192

## 示例

您可以在我们的 [广告主请求示例页面中查看所有可能收到的请求类型的完整列表](https://docs.exoclick.com/rtb/zh/guang-gao-zhu/exoclick-rtb/exoclick-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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.exoclick.com/rtb/zh/guang-gao-zhu/exoclick-rtb/bid-request.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
