> 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 请求的各个组成部分，以便出价。

## 竞价请求头

* **ExoClick RTB 版本 HTTP 头**: `x-exadsrtb-version: 1.0`
* **Keep-Alive HTTP 头**: `Connection: Keep-Alive`
* **内容 JSON**: `Content-Type: application/json`
* **数据编码头**: `Accept-Encoding`

## 竞价请求对象

当针对特定场景请求出价时，平台将发起一个 HTTP 请求，超时时间为 **300ms**. 它将把以下对象作为 JSON 编码，在请求体中通过 POST 发送：

| 属性                | 描述                                                        |
| ----------------- | --------------------------------------------------------- |
| 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} 令牌混淆）            |

\*必填字段

\*\*仅对 banner 类型必填。如果为空，在推送通知中将默认为 192x192

## 示例

您可以在我们的 [广告主请求示例页面](/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 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/exoclick-rtb/bid-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.