本页介绍如何进行招标
建议的投标请求标题
- OpenRTB 版本 HTTP 标头： x-openrtb-version: 2.5
- Keep-Alive HTTP Header: 连接：Keep-Alive
- Content JSON: Content-Type: application/json
以下对象应在请求正文中以 JSON 格式编码发送：
投标要求
| 属性 | 是否需要？ | 说明 |
|---|
| 于 | 是 | 拍卖类型，第一价格 = 1(int) |
| 本我 | 是 | 唯一投标请求 ID(字符串) |
| 小鬼 | 是 | 代表所提供的印象(对象)的 Imp 对象数组。 |
| 地点 | 是 | 有关出版商网站（对象）的详细信息。 |
| 应用 | 是 | 有关发布者应用程序（对象）的详细信息。 |
| 装置 | 是 | 用户设备的详细信息（对象）。 |
| 用户 | 没有 | 设备人类用户的详细信息；广告受众（对象）。 |
| 绵延 | 没有 | 用于扩展 OpenRTB 的占位符。 |
注意：每个请求中只能有一个对象 {site, app}。
| 属性 | 是否需要？ | 说明 |
|---|
| 本我 | 是 | 该投标请求中的唯一印象 ID(字符串) |
| 标底 | 没有 | 此印象的最低出价 (CPM) / 点击 (CPC) 和账户货币 (浮动)。 |
| 旗帜 | 仅用于全页面 imps | 横幅对象（物体）。 |
| 巩 | 否；建议 1 | 表示印象是否需要安全 HTTPS URL 创意资产和标记的标志，其中 0 = 非安全，1 = 安全。如果省略，则安全状态未知，但可以假设支持非安全 HTTP，可选(整数) |
| 属性 | 是否需要？ | 说明 |
|---|
| w | 是 | 横幅宽度(整数) |
| h | 是 | 横幅高度(整数) |
| 哑剧 | 是 | 哑剧类型 - 图像/jpg、图像/png、视频/mp4 或图像/webp |
| 属性 | 是否需要？ | 说明 |
|---|
| 哑剧 | 是 | 支持的内容 MIME 类型（如 "video/mp4"）（字符串数组） |
| 心形 | 没有 | 视频广告最短持续时间（秒）（整数 |
| 最大持续时间 | 没有 | 视频广告最长持续时间（秒）（整数 |
| 协议 | 没有 | 支持的视频协议数组（整数） |
| 线性度 | 没有 | 表示印象是否必须是线性、非线性等。如果未指定，则假定全部允许（整数） |
| 允许拳击 | 没有 | 表示是否允许将 4:3 的内容以字母格式转换到 16:9 的窗口中，0 = 否，1 = 是（整数）。 |
| 姿势 | 没有 | 广告在屏幕上的位置（整数） |
| h | 没有 | 视频播放器的宽度，单位为独立于设备的像素 (DIPS)（整数） |
| w | 没有 | 视频播放器的高度，单位为独立于设备的像素 (DIPS)（整数） |
| 绵延 | 没有 | 用于对 OpenRTB 进行交易所特定扩展的占位符（对象） |
imp.video.ext
| 属性 | 是否需要？ | 说明 |
|---|
| 区域类型 | 没有 | ExoClick 广告格式中的区域类型（例如：视频_滑块） |
| cta | 没有 | 指定广告区域是否显示 CTA 组件（整数） |
| 属性 | 是否需要？ | 说明 |
|---|
| 本我 | 推荐 | 唯一站点 ID(字符串) |
| 名字 | 没有 | 网站名称（字符串） |
| 领域 | 推荐 | 网站域名(字符串) |
| 猫 | 没有 | IAB 类别 ID(字符串数组) |
| 页码 | 推荐 | 显示广告的页面的完整 URL(字符串) |
| 关键词 | 没有 | 关键字可用于确保广告区获得正确类型的广告。关键词应是一串用逗号分隔的单词 |
site.ext
| 属性 | 是否需要？ | 说明 |
|---|
| 交换猫 | 没有 | 自定义 ExoClick 类别 ID(整数) |
| idzone | 没有 | 自定义 ExoClick 区域 ID（整数） |
| 属性 | 是否需要？ | 说明 |
|---|
| 本我 | 推荐 | 唯一应用程序 ID(字符串) |
| 名字 | 没有 | 应用程序名称（字符串） |
| 领域 | 推荐 | 应用程序的域名（字符串） |
| 猫 | 没有 | IAB 类别 ID(字符串数组) |
| 关键词 | 没有 | 关键字可用于确保广告区获得正确类型的广告。关键字应是一串以逗号分隔的单词(字符串) |
| 出版商 | 没有 | 关于发布者(对象)的详细信息 |
| 属性 | 是否需要？ | 说明 |
|---|
| a | 是 | 浏览器用户代理(字符串) |
| sua | 没有 | 结构化用户代理信息，可在客户端支持用户代理客户端提示（对象）时使用 |
| 地理 | 没有 | 设备的位置，假定为地理对象定义的用户当前位置。 |
| ip | 是 | 用户的 IPv4 地址（字符串）* |
| ipv6 | 是 | 用户的 IPv6 地址（字符串）* |
| 语言 | 推荐 | 浏览器语言（字符串） |
| os | 没有 | 操作系统(字符串) |
| js | 没有 | 支持 JavaScript，0 = 否，1 = 是(整数) |
| 绵延 | 没有 | 用于对 OpenRTB 进行交易所特定扩展的占位符 |
注意： 您只需在请求中包含 ip 或 ipv6，而不必同时包含这两个属性。如果使用 ipv6，请删除 ip 属性，反之亦然。同时包含这两个属性会导致错误。
device.geo
device.ext
| 属性 | 是否需要？ | 说明 |
|---|
| 远程地址 | 没有 | 用户的主 IP 地址(字符串) |
| x_forward_for | 没有 | 用户的 X-FORWARDED-FOR IP 地址，未设置时为空(字符串) |
device.sua
结构化用户代理信息。device.sua "被认为是更准确的设备属性表示。
| 属性 | 是否需要？ | 说明 |
|---|
| 浏览器 | 推荐 | 实施者应发送来自 Sec-CH-UA-Full-Version-List 标头的品牌和版本。(品牌版本 "对象数组） |
| 平台 | 推荐 | 实施者应发送源自 Sec-CH-UA-Platform 标头的品牌和源自 Sec-CH-UA-Platform-Version 标头的版本。（"品牌版本 "对象） |
| 手机 | 推荐 | 实施者应从 Sec-CH-UA-Mobile 标头中获取该值。整数 |
| 建筑学 | 推荐 | 实施者应从 Sec-CH-UA-Arch 标头中获取该值。（字符串） |
| 比特度 | 推荐 | 实施者应从 Sec-CH-UA-Bitness 标头中获取该值。（字符串） |
| 模型 | 推荐 | 实施者应从 Sec-CH-UA-Model 标头中获取该值。（字符串） |
| 消息来源 | 推荐 | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| 属性 | 是否需要？ | 说明 |
|---|
| 品牌 | 需要 | 该值可能来自用户代理客户端提示标头，代表用户代理品牌（来自 Sec-CH-UA-Full-Version 标头）或平台品牌（来自 Sec-CH-UA-Platform 标头）。(字符串） |
| 版本 | 推荐 | 按降序排列的版本组件序列[大、小、微、......]（字符串数组） |
| 属性 | 是否需要？ | 说明 |
|---|
| 本我 | 没有 | 唯一用户 ID(字符串) |
| 绵延 | 没有 | 用于对 OpenRTB 进行交易所特定扩展的占位符（对象） |
user.ext
| 属性 | 是否需要？ | 说明 |
|---|
| 同意 | 没有 | 这是 IAB 标准所要求的同意字符串。目前只有否定同意（字符串） |
| 属性 | 是否需要？ | 说明 |
|---|
| 绵延 | 没有 | 用于对 OpenRTB 进行交易所特定扩展的占位符（对象） |
regs.ext
| 属性 | 是否需要？ | 说明 |
|---|
| gdpr | 没有 | 如果调用者认为用户不在 GDPR 范围内，则该值为 0；如果用户在 GDPR 范围内，则该值为 1。如果两者都不适用，则该参数未定义。 |
| 属性 | 是否需要？ | 说明 |
|---|
| 字幕 | 没有 | 子 ID。这应该是一个介于六位数和十位数之间的数字：子 ID 开头不要使用 0。 |