Hướng dẫn này trình bày cách định cấu hình trình thao tác tệp kê khai để yêu cầu các phân đoạn quảng cáo hoặc phân đoạn bảng đen bằng phương thức phân đoạn nhóm quảng cáo .
Chọn một giao thức truyền trực tuyến:
Điều kiện tiên quyết
Trước khi tiếp tục, bạn phải thiết lập một sự kiện phát trực tiếp cho loại Chèn quảng cáo động (DAI) Chuyển hướng phân phát nhóm quảng cáo và hồ sơ mã hoá. Để thiết lập một sự kiện phát trực tiếp, hãy chọn một trong các phương thức sau:
- Giao diện người dùng Ad Manager: Thiết lập một sự kiện phát trực tiếp cho DAI.
- API Ad Manager: Sử dụng thư viện ứng dụng để gọi
LiveStreamEventService.createLiveStreamEventsphương thức. Đặt tham sốLiveStreamEvent.dynamicAdInsertionTypethànhPOD_SERVING_REDIRECT. - Xác thực yêu cầu: Mỗi yêu cầu phân đoạn được thực hiện bằng cách sử dụng tính năng chuyển hướng phân đoạn phân phát nhóm quảng cáo phải bao gồm một mã thông báo được ký bằng HMAC để xác thực. Tính toán mã thông báo này một lần cho mỗi điểm chèn quảng cáo và chia sẻ mã thông báo trên tất cả các phiên luồng. Để tính toán mã thông báo HMAC, hãy xem bài viết Xác thực yêu cầu nhóm quảng cáo.
Sau khi thiết lập sự kiện phát trực tiếp, hãy truy xuất hồ sơ mã hoá của sự kiện
từ giao diện người dùng hoặc API Ad Manager bằng cách gọi
DaiEncodingProfileService.getDaiEncodingProfilesByStatement
phương thức.
Truy xuất luồng nội dung
Khi người dùng chọn một sự kiện phát trực tiếp, ứng dụng khách sẽ đưa ra yêu cầu luồng đến Google Ad Manager. Trong phản hồi luồng, ứng dụng sẽ trích xuất mã phiên DAI của Google và siêu dữ liệu để đưa vào yêu cầu tệp kê khai luồng.
Ví dụ sau đây truyền mã phiên DAI của Google đến một trình thao tác tệp kê khai:
https://MANIFEST_MANIPULATOR_URL/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY
Khi xử lý yêu cầu phát lại nội dung video, hãy lưu trữ mã phiên DAI của Google ID và CUSTOM_ASSET_KEY từ yêu cầu để chuẩn bị cho việc ghép quảng cáo.
Xác định các phân đoạn điểm chèn quảng cáo và chèn các điểm không liên tục
Khi xử lý từng tệp kê khai biến thể, hãy xác định các thẻ EXT-X-CUE-IN và EXT-X-CUE-OUT trong luồng của bạn, cho biết điểm bắt đầu và điểm kết thúc của một điểm chèn quảng cáo.
Thay thế các thẻ EXT-X-CUE-IN và EXT-X-CUE-OUT bằng các phần tử EXT-X-DISCONTINUITY để trình phát video trên ứng dụng khách chuyển đổi giữa nội dung và quảng cáo.
Tệp kê khai ví dụ sau đây thay thế các thẻ EXT-X-CUE-IN và 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
Ví dụ sau đây cho thấy một tệp kê khai đã được thay thế:
#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
Các phân đoạn quảng cáo DAI của Google không được mã hoá. Nếu nội dung của bạn được mã hoá, hãy xoá mã hoá bằng cách chèn phần tử EXT-X-KEY:METHOD=NONE trước phân đoạn quảng cáo đầu tiên của mỗi điểm chèn quảng cáo. Ở cuối điểm chèn quảng cáo, hãy thêm lại mã hoá bằng cách chèn một EXT-X-KEY thích hợp.
Theo dõi thời gian bắt đầu, thời lượng và chỉ mục của điểm chèn quảng cáo sắp tới.
Tạo URL phân đoạn quảng cáo
Thay thế mỗi phân đoạn nội dung giữa các thẻ EXT-X-DISCONTINUITY bằng một URL trỏ đến phương thức phân đoạn nhóm quảng cáo.
Ví dụ sau đây tập hợp một phân đoạn nhóm quảng cáo. Xin lưu ý rằng các phân đoạn quảng cáo sử dụng chỉ mục dựa trên 0:
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
Ví dụ sau đây chèn các phân đoạn nhóm quảng cáo vào tệp kê khai:
#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
Không bắt buộc: Lên lịch điểm chèn quảng cáo
Để tăng tỷ lệ đáp ứng, hãy gửi Thông báo sớm về điểm chèn quảng cáo (EABN) kèm theo thời lượng nhóm quảng cáo, các tham số nhắm mục tiêu tùy chỉnh và dữ liệu tín hiệu SCTE-35. Để biết thêm thông tin chi tiết, hãy xem bài viết Gửi thông báo sớm về điểm chèn quảng cáo.