Tìm hiểu về DAI Ad Break API

API Điểm chèn quảng cáo của tính năng Chèn quảng cáo động (DAI) cho phép bạn tạo và quản lý dữ liệu nhắm mục tiêu quảng cáo và thời gian của các điểm chèn quảng cáo sắp tới trong luồng phát trực tiếp.

Với DAI Ad Break API, bạn có thể làm những việc sau:

  • Tăng tỷ lệ lấp đầy quảng cáo trong thời gian lưu lượng truy cập cao nhất: Cho phép các dịch vụ DAI có thêm thời gian để chọn những quảng cáo mang lại lợi nhuận cao nhất cho sự kiện phát trực tiếp của bạn. Bạn nên sử dụng DAI Ad Break API khi các sự kiện phát trực tiếp có lượng người xem đồng thời cao, thẻ quảng cáo động hoặc quảng cáo có độ trễ cao.
  • Kiểm soát hoàn toàn các điểm chèn quảng cáo: Tạo, cập nhật và xoá các điểm chèn quảng cáo trước, mang lại sự linh hoạt hơn so với tính năng báo hiệu quảng cáo trong tệp kê khai và tỷ lệ lấp đầy cao hơn cho việc phân phát theo nhóm so với việc đưa ra quyết định ngay tại thời điểm đó.
  • Mang đến trải nghiệm xem không bị gián đoạn cho người xem: Giảm thiểu các lỗi phát liên quan đến quảng cáo (chẳng hạn như nhóm quảng cáo có quá ít hoặc quá nhiều quảng cáo) bằng cách cung cấp thông tin chính xác về điểm chèn quảng cáo.

Hướng dẫn này mô tả các phương thức DAI Ad Break API và hướng dẫn bạn về vòng đời điểm chèn quảng cáo cho các luồng DAI Full Service và Pod Serving.

Tìm hiểu các phương thức API khoảng thời gian chèn quảng cáo động

API này cung cấp các phương thức tiêu chuẩn sau đây để quản lý tài nguyên AdBreak:

  • Create: Xác định một thực thể AdBreak mới cho thực thể LiveStreamEvent. Bạn có thể đặt thuộc tính expectedStartTime để lên lịch bắt đầu quyết định quảng cáo trong vòng 60 giây trước khi khoảng thời gian chèn quảng cáo bắt đầu.
  • Get: Truy xuất thông tin chi tiết của một thực thể AdBreak cụ thể, bao gồm cả trạng thái điểm chèn quảng cáo và siêu dữ liệu về thời gian.
  • List: Trả về danh sách các thực thể AdBreak đã được tạo trước đó bằng API cho một thực thể LiveStreamEvent nhất định, được sắp xếp theo thứ tự thời gian đảo ngược. Xin lưu ý rằng API này không chỉ trả về các điểm chèn quảng cáo được xác định trong tệp kê khai luồng nội dung.
  • Update: Sửa đổi thực thể AdBreak hiện có trước khi quyết định quảng cáo bắt đầu.
  • Delete: Huỷ quyết định quảng cáo cho một thực thể AdBreak đã tạo trước đó.

Tìm hiểu vòng đời của điểm chèn quảng cáo

Một thực thể AdBreak có các trạng thái sau:

  • BREAK_STATE_UNSPECIFIED: Trạng thái mặc định.
  • BREAK_STATE_SCHEDULED: Điểm chèn quảng cáo đã được tạo thành công và được lên lịch để đưa ra quyết định về quảng cáo.
  • BREAK_STATE_DECISIONED: Các dịch vụ DAI đã bắt đầu quy trình chọn quảng cáo cho điểm chèn quảng cáo. Bạn không thể sửa đổi điểm chèn quảng cáo nhưng vẫn có thể huỷ điểm chèn quảng cáo. Điều này có thể gây ảnh hưởng tiêu cực đến các máy chủ quảng cáo.
  • BREAK_STATE_COMPLETE: Điểm chèn quảng cáo đã được phân phát cho người dùng.

Sơ đồ sau đây cho thấy dòng thời gian của một thực thể AdBreak, từ khi tạo đến khi hoàn thành.

Thực thể điểm chèn quảng cáo từ khi tạo đến khi hoàn tất.

Bạn có thể tạo thực thể AdBreak từ 1 đến 300 phút trước khi khoảng thời gian chèn quảng cáo dự kiến bắt đầu.

  • Tránh tạo điểm chèn quảng cáo dưới 1 phút trước thời gian bắt đầu dự kiến của điểm chèn, vì DAI của Google có thể không có đủ thời gian để đưa ra quyết định về quảng cáo, dẫn đến tỷ lệ lấp đầy quảng cáo thấp hơn.
  • Tránh tạo điểm chèn quảng cáo quá 6 giờ trước thời gian bắt đầu dự kiến của điểm chèn đó, vì máy chủ quảng cáo có thể vô hiệu hoá quảng cáo được yêu cầu.

Các phần sau đây trình bày các trạng thái chuyển đổi điểm chèn quảng cáo trong luồng phân phát dịch vụ đầy đủ DAI và luồng phân phát nhóm quảng cáo.

Tìm hiểu quy trình DAI (Chèn quảng cáo động) toàn diện

Tính năng DAI trọn gói của Google quản lý cả tệp kê khai nội dung và nhóm quảng cáo.

Đối với tính năng nhắm mục tiêu quảng cáo tuỳ chỉnh, hãy sử dụng DAI Ad Break API để tạo một thực thể AdBreak trước điểm đánh dấu quảng cáo tương ứng trong tệp kê khai luồng phát trực tiếp nội dung.

  • Thời gian chờ này cho phép các dịch vụ DAI của Google sử dụng dữ liệu AdBreak của bạn để đưa ra quyết định về quảng cáo.
  • Khi DAI của Google phát hiện dấu quảng cáo trong tệp kê khai, hệ thống sẽ sử dụng các quyết định về quảng cáo với dữ liệu thực thể AdBreak và chuyển trạng thái của thực thể thành BREAK_STATE_COMPLETE.

Thực thể điểm chèn quảng cáo từ khi tạo đến khi hoàn tất trong quy trình DAI trọn gói.

Tìm hiểu quy trình phân phát Pod

Trong quy trình này, bạn quản lý tệp kê khai nội dung phát trực tiếp hoặc sử dụng dịch vụ thao tác tệp kê khai của bên thứ ba để phát hiện các điểm đánh dấu quảng cáo trong tệp kê khai.

Gọi API Khoảng thời gian quảng cáo DAI trước thời gian bắt đầu dự kiến của khoảng thời gian quảng cáo để tạo thực thể AdBreak trước khi bạn cần yêu cầu các phân đoạn nhóm quảng cáo hoặc tệp kê khai quảng cáo.

Khi trình ghép video của bạn phát hiện thấy điểm đánh dấu quảng cáo trong tệp kê khai và đưa ra các yêu cầu về phân đoạn quảng cáo bằng mã nhận dạng khoảng thời gian quảng cáo, thì DAI của Google sẽ sử dụng dữ liệu AdBreak có cùng mã nhận dạng để đưa ra quyết định về quảng cáo.

Sau khi ứng dụng của bạn yêu cầu nội dung nghe nhìn quảng cáo, thực thể AdBreak mà bạn đã tạo thông qua API sẽ chuyển sang trạng thái BREAK_STATE_COMPLETE.

Trạng thái hoàn chỉnh của thực thể điểm chèn quảng cáo.

Đưa ra yêu cầu đầu tiên

Để thiết lập quyền truy cập API và đưa ra yêu cầu đầu tiên, hãy xem phần Sử dụng DAI Ad Break API.