DV360 OpenRTB 规范

要点：验证出价请求是否符合 DV360 OpenRTB 规范。

警告：现有集成可能正在使用不兼容的扩展规范。

在参考本页面的同时，请参阅 OpenRTB 2.6 规范。

Display & Video 360 不支持 OpenRTB 规范中的所有字段，并且可能存在细微差别。本文档的各个部分包含与 Display & Video 360 实现相关的特定信息和建议。除非另有说明，否则您还应遵循 OpenRTB 规范中提供的准则。

某些字段不受支持，但仍会进行解析。这些字段必须采用正确的格式，但不会影响出价结果。

出价请求规范

出价请求是一种 HTTP Post 请求，其正文包含出价请求对象。正文的格式在 Content-Type 标头中定义。

相应的响应要么是 HTTP 204（不出价时没有正文），要么是 HTTP 200（有出价响应正文）。

如果出价请求格式有误，系统可能会返回 HTTP 200，其正文为填充了 nbr 字段的出价响应。

响应格式由 Accept 标头控制。

JSON 格式

如果未提供任何可接受的 MIME 类型，则使用默认格式。

JSON 请求和响应遵循 IAB OpenRTB 2.6 规范。以下文档介绍了扩展和字段支持。

标头 Content-Type：application/json 表示 JSON 出价请求；Accept：application/json 表示出价响应应采用 JSON 格式。

Protobuf 格式

注意：Protobuf 支持目前处于 Beta 版阶段，如果您有兴趣，请与 DV360 联系。

JSON 请求和响应遵循 IAB OpenRTB 2.6 Protobuf 规范。

扩展功能的支持有限，如果您感兴趣，请与 DV360 联系。

发送标头 Content-Type: application/x-protobuf 以指示 Protobuf 出价请求，并设置 Accept: application/x-protobuf 以接收 Protobuf 出价响应。

出价请求对象

字段	类型	详细信息
id	字符串	必填。 出价请求的唯一 ID。这可用于在请求得到处理后的一段很短的时间内识别各个请求。
imp	展示数组	必须提供至少 1 个 imp 对象。 对于音频 pod，支持多个 imp 对象。 对于其他使用情形（例如网页上的多个独立广告位），系统会使用第一个 imp 对象，其余对象会被舍弃。
site	网站	对于网站请求，此字段为必填字段。 site 和 app 互斥。
app	应用广告系列	对于应用请求是必需的。 app 和 site 互斥。
device	设备	必填。
user	用户	必填。
test	整数	不支持。
at	整数	1：最高出价竞价，广告客户需支付其出价金额。 2（默认）：次高出价竞价，广告客户只需支付略高于次高出价的价格。 3：请求中包含底价，与竞争性出价无关。
tmax	整数	可选，默认值为每个集成自定义。
wseat	字符串数组	允许的买方席位列表。 除非允许所有广告客户出价，否则建议使用此值。 如果未设置，则表示没有限制。
bseat	字符串数组	应屏蔽出价的买方席位的列表。系统将禁止所列买方针对交易和公开竞价出价。
allimps	整数	不支持。
cur	字符串数组	可选，但强烈建议使用。 默认值为每个集成。 出价请求中的币种必须与集成期间注册的币种之一相符。 强烈建议每个交易所支持单一币种。
wlang	字符串数组	不支持。
bcat	字符串数组	使用 IAB 内容类别屏蔽的广告客户类别。 不设置此政策表示不屏蔽任何类别。
badv	字符串数组	根据广告客户提供的网域指定被屏蔽的广告客户。 未设置表示没有屏蔽任何广告客户。
bapp	字符串数组	不支持。
source	来源	schain 的半必需参数。
regs	Regs	可选。
ext	出价请求扩展服务	可选。

出价请求扩展对象

字段	类型	详细信息
schain	供应链	新的集成应改用 Source 中的 BidRequest.source.schain 字段。
purch	整数	“所购流量”参数是指从非自有媒体资源重定向的流量，这些流量是通过付费或其他奖励活动获得的。 这是根据新的 MRC IVT 2.0 规范得出的。 在面向买方的报告中，此属性将称为发布商流量来源，并且具有以下值之一： 0（默认）：未定义 - 未在出价请求中发送值。 无法捕获价值； 1：付费 - 从非自有媒体资源重定向的流量（收购的媒体资源或其他利诱性质的活动）。 2：自然 - 直接网址输入、网站搜索或应用下载。
gdemsignals	字符串	来自 GMA SDK 的 SCAR API 信号 blob。 如果流量来自 GMA SDK，则建议使用此值；否则禁止使用。
disable_gma_format	int	如果提供了 gdemsignals，则此参数为可选；否则为禁止。 0（默认）：当 gdemsignals 填充完毕后，出价响应 adm 将是一个 JSON blob。 1：系统还会提供广告代码，而不是 JSON blob。

源对象

字段	类型	详细信息
fd	整数	负责最终展示销售决策的实体 0（默认）：由广告交易平台决定。 1：由上游来源决定。
tid	字符串	不支持。
pchain	字符串	不支持。
schain	供应链	在几乎所有情况下都是必需的。 与通过出价请求扩展程序或来源扩展程序提供 schain 相比，此字段是首选方式。
ext	来源扩展程序	可选。

来源扩展对象

强烈建议您使用此扩展服务，因为它会影响 DV3 中向客户报告的可视性指标。如果 OMID 合作伙伴名称未列在 IAB 认证列表中，根据 MRC 的要求，我们必须单独报告可见度指标，而不是与 MRC 认证的指标一起报告。了解详情。

字段	类型	详细信息
omidpn	字符串	OM SDK 集成的标识符。此值与 OMID 合作伙伴对象的“名称”参数相同。
omidpv	字符串	OM SDK 集成版本。此值与 OMID 合作伙伴对象的“versionString”参数相同。
schain	供应链	新的集成应改用 Source 中的 schain 字段。

Regs 对象

字段	类型	详细信息
coppa	整数	0（默认）：COPPA 不适用于此请求。 1：此请求受 COPPA 约束。
ext	Regs 扩展程序	可选。

Regs 扩展对象

字段	类型	详细信息
gdpr	整数	指明出价请求是否来自欧洲经济区 (EEA)。 0（默认）：非 EEA 地区。 1：欧洲经济区 (EEA) 地区， 如需了解详情，请参阅针对 GDPR 的已征得用户同意的提供商解决方案。
us_privacy	字符串	请按照 IAB Tech Lab 提供的技术规范，植入 us_privacy 字符串。 当我们收到出价请求中的 us_privacy 字符串时，以及当 IAB 字符串表明用户尚未拒绝时，Display & Video 360 将针对此类请求出价。我们不会将 IAB 信号进一步传播到其他供应商。如果 IAB 字符串表明用户已选择停用，Google 将不会针对此类请求出价。

Imp 对象

字段	类型	详细信息
id	字符串	出价请求上下文中相应展示的唯一标识符（通常，值从 1 开始，对于 n 次展示，值会递增到 n）。
metric	对象	不支持。
banner	横幅广告	对于横幅广告机会，此参数为必需参数。
video	视频	对于视频广告机会，此参数是必需的。
audio	音频	对于音频广告机会，此参数为必需参数。
native	原生代码	对于原生广告机会是必需的。
pmp	Pmp	此展示机会生效的私下交易市场交易。
displaymanager	字符串	负责呈现广告（通常是视频广告或移动广告）的广告中介合作伙伴、SDK 技术或播放器的名称。供某些广告服务器用于按合作伙伴自定义广告代码。建议用于视频和/或应用。
displaymanagerver	字符串	负责呈现广告（通常是视频广告或移动广告）的广告中介合作伙伴、SDK 技术或播放器的版本。供某些广告服务器用于按合作伙伴自定义广告代码。建议用于视频和/或应用。
instl	整数	0（默认）：非插页式广告。 1：广告是插页式广告或全屏广告。
tagid	字符串	用于标识发起竞价的特定广告展示位置或广告代码。这有助于排查任何问题，或供买方进行优化。
bidfloor	浮点数	相应展示的最低出价（以每千次展示费用表示）。
bidfloorcur	字符串	使用 ISO-4217 字母代码指定的币种。
clickbrowser	整数	表示在应用中点击广告素材时打开的浏览器类型。 0（默认）：嵌入式 1：原生 请注意，对于此字段，iOS 9.x 设备中的 Safari View Controller 被视为原生浏览器。
secure	整数	相应展示需要使用安全的 HTTPS 网址还是不安全的 HTTP 网址。 0（默认值）：不安全 1：安全
iframebuster	字符串数组
exp	整数	出价到期时间由 DV360 设置，而不考虑合作伙伴在此字段中发送的值。在展示过时时间窗口（通常为 1 小时）之后收到的展示事件会被视为过时事件而舍弃，并且不会被 DV360 视为可结算事件。
rwdd	整数	指明用户是否会因观看广告而获得奖励。 0（默认值）：未获得奖励 1：获得奖励 通常，视频广告实现可让用户免费阅读一篇额外的新闻报道、在游戏中获得一条额外的生命，或获得赞助的无广告音乐会话。奖励通常在视频广告播放完毕后发放。

Imp 扩展对象

字段	类型	详细信息
bcrid	字符串	应屏蔽的广告素材 ID 的列表。

横幅对象

字段	类型	详细信息
format	格式数组	支持的格式列表。
w	整数	h 和 w 合并到 format 字段中。 建议改用 format。
h	整数	h 和 w 合并到 format 字段中。 建议改用 format。
wmax	整数	不支持。
hmax	整数	不支持。
wmin	整数	不支持。
hmin	整数	不支持。
btype	整数数组	屏蔽的横幅广告类型列表： 1：HTML 文字广告 2：HTML 横幅广告 3：JavaScript 广告 4：IFrame 广告
battr	整数数组	支持以下值： 1：音频自动播放 2：音频由用户发起 3：可展开的自动广告 4：可展开的点击发起广告 5：可展开的悬停发起广告 6：横幅中的视频自动播放 7：横幅中的视频由用户发起 8：弹出式广告（弹出式/弹出式底层/退出时弹出） 9：挑逗性或暗示性广告 10：“令人讨厌”的广告，例如：晃动、闪烁、闪动、极端动画、表情符号 11：调查问卷广告 12：纯文字广告 13：用户互动式广告（游戏） 14：Windows 对话框或提醒样式广告 15：带有音频开启/关闭按钮的广告 16：可跳过的广告 17：Flash 广告
pos	整数	广告的位置： 0（默认）：未知 1：首屏 2： 不支持：可能位于首屏下方 3：首屏下方 4：页眉 5：页脚 6：边栏 7：全屏
mimes	字符串数组	不支持。 DV360 将对所有横幅广告素材使用 text/html。
topframe	整数	0（默认）：横幅在 iframe 中投放。 1： 不受支持：横幅广告在顶部框架中投放。
expdir	整数数组	1：左 2：右 3：上 4：下 5：可展开的全屏
api	整数数组	支持的 API 框架 1：左 2：右 3：上 4：下 5：可展开的全屏
id	字符串	横幅对象的标识符，在展示中应具有唯一性。 当 banner 对象与视频对象搭配使用时，建议使用此属性。
vcm	整数	仅适用于与视频对象搭配使用的 banner。 0：横幅与视频广告素材同时显示。 1：横幅是视频结束后的结束画面。

格式对象

字段	类型	详细信息
w	整数	宽度（以与设备无关的像素 [DIP] 为单位）。
h	整数	高度（以与设备无关的像素 [DIP] 为单位）。
wratio	整数	不支持。
hratio	整数	不支持。
wmin	整数	不支持。

视频对象

我们强烈建议您在出价请求中指定视频展示位置。缺少展示位置字段会被归类为未知展示位置。如需了解详情，请参阅有关位置定位的文章。

字段	类型	详细信息
mimes	字符串数组	必须至少提供一种 MIME 类型。 video/flv 或 video/x-f4v video/mp4、video/x-mp4 或 application/mp4 video/webm 或 video/x-webm video/x-ms-wmv video/3gpp video/ogg 或 application/ogg application/javascript 或 application/x-javascript
minduration	整数	视频的最低时长（以秒为单位），默认值为无最低时长。
maxduration	整数	视频的时长上限（以秒为单位），默认情况下没有上限。
protocols	整数数组	必须至少指定一种受支持的协议。 1：VAST 1.0 2：VAST 2.0 3：VAST 3.0 4：VAST 1.0 Wrapper 5：VAST 2.0 Wrapper 6：VAST 3.0 Wrapper 7：VAST 4.0 8：VAST 4.0 Wrapper 9：DAAST 1.0 10：DAAST 1.0 Wrapper
w	整数	视频播放器的宽度（以设备无关像素 [DIP] 为单位）。
h	整数	视频播放器的高度（以设备无关像素 [DIP] 为单位）。
startdelay	整数	前贴片广告、中贴片广告或后贴片广告展示位置的开始延迟时间（以秒为单位）。
placement	整数	强烈建议在出价请求中指定视频的 plcmt（和/或）展示位置。 如果这两个字段都缺失，则会被归类为未知展示位置。 0（默认）：未知 1：插播广告 2：横幅广告 3：文章广告 4：Feed 广告 5：浮动广告 注意：若要被视为插播广告（展示位置或 Plcmt 类型 1），视频展示位置/展示必须设置为“开启声音”，并且在播放方法中正确发出信号（值 1、3、4 和 5 均符合条件）。
plcmt	整数	强烈建议在出价请求中指定视频的 plcmt（和/或）展示位置。 如果这两个字段都缺失，则会被归类为未知展示位置。 0（默认值）：未知 1：插播 2：随播内容 3：插页式 4：无内容/独立 注意：若要被视为插播广告（展示位置或 Plcmt 类型 1），视频展示位置/展示必须设置为“开启声音”，并且在播放方法中正确发出信号（值 1、3、4 和 5 均符合条件）。 注意：如果同时提供 plcmt 和 placement，则以 plcmt 为准。请参阅有关迁移到 plcmt 的 IAB 指南。 注意： plcmt: Accompanying Content (2) 在 plcmt 中被视为 placement: In Article (3) plcmt: No Content/Standalone (4) 在 plcmt 中被视为 placement: In feed (4) placement: In Banner 在 plcmt 中没有映射
linearity	整数	不支持。
skip	整数	视频播放器是否允许跳过广告。 0（默认）：不可跳过 1：可跳过
skipmin	整数	不支持。
skipafter	整数	不支持。
sequence	整数	如果同一出价请求中提供了多次广告展示机会，序列号将有助于协调多个广告素材的投放。
battr	整数数组	被屏蔽的广告素材属性。
maxextended	整数	扩展视频广告的时长上限（如果允许扩展）。 0（默认）：不允许扩展 -1：允许扩展，且没有时间限制 >0：支持的扩展播放时长（以秒为单位），超出 maxduration 值。
minbitrate	整数	最低比特率（以 Kbps 为单位）。
maxbitrate	整数	最大比特率（以 Kbps 为单位）。
boxingallowed	整数	表示是否允许将 4:3 内容以信箱模式显示在 16:9 窗口中 0：不允许 1（默认）：允许
playbackmethod	整数数组	可能正在使用的播放方法。如果未指定任何方法，则可以使用任何方法。 0（默认）：未知 1：自动播放，开启声音 2：自动播放，关闭声音 3：点击播放 4：鼠标悬停 5：进入视口时开始播放，开启声音 6：进入视口时开始播放，关闭声音 注意：所有默认静音（播放方法为 2、6 或 0）的展示都必须指明类型为 2、3、4 或 5（oRTB 2.5）的插播广告展示位置，或 Plcmt 子类型为 2、3 或 4 的插播广告展示位置。
playbackend	整数	导致播放结束的事件。 1：视频播放完毕或用户终止播放 2：离开视口或用户终止播放 3：离开视口后，继续以浮动窗口的形式播放，直至播放完毕或用户终止播放
delivery	整数数组	支持的交付方式。如果未指定任何值，则假定所有值均受支持。 1：流式 2：渐进式
pos	整数	广告在屏幕上的位置。 0（默认）：未知 1：首屏 2： 不支持：可能位于首屏下方 3：首屏下方 4：页眉 5：页脚 6：边栏 7：全屏
companionad	横幅数组	随播广告（如果有）。
api	整数数组	0（默认）：未知 1：VPAID 1 2：VPAID 2 3：MRAID 1 4：ORMMA 5：MRAID 2 6：MRAID 3 7：OMID 1 - 必须启用此值才能使用 OMID 进行 Active View 衡量。 8：SIMID 1
companiontype	整数数组	不支持。
maxseq	整数	动态视频广告连播中要返回的广告数量上限。
poddur	整数数组	动态视频广告连播的时长上限（以秒为单位）。

视频对象支持的扩展名

字段	类型	详细信息
rewarded	整数	此字段用于指明请求是否为奖励广告请求。应以整数形式发送。 0（默认值）：未获得奖励 1：已获得奖励

音频对象

字段	类型	详细信息
mimes	字符串数组	必须至少提供一种 MIME 类型。 audio/m4a、audio/mp4 或 audio/x-m4a audio/mpeg 或 audio/mp3 audio/ogg 或 audio/x-ogg
minduration	整数	广告时长下限（以秒为单位）。
maxduration	整数	广告时长上限（以秒为单位）。
protocols	整数数组	3：VAST 3.0 6：VAST 3.0 封装容器 7：VAST 4.0 8：VAST 4.0 封装容器
startdelay	整数	前贴片广告、中贴片广告或后贴片广告展示位置的开始延迟时间（以秒为单位）。 -2：后贴片广告 -1：中贴片广告 0：前贴片广告 >0：中贴片广告
sequence	整数	不支持。
battr	整数数组	不支持。
maxextended	整数	不支持。
minbitrate	整数	最低比特率（以 Kbps 为单位）。
maxbitrate	整数	最大比特率（以 Kbps 为单位）。
delivery	整数数组	不支持。
companionad	横幅对象数组	任何横幅随播广告素材广告位。
api	整数数组	相应展示的支持的 API 框架列表。 7：OMID V1
companiontype	整数数组	不支持。
maxseq	整数数组	不支持。
feed	整数	音频 Feed 的类型。 1：音乐服务 2：广播 3：播客
stitched	整数	不支持。
nvol	整数	不支持。

原生对象

如需了解详情，请参阅 DV360 原生广告规范。

字段	类型	详细信息
request	字符串	编码的字符串原生 JSON 对象。
ver	字符串	1.0： 不支持 1.1： 不支持 1.2
api	整数数组	相应展示的支持的 API 框架列表。 7：Omid V1
battr	整数数组	不支持。

PMP 对象

字段	类型	详细信息
private_auction	整数	0（默认）：允许所有出价 1：仅限交易
deals	Deal 对象数组	要包含的交易。

交易对象

字段	类型	详细信息
id	字符串	PMP 对象不能包含每个 ID 对应的多个交易对象。
bidfloor	双精度	相应展示的最低出价（以每千次展示费用为单位）。 如果 at=3，则为必需。
bidfloorcur	字符串	使用 ISO-4217 字母代码指定的币种。 如果未指定，则默认为出价请求币种。
at	整数	如果未指定，则默认匹配 bid_request.at。 1：第一价格 2：第二价格 3：固定价格
wseat	字符串数组	有资格参与相应交易的合作伙伴的合作伙伴 ID。 如果未指定座位数，则表示没有座位限制。
wadomain	字符串数组	允许对相应交易进行出价的广告客户网域。 没有席位意味着没有网域限制。
guar	整数	此字段用于指明相应交易是否为有保证的交易。应以整数形式发送。 广告交易平台必须列入许可名单，DV360 才能接受有保证的交易；请与我们联系以申请将广告交易平台列入许可名单。 如果您的广告交易平台目前使用其他机制来向 DV360 传递有保证的交易信号，请与我们联系，讨论改用此首选扩展服务。 0（默认值）：无保证 1：有保证
ext	促销扩展	可选。

交易对象的支持扩展

字段	类型	详细信息
guaranteed	整数	此字段用于指明相应交易是否为有保证的交易。应以整数形式发送。 广告交易平台必须列入许可名单，DV360 才能接受有保证的交易；请与我们联系以申请将广告交易平台列入许可名单。 如果您的广告交易平台目前使用其他机制来向 DV360 传递有保证的交易信号，请与我们联系，讨论改用此首选扩展服务。 0（默认值）：无保证 1：有保证 建议使用 deal.guar 而不是此字段。

网站对象

字段	类型	详细信息
id	字符串	广告交易平台上的网站的 ID。
name	字符串	不支持。
domain	字符串	网站的网域。 建议在 site.page 中发送完整网址，而不是仅填充 site.domain。
cat	字符串数组	不支持。
sectioncat	字符串数组	不支持。
pagecat	字符串数组	不支持。
page	字符串	要展示展示的完整网址。 建议发送完整网址以用于定位。
ref	字符串	导致导航到当前页面的引荐来源网址。
search	字符串	不支持。
mobile	整数	不支持。
privacypolicy	整数	不支持。
publisher	发布商对象	网站发布商的相关详细信息。
content	内容对象	网站内内容的详细信息。
keywords	字符串（CSV 格式）	不支持。
ext	网站扩展程序	网站对象的扩展属性。

网站扩展对象

字段	类型	详细信息
inventorypartnerdomain	字符串	用于联网电视广告资源共享，请参阅 IAB CTV 应用添加项说明。

应用对象

字段	类型	详细信息
id	字符串	广告交易平台上的应用 ID。
name	字符串	应用名称，可能会根据发布商的要求进行别名化。 对于不使用 SDK 的请求（主要是联网电视），发布商可以直接在请求中提供应用名称。
bundle	字符串	必需。 对于 iOS，必须是数字应用商店 ID。我们不接受反向 DNS 样式的软件包 ID。 对于 CTV 应用，我们建议传递商店定义的应用标识符。请遵守最近发布的 IAB OTT/CTV 商店专用 ID 指南。
domain	字符串	网域，例如 mygame.foo.com
storeurl	字符串	必须提供，用于 app-ads.txt 验证和联网电视应用商店验证。
cat	字符串数组	不支持。
sectioncat	字符串数组	不支持。
pagecat	字符串数组	不支持。
ver	字符串	不支持。
privacypolicy	整数	不支持。
paid	整数	不支持。
publisher	发布商对象	应用发布商的相关信息。
content	内容对象	应用内容方面的信息。
keywords	字符串（CSV 格式）	不支持。
ext	附加应用信息	应用对象的扩展信息。

附加应用信息对象

字段	类型	详细信息
inventorypartnerdomain	字符串	用于联网电视广告资源共享，请参阅 IAB CTV 应用添加项说明。

内容对象

我们建议您尽可能传递这些属性。

字段	类型	详细信息
id	字符串	唯一标识内容的 ID。
episode	整数	内容剧集编号（通常用于视频内容）。
title	字符串	建议用于 CTV、视频和音频请求。
series	字符串	建议用于 CTV、视频和音频请求。
season	字符串	相应内容的季标签。
artist	字符串	内容中注明了音乐人。
genre	字符串	最能描述相应内容的类型。DV360 建议为联网电视、视频和音频请求提供此信号。 DV360 支持此字段的几种视频流派值分类法： Google 类型列表 （下载） IAB 电视/电影/体育类别 （下载） Nielsen 的 Gracenote 视频流派分类法
album	字符串	内容所属的专辑，通常是音频内容。
isrc	字符串	符合 ISO-3901 的国际标准音像制品编码。
producer	生产者对象	内容制作方的详细信息。
url	字符串	内容的网址。
cat	字符串数组	用于描述内容的 IAB 内容类别。
prodq	整数	制作质量： 0（默认）：未知 1：专业 2：准专业 3：用户生成
videoquality	整数	不支持。
context	整数	内容类型： 1：视频 2：游戏 3：音乐 4：应用 5：文字 6：其他 7：未知
contentrating	字符串	建议为音频广告和视频广告/联网电视广告设置此属性，因为我们将开始根据此属性做出广告投放决策。
userrating	字符串	星级、好评数等…
qagmediarating	整数	根据 [QAG 指南](http://www.iab.net/ne_guidelines) 确定的媒体评级。 1：所有受众群体 2：12 岁以上 3：成熟
keywords	字符串（CSV 格式）	不支持。
livestream	整数	如果内容是直播内容。 0：非直播 1：内容为直播
sourcerelationship	整数	0：间接 1：直接
len	整数	内容时长（以秒为单位）。 建议用于联网电视/视频和音频请求。
language	字符串 (ISO-639-1-alpha-2)	内容的语言。
embeddable	整数	内容是否可嵌入的指示器（例如，可嵌入的视频播放器） 0：不可嵌入 1：可嵌入
data	数据对象的数组	其他数据。

提供方对象

字段	类型	详细信息
id	字符串	不支持。
name	字符串	不支持。
cat	字符串数组	不支持。
domain	字符串	提供方的顶级网域。

数据对象

字段	类型	详细信息
id	字符串	数据提供商的 ID。
name	字符串	数据提供方的交易所名称。
segment	细分对象的数组	实际数据值。
ext	数据扩展	数据对象的扩展。

数据对象支持的扩展程序

字段	类型	详细信息
segtax	整数	分类 ID，如需了解详情，请参阅细分受众群分类。
segclass	字符串	分类器的版本，该分类器在分类中生成了细分 ID。

细分对象

字段	类型	详细信息
id	字符串	数据提供方特有的数据段 ID。
name	字符串	数据段的名称。
value	字符串	数据细分受众群的价值。

发布商对象

字段	类型	详细信息
id	字符串	必填。
name	字符串	不支持。
cat	字符串数组	不支持。
domain	字符串	不支持。

设备对象

字段	类型	详细信息
ua	字符串	必填。
sua	UserAgent 对象	结构化的用户代理信息。
geo	地理位置对象	设备的位置。
dnt	整数	浏览器标头中设置的“请勿跟踪”标志。 0：跟踪不受限制 1：不跟踪
lmt	整数	商业认可的“限制广告跟踪”信号。 0：跟踪不受限制 1：必须根据商业指南限制跟踪
ip	字符串	如果为 IPv4，则为必需。 如果 IP 地址被截断，则必须在 device.ext.truncated_ip 中声明。
ipv6	字符串	如果为 IPv6，则为必需。 如果 IP 地址被截断，则必须在 device.ext.truncated_ip 中声明。
devicetype	整数	强烈建议为所有广告资源类型提供。用于增强设备类型识别。
make	字符串
model	字符串
os	字符串	设备的操作系统。 ios：在应用请求中，此参数用于标识 iOS 流量。 android：如果 ua 或 sua 未识别出 Android 设备，则用于识别 Android 设备。 [anything else]：用于诊断以隔离问题。 此字段不区分大小写。
osv	字符串	不支持。
hwv	字符串	设备的硬件版本。
h	整数	屏幕的实际高度（以像素为单位）。
w	整数	屏幕的实际宽度（以像素为单位）。
ppi	整数	不支持。
pxratio	双精度	物理像素与设备无关像素的比率。
js	整数	不支持。
geofetch	整数	不支持。
flashver	字符串	不支持。
language	字符串 (ISO-639-1-alpha-2)	设备语言。
carrier	字符串	不支持。
mccmnc	字符串	不支持。
connectiontype	整数	网络连接类型
ifa	字符串	允许广告客户以明文形式使用的 ID。
didsha1	字符串	不支持。
didmd5	字符串	不支持。
dpidsha1	字符串	不支持。
dpidmd5	字符串	不支持。
macsha1	字符串	不支持。
macmd5	字符串	不支持。
ext	设备扩展	设备对象的扩展服务。

设备对象的支持扩展服务

如果 ip 发生更改或被截断，我们强烈建议发送以下扩展，以防止流量被声明为无效流量。

字段	类型	详细信息
truncated_ip	整数	指明出价请求的 device.ip 字段中的 IP 地址是否被截断。 0：未截断 1：已截断 默认情况下不截断，如果 IP 地址被截断，则必须提供。 如果未声明，出价请求可能会被归类为无效流量。
ifa_type	字符串	指明 device.ifa 字段的来源，是来自设备本身，还是由供应链中的发布商或 SSP 生成。 aaid：Android TV rida：Roku afai：Amazon Fire idfa：Apple tvOS msai：Xbox/Microsoft dpid：通用设备平台 ID ppid：发布商提供的 ID sspid：SSP 提供的 ID sessionid：短期会话 ID（仅用于频次上限）
attestation_token	字符串（采用 base64 编码）	支持相应设备验证级别的交易平台的基于设备的证明令牌。
atts	整数	（仅限 iOS）传递的整数，用于表示应用的跟踪授权状态。 0：未确定 1：受限 2：遭拒 3：已授权
cdep	字符串	Chrome 弃用第三方 Cookie 的标签。 请参阅 Chrome 协助进行的测试和 IAB 社区规范

UserAgent 对象

字段	类型	详细信息
browsers	BrandVersion 对象的数组	每个 BrandVersion 对象都用于标识浏览器或类似软件组件。
platform	BrandVersion 对象	标识平台。
mobile	整数	0（默认）：代理偏好“桌面版”或“完整版”内容。 1：代理偏好“移动”内容。
architecture	字符串	设备架构，例如“x86”或“arm”。
bitness	字符串	设备的位数，例如“64”表示 64 位架构。
model	字符串	设备型号。
source	整数	用于创建此对象的数据源，请参阅 列表：User-Agent 源。建议在传递 UserAgent 对象时使用。

BrandVersion 对象

字段	类型	详细信息
brand	字符串	品牌标识符，例如“Chrome”或“Windows”。必填。
version	字符串数组	版本组件序列，按降序层次结构顺序（主要版本、次要版本、微版本等）。

地理位置对象

字段	类型	详细信息
lat	双精度	不支持。
lon	双精度	不支持。
type	整数	不支持。
accuracy	整数	不支持。
lastfix	整数	不支持。
ipservice	整数	不支持。
country	字符串	不支持。
region	字符串	不支持。
regionfips104	字符串	不支持。
metro	字符串	不支持。
city	字符串	不支持。
zip	字符串	不支持。
utcoffset	整数	不支持。

用户对象

字段	类型	详细信息
id	字符串	如果 Google 托管 ID 匹配表，则支持。
buyeruid	字符串	如果 SSP 托管 ID 匹配表，则支持。
yob	整数	建议用于受众特征定位。
gender	字符串	建议用于受众特征定位。
keywords	字符串 (CSV)	不支持。
customdata	字符串	不支持。
geo	地理位置对象	不支持。
data	数据对象的数组	其他数据。
eids	扩展 ID 对象的数组	由广告交易平台提供的扩展 ID 实例。
ext	用户扩展	用户对象的扩展。

用户对象支持的扩展

字段	类型	详细信息
consent	字符串（Web 安全的 Base64）	IAB 意见征求字符串。 包含元数据，用于说明用户同意收集哪些信息，以及允许哪些供应商使用这些信息。 该值是一个使用自定义二进制格式的、可在网络中安全使用的 base64 编码二进制字符串。
us_privacy	字符串	用户是否已看到有关 CCPA 或类似法律的合规性信息。
consented_providers_settings.consented_providers	封装内部整数数组 (consented_providers) 的外部对象 (consented_providers_settings)。	如果通过 TCF 收集 GDPR 意见征求数据，此字段会列出用户同意的未参与 TCF 的广告技术提供商。请参阅“Google 额外同意模式技术规范”。
eids	扩展 ID 对象的数组	由广告交易平台提供的扩展 ID 实例。

扩展 ID 对象

字段	类型	详细信息
source	字符串	标识符的提供方
uids	扩展 ID UID 对象的数组	实际标识符

扩展 ID UID 对象

字段	类型	详细信息
id	字符串	标识符本身。
atype	整数	与此 ID 关联的用户代理的类型。

供应链对象

字段	类型	详细信息
complete	整数	0（默认）：供应链不完整。 1：供应链完整，可追溯到发布商。
ver	字符串	必填。 值的格式为“主版本号.次版本号”，例如，版本 1.0 的字符串为“1.0”。
nodes	供应链节点数组	必填。 在完整的供应链中，第一个节点表示交易中涉及的初始广告系统和卖家 ID，即网站、应用或其他媒体的所有者。 在不完整的供应链中，它表示第一个已知节点。最后一个节点表示发送相应出价请求的实体。

供应链节点对象

字段	类型	详细信息
asi	字符串	这是出价工具连接到的 SSP、广告交易平台、标头封装容器等系统的规范域名。可以使用此类系统的运行域名作为该域名（如果运行域名与父级企业域名不同的话），这样便于进行 WHOIS 查询和反向 IP 查询，进而明确委托系统的所有权。 此值应与用于在 ads.txt 文件（如果存在）中标识卖家的值相同。
sid	字符串	与广告系统内的卖方或转销商账号相关联的标识符。该字段包含的值必须与在 SSP/广告交易平台指定的字段中的交易（即 OpenRTB 出价请求）中使用的值相同。 在 OpenRTB 中，这通常是 publisher.id。 对于 OpenDirect，该值通常是发布商的组织 ID。 长度应限制为 64 个字符。
rid	字符串	相应请求（由相应卖方发出）的 OpenRTB RequestId。
name	字符串	获得根据指定 seller_id 进行的广告资源交易付款的公司（法定实体）的名称。 此值是可选值，如果广告系统的 sellers.json 文件中存在此值，则不应包含此值。
domain	字符串	相应节点所代表实体的业务域名。 此值是可选的，如果广告系统的 sellers.json 文件中存在此值，则不应包含此值。
hp	整数	指示相应节点是否会参与到广告资源的付款流程中。 1：asi 字段中的广告系统向 sid 字段中的卖家付款，后者负责向链中的上一个节点付款。 0：此节点不参与商品目录的付款流程。 对于供应链的 1.0 版本，此属性应始终为 1。明确要求包含此节点，因为预计未来版本的规范会引入非付款处理节点。 实现者应确保他们支持此字段，并在出价请求中构建 SupplyChain 对象时将其传播到下游广告系统。

出价响应规范

BidResponse 对象

属性	支持	实现细节	始终通过
id		如果发生解析错误，此值可能为“0”，而不是出价请求 ID。	是
seatbid
bidid
cur		如果发生解析错误，则不会传递此参数。对于有效的出价请求流量，始终会提供 cur。	是
customdata
nbr		仅当出价请求存在问题时才会包含此字段。可能的值包括： 2：无效请求 12：违反 ads.txt 授权 16：SupplyChain 不完整 17：SupplyChain 节点被屏蔽 注意：当检测到违反 (app-)ads.txt 或 SupplyChain 的具体情况时，部分（1%）响应中会填充代码 12、16 或 17。对于所有其他无效请求，系统都会填充代码 2。 包含 NBR 的请求如下所示： { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } }
ext		如果出价请求存在问题，则 ext 可能会包含有助于诊断错误的信息（如果支持）。

BidResponse 对象支持的扩展服务

属性	实现细节
err	直观易懂的出价请求错误说明。响应案例包括： 出价请求正文为空。 出价请求所用的币种不在特定广告交易平台的许可名单中。 出价请求未包含可接受的 MIME 类型。
errHelp	指向此页面的链接。

Seatbid 对象

属性	支持	实现细节	始终通过
出价			是
个席位			是
群组

出价对象

属性	支持	实现细节	始终通过
id			是
impid			是
价格			是
nurl
树瘤
lurl
adm
adid
adomain
地理区域集合
iurl
cid			是
crid			是
策略
猫
attr
API
协议
qagmediarating
language
dealid
周
小时
wratio
hratio
exp

出价对象支持的扩展程序

属性	实现细节
apis	如果同时支持 OMID 和 MRAID，DV360 将发送 seatbid.bid.apis。DV360 会将 OMID_1 和 MRAID 都设置为整数数组。

广告投放选项

在 OpenRTB 规范的 4.3 部分中，有两种不同的投放选项：

• 在胜出通知中提供的标记
• 出价中提供的标记

DV360 支持这两种选项。

• 对于横幅广告，DV360 始终会在 adm 字段中返回标记。在胜出通知中提供的标记是可选的。
• 对于使用 VAST 协议的视频/音频广告，DV360 支持根据广告交易平台合作伙伴的要求，在 adm 字段或胜出通知的响应中返回 VAST XML。

请参阅 OpenRTB 规范，了解这两种方案的优缺点。

最佳做法

强烈建议使用 Display & Video 360 的合作伙伴 ID 作为席位 ID。不建议使用特定于交易平台的席位 ID。

确保您的发布商拥有 ads.txt 文件或关联了 app-ads.txt 文件的应用，并且他们在文件中将您列为授权卖方或经销商。了解详情。

此外，还要确保在出价请求中传递的信息保持一致。例如，app.bundle 必须与移动设备信息和 app.storeurl 保持一致。

联网电视

在传递 device.ifa 和 device.lmt 时，请遵循 IAB OTT IFA 指南。您还应实现 device.ext.ifa_type 以符合相关准则。我们所有的 CTV 频次上限和受众群体定位功能都需要有 IFA。

此外，还应遵守最近发布的 IAB OTT/CTV 商店分配的 ID 指南，该指南定义了如何为 CTV 应用传递 app.bundle，主要使用应用商店定义的 ID。

Active View 衡量

Active View 是 Google 推出的一项技术，用于衡量展示是否可见以及可见时长。Active View 会针对展示广告和视频广告使用 OMID。如需使用 OMID 启用效果衡量，广告交易平台必须在 OpenRTB 请求中添加以下字段，以便 DV360 了解客户对 OMID 的支持情况。

• 必需：向出价请求添加 API 框架（OMSDK 的 Video.api=7）。对于使用 OMID 启用衡量功能的 Active View，此属性是必需的。
• 建议：强烈建议向 Source.Ext 添加 omidpn 和 omidpv，因为这会影响 DV360 向客户报告可视性指标的方式。如果 OMID 合作伙伴名称未列在 IAB 认证列表中，根据 MRC 的要求，我们需要单独报告可视性指标，而不是与 MRC 认证的指标一起报告。 了解详情。

常见问题解答

DV360 是否支持广告交易平台自定义扩展服务？

可以。除了此规范中列出的扩展服务之外，Display & Video 360 还可能会根据具体情况支持自定义扩展服务。建议在集成期间指定并测试自定义扩展程序。

DV360 是否支持激励视频？

是，请向我们发送激励视频广告扩展服务。

我的很多影视内容都显示为“受众特征未知”，如何提高受众特征覆盖面？

在向 DV360 发送的出价请求中填充 user.yob 和 user.gender，以扩大覆盖面。

DV360 是否为每个地区都设置了端点？

不可以，我们使用单一的全球端点，并且会自动将请求路由到最近的数据中心，因此无法提供特定于区域的端点。

服务器到服务器 (s2s) 请求有哪些要求？

联系我们，申请将您的项目添加到我们的许可名单中。必须转发客户端 User-Agent，并确保在对 s2s VAST 提取的响应中停用/忽略 Cookie。

DV360 是否支持 OMID？

只要在出价请求时声明为启用 OMID，我们就能使用 OMID 衡量可见度。有关此方面的详细信息，请参阅第 24-25 页。

您支持哪个版本的 Native？您是否有任何 Native 要求？

我们仅支持原生广告版本 1.2。原生广告规范。

DV360 是否支持以 GZIP 格式发送的出价请求？

DV360 可以接收 gzip 压缩的出价请求，并且如果 Accept-Encoding 标头表明支持 gzip 压缩，则会以 gzip 压缩的响应进行回复。

DV360 是否支持 DB网址？

目前还不行。

DV360 是否支持成败通知？

目前不能。如果您认为我们支持此功能会很有用，请与我们联系并提供更多详细信息。

DV360 是否需要 App.name 进行定位？

否，DV360 使用 App.name 进行引用，但它不是定位所必需的，App.bundle 用于定位。

DV360 是否支持在单个出价请求中发送多种广告尺寸？

是的，我们会考虑 banner.format 中的所有符合条件的广告素材尺寸。

DV360 是否支持在同一出价请求中发送多种格式？

我们对包含多种格式的出价请求的支持有限，但正在努力改进。我们支持插页式广告的展示广告和视频广告格式，但目前不支持展示广告和原生广告。如果您发送的是多格式出价请求，请与我们联系以申请测试。

DV360 是否支持在同一请求中混合使用不同类型的展示？

目前，我们仅支持视频/横幅插页式广告。我们正在开发原生广告/横幅广告和视频广告/横幅广告。如果存在其他组合，请联系我们的团队。

多个席位能否在同一请求中针对一个或多个此类展示机会各自发送多个出价？

可以。

对于同一请求中多次出现此类展示机会的情况，DV360 是否有关于限制或展示同一广告客户的解决方案或特定需求？

DV360 强制规定，对于每个请求，一个广告客户只能针对一个展示机会出价。我们希望 SSP 以有意义的方式对 imp 对象进行分组；例如，全部位于同一网页上、全部位于同一应用中等。

DV360 是否支持在同一出价请求中包含多个展示机会？

DV360 目前支持多个展示音频对象。不过，我们需要测试/启用想要使用此功能的每个交易所。如需了解详情，请参阅出价请求规范。我们正在努力将此功能扩展到其他格式：

{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

与我们联系

如果您有任何疑问或问题，请联系我们的交易所支持团队。