视频广告支持推出后,买方可以通过 Authorized Buyers 购买视频广告资源。 本文档简要介绍了使用 Authorized Buyers 协议通过实时出价进行购买时需满足的集成要求。 如需了解可用协议,请参阅入门指南的选择协议部分。
买方可以购买跨展示位置(目前为插播广告和插页式广告)的视频广告资源。 如需了解详情,请参阅 插页式广告。
买方要求
新的实时出价买方应使用最新的协议缓冲区和以下各部分中所述的信息开发出价工具。如需下载协议,请参阅实时出价参考数据页面。 如需了解如何开发出价工具,请参阅处理请求和构建响应。
Supported macros
插播视频广告素材支持以下宏:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Click 宏(例如 CLICK_URL_ESC
)不是必需的,因为 Authorized Buyers 将其点击跟踪广告代码包含在 VAST 封装容器中。
因此,插播视频广告不支持 Click 宏。
如需详细了解支持的宏,请参阅构建响应下的指定宏。
宣传信息详情
实时出价协议使用 real-time-bidding-proto.txt 文件中定义的视频消息来识别视频请求,并提供有关该请求的其他视频信息。
嵌套视频消息中的以下字段列表也提供了详细说明和示例:
description_url
-
描述视频内容的网页对应的网址(移除了参数)。 发布商将此网址提交给 Google。例如:
http://www.publisher.com/watchpagelink
EndCapSupport
-
启用后,可选择随播广告,以便在视频广告播放完毕后在视频广告位中作为结束画面(信息卡)呈现。
END_CAP_NOT_ENABLED
随播广告未呈现为结尾画面。 END_CAP_OPTIONAL
如果响应中包含符合条件的随播横幅广告,但不需要随播横幅广告,则呈现结尾画面。 END_CAP_FORBIDDEN
包含随播广告的响应被过滤。 END_CAP_REQUIRED
不含随播广告的响应会被滤除。 is_embedded_offsite
-
如果设为
true
,则视频会嵌入到发布商网域之外的网页上。 is_rewarded
-
如果设置为
true
,则表示用户因观看视频广告而获得奖励。一般奖励包括免费阅读一篇额外的文章、在游戏中多走一条命,或者参加一次无广告打扰的音乐活动。 max_ad_duration
-
所返回广告的时长上限(以毫秒为单位)。 如果设置为
0
,则没有时长上限。 max_ads_in_pod
- Authorized Buyers 视频广告连播中的广告数量上限。 非零值表示当前广告位是可展示多个视频广告的视频广告连播。 实际展示的视频广告数量可以小于或等于此值,但不能超出此值。
min_ad_duration
- 您应返回的广告的时长下限(以毫秒为单位)。 如果未设置此属性或值小于或等于零,则没有最短时长限制。
Placement
- 说明视频播放位置。
UNKNOWN_PLACEMENT
展示位置未知或无法确定。 INSTREAM
插播广告是指在其他视频内容播放前、播放过程中或播放后播放广告。这与传统电视商业广告类似。 用户观看的视频内容不会在广告播放时播放。 INTERSTITIAL
插页式广告是指在非视频内容(例如新闻报道或视频游戏)前播放的视频广告。 广告会占据屏幕上的所有内容或几乎所有空间,并且用户必须看完广告或跳过广告才能继续操作。 IN_FEED
信息流视频格式是一种视频广告素材,会在用户滚动浏览内容信息流(通常是社交应用信息流、新闻报道等)时显示。视频会在主信息流中以及用户的视听和阅读流程中呈现。此类视频不会像横幅内嵌视频那样在侧面呈现。 skippable_max_ad_duration
- 当广告可跳过时,您应返回的广告的时长上限(以毫秒为单位)。 这通常不同于不可跳过广告允许的时长上限。 如果此字段未设置或值小于或等于零,则允许任何时长。
VideoPlaybackMethod
- 说明如何播放视频广告。根据可用的最佳测量结果确定播放方法为自动播放还是点击播放。
AUTO_PLAY_SOUND_ON
表示广告会在有声状态下自动播放。 AUTO_PLAY_SOUND_OFF
表示广告会在静音状态下自动播放。 CLICK_TO_PLAY
表示广告只有被用户点击后才会播放。 video_ad_skippable
- 这是包含以下某个值的
SkippableBidRequestType
值:ALLOW_SKIPPABLE
表示允许投放可跳过式广告和不可跳过式广告。 REQUIRE_SKIPPABLE
表示只能返回可跳过的广告。 BLOCK_SKIPPABLE
表示只能返回不可跳过的广告。 如果未设置此字段,则默认允许可跳过广告。
videoad_start_delay
-
从视频开始播放到展示广告的位置所用的时间(以毫秒为单位)。 0 表示前贴片广告,-1 表示后贴片广告。 任何其他正值表示广告位位于视频中间。
仅当设置了此参数时,该值才有效。 如果未设置,则显示位置未知。
以下信号并非视频广告素材所独有,但对于出价方来说特别有价值:
advertising_id
- 此字段是仅在使用 SSL 时设置的 16 字节 UUID。这是
encrypted_advertising_id
的未加密版本。 对于 iOS 设备,它包含广告客户标识符 (IDFA)。对于 Android 设备,它包含 Android 标识符 (ADID)。对于联网电视设备,该文件包含唯一标识符(例如 Roku 的 RIDA)。 device_type
- 指定设备的类型。
UNKNOWN_DEVICE
是此字段的默认值。 HIGHEND_PHONE
包括具备视频功能的手机。 TABLET
包括平板电脑设备 PERSONAL_COMPUTER
包括桌面设备和笔记本电脑设备。 CONNECTED_TV
包括联网电视(即智能电视)和联网设备(例如 Roku、Apple TV 等)。 GAME_CONSOLE
包括专用游戏设备。 brand
- 指定设备的品牌(如诺基亚或三星)。 此字段是选填字段;默认情况下不指定。
model
- 指定设备的确切型号(例如 N70 或 Galaxy)。此字段是选填字段;默认情况下不指定。
screen_orientation
-
指定发送广告请求时设备的屏幕方向。
有效值为
LANDSCAPE
、PORTRAIT
和UNKNOWN_ORIENTATION
。 viewability
-
根据此槽过去的可见频率,估计最终用户看到相应槽位的可能性。以 [0, 100] 范围内的百分比表示。默认值
-1
表示不提供历史可见度数据。 content_attributes.duration_seconds
-
视频广告播放的秒数(例如 200 秒)。
这在
ContentAttributes
消息中声明。 此属性设置为视频发布商提供的视频元数据中指定的值。
视频出价请求还包含与广告资源相关的信息,例如行业、允许的供应商和频道信息。出价请求中的所有其他现有字段也会应用于视频广告。
视频广告请求的 AdSlot 消息中的宽度和高度字段与视频广告播放器的尺寸相对应。
allowed_vendor_type
- 允许的供应商。如需查看 ID 列表,请参阅技术文档中的 vendors.txt 文件。 例如,309 = DFA 视频单元。
allowed_video_formats
- 说明应此请求而投放的广告所允许的视频技术。
响应应指明至少支持其中一项。
此重复字段的值来自枚举 VideoFormat:
VIDEO_FLASH
允许播放使用 Flash 视频 (FLV) 格式的视频。 VIDEO_HTML5
允许采用 HTML5 视频格式的视频。 VPAID_FLASH
允许采用视频播放器广告投放接口定义 (VPAID) Flash 视频格式的视频。 VPAID_JS
允许采用 VPAID JavaScript 视频格式的视频。 companion_slot
-
此字段表示包含以下字段的 CompanionSlot 消息:
height
此广告位的可用高度。 width
此广告位的可用宽度。 CreativeFormat
广告素材格式表示相应广告素材在此随播广告位中可能采用的格式。 url
-
视频观看页面的网址或已嵌入视频的网页的网址。例如:
http://www.publisher.com/watchpagelink
在响应视频广告请求时,出价工具应在 video_url
字段中返回 VAST 重定向网址。
出价响应还应包含相应视频广告的正确声明。
以下是一个合适的视频广告出价响应摘要:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
视频广告出价响应中的重要字段如下:
attribute
-
可通过此代码段展示的广告的所有属性。如需查看 ID 列表,请参阅
buyer-declarable-creative-attributes.txt 文件。
我们会检查并确保这些属性都不会显示在出价请求的
excluded_attribute
列表中。 仅当系统返回 HTML 代码段或视频广告时,才设置此字段。 例如,如果将此字段设为30
,则表示广告需要支持 VPAID 才能呈现。 protocol
-
说明发布商针对视频广告请求支持的 VAST 版本,允许使用最高且包含指定版本的 VAST 广告。
包含一组受支持的视频广告协议。
这与 OpenRTB 2.4 中的行为相对应。可能出现的值包括
VAST_2_0
、VAST_3_0
、VAST_2_0_WRAPPER
、VAST_3_0_WRAPPER
、VAST_4_0
和VAST_4_0_WRAPPER
。 video_url
-
视频广告的 VAST 重定向网址。例如:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
预定位
为了接收视频广告资源,实时出价买方必须为包含视频广告资源的实时出价提供预定位配置。
出价请求和响应示例
AdX 视频广告格式
买方如何添加视频广告
下表说明了买方可通过哪些方法在广告素材和展示位置(分别用于网站和移动应用)中添加视频。
Web
视频广告素材 | 插播广告(全部) | 信息流广告/文章 | 原生信息流广告/文章内嵌广告 | 插页式广告 | 横幅内嵌广告 |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID + JS |
|
|
|
|
|
自定义 JS |
|
||||
原生广告 + VAST |
|
移动应用
视频广告素材 | 插播广告(全部) | 信息流广告/文章 | 原生信息流广告/文章内嵌广告 | 插页式广告 | 横幅内嵌广告 |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID + JS |
|||||
自定义 JS |
|||||
原生广告 + VAST |
键: | 格式/技术不可用 | 此展示位置已接受视频广告素材,但要遵守发布商屏蔽设置 |
此展示位置不提供视频广告素材 |
---|
OpenRTB 建议信号
下表介绍了适用于桌面版网站和移动网站以及移动应用的所有视频广告格式的 OpenRTB 建议信号。
桌面网站和移动网站
视频格式 | 推荐信号(仅限与视频广告相关的信号) | 相关信号(仅限视频广告相关信号) |
---|---|---|
插播 (VPAID) |
存在 VIDEO 对象 & |
|
插播广告(无 VPAID) |
存在 VIDEO 对象 & |
|
外播 |
存在 VIDEO 对象
|
|
信息流广告 |
存在 VIDEO 对象 & |
|
文章内嵌 |
存在 VIDEO 对象 & |
|
原生 |
存在 NATIVE 对象 |
|
横幅内嵌广告 |
视频对象不存在 & |
移动应用
视频格式 | 出价请求详细信息(仅限视频相关详细信息) | |
---|---|---|
插播 |
存在 VIDEO 对象 & |
|
外播 |
存在 VIDEO 对象
|
|
信息流广告 |
存在 VIDEO 对象 & |
|
文章内嵌 |
存在 VIDEO 对象 & |
|
原生 |
存在 NATIVE 对象 |
|
插页式 (VAST) |
存在 VIDEO 对象 & |
|
插页式广告(无 VAST) |
存在 VIDEO 对象 & |
已过滤 |
横幅内嵌广告 (MRAID) |
视频对象不存在 & |
|
横幅内嵌广告 (不使用 MRAID) |
视频对象不存在 & |
AdX 协议推荐的信号
下表说明了适用于桌面版网站和移动网站以及移动应用的所有视频广告格式的 Authorized Buyers proto 推荐信号。
桌面版网站和移动网站
视频格式 | 推荐的视频相关信号 | 相关视频相关信号 |
---|---|---|
插播 (VPAID) |
显示视频消息 & |
|
插播广告(无 VPAID) |
显示视频消息 & |
Allowed_video_formats = VIDEO_HTML5 & |
信息流广告 |
显示视频消息 & |
Allowed_video_formats = VIDEO_HTML5 & |
文章内嵌 |
显示视频消息 & |
|
原生 |
原生消息中显示了 NATIVE 消息 & |
|
横幅内嵌广告 |
|
|
移动应用
下表显示了适用于桌面版网站和移动网站以及移动应用的所有视频广告格式的 AdX proto 推荐信号。
视频格式 | 与视频相关的出价请求的详细信息 | 视频相关信号 |
---|---|---|
插播 |
存在视频消息 |
|
信息流广告 |
显示视频消息 & |
|
文章内嵌 |
显示视频消息 & |
|
原生 |
原生消息中显示了 NATIVE 消息 & |
|
插页式广告 |
显示视频消息 & |
|
横幅内嵌广告 (MRAID) |
|
|
横幅内嵌广告 (不使用 MRAID) |
|
|
发布商如何允许/禁止视频
下表说明了发布商可在其展示位置中允许/禁止视频的各种方法,以及视频如何在 OpenRTB 和 AdX Proto 的出价请求中显示。
OpenRTB
发布选项 | 适用的格式 | 在出价请求中描述为 |
---|---|---|
为插播视频广告指定单位 |
插播广告(全部) |
存在视频对象 & |
选择启用 VPAID |
插播网站广告 |
视频对象展示 & |
选择加入 IBV |
横幅内嵌广告 插页式广告 |
|
选择启用外播广告(instructions) |
信息流广告 文章内嵌 |
存在视频对象 & |
选择启用外播广告(instructions) |
原生 |
存在原生对象 |
屏蔽视频插页式广告 |
插页式应用 |
视频对象不存在 |
AdX 协议
发布选项 | 适用的格式 | 在出价请求中描述为(注意:这些是出价请求中发布商选项的所有指示符 - 有关建议的信号,请参阅下表) | 默认设置 |
---|---|---|---|
为插播视频广告指定单位 |
插播广告(全部) |
显示视频消息 & |
不适用 |
选择启用 VPAID |
插播网站广告 |
显示视频消息 &
|
已停用 |
选择加入 IBV |
横幅内嵌广告 插页式广告 |
|
已停用 |
选择启用外播广告(instructions) |
信息流广告 文章内嵌 |
显示视频消息 & |
已停用 |
选择启用外播广告(instructions) |
原生 |
出现原生消息并 原生消息中的 |
已停用 |
屏蔽视频插页式广告 |
插页式应用 |
视频消息不存在 & |
已启用 |
边缘用例
# | 支持请求说明 | 评论 | 出价请求 |
---|---|---|---|
1 |
使用 MRAID 的延迟自定义关闭 |
对于插页式广告,关闭广告可使用 MRAID 向买方发送通知,即使他们未使用自定义关闭也是如此。 AdX 应用的 X 将始终显示在任何自定义关闭操作的顶部,即使自定义关闭在 5 秒后显示也是如此 |
术语库
插播广告和外播广告格式的 AdX 和 OpenRTB 字段
AdX 协议
BidRequest.Video 等。 | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB 协议
BidRequest.Video 等。 | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
指明展示必须是线性还是非线性等。如果未指定任何类型,则假定允许所有展示。
|
||||
videoad_start_delay
|
|
出价请求价值来源
OpenRTB 对象 | 字段 | AdX /广告交易平台 出价 外播广告 |
示例值 | 谁负责决定? /此值派生自 的来源? |
---|---|---|---|---|
对象 | ||||
视频 | 哑剧 | 是 | ["application/javascript", "video/mp4"]", |
|
最短持续时间 | 否 | 发布商配置 | ||
最大时长 | 是 | 发布商配置 | ||
playmet hod |
是 | [6] | 通常是由发布商 配置 |
|
API (MRAID) | 是 | [1、2] | ||
protocols | 是 | [2,3,5,6,7,8] | ||
线性度 | 是 | [1] | ||
展示位置 | 是 | [1] | ||
播放器宽度 | 是 | 400,400,300 | ||
播放器高度 | 是 | 225,300,153 | ||
启动延迟 | 是 | 0 | Google,默认为 5 秒 | |
跳过 | 是 | 1 | Publisher/Google - 对于插页式广告 => Google - 对于插播广告 => 发布商 决定是允许 允许可跳过式、不可跳过式或同时采用两者。 激励广告,一律不可跳过; |
|
最低比特率 | 否 | |||
最大比特率 | 否 | |||
pos | 是 | 1 | ||
设备 | ||||
Px 比率 | 是 | 1 | ||
展示 | ||||
安全 | 是 | 1 | Google 默认为 true ,因为广告代码始终是 安全的 |