可跳过式 VOD 视频流广告

本指南演示了如何使用 DAI API 请求 VOD 视频流 可跳过式广告，则根据 YouTube 视频中的说明呈现“跳过”按钮 Google Ads 要求， 并发送相关的跟踪事件。

前提条件

针对可跳过式广告发出请求

如需请求包含可跳过广告的 VOD 视频流，您必须传递 dai-sas 参数（位于 视频流请求。

API 端点

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

路径参数

{CMS_ID} 视频流的 CMS ID。
{VIDEO_ID} 视频流的视频 ID。

正文参数

dai-sas 设置 dai-sas=1 即可启用可跳过的广告。

示例请求 (c网址)

对于 HLS 视频流请求：

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

将网址中的 'dash' 替换为 DASH 流：

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

请使用以下格式在请求的 正文：

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

处理跳过广告的操作

要处理跳过广告，请使用 Ad 结构体或 AdBreak 结构体，具体取决于您是跳过当前广告还是整个广告插播时间点。 获取 start 值并添加 duration 值，然后跳转至该点 直播通过 SkipMetadata 子消息还包含 offset 值，该值是 才能跳过广告。SkipMetadata 子消息 只会出现在可跳过的广告上。

ad_breaks 广告插播时间点列表。
start (number) 视频流中插播广告开始的位置（以秒为单位）。
duration (number) 广告插播时长（以秒为单位）。
ads (object(Ad)) 流中的广告列表。
start (number) 广告在此视频流中开始播放的位置 。
duration (number) 广告的持续时间，以秒为单位。
skip_metadata (object(SkipMetadata)) 可跳过式广告的可选元数据 广告。如果设置，则表示广告是可跳过的，并且包含 有关如何处理跳过界面和跟踪事件的说明。
offset (number) 偏移值表示 进入广告后，播放器应该等待的秒数 跳过按钮。如果 VAST 中未提供，则省略。
tracking_url （字符串）：系统应该在跳过时对其执行 ping 操作的网址 事件。

示例响应

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

用户跳过广告后，对视频流响应中包含的跳过事件网址执行 ping 操作。 它包含在 SkipMetadata 子消息中。

“跳过”按钮要求

对于可跳过式广告，请使用以下设计来呈现“跳过”按钮 要求。不遵守这些要求可能会受到限制 被投放到您的网站或应用中的 Google 广告。

倒计时器

在 VAST 中指定的 skipoffset 时间之前，广告不得处于可跳过状态。 在此不可跳过的时间段内，您必须向用户显示通知， 确保用户可以在 X 秒后跳过广告。通知必须翻译成 用户的语言。

“跳过”按钮位置

对于从左到右书写的语言，请将跳过按钮放置在 视频播放器。对于从右到左书写的语言，请将跳过按钮置于 视频播放器的左下方。

“跳过”按钮大小

按钮和文字必须足够大，以便用户舒适地浏览时清晰易读 体验。

文字和图标

“跳过”按钮必须同时包含文字和图标。您可以使用 跳过下一个 Material 图标作为您的图标。

无障碍

用户应该能够使用键盘或 遥控器。倒计时结束后，应用应聚焦于跳过按钮 。

国际化

建议将跳过的文本翻译成用户的语言。

广告连播

“跳过”按钮可用于跳过广告连播中的当前广告，或跳过 整个 Pod

“跳过广告”翻译

使用 skipAdTranslations.json 文件 翻译“跳过广告”根据用户的语言区域显示相应的文本。