API phân phát nhóm cho phép truy cập vào các nhóm quảng cáo dạng video có tốc độ bit thích ứng được chuẩn bị theo cách có thể ghép chúng trực tiếp vào danh sách phát nội dung nghe nhìn HLS hoặc MPEG DASH mà người dùng nhìn thấy.
API này dành cho các nhà xuất bản và đối tác công nghệ video tiên tiến. Để sử dụng API này trên quy mô lớn, bạn phải thiết kế và triển khai một quy trình phân phát nội dung nghe nhìn tinh vi nằm ngoài phạm vi của tài liệu này.
Điều kiện tiên quyết
Trước khi xử lý một chương trình phát trực tiếp thông qua API phân phát nhóm DAI, bạn cần tạo một sự kiện phát trực tiếp bằng cách sử dụng giao diện người dùng Google Ad Manager hoặc API sự kiện trực tiếp.
Thành phần
Có ba thành phần tạo nên bất kỳ cách triển khai nào của API phân phát nhóm: Google Ad Manager, một trình phát video ứng dụng và một máy chủ thao tác tệp kê khai.
Ad Manager
Ad Manager chịu trách nhiệm phân phối quảng cáo đến người dùng và có thể được quản lý thông qua SDK Ad Manager hoặc giao diện web của SDK đó. Dịch vụ có những trách nhiệm sau:
- Nhận yêu cầu phát trực tiếp từ trình phát video của ứng dụng, quyết định quảng cáo và cung cấp hiển thị để khớp với hồ sơ mã hoá nội dung của bạn
- Phản hồi các yêu cầu về phân khúc quảng cáo từ trình phát video của khách hàng và cung cấp phần thích hợp của nhóm quảng cáo cho người dùng cụ thể
- Nhận và xử lý ping theo dõi từ trình phát video của ứng dụng
Trình phát video của ứng dụng
Trình phát video của ứng dụng là ứng dụng hoặc trang web mà ứng dụng sử dụng để phát luồng video kết quả. Người chơi có những trách nhiệm sau:
- Khởi tạo tài nguyên luồng từ Ad Manager và nhận một đối tượng luồng đại diện cho một phiên phát duy nhất của một sự kiện phát trực tiếp cụ thể.
- Yêu cầu tệp kê khai luồng từ máy chủ thao tác tệp kê khai, máy chủ này sẽ bắt đầu phát
- Định kỳ thăm dò siêu dữ liệu của nhóm quảng cáo từ Ad Manager mô tả các sự kiện quảng cáo được nhúng trong phân khúc quảng cáo của luồng
- Theo dõi các sự kiện siêu dữ liệu được tính giờ do trình phát nâng lên có chứa mã nhận dạng nội dung nghe nhìn quảng cáo. Khi gặp những sự kiện này, người chơi sẽ chuyển tiếp các sự kiện đó đến Ad Manager để xác minh rằng các sự kiện quảng cáo đã xảy ra thành công.
Để tìm hiểu thêm về cách triển khai đúng trình phát video của ứng dụng, hãy xem hướng dẫn phân phát nhóm cho nền tảng của bạn:
Để triển khai tuỳ chỉnh, hãy xem hướng dẫn ứng dụng phân phát nhóm cho API DAI.
Máy chủ thao tác trong tệp kê khai
Máy chủ thao tác tệp kê khai là máy chủ chịu trách nhiệm lưu trữ tệp kê khai luồng được cung cấp cho trình phát video của ứng dụng. Máy chủ có những trách nhiệm sau:
- Xử lý việc phân phối tệp kê khai đến trình phát video của ứng dụng
- Yêu cầu mẫu khoảng thời gian từ Ad Manager (chỉ dành cho luồng MPEG DASH) để điền sẵn các phân khúc quảng cáo.
- Chèn URL phân đoạn quảng cáo do Ad Manager lưu trữ vào tệp kê khai luồng video (đối với HLS) hoặc giai đoạn quảng cáo (đối với MPEG DASH) trong thời điểm chèn quảng cáo.
- Phân phối tệp kê khai đã sửa đổi tới trình phát video của ứng dụng.
Để tìm hiểu thêm về cách triển khai một máy chủ thao tác tệp kê khai tuỳ chỉnh, hãy xem hướng dẫn thao tác với tệp kê khai.
Bảng thuật ngữ
- Sự kiện phát trực tiếp: Một sự kiện lưu trữ dữ liệu cấu hình quan trọng cho sự kiện phát trực tiếp, chẳng hạn như hồ sơ mã hoá. Các sự kiện phát trực tiếp được tạo bằng Ad Manager.
- Đối tượng luồng: Đối tượng đại diện cho một phiên phát duy nhất của một tài sản video cụ thể. Các thuộc tính đáng chú ý bao gồm mã luồng và URL xác minh nội dung nghe nhìn.
- Nhóm quảng cáo: Nhóm các video quảng cáo hiển thị trong một điểm chèn quảng cáo
- Phân khúc quảng cáo: Tệp phân khúc nội dung nghe nhìn cho điểm chèn quảng cáo
- Siêu dữ liệu của nhóm quảng cáo: Siêu dữ liệu cho điểm chèn quảng cáo dùng để hiển thị giao diện người dùng của quảng cáo trên máy khách; ví dụ: ẩn các nút tìm kiếm trong khi quảng cáo
- Mã nhận dạng nội dung đa phương tiện của quảng cáo: Siêu dữ liệu được mã hoá dưới dạng thẻ ID3 trong các tệp phân khúc quảng cáo. Siêu dữ liệu này dùng để xác định thời điểm xảy ra các sự kiện cụ thể liên quan đến quảng cáo trong khi phát, chẳng hạn như thời điểm bắt đầu hoặc điểm giữa quảng cáo.