Làm quen với SGAI cho sự kiện phát trực tiếp

bằng cách sử dụng API phân phát nhóm Chèn quảng cáo động (DAI) của Google.

Tính năng chèn quảng cáo có hướng dẫn của máy chủ (SGAI) cung cấp một tệp kê khai nhóm quảng cáo sẵn sàng để ghép trên các thiết bị ứng dụng. Nếu đã bật tính năng Phân phát theo nhóm DAI trong mạng Google Ad Manager, thì bạn có quyền sử dụng SGAI. Nếu bạn chưa bật tính năng DAI phân phát theo nhóm, hãy liên hệ với người quản lý tài khoản của bạn.

Với SGAI, bạn sử dụng các điểm cuối API phân phát nhóm để tạo một luồng, truy xuất siêu dữ liệu quảng cáo và tệp kê khai nhóm quảng cáo.

Nếu có một máy chủ thao tác tệp kê khai, bạn có thể tạo URL tệp kê khai nhóm quảng cáo và chèn các điểm đánh dấu quảng cáo mang thông tin tệp kê khai nhóm quảng cáo vào luồng nội dung theo quy cách mà bạn muốn.

Ngoài ra, bạn có thể lên lịch cho một điểm chèn quảng cáo bằng một cơ chế khác ngoài các điểm đánh dấu quảng cáo trong tệp kê khai luồng phát. Trong những trường hợp này, ứng dụng của bạn có thể theo dõi các sự kiện khác, chẳng hạn như hoạt động tương tác của người dùng với luồng phát, chính ứng dụng hoặc thông báo đẩy. Sau những sự kiện này, ứng dụng có thể tạo URL tệp kê khai nhóm quảng cáo và yêu cầu trình phát bắt đầu tải tệp kê khai nhóm quảng cáo.

Điều kiện tiên quyết

Trước khi tiếp tục, hãy đảm bảo bạn có những thông tin sau:

Làm theo các đề xuất

Trước khi tạo URL tệp kê khai nhóm quảng cáo, bạn nên gọi API Thông báo điểm chèn quảng cáo sớm (EABN) để chỉ định thời lượng dự kiến, thông tin nhắm mục tiêu và các thông số khác của mỗi điểm chèn quảng cáo.

Đối với các luồng phát hành chính thức và thử nghiệm, hãy gọi API EABN, đặc biệt nếu mạng quảng cáo của bạn có bất kỳ chiến dịch có lập trình nào. Để biết thêm thông tin, hãy xem Các tính năng và nguyên tắc của tính năng Trực tiếp theo chương trình.

Đưa ra yêu cầu đăng ký luồng phát

Khi người dùng bắt đầu một luồng nội dung trong ứng dụng trình phát video, bạn sẽ gửi yêu cầu đăng ký luồng kèm theo các thông số nhắm mục tiêu để tạo một phiên phát trực tuyến trên Ad Manager. Để biết thông tin chi tiết về cách đưa ra yêu cầu đăng ký luồng, hãy xem phần Phương thức:stream. Sau đó, bạn sẽ nhận được dữ liệu phản hồi từ yêu cầu.

Các ví dụ sau đây đưa ra yêu cầu đăng ký luồng phát:

HTTP văn bản thuần tuý

  • Yêu cầu:
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
  • Phản hồi:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

Vỏ

  • Dòng lệnh:
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
  • Kết quả:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

JavaScript

  • Sử dụng Fetch API:
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);
  • Nhật ký trên bảng điều khiển:
{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

Lấy siêu dữ liệu điểm chèn quảng cáo

Sau khi bạn đưa ra yêu cầu đăng ký luồng phát, hãy thăm dò siêu dữ liệu quảng cáo. Để thăm dò ý kiến, bạn đặt một bộ hẹn giờ bằng cách sử dụng polling_frequence trong phản hồi luồng ở bước đăng ký để gọi siêu dữ liệu quảng cáo. Đối với mỗi cuộc thăm dò, bạn có thể nhận được một danh sách quảng cáo một phần có siêu dữ liệu khi chúng có sẵn.

Tạo URL tệp kê khai nhóm quảng cáo

Tạo một URL cho tài nguyên nhóm của Pod Serving API. Sau đó, hãy truyền URL đến một trình phát video để bắt đầu tải nhóm quảng cáo.

Ví dụ sau đây minh hoạ cấu trúc của URL tệp kê khai nhóm quảng cáo:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/ad_break_id/ab101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

Bạn có thể tính toán các thông số URL của tệp kê khai nhóm quảng cáo dựa trên thông tin về điểm chèn quảng cáo được truy xuất từ trình phát video hoặc thông báo của máy chủ. Để biết các yêu cầu về những tham số này, hãy xem Phương thức: tệp kê khai pod.

Phát tệp kê khai nhóm quảng cáo

Trên ứng dụng trình phát video phía máy khách, hãy bắt đầu phát luồng nội dung bằng một trình phát video chính và làm theo tài liệu của trình phát video về việc quan sát lịch phát và lịch quảng cáo (nếu có).

Nếu bạn tạo URL tệp kê khai nhóm quảng cáo và chèn các URL đó vào tệp kê khai ở phía máy chủ, hãy theo dõi các sự kiện điểm chèn quảng cáo sắp tới của trình phát video và đảm bảo đăng ký các sự kiện id3 trong mỗi lần phát điểm chèn quảng cáo. Nếu bạn lên lịch các sự kiện chèn quảng cáo từ phía máy khách, hãy đăng ký các sự kiện id3 khi tạo.

Báo cáo lượt hiển thị và sự kiện quảng cáo

Khi trình phát video phát nhóm quảng cáo và gặp siêu dữ liệu có dấu thời gian id3, hãy nghe các sự kiện quảng cáo mà trình phát video kích hoạt và xử lý các sự kiện đó để gửi ping xác minh nội dung nghe nhìn.