在不使用 IMA SDK 的情况下实施基于代码的视频广告解决方案来满足 Ad Exchange 需求是一项 Beta 版功能,未必可供您的广告联盟使用。如需了解详情,请与您的客户经理联系。
下方列出了一部分 VAST 广告代码网址参数。在程序化交易中实施基于代码的视频广告解决方案时,如果未集成 IMA SDK,这些参数则为必需参数。
请参阅用于网站的必需参数和建议参数或用于应用的必需参数列表。
跳转到列表中的特定参数
参数 | 详细说明 | |
---|---|---|
hl
(语言) |
“语言”参数接受常量值,用于请求使用该语言的广告,在对 Ad Exchange 或 AdSense 视频进行动态分配的过程中,此参数用于指定在进行广告选择和视频广告呈现时所使用的语言。 参数值可以是任意的 ISO 639-1(两个字母)或 ISO 639-2(三个字母)代码。请参阅有效代码列表。 如果省略,参数值默认为在 Ad Exchange 中根据语言定位广告时指定的任一语言。 用法示例
是否必需对于程序化变现为推荐参数 |
|
description_url
(说明网址) |
“说明网址”参数接受变量值,此值应该用于描述在网页上播放的视频。用 1-3 段描述性内容概述网页。例如,从预定义的块中动态拼接 对于网页视频播放器和 CTV/OTT 设备, 此参数不是由 IMA SDK 自动设置的,需要手动设置。 用法示例经过网址编码: 未经网址编码: 是否必需对于网站、应用和 Ad Exchange,是必需参数 对于程序化变现而言,是推荐项 |
|
dth
(设备类型提示) |
设备类型提示参数接受常量值,有助于减少设备分类错误,尤其是在联网电视和机顶盒环境中。 设备误分类可能是由于发布商或联网电视 OEM 的意外错误造成的。此参数将与其他信号结合使用,以便 Google 自动标记可能需要对联网电视广告资源进行重新分类的情况。 用法示例请求来源:
是否必需对于联网电视上的程序化变现,此参数为推荐参数。 对于 PAL 和 PAI(非 SDK)实现方案,此参数为推荐参数。IMA SDK 和 DAI SDK 不需要此参数。 |
|
msid
(应用 ID) an
(应用名称) |
“应用 ID”参数和“应用名称”参数接受变量值,它们应该应用于从移动应用和联网电视设备发送的请求,因为大多数程序化视频广告都需要使用它们。 IMA SDK 会自动填充这两个参数,但必须在非 SDK 环境(包括直接 VAST 调用)中或者使用 Programmatic Access Library (PAL) 或发布商身份经过验证的广告资源 (PAI) 时手动指定这些参数。 虽然应用名称应该会是人类可读的名称,但在 iOS 和 tvOS 上,SDK 却无法获取应用 ID。在这些情况下,系统不会发送 用法示例
应用 ID 在不同应用商店中采用不同的命名方式和格式。查看应用识别的 IAB 指南或常见唯一标识符示例。 对于没有应用商店的平台,IAB 建议发布商使用以下格式的商店 ID: 是否必需应用需要这两个参数 对于程序化变现为推荐参数 |
|
plcmt
(展示位置) |
||
pp
(广告素材配置文件) |
||
rdid
(可重置的设备标识符) |
可重置设备标识符接受变量值。 对于内置应用(而非网站或移动网站),SDK 会通过以下各项的参数将用于用户定位的可重置设备标识符传递到视频流请求: 几乎所有程序化视频广告都需要这些值。
用法示例查看可重置设备标识符的详细示例。 是否必需对于应用为必需参数 对于程序化获利为推荐参数 |
|
sid
(会话 ID) |
“会话 ID”参数接受变量值,它是一种保护用户隐私的广告标识符,仅用于实现频次上限。 来自联网电视的插播视频请求和来自移动应用设备的插播视频广告资源均支持会话 ID。Web 应用目前不支持此 ID。 根据 IAB 的 IFA 指南,此参数必须以 UUID 格式填充。详细了解用于用户定位的可重置设备标识符。 您可以通过设置 用法示例
是否必需对于程序化变现为推荐参数 |
|
url
(网址) |
“网址”参数接受一个变量值,此值应设为发送请求的完整网址。买方需要使用此值来协助确定和了解该请求是在何种情境下发送的。您应尽可能在广告请求中动态地填充此值。 在网页中,这是显示视频播放器的网页的网址。如果您使用 IMA SDK,它会自动设置网址值。如果您的播放器设置了此值,IMA SDK 将会遵循所设置的值。 在应用(移动应用或联网电视应用)内,此值应设为一个最能准确体现正被用来变现的视频/音频广告资源的网址。例如,如果用户正在一款移动应用内观看某个视频,而等效的桌面版网址上也提供了该视频。* 此参数的值应进行编码。 用法示例
*对于应用,如果无法将该参数设为一个变量网址值,最好使用以下格式来设置它: 是否必需对于程序化变现为推荐参数 |
|
vpa
(视频自动播放) |
||
vpmute
(视频播放静音) |
||
vpos
(视频内位置) |
||
wta
(为什么显示该广告) |
“为什么显示该广告?”参数接受常量值,用于指明视频播放器是否支持呈现广告标示。如果未发送 当使用 IMA SDK 时,系统会自动支持广告标示功能。当未使用 IMA SDK 时,视频播放器必须实现 VAST 如果发布商不会呈现 VAST 响应中提供的“广告选项”图标,则必须发送 如果 VAST 响应中提供的“广告选项”图标将在随播广告上呈现或以其他方式提供给用户,音频广告请求可能会发送 对于来自欧洲经济区 (EEA) 的流量,如果请求中设置了 广告必须符合在欧洲经济区投放广告需遵循的适用法规要求。这包括为用户提供举报非法内容的机制。发布商必须使用相应表单,将收到的任何非法内容举报信息告知 Google。 用法示例支持:
不支持: 是否必需对 Ad Exchange 而言,是必需项 对于程序化变现而言,是推荐项 |