API Trình giám sát hoạt động phát trực tuyến (SAM) của tính năng Chèn quảng cáo động (DAI) cho phép bạn kiểm tra và khắc phục sự cố cho từng phiên xem sự kiện phát trực tiếp và video theo yêu cầu (VOD).
Để kiểm tra và khắc phục sự cố một cách trực quan cho một phiên xem video theo yêu cầu (VOD) hoặc sự kiện phát trực tiếp riêng lẻ, hãy sử dụng Trình giám sát hoạt động phát trực tuyến trong giao diện người dùng của Google Ad Manager.
Để truy xuất dữ liệu chẩn đoán cho một phiên theo phương thức lập trình, hãy sử dụng tài nguyên networks.daiSessions của API Ad Manager.
Tìm hiểu các trường hợp sử dụng
Với SAM API, bạn có thể tự động hoá quy trình chẩn đoán luồng phát và giải quyết các vấn đề về việc phân phối quảng cáo trên các chế độ tích hợp DAI, chẳng hạn như:
- Xác minh việc tạo phiên phát trực tiếp: Xác nhận các thông số, chế độ ghép nối của
STITCHEDhoặcPOD_SERVING, chế độ báo cáo và siêu dữ liệu nội dung mà Google DAI nhận được khi tạo phiên phát trực tiếp hoặc phiên VOD. - Kiểm tra các yêu cầu và phản hồi quảng cáo: Kiểm tra các thẻ quảng cáo Mẫu phân phát quảng cáo dạng video (VAST) và Danh sách phát nhiều quảng cáo dạng video (VMAP) gửi đi, mã trạng thái HTTP, độ trễ phản hồi, nội dung phản hồi XML thô và chuỗi chuyển hướng trình bao bọc.
- Khắc phục sự cố về quyết định và mẫu quảng cáo của nhóm quảng cáo: Xác minh những quảng cáo mà Google DAI chọn hoặc loại bỏ cho mỗi nhóm, thời lượng của mỗi quảng cáo trong nhóm và hệ thống quảng cáo nguồn của mẫu quảng cáo.
- Theo dõi quá trình thực thi tìm nạp trước quảng cáo: Xác định xem tính năng Chèn quảng cáo động (DAI) của Google có tìm nạp trước một nhóm quảng cáo hay không và kiểm tra giai đoạn tìm nạp trước của từng nhóm quảng cáo.
- Xác thực lệnh gọi API Điểm chèn quảng cáo DAI và API DAI phân phát theo nhóm: Kiểm tra việc thực thi điểm chèn quảng cáo thực tế, thời lượng quảng cáo được phân phát và thời lượng chèn ảnh tĩnh so với các lệnh gọi API, chẳng hạn như API Điểm chèn quảng cáo DAI và API DAI phân phát theo nhóm.
- Xác minh hoạt động theo dõi sự kiện quảng cáo: Xác nhận xem ping theo dõi phía máy khách hay phía máy chủ có thành công hay không và kiểm tra phản hồi HTTP từ máy chủ quảng cáo.
- Tự động hoá việc giám sát và cảnh báo phiên: Phân tích cú pháp các mục kết quả có cấu trúc có mức độ nghiêm trọng
INFO,WARNINGhoặcERRORđể phát hiện các vấn đề về việc phát hoặc kiếm tiền trong các quy trình giám sát hoạt động sản xuất và kiểm thử tích hợp tự động.
Tìm hiểu về tài nguyên cấp cao nhất
SAM API là một phần của API REST của Google Ad Manager (Thử nghiệm) trên điểm cuối admanager.googleapis.com và hiển thị phương thức chỉ đọc networks.daiSessions.get. Bạn có thể truy vấn tài nguyên DaiSession bằng mã phiên DAI hoặc khoá gỡ lỗi tuỳ chỉnh. DAI giữ lại bản ghi phiên trong tối đa 3 ngày sau khi phát.
API SAM không hỗ trợ việc liệt kê tất cả tài nguyên DaiSession trong một mạng Google Ad Manager.
Kiểm tra phản hồi của luồng DAI bằng SAM
Để xác minh cách Google DAI xử lý các yêu cầu về luồng, hãy kiểm tra phản hồi DaiSession:
- API DAI đầy đủ dịch vụ: Kiểm tra trường
creationContext.streamCreateRequestđể xác minh lệnh gọi đăng ký luồng, kiểm tra bản đồadSelectionsvàadPodsđể xem xét quyết định quảng cáo, đồng thời kiểm tra bản đồadBreaksđể xác nhận quảng cáo được ghép nối, mẫu quảng cáo dạng video thay thế và thời lượng nội dung cơ bản. - API DAI phân phát nhóm: Xác nhận rằng trường
creationContext.stitchingTypeđược đặt thành giá trịPOD_SERVING, kiểm tra chéo trườngadBreakIdtrong bản đồadPodsvàadBreaksvới tệp kê khai nhóm hoặc lệnh gọi yêu cầu phân đoạn nhóm, đồng thời kiểm tra đèn hiệu phía máy chủ hoặc đèn hiệu xác minh nội dung nghe nhìn trong bản đồtrackingPings. - DAI Ad Break API: Khớp giá trị
breakSequencecủa đối tượngAdBreakvới thuộc tínhAdBreak.breakSequence.
Thực hiện yêu cầu đầu tiên
Để thiết lập quy trình xác thực và truy xuất tài nguyên phiên DAI, hãy xem bài viết Sử dụng API Trình giám sát hoạt động phát trực tuyến.