在不使用 IMA SDK 的情况下实施基于代码的视频广告解决方案来满足 Ad Exchange 需求是一项 Beta 版功能,未必可供您的广告联盟使用。如需了解详情,请与您的客户经理联系。
下方列出了一部分 VAST 广告代码网址参数。在网站中实施基于代码的视频广告解决方案时,如果未集成 IMA SDK,这些参数则为必需参数。
请查看用于应用的必需参数或用于程序化变现的必需参数和推荐参数列表。
您可通过下方列表中的链接跳转至具体参数
参数 |
详细说明 |
correlator
(Correlator)
|
“Correlator”参数接受变量值,源于同一次网页浏览的多项请求会共用此值。在进行竞争排除(包括在没有 Cookie 的环境中)时会用到此参数。
如果您使用 IMA SDK,系统会自动设置 Correlator 值。如果您的播放器尝试设置此值,SDK 会将其替换成自己的值。
如果您未使用 IMA SDK,请确保将此值设置为当前没有被多次网页浏览重复使用的真正随机的正整数值。
用法示例
correlator=4345645667
是否必需
对于网站和应用为必需参数
对于程序化变现为推荐参数
|
description_url
(说明网址)
|
“说明网址”参数接受变量值,此值应该用于描述在网页上播放的视频。该网页通常是包含视频播放器的网页,但也可以是包含视频介绍文字的网页。
对于网页视频播放器和 CTV/OTT 设备,description_url 值必须经过网址编码;对于移动应用内视频播放器,此值必须未经网址编码。
此参数不是由 IMA SDK 自动设置的,需要手动设置。
用法示例
经过网址编码:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
未经网址编码:
description_url=
https://www.sample.com/golf.html
是否必需
对于网站、应用和 Ad Exchange,是必需参数
对于程序化变现为推荐参数
|
env
(环境)
|
“环境”参数接受常量值,用于指明这是一项插播广告请求或者该请求是明确来自视频播放器。
可能的值包括 instream (可用于视频和音频广告)或 vp (仅可用于视频广告)。
用法示例
视频和/或音频:
env=instream
仅限视频:
env=vp
是否必需
对于网站和应用为必需参数
|
gdfp_req
(Ad Manager 架构指示器)
|
“Ad Manager 架构指示器”参数接受常量值,用于指明用户在 Ad Manager 架构中。
用法示例
gdfp_req=1
是否必需
对于网站和应用为必需参数
|
iu
(广告单元)
|
“广告单元”参数接受变量值,此值应设为当前广告单元,格式为:
/network_code/.../ad_unit
用法示例
iu=/6062/videodemo
是否必需
对于网站和应用为必需参数
|
output
(广告输出格式)
|
“广告输出格式”参数接受常量值,此值应设为广告的输出格式。
请根据您为广告联盟设置的默认 VAST 版本来使用 output=vast 。对于您网站中的特定广告代码或特定部分,您可以请求特定 VAST 或 VMAP 版本。
对于 VAST,如果您的视频播放器使用 IMA SDK,那么视频广告请求的输出参数将始终设为 output=xml_vast4 。这不会导致可靠性方面的风险,因为此 SDK 可向后兼容任何第三方广告服务器可能投放的所有 VAST 版本。
若要返回您为广告联盟启用的默认 VMAP 版本(如 VMAP 1),请使用 output=vmap 。如果您要在 VMAP 内部返回 VAST,则可以使用 xml_vmap1_vast3 或 xml_vmap1_vast4 指定要返回的 VAST 版本。
用法示例
您广告联盟的默认 VAST 设置:
output=vast
VAST 4:
output=xml_vast4
您广告联盟的默认 VMAP 设置:
output=vmap
VMAP 1:
output=xml_vmap1
VMAP 1,返回 VAST 4:
output=xml_vmap1_vast4
是否必需
对于网站和应用为必需参数
|
plcmt
(展示位置)
|
展示位置参数接受常量值,用于指明插播广告资源是声明为插播广告资源还是随播广告资源,详情请参阅IAB 规范。
对于非插播请求,此字段会由系统根据声明的广告资源格式自动为买家填充,并将替换任何插播或随播内容声明。
用法示例
插播广告请求:
plcmt=1
随播内容请求:
plcmt=2
是否必需
对于网站和程序化变现是必需的
|
sz
(尺寸)
|
“尺寸”参数接受变量值,此值应设为主视频广告位的尺寸。
多个尺寸应以竖线 (| ) 字符进行分隔。
请勿在尺寸后面添加“v ”。
用法示例
sz=400x300
是否必需
对于网站和应用为必需参数
如果仅请求 ad_type=audio ,此参数为可选参数。
|
unviewed_position_start
(延迟记录展示次数)
|
“延迟记录展示次数”参数接受常量值,用于指明为视频延迟记录展示次数。
用法示例
unviewed_position_start=1
是否必需
对于网站和应用为必需参数
|
url
(网址)
|
“网址”参数接受一个变量值,此值应设为发送请求的完整网址。买方需要使用此值来协助确定和了解该请求是在何种情境下发送的。您应尽可能在广告请求中动态地填充此值。
在网页中,这是显示视频播放器的网页的网址。如果您使用 IMA SDK,它会自动设置网址值。如果您的播放器设置了此值,IMA SDK 将会遵循所设置的值。
在应用(移动应用或联网电视应用)内,此值应设为一个最能准确体现正被用来变现的视频/音频广告资源的网址。例如,如果用户正在一款移动应用内观看某个视频,而等效的桌面版网址上也提供了该视频。*
此参数的值应进行编码。
用法示例
url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html
*对于应用,如果无法将该参数设为一个变量网址值,最好使用以下格式来设置它:
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com
是否必需
对于网站和应用为必需参数
对于程序化变现为推荐参数
|
vpa
(视频自动播放)
|
建议使用,请参阅 MRC 视频衡量指南
“视频自动播放”参数接受常量值,用于指明广告中的视频内容是会自动开始播放还是在用户点击后开始播放。
可能的值包括:click (如果网页等待用户操作)或 auto (如果视频自动播放)。
如果该参数未知,则应使其保持未设置状态。
用法示例
自动播放:
vpa=auto
点击播放:
vpa=click
是否必需
对于程序化变现为推荐参数
|
vpmute
(视频播放静音)
|
建议使用,请参阅 MRC 视频衡量指南
“静音视频”参数接受常量值,用于指明在开始播放广告时是否将视频播放器设为静音状态。
用法示例
设为静音:
vpmute=1
不设为静音:
vpmute=0
是否必需
对于网站和程序化变现是必需的
|
wta
(为什么显示该广告)
|
“为什么显示该广告?”参数接受常量值,该值旨在指明视频播放器对呈现“为什么显示该广告?”的支持能力。
当使用 IMA SDK 时,系统会自动支持“为什么显示该广告?”功能。当未使用 IMA SDK 时,视频播放器必须实现 VAST Icon 和 IconClickFallbackImage 支持,如 IAB VAST 标准中所述。
如果“广告选项”图标(如 VAST 响应中所含)将在随播广告上呈现或以其他方式提供给用户,音频广告请求应发送 wta=1 。
为了能够对接欧洲经济区 (EEA) 境内的 Google 需求来源和 Google 托管的预订流量,广告请求必须发送 wta=1 以表明:对于所有广告素材,“广告选项”图标(如 VAST 响应中所含)都将在视频广告上、在随播广告上或以其他方式提供给用户。
用法示例
支持:
wta=1
不支持:
wta=0
是否必需
对 Ad Exchange 而言,是必需
对网站和应用 EEA 流量而言,是必需
对于程序化变现为推荐参数
|