通知

仅在 Google Ad Manager 360 中提供。

替换视频流参数

替换视频流参数是一项可选的操作。

如果您想让播放器或应用替换以下内容,则可执行此操作:

  • 视频流创建参数的默认值
  • 请求 HLS 或 DASH 播放列表时所选或默认的变体顺序。

对于 IMA SDK服务器端信标 (SSB)DAI API 实现,您都可从播放器或应用中传递这些参数。

提示:您还可替换其他默认广告代码参数

替换所选变体和变体顺序

默认的播放列表顺序由发布商决定。如果您未指定任何排序参数,系统便会按照发布商设置的原始顺序返回播放列表。

您可以替换在创建视频流的过程中指定的变体选项和排序参数。这样一来,您便可指定在响应主播放列表请求时要包含哪一部分变体以及这些变体采用何种顺序。如果您想根据内容观看者的具体情况让某个特定变体优先于另一个变体,替换视频流变体参数可能会非常有用。

这部分变体及其顺序在相应视频流的整个播放期内将保持不变。这些参数可通过以下形式被接受:作为 adTagParameters 结构的一部分(使用 IMA SDKDAI API 参数时),或作为额外的 HTTP GET 参数(使用 SSB 时)。

参数 流式传输协议 说明 示例
dai-aor HLS、DASH

要返回的音频变体的带宽范围。

  • 若想选择所有较高带宽,请仅指定 startBandwidth
  • 若要选择所有较低带宽,请仅指定 :endBandwidth(以英文冒号“:”为前缀)。

dai-aor=123:456
dai-aor=12
dai-aor=:456

dai-dlid HLS、DASH

为视频素材资源创建 CDN 配置时,请指定默认的 CDN 配置以及额外的 CDN 分发设置。这样一来,您便可设置多个 CDN 并在会话开始时使用键值对动态地选择希望从哪个 CDN 分发内容。

在您设置并保存 CDN 配置后,Ad Manager 会为每个配置分配一个名称。此名称应以 dai-dlid 参数值的形式传递到视频流创建请求中。

如果未向相应请求传递任何名称,则 Ad Manager 会使用默认的 CDN。

注意:如果单项内容有多个 CDN 且有多个分发位置,则 dai-dlid 允许使用多个值。

dai-dlid=AaBbC1aaBa0obA1BABaaBA

AaBbC1aaBa0obA1BABaaBA 是 Ad Manager 中显示的名称)

dai-excl HLS、DASH 要从播放列表中排除的转译版本。支持 subtitlescodecaudio-langsubtitle-langiframeresolution。您可使用单个值或一系列以英文逗号分隔的值来排除分辨率、音频编解码器、视频编解码器以及音频和/或字幕语言。系统还支持带有后缀“*”的 Codec 前缀,这会排除带有指定前缀的 codec 的所有转义版本。

dai-excl=subtitles
dai-excl=iframe


一个编解码器
dai-excl=codec:ec-3

多个编解码器
dai-excl=codec:ec-3,codec:ac-3

编解码器前缀
dai-excl=codec:avc1*


一种音频语言
dai-excl=audio-lang:en

一种字幕语言
dai-excl=subtitle-lang:en

多项选择
dai-excl=audio-lang:en,
audio-lang:es,
subtitle-lang:en,
subtitle-lang:es


分辨率
dai-excl=resolution:480x272

dai-os HLS 要放置在主播放列表顶部的视频变体带宽。系统会选择与 startBandwidth 值最接近的变体。如果有两个值与此值同等接近,系统会选择最低值。如果提供了此参数,而未提供 dai-aor,系统将排除所有仅限音频的变体。 dai-os=1700000
dai-ot
                         
HLS

这是顺序类型信息,用于描述 dai-ov 参数所指定的值的类型。具体应是表示带宽(最接近的匹配)的“bw”,或是基于带宽和分辨率(完全匹配)的排序。必须至少指定一个带宽或分辨率。默认值为“bw”。

如果指定了 dai-ot 参数,而未指定 dai-ov 参数,播放列表将按照原始顺序返回所有变体。

dai-ot=bw
dai-ot=bw_res
dai-ov HLS

这是一系列以英文逗号分隔的值,用于指定要返回的媒体播放列表的顺序。必须和 dai-ot 搭配使用,并且每个值都应与 dai-ot 参数所描述的类型相同。使用 audio 特殊值可指定音频变体。

如果多个变体具有相同的顺序值(例如,带宽相同但分辨率不同的两个变体),这些变体会保持原始顺序。

dai-ot=bw&dai-ov=2025837,1406061

dai-ot=bw_res&dai-ov=1400000:640x360,audio

dai-sr HLS、DASH

要返回的视频变体的带宽范围。若要选择所有较高带宽,请仅指定 startBandwidth。若要选择所有较低带宽,请仅指定 :endBandwidth(以英文冒号“:”为前缀)。

带宽强制执行仅适用于视频内容。
dai-sr=1300000:2500000

其他可替换参数

参数 流式传输协议 说明 示例
dai-ah HLS、DASH 指定某个直播活动是否应该应用暂停显示广告。必须在直播活动配置中指定暂停显示广告的时长。 启用“暂停显示广告”:
dai-ah=1
dai-apto
 (Beta 版) 
HLS、DASH

广告连播决策超时时限(以毫秒为单位),用于限制 VOD 和直播活动创建。

此值用于在创建视频流时做出的所有“屏蔽广告”相关决策,包括线性直播的中间广告插播决策和既往广告插播决策,以及 VOD 的 VMAP 决策。对于既往的广告插播时间点,这一时限仅在使用 EVENT 类型的播放列表dai-dpb 参数时可用。

这一时限可设为任何大于 0 且不大于 10,000 的值。

将这一时限设为非常低/高的值可能会影响广告填充或用户体验。

dai-apto=4000
dai-dpb HLS、DASH

指定是否要为非 SSB 线性视频流启用既往广告插播决策(对于 SSB 视频流,此参数会被忽略)。如果启用,既往广告插播决策会与中间广告插播决策一同制定。

这可能会影响启动延迟时间,您可以使用 dai-apto 参数控制该时间。

既往广告插播不会被用户看到,除非用户回放,而这可能会导致代码调用次数增多。

启用“既往广告插播决策”:
dai-dpb=true

为 HLS EVENT 类型的播放列表停用“既往广告插播决策”:
dai-dpb=false
dai-dvr HLS、DASH 用户可以向回滚动并保持播放流畅的直播内容和广告的 DVR 时长(以秒为单位)。

此时长的当前默认值是 100 秒,或是在直播活动设置期间指定的值。不过,您可为每个直播活动指定一个新的上限(对于 SSB,最长可以指定 100 秒;如果使用 SDK 或 API,最长可以指定 1800 秒)。如果您需要更长的 DVR 时长,请与您的客户经理联系。

dai-dvr=60
dai-emsgv HLS

Event Message 版本是一个视频流创建参数,允许调用方为 Common Media Application Format (CMAF) 内容指定“emsg”版本。

HLS 标准要求使用“emsg”版本 1。

对于不支持标准版本 1 且需要版本 0 的平台(例如 Roku),此设置非常有用。
dai-emsgv=1
dai-pre (Beta 版)  HLS、DASH 指定启用了前贴片广告的直播活动是否应在前贴片广告和中贴片广告重叠的情况下展示前贴片广告,而不展示中贴片广告。默认行为是展示重叠部分的中贴片广告,而不展示前贴片广告。 dai-pre=1
dai-ad-dlid (Beta 版)  HLS、DASH

为您已在 Google Ad Manager 中预配置的外部 CDN 指定与众不同的名称,以便向直播活动投放广告。

详细了解如何通过外部 CDN 投放广告

dai-ad-dlid=AaBbC1aaBa0obA1BABaaBA

AaBbC1aaBa0obA1BABaaBA 是 Ad Manager 中显示的名称)

dai-aup (Beta 版)  HLS、DASH

指定一个指向外部 CDN 的任意网址前缀,用于构建广告片段网址,以便向直播活动投放广告。

详细了解如何通过外部 CDN 投放广告

dai-aup=https://domain.com/path-c1/path-c2

参数替换示例

全部展开  全部收起

对于与 DAI 问题排查或服务中断相关的任何问题,请与发布商支持团队联系

该内容对您有帮助吗?

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