在不使用 IMA SDK 的情况下实施基于代码的视频广告解决方案来满足 Ad Exchange 需求是一项 Beta 版功能,未必可供您的广告联盟使用。如需了解详情,请与您的客户经理联系。
下方列出了一部分 VAST 广告代码网址参数。在应用中实施基于代码的视频广告解决方案时,如果未集成 IMA SDK,这些参数则为必需参数。
请查看用于网站的必需参数或用于程序化变现的推荐参数列表。
跳转到列表中的特定参数
rdid sz unviewed_position_start url wta
|
参数 | 详细说明 | |
---|---|---|
correlator
(Correlator) |
||
description_url
(说明网址) |
“说明网址”参数接受变量值,此值应该用于描述在网页上播放的视频。用 1-3 段描述性内容概述网页。例如,从预定义的块中动态拼接 对于网页视频播放器和 CTV/OTT 设备, 此参数不是由 IMA SDK 自动设置的,需要手动设置。 用法示例经过网址编码: 未经网址编码: 是否必需对于网站、应用和 Ad Exchange,是必需参数 对于程序化变现而言,是推荐项 |
|
env
(环境) |
||
gdfp_req
(Ad Manager 架构指示器) |
||
iu
(广告单元) |
||
msid
(应用 ID) an
(应用名称) |
“应用 ID”参数和“应用名称”参数接受变量值,它们应该应用于从移动应用和联网电视设备发送的请求,因为大多数程序化视频广告都需要使用它们。 IMA SDK 会自动填充这两个参数,但必须在非 SDK 环境(包括直接 VAST 调用)中或者使用 Programmatic Access Library (PAL) 或发布商身份经过验证的广告资源 (PAI) 时手动指定这些参数。 虽然应用名称应该会是人类可读的名称,但在 iOS 和 tvOS 上,SDK 却无法获取应用 ID。在这些情况下,系统不会发送 用法示例
应用 ID 在不同应用商店中采用不同的命名方式和格式。查看应用识别的 IAB 指南或常见唯一标识符示例。 对于没有应用商店的平台,IAB 建议发布商使用以下格式的商店 ID: 是否必需应用需要这两个参数 对于程序化变现为推荐参数 |
|
output
(广告输出格式) |
“广告输出格式”参数接受常量值,此值应设为广告的输出格式。 请根据您为广告联盟设置的默认 VAST 版本来使用 对于 VAST,如果您的视频播放器使用 IMA SDK,那么视频广告请求的输出参数将始终设为 若要返回您为广告联盟启用的默认 VMAP 版本(如 VMAP 1),请使用 用法示例您广告联盟的默认 VAST 设置: VAST 4: 您广告联盟的默认 VMAP 设置: VMAP 1: VMAP 1,返回 VAST 4: 是否必需 |
|
pvid
(应用组 ID) pvid_s
(应用组范围) |
||
rdid
(可重置的设备标识符) |
可重置设备标识符接受变量值。 对于内置应用(而非网站或移动网站),SDK 会通过以下各项的参数将用于用户定位的可重置设备标识符传递到视频流请求: 几乎所有程序化视频广告都需要这些值。
用法示例查看可重置设备标识符的详细示例。 是否必需对于应用为必需参数 对于程序化获利为推荐参数 |
|
sz
(尺寸) |
||
unviewed_position_start
(延迟记录展示次数) |
||
url
(网址) |
“网址”参数接受一个变量值,此值应设为发送请求的完整网址。买方需要使用此值来协助确定和了解该请求是在何种情境下发送的。您应尽可能在广告请求中动态地填充此值。 在网页中,这是显示视频播放器的网页的网址。如果您使用 IMA SDK,它会自动设置网址值。如果您的播放器设置了此值,IMA SDK 将会遵循所设置的值。 在应用(移动应用或联网电视应用)内,此值应设为一个最能准确体现正被用来变现的视频/音频广告资源的网址。例如,如果用户正在一款移动应用内观看某个视频,而等效的桌面版网址上也提供了该视频。* 此参数的值应进行编码。 用法示例
*对于应用,如果无法将该参数设为一个变量网址值,最好使用以下格式来设置它: 是否必需对于程序化变现为推荐参数 |
|
wta
(为什么显示该广告) |
“为什么显示该广告?”参数接受常量值,用于指明视频播放器是否支持呈现广告标示。如果未发送 当使用 IMA SDK 时,系统会自动支持广告标示功能。当未使用 IMA SDK 时,视频播放器必须实现 VAST 如果发布商不会呈现 VAST 响应中提供的“广告选项”图标,则必须发送 如果 VAST 响应中提供的“广告选项”图标将在随播广告上呈现或以其他方式提供给用户,音频广告请求可能会发送 对于来自欧洲经济区 (EEA) 的流量,如果请求中设置了 广告必须符合在欧洲经济区投放广告需遵循的适用法规要求。这包括为用户提供举报非法内容的机制。发布商必须使用相应表单,将收到的任何非法内容举报信息告知 Google。 用法示例支持:
不支持: 是否必需对 Ad Exchange 而言,是必需项 对于程序化变现而言,是推荐项 |