VAST 广告代码网址参数

适用于网站的必需参数和建议参数

在不使用 IMA SDK 的情况下实施基于代码的视频广告解决方案来满足 Ad Exchange 需求是一项 Beta 版功能,未必可供您的广告联盟使用。如需了解详情,请与您的客户经理联系。

下方列出了一部分 VAST 广告代码网址参数。在网站中实施基于代码的视频广告解决方案时,如果未集成 IMA SDK,这些参数则为必需参数。

您可以查看应用的必需参数程序化变现的必需参数和建议参数列表。

书签 您可通过下方列表中的链接跳转至具体参数

correlator
description_url
env
gdfp_req

iu
output
plcmt
sz

unviewed_position_start
url
vpmute
wta

 
参数 详细说明
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_id/.../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_vast3xml_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

是否必需

必需 对于网站应用为必需参数

推荐 对于程序化变现为推荐参数

vpmute

(视频播放静音)

建议使用,请参阅 MRC 视频衡量指南

“静音视频”参数接受常量值,用于指明在开始播放广告时是否将视频播放器设为静音状态。

用法示例

设为静音:
vpmute=1

不设为静音:
vpmute=0

是否必需

必需 对于网站程序化变现是必需的

wta

(为什么显示该广告)

“为什么显示该广告?”参数接受常量值,该值旨在指明视频播放器对呈现“为什么显示该广告?”的支持能力。

当使用 IMA SDK 时,系统会自动支持“为什么显示该广告?”功能。当未使用 IMA SDK 时,视频播放器必须实现 VAST IconIconClickFallbackImage 支持,如 IAB VAST 标准中所述。

如果“广告选项”图标(如 VAST 响应中所含)将在随播广告上呈现或以其他方式提供给用户,音频广告请求应发送 wta=1

为了能够对接欧洲经济区 (EEA) 境内的 Google 需求来源和 Google 托管的预订流量,广告请求必须发送 wta=1 以表明:对于所有广告素材,“广告选项”图标(如 VAST 响应中所含)都将在视频广告上、在随播广告上或以其他方式提供给用户。

用法示例

支持:
wta=1

不支持:
wta=0

是否必需

必需Ad Exchange 而言,是必需

必需网站应用 EEA 流量而言,是必需

推荐 对于程序化变现为推荐参数

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
Google 应用
主菜单
5185514517092121071
true
搜索支持中心
true
true
true
true
true
148