Làm quen với SGAI

Tính năng chèn quảng cáo do máy chủ hướng dẫn (SGAI) cung cấp một tệp kê khai nhóm quảng cáo sẵn sàng để ghép nối trên thiết bị ứng dụng. Nếu đã bật tính năng DAI phân phát theo nhóm trong mạng Google Ad Manager, bạn sẽ có quyền sử dụng SGAI. Nếu bạn chưa bật tính năng Phân phát theo nhóm DAI, 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 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áy chủ thao tác tệp kê khai, bạn có thể tạo URL tệp kê khai của nhóm quảng cáo và chèn các điểm đánh dấu quảng cáo chứa thông tin tệp kê khai của nhóm quảng cáo trong luồng nội dung, theo thông số kỹ thuật mà bạn muốn.

Ngoài ra, bạn có thể lên lịch chèn quảng cáo bằng một cơ chế khác với các điểm đánh dấu quảng cáo trong tệp kê khai luồng. Trong những trường hợp này, ứng dụng của bạn có thể nghe 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, chính ứng dụng hoặc thông báo đẩy. Sau các 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ó:

  • Tính năng phân phát theo nhóm DAI đã được bật trên mạng Google Ad Manager của bạn.
  • Sự kiện phát trực tiếp có loại Tệp kê khai phân phát nhóm. Để tạo sự kiện, hãy xem bài viết Thiết lập sự kiện phát trực tiếp cho DAI.

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

Tạo yêu cầu đăng ký luồng

Khi người dùng bắt đầu phát trực tuyến nội dung trong ứng dụng trình phát video, bạn sẽ tạo một yêu cầu đăng ký luồng bằng 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 tạo yêu cầu đăng ký luồng, hãy xem phần Phương thức:luồng. 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 tạo một yêu cầu đăng ký luồng:

HTTP văn bản thuần tuý Vỏ JavaScript
  • 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"
}
  • 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"
}
  • 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ý 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"
}

Điều tra ý kiến về siêu dữ liệu điểm chèn quảng cáo

Sau khi bạn tạo yêu cầu đăng ký luồng, hãy thăm dò ý kiến về siêu dữ liệu quảng cáo. Để thăm dò ý kiến, bạn đặ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 metadata quảng cáo. Đối với mỗi cuộc thăm dò ý kiến, bạn có thể nhận được một phần danh sách quảng cáo 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 URL cho tài nguyên nhóm của API Phân phát nhóm. Sau đó, hãy chuyển URL đến 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 tham số URL 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ề các 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 của ứng dụng, hãy bắt đầu phát nội dung trực tuyến bằng trình phát video chính và làm theo tài liệu của trình phát video để quan sát lịch phát và 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 quan sát 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 sự kiện chèn quảng cáo từ phía máy khách, hãy đăng ký 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 tính giờ 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.