VOD 串流可略過廣告

本指南示範如何使用 DAI API，以要求內含 系統會根據 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 即可啟用可略過的廣告。

要求範例 (cURL)

針對 HTTP 即時串流要求：

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)) 可略過的選用中繼資料 廣告。如果設定此值，表示廣告可略過，而且包含 瞭解如何處理略過 UI 和追蹤事件。
offset (number) 偏移值表示 就會等待秒數 略過按鈕。如果 VAST 中未提供此值則省略。
tracking_url (字串) 略過時應連線偵測的網址 活動。

回應範例

{
  ...
  "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 Cloud 就是最佳選擇如未遵守這些規定，可能會受到限制 顯示在您網站或應用程式的 Google 廣告中

倒數計時器

在 VAST 中指定的 skipoffset 時間之前，廣告不得可略過。 在不可略過的這段期間，您必須向使用者顯示通知訊息 觀眾可在 X 秒後略過廣告通知必須翻譯為 決定使用者的語言

略過按鈕位置

如果是由左至右書寫的語言，請將略過按鈕放在 影片播放器。若是由右至左的語言，請將略過按鈕放在 影片播放器左下方。

略過按鈕大小

按鈕和文字的大小必須夠大，清晰可辨 無須專人管理

文字和圖示

略過按鈕必須同時包含文字和圖像。您可以使用 略過下一個 Material 圖示 做為圖像圖像。

無障礙設定

使用者應可使用鍵盤或 遠端控制。倒數計時結束後，應用程式應將焦點移至略過按鈕 完成。

國際化

建議您將略過文字翻譯成使用者的語言。

廣告連播

略過按鈕可用來跳過廣告連播中的目前廣告 整個 Pod 的資料

「略過廣告」翻譯

使用 skipAdTranslations.json 檔案 將「略過廣告」根據使用者的語言代碼顯示文字