本页描述了您在竞价时将收到的 RTB 请求的不同组成部分。
投标请求标题
- OpenRTB 版本 HTTP 标头： x-openrtb-version: 2.4
- Keep-Alive HTTP Header：连接：Keep-Alive
- 内容 JSON：内容类型：application/json
- 数据编码头：接受编码
投标要求
When requesting bids for a specific context, the platform will perform an HTTP request with a timeout of 300ms and send the following object encoded as JSON in the request body. HTTP is recommended due to extra latency when using HTTPS.
| 属性 | 说明 |
|---|
| 于 | 拍卖类型，第一价格 = 1(int) |
| 本我 | 唯一投标请求 ID(字符串) |
| 小鬼 | 代表所提供印象的对象(对象)。 |
| 地点 | 通过网站对象了解出版商网站(对象)的详细信息。 |
| 装置 | 通过 "设备"(Device)对象提供的用户设备(对象)的详细信息。 |
| 用户 | 通过用户对象了解设备用户的详细信息；广告受众(对象)。 |
| 绵延 | 交易所特定扩展名的占位符。 |
| 属性 | 说明 |
|---|
| 本我 | 该投标请求中的唯一印象 ID(字符串) |
| 标底 | 此印象(CPM)/点击(CPC)的最低出价和账户货币，可选(浮动)。 |
| 投标书 | 使用 ISO-4217 阿尔法代码指定的最低出价货币，可选(字符串) |
| 本地人 | 本地对象；如果该印象是作为本地广告机会(对象)提供的，则需要本地对象。 |
| 旗帜 | 横幅广告对象；如果该印象作为横幅广告机会(对象)提供，则需要横幅广告对象。 |
| instl | 如果该印象是作为插播广告机会(对象)提供的，则需要插播对象。 |
| 巩 | 表示印象是否需要安全 HTTPS URL 创意资产和标记的标志，其中 0 = 非安全，1 = 安全。如果省略，则安全状态未知，但可以假设支持非安全 HTTP，可选(整数) |
| el | Base64 编码电子邮件(字符串) |
| 属性 | 说明 |
|---|
| w | 横幅宽度(像素)(整数)。 |
| h | 横幅的高度(像素)(整数)。 |
imp.instl
| 属性 | 说明 |
|---|
| instl | 指定广告是否为 popunder/插播广告的标志(整数)：1=true, 0=false |
imp.native(本地和推送通知)
| 属性 | 说明 |
|---|
| 要求 | 符合本地广告规范的请求有效载荷--本地广告请求的JSON 编码字符串，包括其本地顶层对象(JSON 对象) |
| ......验证 | 请求**符合的动态原生广告 API 的版本(字符串) |
imp.native.request
| 属性 | 说明 |
|---|
| ......验证 | 使用中的本地标记版本(字符串) |
| 背景 | 广告出现的上下文。在这种情况下，它是 1(以内容为中心的上下文，如新闻推送、文章、图片库、视频库或类似)，可选(整数) |
| plcmttype | 广告单元的设计/格式/布局。目前我们支持 4(推荐小部件)和 500(推送通知)(整数) |
| plcmtcnt | 该布局中相同位置的数量(整数) |
| 资产 | 资产对象**的数组。任何投标响应都必须符合投标请求中表达的元素数组(JSON 对象数组) |
| 序列 | 第一个广告为 0，第二个广告为 1，以此类推。请注意，这通常不能与 plcmtcnt 结合使用--要么您是在拍卖多个相同的位置(在这种情况下，plcmtcnt>1，seq=0)，要么您是在为信息源中不同的项目举行单独的拍卖(在这种情况下，plcmtcnt=1，seq=>=1) |
imp.native.request.assets
| 属性 | 说明 |
|---|
| 本我 | 交易所分配的唯一资产 ID。通常是数组的计数器(整数) |
| 所需 | 如果资产是必需的，则设置为 1；如果资产是可选的，则设置为 0(整数) |
| plcmtcnt | 该布局中相同位置的数量(整数) |
| 图像 | 用于图像资产的图像对象*(JSON 对象) |
| 标题 | 标题资产的标题对象*(JSON 对象) |
| 数据 | 品牌名称、描述、评级、价格等数据对象(JSON 对象) |
| 视频 | 用于视频资产的视频对象。请参见视频请求对象定义。请注意，流内(即预滚动等)视频广告不属于本地广告。本地广告可能包含视频作为广告创意本身(对象)。 |
- 每个资产对象中只能有一个{img、title、data} 对象
** 根据可能显示广告的发布者区域的配置，对资产进行必要的标记
imp.native.request.assets.img
| 属性 | 说明 |
|---|
| 类型 | 出版商支持的图像元素类型 ID。我们支持 1(图标图像)(整数)，3(广告大图预览)(整数) |
| w | 图像宽度(像素)，可选(整数 |
| h | 图像的高度(像素)，可选(整数 |
| wmin | 要求的图像最小宽度(像素)(整数 |
| hmin | 要求的图像最小高度(像素)(整数 |
imp.native.request.assets.title
imp.native.request.assets.data
| 属性 | 说明 |
|---|
| 类型 | 发布者支持的元素类型 ID(整数)。我们支持 1(sponsored - Sponsored By 消息，响应应包含赞助商的品牌名称)，2(desc - 与广告产品或服务相关的描述性文本)。 |
| 宽 | 元素响应文本的最大长度(整数) |
| 属性 | 说明 |
|---|
| 哑剧 | 支持的 MIME 类型列表(字符串数组) |
| 协议 | 支持的视频投标响应协议列表(int 数组) |
| 跳读 | 表示播放器是否允许跳过视频，0 = 否，1 = 是 |
| 跳读 | 视频必须播放多少秒后才能启用跳过功能；仅适用于广告可跳过的情况 |
| 跳读 | 总时长大于此秒数的视频可跳过；仅适用于广告可跳过的情况 |
注意： 如果发布者在请求中提供了 "skip"(跳过)，但没有提供 "skipafter"(跳过)，视频将在 5 秒后跳过。如果发布者在请求中提供了 "skip"，但没有提供 "skipmin"，则无论视频的持续时间长短，都可以跳过。
| 属性 | 说明 |
|---|
| id* | 唯一站点 ID(字符串) |
| 域* | 网站域名(字符串) |
| 猫 | IAB 类别 ID(字符串数组) |
| 页码 | 显示广告的页面的完整 URL(字符串) |
| 关键词 | 关键字可用于确保广告区获得正确类型的广告。关键词应是一串用逗号分隔的单词 |
| 绵延 | 用于对 OpenRTB 进行交易所特定扩展的占位符。 |
*直接链接和电子邮件点击格式必须使用这些属性。
site.ext
| 属性 | 说明 |
|---|
| 交换猫 | 自定义 ExoClick 类别 ID(整数) |
| idzone | 自定义 ExoClick 广告区 ID(整数) |
| 关键词 | 匹配关键字(如果有)(字符串 |
idzone 属性用于在 ExoClick 中识别流量的来源。
| 属性 | 说明 |
|---|
| a | 浏览器用户代理(字符串) |
| 地理 | 设备的位置，假定为地理对象定义的用户当前位置。 |
| ip | 用户的 IP 地址(字符串)* |
| ipv6 | 用户的 IPv6 地址(字符串)* |
| 语言 | 使用 ISO-639-1-alpha-2 的浏览器语言(字符串) |
| os | 操作系统(字符串) |
| js | 支持 JavaScript，0 = 否，1 = 是(整数) |
| 绵延 | 用于对 OpenRTB 进行交易所特定扩展的占位符 |
device.geo
device.ext
| 属性 | 说明 |
|---|
| 远程地址 | 用户的主 IP 地址(字符串) |
| x_forward_for | 用户的 X-FORWARDED-FOR IP 地址，未设置时为空(字符串) |
| 属性 | 是否需要？ | 说明 |
|---|
| 字幕 | 没有 | 子将是一个整数，代表请求所在区域的 ID。 |
regs.ext
| 属性 | 说明 |
|---|
| 应用 | 指示是否对请求应用 DSA 的标志。1 = 需要(int) |
| dsa | 扩展 DSA 透明度信息(对象) |
regs.ext.dsa
| 属性 | 说明 |
|---|
| 所需 | 指示是否提供 DSA 信息的标志。0 = 不需要；1 = 支持，接受带或不带 DSA 对象的投标响应；2 = 需要，不接受不带 DSA 对象的投标响应；3 = 需要，不接受不带 DSA 对象的投标响应，发布者为在线平台 (int) |
| 数据发布 | 发布者可能需要透明度数据进行审计。0 = 不发送透明度数据，1 = 可选发送透明度数据，2 = 发送透明度数据(int) |
注意： *如果收到dsaapply：1和required：2 或 3，则必须在响应中添加带值的 dsa 属性，否则响应将被拒绝。
You can find a complete list of all the types of requests you can receive in our Advertiser Request example page.