Làm quen với SGAI

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

Ngoài ra, bạn có thể lên lịch một điểm chèn quảng cáo bằng một cơ chế khác so với đ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 với các sự kiện khác, ví dụ: 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 quảng cáo URL của tệp kê khai nhóm quảng cáo và yêu cầu người chơi 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ó:

• Đã bật tính năng phân phát nhóm DAI trên mạng Google Ad Manager của bạn.
• Một sự kiện phát trực tiếp thuộc loại Tệp kê khai phân phát nhóm. Cách tạo sự kiện: xem 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 của tệp kê khai nhóm quảng cáo thì bạn nên bạn gọi phương thức API Thông báo điểm chèn quảng cáo sớm (EABN) để xác định thời lượng dự kiến, thông tin nhắm mục tiêu và các thông tin khác thông số của từng điểm chèn quảng cáo.

Đối với luồng thử nghiệm và luồng phát hành công khai, hãy gọi API EABN, đặc biệt khi quảng cáo của bạn mạng 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

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

Ví dụ sau đây về một yêu cầu đăng ký luồng:

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 API Tìm nạp:

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"
}

Cuộc thăm dò ý kiến về siêu dữ liệu của điểm chèn quảng cáo

Sau khi bạn gửi yêu cầu đăng ký sự kiện phát trực tiếp, hãy thăm dò ý kiến của siêu dữ liệu quảng cáo. Người nhận cuộc thăm dò ý kiến, bạn đã đặt bộ tính giờ bằng cách sử dụng polling_frequence trong phản hồi theo luồng tại bước đăng ký để gọi quảng cáo siêu dữ liệu. Đố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 vì chúng trở nên có sẵn.

Tạo URL tệp kê khai của 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 đang 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/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

Lưu ý: Các thông số điểm chèn quảng cáo, chẳng hạn như pod_id, duration, cust_params và scte35 phải giống nhau đối với tất cả khách hàng xem cùng một buổi phát trực tiếp, trong khi mã luồng là duy nhất cho mỗi khách hàng. Nếu bạn chọn tạo URL tệp kê khai của nhóm quảng cáo ở phía máy chủ và chèn các URL đã tạo trong tệp kê khai luồng, hãy làm theo trình điều khiển tệp kê khai tài liệu máy chủ về việc gửi ID luồng từ ứng dụng khách và tạo các thông số chèn quảng cáo khác.

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

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

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

Nếu bạn tạo URL của tệp kê khai nhóm quảng cáo và chèn các URL đó vào tệp kê khai trên phía máy chủ, quan sát các sự kiện 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ập lịch quảng cáo ngắt sự kiện ở phía máy khách, đăng ký sự kiện id3 khi tạo.

Báo cáo số 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 xác định thời gian id3, nghe các sự kiện quảng cáo mà trình phát video kích hoạt và xử lý chúng gửi ping xác minh nội dung nghe nhìn.

Lưu ý quan trọng: Đừng trì hoãn lệnh ping đến URL xác minh nội dung nghe nhìn. Bạn nên ping ngay lập tức và không quá một phút.