Hướng dẫn này minh hoạ cách sử dụng API DAI để yêu cầu luồng VOD bằng quảng cáo có thể bỏ qua, hiển thị nút bỏ qua theo các yêu cầu của Google Ads, rồi gửi các sự kiện theo dõi liên quan.
Điều kiện tiên quyết
- Một ứng dụng triển khai các lệnh gọi API DAI cho các luồng VOD. Xem Hướng dẫn truyền trực tuyến VOD API DAI để biết thêm thông tin.
Tạo yêu cầu cho quảng cáo có thể bỏ qua
Để yêu cầu một luồng VOD có quảng cáo có thể bỏ qua, bạn phải chuyển dai-sas
trong
yêu cầu luồng.
Điểm cuối của API
POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded
Tham số đường dẫn
{CMS_ID} |
Mã CMS của luồng. |
{VIDEO_ID} |
Mã video của luồng. |
Thông số cơ thể
dai-sas |
Đặt dai-sas=1 để bật quảng cáo có thể bỏ qua.
|
Yêu cầu mẫu (cURL)
Đối với các yêu cầu phát trực tuyến 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
Thay thế 'dash' trong URL cho các luồng DASH:
https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Sử dụng định dạng sau để bao gồm nhiều thông số luồng trong yêu cầu của bạn nội dung:
-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \
Xử lý thao tác bỏ qua quảng cáo
Để xử lý việc bỏ qua quảng cáo, hãy sử dụng thông tin trong
Ad
cấu trúc hoặc
AdBreak
tuỳ thuộc vào việc bạn đang bỏ qua quảng cáo hiện tại hay toàn bộ điểm chèn quảng cáo.
Lấy giá trị start và thêm giá trị duration, sau đó kéo đến điểm đó trong
luồng. Chiến lược phát hành đĩa đơn
SkipMetadata
tin nhắn con cũng bao gồm giá trị offset. Đây là một giá trị trong
giây trước khi có thể bỏ qua quảng cáo. SkipMetadata thông báo con
sẽ chỉ được đưa vào những quảng cáo có thể bỏ qua.
ad_breaks |
Danh sách các điểm chèn quảng cáo.
|
Ví dụ về phản hồi
{
...
"ad_breaks":[
{
...
"start":0,
"duration":10,
"ads":[
{
...
"start":0,
"duration":10,
"skip_metadata":{
"offset": 5,
"tracking_url": "https://example_skip_url.com"
}
}
}
}
Sau khi quảng cáo bị bỏ qua, ping URL sự kiện bỏ qua có trong phản hồi luồng.
Tin nhắn này có trong tin nhắn con SkipMetadata.
Yêu cầu đối với nút bỏ qua
Đối với quảng cáo có thể bỏ qua, hãy hiển thị nút bỏ qua với thiết kế sau các yêu cầu liên quan. Việc không tuân thủ các yêu cầu này có thể dẫn đến các hạn chế được đặt trên quảng cáo của Google đang được phân phát đến trang web hoặc ứng dụng của bạn.
Đồng hồ đếm ngược
Quảng cáo không được bỏ qua cho đến thời điểm skipoffset được chỉ định trong VAST.
Trong thời gian không thể bỏ qua này, bạn phải hiển thị thông báo cho người dùng
họ có thể bỏ qua quảng cáo sau X giây. Thông báo phải được dịch sang
ngôn ngữ của người dùng.
Vị trí nút bỏ qua
Đối với ngôn ngữ từ trái sang phải, hãy đặt nút bỏ qua ở góc dưới cùng bên phải của trình phát video. Đối với ngôn ngữ từ phải sang trái, hãy đặt nút bỏ qua trên góc dưới cùng bên trái trình phát video.
Kích thước nút bỏ qua
Nút và văn bản phải đủ lớn để có thể đọc được rõ ràng khi thao tác trên phần nền của bạn.
Văn bản và biểu tượng
Nút bỏ qua phải có cả văn bản và biểu tượng. Bạn có thể sử dụng bỏ qua biểu tượng material tiếp theo làm hình tượng học của bạn.
Hỗ trợ tiếp cận
Người dùng phải có thể chuyển đến nút bỏ qua bằng bàn phím hoặc điều khiển từ xa. Ứng dụng nên đặt tiêu điểm vào nút bỏ qua sau khi đếm ngược xong đã hoàn tất.
Quốc tế hoá
Bạn nên dịch văn bản bỏ qua sang ngôn ngữ của người dùng.
Nhóm quảng cáo
Bạn có thể dùng nút bỏ qua để bỏ qua quảng cáo hiện tại trong nhóm quảng cáo hoặc bỏ qua toàn bộ nhóm.
"Bỏ qua quảng cáo" bản dịch
Sử dụng
tệp skipAdTranslations.json
để dịch 'Bỏ qua quảng cáo' văn bản dựa trên ngôn ngữ của người dùng.