在不使用 IMA SDK 的情况下实施基于代码的视频广告解决方案来满足 Ad Exchange 需求是一项 Beta 版功能，未必可供您的广告联盟使用。如需了解详情，请与您的客户经理联系。
本文列出了用于在网站广告实现机制中投放广告的 VAST 广告代码的必需参数和建议参数。
本页内容
您可以查看其他广告实现类型的列表或VAST 广告代码的网址要求。
适用于网站的必需参数和建议参数
广告投放必需参数
correlator (Correlator)
说明
“Correlator”参数 (correlator) 接受变量值，源于同一次网页浏览的多项请求会共用此值。在进行竞争排除（包括在没有 Cookie 的环境中）时会用到此参数。
用法示例
correlator=4345645667
description_url（说明网址）
说明
“说明网址”参数 (description_url) 接受变量值，此值应用于描述在网页上播放的视频。
说明网址应与网页应用、移动应用或电视应用的特定网页上播放的视频相关。它不应是所有视频或所有广告请求的顶级域名。例如，如果您有一个 https://www.sample.com/golf.html 网页用于展示与高尔夫相关的视频，请将其设置为 description_url 的值。
用法示例
对于包含视频的网页和 CTV/OTT 设备，description_url 值必须经过网址编码。不过，对于移动应用，description_url 值不得编码。
经过网址编码：
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
未经网址编码：
description_url=
https://www.sample.com/golf.html
要求和建议
若要在网站和移动应用中实现广告投放，则必须提供此参数。如果您使用 Ad Exchange 或 AdSense 进行动态分配，也必须使用此参数。
对于程序化变现，此参数为推荐参数。
SDK 使用情况
此参数不是由 IMA SDK 自动设置的，需要手动设置。
请参阅适用于您平台的 IMA SDK 指南。
env（环境）
说明
“环境”参数 (env) 接受常量值，用于指明这是一项插播广告请求或者该请求是明确来自视频播放器。
可能的值包括 instream（可用于视频和音频广告）或 vp（仅可用于视频广告）。
用法示例
视频和/或音频：
env=instream
仅限视频：
env=vp
gdfp_req（架构指示器）
iu（广告单元）
output（输出）
说明
“输出格式”参数 (output) 接受常量值，此值应设为广告的输出格式。
用法示例
output=vast
使用 VAST 4（您可为特定代码设置特定版本）：
output=xml_vast4
使用您广告资源网的默认 VMAP 设置：
output=vmap
使用 VMAP 1：
output=xml_vmap1
使用 VMAP 1，返回 VAST 4（如果您要在 VMAP 内部返回 VAST）：
output=xml_vmap1_vast4
要求和建议
若要在网站、移动应用、联网电视、音频和数字户外广告中实现广告投放，则必须使用此参数。 必须输出正确的广告投放响应格式。
SDK 使用情况
对于 VAST，如果您的视频播放器使用 IMA SDK，那么视频广告请求的输出参数将始终设为 output=xml_vast4。这不会导致可靠性方面的风险，因为此 SDK 可向后兼容任何第三方广告服务器可能投放的所有 VAST 版本。
Authorized Buyers 和公开出价的 VAST 版本
如果您想针对 Authorized Buyers 和公开出价严格按 VAST 版本进行过滤，可以在您的广告资源网设置中启用“严格滤除 VAST 版本”设置。
sz（尺寸）
说明
“尺寸”(sz) 参数接受变量值，此值应设为主视频广告位的尺寸。
多个尺寸应以竖线 (|) 字符进行分隔。
请勿在尺寸后面添加“v”。
用法示例
单个尺寸：sz=400x300
多个尺寸：sz=300x250|400x300
unviewed_position_start（延迟记录的展示次数）
url（网址）
说明
“网址”参数 (url) 接受一个变量值，此值应设为发送请求的完整网址。买方需要使用此值来协助确定和了解该请求是在何种情境下发送的。您应尽可能在广告请求中动态地填充此值。
- 在网站上，这是显示视频播放器的网页的网址。
- 在非网站环境中，此值应设为一个最能准确体现正被用来变现的视频/音频广告资源的网址。例如，如果用户正在一款移动应用内观看某个视频，而等效的桌面版网址上也提供了该视频。*
注意：url 与 description_url 不同，url 是指发出广告请求的位置，而 description_url 是可抓取的网页，用于描述视频内容。
此参数的值应进行编码。
用法示例
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
*对于应用，如果无法将该参数设为一个变量网址值，建议使用以下格式：url=https%3A%2F%2F<app/bundleid>.example.com
程序化广告必需参数
ott_placement（OTT 展示位置）
说明
OTT 展示位置参数 (ott_placement) 接受常量值，用于指明对特定类型展示位置的请求。
以下是展示位置定义示例：
- 暂停时广告：外播广告格式，当用户暂停内容播放时，以叠加层的形式显示在视频内容上层。
- 主屏幕：在联网电视设备或 OTT 应用的主屏幕上展示的广告。这包括主屏幕上的标头广告、横幅广告和磁贴广告实现。
- 画中画：在视频内容旁边的单独广告视频播放器中播放的插播视频广告。通常需要缩小视频内容并加载第二个视频播放器。
- L 型横幅广告：一种插播展示广告，通过压缩视频内容并在视频周围创建广告来实现。通常是 L 形广告内容框，但不限于这种形式。
- 重叠式广告：这类广告是指叠加在视频内容上展示的任意插播广告，但它不会占据整个屏幕。可以是展示广告，也可以是视频广告。
用法示例
支持的格式及其对应的值：
暂停时广告：
ott_placement=1
主屏幕广告：
ott_placement=2
画中画：
ott_placement=3
L 形横幅广告：
ott_placement=4
重叠式广告：
ott_placement=5
自定义/其他：
ott_placement=99
plcmt（展示位置）
说明
展示位置参数 (plcmt) 接受常量值，用于指明插播广告资源是声明为插播广告资源还是随播广告资源，详情请参阅 IAB 规范。
对于非插播请求，此字段会由系统根据声明的广告资源格式自动为买家填充，并将替换任何插播或随播声明。
用法示例
插播广告请求：
plcmt=1
随播内容请求：
plcmt=2
vpa（视频自动播放）
说明
“视频自动播放”(vpa) 参数接受常量值，用于指明广告中的视频内容是会自动开始播放还是在用户点击后开始播放。
可能的值包括：click（如果网页等待用户操作）或 auto（如果视频自动播放）。此参数不会更改视频播放器的状态，播放行为必须由视频播放器直接处理。
用法示例
自动播放：
vpa=auto
点击播放：
vpa=click
如果该参数未知，则应使其保持未设置状态。
vpmute（视频静音播放）
说明
“视频播放静音”参数 (vpmute) 接受常量值，用于指明在开始播放广告时是否将视频播放器设为静音状态。此参数不会更改视频播放器的状态，播放行为必须由视频播放器直接处理。
用法示例
播放开始时设为静音：
vpmute=1
播放开始时不设为静音：
vpmute=0
程序化广告建议参数
aconp（音频连续播放）
说明
“音频连续播放”参数 (aconp) 接受常量值，用于指明播放器是否会继续播放音频内容。这有助于 Google Ad Manager 选择最适合用户体验的广告。
用法示例
开启连续播放：
aconp=2
关闭连续播放：
aconp=1
如果您不知道音频是否会连续播放，则应使此参数保持未设置状态或将其设置为 aconp=0。
dth（设备类型提示）
说明
设备类型提示参数 (dth) 接受常量值，有助于减少设备分类错误，尤其是在联网电视和机顶盒环境中。
设备误分类可能是由于发布商或联网电视 OEM 的意外错误造成的。 此参数将与其他信号结合使用，以便 Google 自动标记可能需要对联网电视广告资源进行重新分类的情况。
用法示例
请求来自：
- 非智能手机：
dth=1 - 智能手机：
dth=2 - 桌面设备：
dth=3 - 平板电脑：
dth=4 - 联网电视：
dth=5 - 游戏机：
dth=6 - 机顶盒：
dth=7
givn（视频 Nonce）
说明
对于使用 Programmatic Access Library (PAL) 的集成，视频 Nonce 参数接受变量字符串值。
Nonce 适合包含在网址中，因此您无需对其进行网址编码。
注意：如果您之前使用旧版 paln 参数提供过 Nonce，我们强烈建议您迁移到 givn 参数并停止发送 paln。请勿同时包含这两个参数。
用法示例
如需详细了解向此参数传递的值，请参阅 PAL 的相关入门指南。
hl（语言）
说明
“语言”参数 (hl) 接受常量值，用于请求使用该语言的广告，在对 Ad Exchange 或 AdSense 视频进行动态分配的过程中，此参数用于指定在进行广告选择和视频广告呈现时所使用的语言。
用法示例
请求以意大利语投放广告：
hl=it
参数值可以是任意的 ISO 639-1（两个字母）或 ISO 639-2（三个字母）代码。请参阅有效代码列表。
如果省略，参数值默认为在 Ad Exchange 中根据语言定位广告时指定的任一语言。
omid_p（OMID 合作伙伴名称）
说明
OMID 合作伙伴名称参数 (omid_p) 接受变量值，以用于指明集成 OMID 衡量功能的合作伙伴的名称以及合作伙伴版本。
“支持的 SDK API”参数 (sdk_apis) 接受变量值，这些值可以是单个支持的 API，也可以是逗号分隔的支持的 API 列表。
这些参数是用于衡量广告可见度和进行广告验证的一组参数的一部分。
用法示例
不使用 PAL 时：
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
不妨查看一下可能的 API 框架值的列表。
使用 PAL 时：
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
要求和建议
虽然此参数不是向任何特定实现投放广告的必需参数，但建议在网站、移动应用、联网电视、音频和数字户外广告中进行程序化创收时使用此参数。
SDK 使用情况
- 此参数仅适用于使用 Open Measurement SDK (OM SDK) 时需要 Active View 衡量功能的发布商。
- 如要在使用 Programmatic Access Library (PAL) 时指明 OMID 支持，您需要使用
omidPartnerName和omidPartnerVersion来设置合作伙伴名称和版本。如果您不使用 PAL 或 IMA SDK，则必须设置omid_p和sdk_apis参数。 - 使用 IMA SDK 时，不应使用此参数，因为系统会自动设置它。
vconp（视频连续播放）
说明
“视频连续播放”(vconp) 参数接受常量值，用于指明播放器是否会继续播放视频内容（类似于电视广播）。
用法示例
开启连续播放：
vconp=2
关闭连续播放：
vconp=1
如果该参数未知，则应使其保持未设置状态。
vid_d（视频时长）
说明
“视频时长”(vid_d) 参数接受变量值，以用于指定内容的时长（以秒为单位）。
vid_d和allcues参数用于在不进行内容提取的情况下投放中贴片广告。- 您必须使用广告规则才能返回中贴片广告。如果您的广告规则中使用了基于时间的广告插入点（例如，“每 N 秒插播一次”或“在固定的时间”），系统会使用广告规则中设定的广告插入点，并忽略传递到
allcues的广告插入点。插播广告仍需设置时长，因此vid_d仍是必须传递的参数。
用法示例
视频内容时长为 90000 秒（25 小时）：
vid_d=90000
vpos（视频内位置）
说明
“视频内位置”(vpos) 参数接受常量值，用于指明广告请求是从前贴片广告位、中贴片广告位还是后贴片广告位发出的。
用法示例
前贴片广告位：
vpos=preroll
中贴片广告位：
vpos=midroll
后贴片广告位：
vpos=postroll
wta（为什么显示该广告）
说明
“为什么显示该广告？”参数 (wta) 接受常量值，用于指明视频播放器是否支持呈现广告标示。
用法示例
如果播放器应呈现 VAST 响应中提供的“广告选项”图标，请使用：
wta=1（或省略wta参数，或传递未设置值的wta）如果 VAST 响应中提供的“广告选项”图标将在随播广告上呈现或以其他方式提供给用户，音频请求应使用
wta=1。
如果播放器不应呈现 VAST 响应中提供的“广告选项”图标，请使用：
wta=0
要求和建议
虽然对于任何特定实现类型而言，无需此参数即可投放广告，但对于网站、移动应用、联网电视和音频中的程序化变现而言，此参数为推荐参数。
使用此参数时：
&wta=0流量不符合条件，无法使用 Google 需求来源的某些类型的个性化功能。- 来自欧洲经济区 (EEA) 的
&wta=0流量不符合条件，无法在预订型订单项和由发布商管理的有保证程序化订单项中投放启用了广告标示的广告素材。
广告必须符合在欧洲经济区投放广告需遵循的适用法规要求。这包括为用户提供举报非法内容的机制。发布商必须使用举报 Google 上的内容表单，将收到的所有针对非法内容的举报信息告知 Google。
SDK 使用情况
当使用 IMA SDK 时，系统会自动支持广告标示功能。当未使用 IMA SDK 时，视频播放器必须实现 VASTIcon 和 IconClickFallbackImage 支持，如 IAB VAST 标准中所述。