本指南說明如何設定資訊清單操控工具,使用廣告連播片段方法要求廣告或字卡片段。
選取串流通訊協定:
必要條件
請先為Pod 放送重新導向動態廣告插播 (DAI) 類型和編碼設定檔設定直播活動,再繼續操作。如要設定直播活動,請選擇下列其中一種方式:
- Ad Manager 使用者介面: 為 DAI 設定直播。
- Ad Manager API:使用用戶端程式庫呼叫
LiveStreamEventService.createLiveStreamEvents方法。將LiveStreamEvent.dynamicAdInsertionType參數設為POD_SERVING_REDIRECT。 - 驗證要求:使用區隔重新導向 Pod 放送服務提出的每項區隔要求,都必須包含用於驗證的 HMAC 簽署權杖。每個廣告插播時段計算一次這個權杖,並在所有串流工作階段中共用權杖。如要計算 HMAC 權杖,請參閱「驗證廣告連播請求」。
設定直播活動後,請呼叫 DaiEncodingProfileService.getDaiEncodingProfilesByStatement 方法,從 Ad Manager 使用者介面或 API 擷取活動的編碼設定檔。
擷取內容串流
使用者選取直播活動時,用戶端應用程式會向 Google Ad Manager 發出串流請求。在串流回應中,應用程式會擷取 Google DAI 工作階段 ID 和中繼資料,並納入串流資訊清單要求。
以下範例會將 Google DAI 會期 ID 傳遞至資訊清單操控器:
https://MANIFEST_MANIPULATOR_URL/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY
處理影片內容播放要求時,請儲存要求中的 Google DAI 工作階段 ID 和 CUSTOM_ASSET_KEY,以便準備縫合廣告。
找出廣告插播片段並插入不連續點
處理每個變體資訊清單時,請找出串流中的 EXT-X-CUE-IN 和 EXT-X-CUE-OUT 標記,指出廣告插播的開始和結束時間。
將 EXT-X-CUE-IN 和 EXT-X-CUE-OUT 標記替換為 EXT-X-DISCONTINUITY 元素,讓用戶端影片播放器在內容和廣告之間切換。
下列資訊清單範例會取代 EXT-X-CUE-IN 和 EXT-X-CUE-OUT 標記:
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXT-X-CUE-OUT:15.000
#EXTINF:5.000,
contentorigin.com/3.ts
#EXTINF:5.000,
contentorigin.com/4.ts
#EXTINF:5.000,
contentorigin.com/5.ts
#EXT-X-CUE-IN
#EXTINF:5.000,
contentorigin.com/6.ts
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4
以下範例顯示已取代的資訊清單:
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXTINF:5.000,
#EXT-X-DISCONTINUITY
{... Insert ad segments here ...}
#EXT-X-DISCONTINUITY
#EXTINF:5.000,
contentorigin.com/6.mp4
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4
Google DAI 廣告片段不會加密。如果內容經過加密,請在每個廣告插播的第一個廣告片段前插入 EXT-X-KEY:METHOD=NONE 元素,移除加密。在廣告插播結束時,插入適當的 EXT-X-KEY,重新加入加密。
追蹤即將放送的廣告插播的開始時間、時間長度和索引。
建立廣告區隔網址
將 EXT-X-DISCONTINUITY 標記之間的每個內容片段,替換成指向廣告連播片段方法的網址。
以下範例會組裝廣告連播片段。請注意,廣告片段使用以零為起始的索引:
https://dai.google.com/linear/pods/v1/seg/network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=AD_SEGMENT_DURATION&pd=AD_BREAK_DURATION&stream_id=SESSION_ID&auth-token=HMAC
以下範例會在資訊清單中插入廣告連播片段:
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.00,
contentorigin.com/1.ts
#EXTINF:5.00,
contentorigin.com/2.ts
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=5000&so=0&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/1.ts?sd=5000&so=5000&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/2.ts?sd=5000&so=10000&pd=15000&stream_id=SESSION_ID
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
contentorigin.com/6.mp4
#EXTINF:5.00,
contentorigin.com/7.mp4
#EXTINF:5.00,
contentorigin.com/8.mp4
選用:排定廣告插播時間
如要提高供應率,請傳送 Early Ad Break Notification (EABN),並提供廣告連播時間長度、自訂指定目標參數和 SCTE-35 信號資料。詳情請參閱「提早傳送廣告插播通知」。