适用于程序化交易的必需参数和建议参数

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

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

您可以查看适用于网站的必需参数和建议参数或适用于应用的必需参数列表。

跳转到列表中的特定参数

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

参数	详细说明
hl （语言）	“语言”参数接受常量值，用于请求使用该语言的广告，在对 Ad Exchange 或 AdSense 视频进行动态分配的过程中，此参数用于指定在进行广告选择和视频广告呈现时所使用的语言。 参数值可以是任意的 ISO 639-1（两个字母）或 ISO 639-2（三个字母）代码。请参阅有效代码列表。 如果省略，参数值默认为在 Ad Exchange 中根据语言定位广告时指定的任一语言。 用法示例 hl=it 是否必需 对于程序化变现为推荐参数
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，是必需参数 对于程序化变现为推荐参数
msid （应用 ID） an （应用名称）	“应用 ID”参数和“应用名称”参数接受变量值，它们应该应用于从移动应用和联网电视设备发送的请求，因为大多数程序化视频广告都需要使用它们。 IMA SDK 会自动填充这两个参数，但必须在非 SDK 环境（包括直接 VAST 调用）中或者使用 Programmatic Access Library (PAL) 或发布商身份经过验证的广告资源 (PAI) 时手动指定这些参数。 虽然应用名称应该会是人类可读的名称，但在 iOS 和 tvOS 上，SDK 却无法获取应用 ID。在这些情况下，系统不会发送 msid 参数，而 SDK 会通过 an 参数发送 app bundle。 用法示例 msid=com.package.publisher&an=sample%20app 应用 ID 在不同应用商店中采用不同的命名方式和格式。查看应用识别的 IAB 指南或常见唯一标识符示例。 对于没有应用商店的平台，IAB 建议发布商使用以下格式的商店 ID：com.publisher.deviceplatform 是否必需 应用需要这两个参数 对于程序化变现为推荐参数
plcmt （展示位置）	展示位置参数接受常量值，用于指明插播广告资源是声明为插播广告资源还是随播广告资源，详情请参阅IAB 规范。 对于非插播请求，此字段会由系统根据声明的广告资源格式自动为买家填充，并将替换任何插播或随播内容声明。 用法示例 插播广告请求： plcmt=1 随播内容请求： plcmt=2 是否必需 对于网站和程序化变现是必需的
pp （广告素材配置文件）	“广告素材配置文件”参数接受变量值，用于控制哪些广告素材能够根据视频和音频广告素材配置文件中设置的配置进行投放。 用法示例 pp=creative_profile 是否必需 对于程序化获利为推荐参数
rdid idtype is_lat （可重置的设备标识符）	可重置设备标识符接受变量值。 对于内置应用（而非网站或移动网站），SDK 会通过以下各项的参数将用于用户定位的可重置设备标识符传递到视频流请求：rdid、idtype 和 is_lat。在 SSB 视频流中，您必须将这些标识符作为显式参数进行传递，就像处理客户端广告请求时一样。详细了解设备标识符。 几乎所有程序化视频广告都需要这些值。 从 iOS 14.5 开始，Apple 已弃用 LAT 信号。Google 则改为依靠非零 IDFA 来表明用户已同意在支持应用跟踪透明度的 iOS 版本上进行跟踪。因此，有效的 UserAgent 表示需要提供正确的操作系统版本。 用法示例 查看可重置设备标识符的详细示例。 是否必需 对于应用为必需参数 对于程序化获利为推荐参数
sid （会话 ID）	“会话 ID”参数接受变量值，它是一种保护用户隐私的广告标识符，仅用于实现频次上限。 来自联网电视的插播视频请求和来自移动应用设备的插播视频广告资源均支持会话 ID。Web 应用目前不支持此 ID。 根据 IAB 的 IFA 指南，此参数必须以 UUID 格式填充。详细了解用于用户定位的可重置设备标识符。 您可以通过设置 sid=0 选择不传递会话 ID。 用法示例 123e4567-e89b-12d3-a456-426614174000 是否必需 对于程序化变现为推荐参数
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 是否必需 对于网站和程序化变现是必需的
vpos （视频内位置）	“视频内位置”参数接受常量值，用于指明广告请求是从前贴片广告位、中贴片广告位还是后贴片广告位发出的。 用法示例 前贴片广告位： vpos=preroll 中贴片广告位： vpos=midroll 后贴片广告位： vpos=postroll 是否必需 对于程序化获利为推荐参数
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 流量而言，是必需 对于程序化变现为推荐参数