Tìm hiểu về API Trình giám sát hoạt động phát trực tuyến

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 STITCHED hoặc POD_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, WARNING hoặc ERROR để 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 đồ adSelections và 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ường adBreakId trong bản đồ adPods và adBreaks vớ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ị breakSequence của đối tượng AdBreak với thuộc tính AdBreak.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.