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ý thời gian cũng như dữ liệu nhắm mục tiêu quảng cáo của các điểm chèn quảng cáo sắp tới trong sự kiện phát trực tiếp.

Với API Điểm chèn quảng cáo DAI, bạn có thể làm những việc sau:

  • Tăng tỷ lệ đáp ứng quảng cáo trong thời gian lưu lượng truy cập cao điểm: Cho các dịch vụ DAI thêm thời gian để chọn 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 API Điểm chèn quảng cáo DAI khi sự kiện phát trực tiếp của bạn 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á trước các điểm chèn quảng cáo, mang lại sự linh hoạt hơn so với việc 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 nhóm quảng cáo so với việc ra quyết định theo thời gian thực.
  • Mang đến trải nghiệm xem không bị gián đoạn: 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 không được lấp đầy hoặc lấp đầy quá mức, 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 của API Điểm chèn quảng cáo DAI và hướng dẫn bạn về vòng đời của điểm chèn quảng cáo cho quy trình Phân phát nhóm và Dịch vụ đầy đủ của DAI.

Tìm hiểu các phương thức API Điểm chèn quảng cáo DAI

API này cung cấp các phương thức 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 một thực thể LiveStreamEvent. Nếu muốn, bạn có thể đặt thuộc tính expectedStartTime để lên lịch cho một quyết định quảng cáo bắt đầu trong vòng 60 giây trước khi điểm chèn quảng cáo bắt đầu.
  • Get: Truy xuất thông tin chi tiết về 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 đã 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 không trả về các điểm chèn quảng cáo chỉ được xác định trong tệp kê khai luồng nội dung.
  • Update: Sửa đổi một 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

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 xấu đến 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.
  • BREAK_STATE_EXPIRED: Điểm chèn quảng cáo đã hết hạn trước khi phân phát. Chỉ áp dụng khi bạn bật tính năng lên lịch cho nhiều điểm chèn quảng cáo trong sự kiện phát trực tiếp. Để biết chi tiết, hãy xem phần Cài đặt điểm chèn quảng cáo chèn giữa. Theo mặc định, điểm chèn quảng cáo sẽ hết hạn sau 30 phút kể từ giá trị của trường expectedStartTime hoặc 30 phút sau khi bắt đầu đưa ra quyết định nếu bạn không đặt trường expectedStartTime. Bạn có thể tuỳ chỉnh thời lượng này bằng trường expireDuration.

Sơ đồ sau đây cho thấy tiến trình của một thực thể AdBreak, từ khi tạo đến khi hoàn tất.

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 một thực thể AdBreak từ 1 đến 300 phút trước khi điểm chèn quảng cáo dự kiến bắt đầu.

  • Tránh tạo điểm chèn quảng cáo chưa đầy một phút trước thời gian bắt đầu dự kiến của điểm chèn quảng cáo, vì Google DAI có thể không có đủ thời gian để đưa ra quyết định về quảng cáo, dẫn đến tỷ lệ đáp ứng quảng cáo thấp hơn.
  • Tránh tạo điểm chèn quảng cáo sớm hơn 6 giờ so với thời gian bắt đầu dự kiến của điểm chèn quảng cáo, 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 về quá trình chuyển đổi trạng thái điểm chèn quảng cáo trong quy trình Dịch vụ đầy đủ của DAI và Phân phát nhóm quảng cáo.

Tìm hiểu quy trình DAI đầy đủ dịch vụ

Tính năng DAI đầy đủ dịch vụ của Google quản lý cả tệp kê khai nội dung và nhóm quảng cáo.

Để nhắm mục tiêu quảng cáo tuỳ chỉnh, hãy sử dụng API Điểm chèn quảng cáo DAI để 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 sự kiện phát trực tiếp nội dung.

  • Thời gian thực hiện 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 điểm đánh dấu quảng cáo trong tệp kê khai, hệ thống sẽ sử dụng quyết định quảng cáo có dữ liệu thực thể AdBreak và chuyển trạng thái của thực thể sang BREAK_STATE_COMPLETE.

Khi bật tính năng lập lịch nhiều điểm chèn quảng cáo cho sự kiện phát trực tiếp, bạn có thể đặt trường matchParams trên một thực thể AdBreak. Quy trình này cho phép DAI của Google so khớp các điểm đánh dấu quảng cáo trong tệp kê khai được phát hiện với các điểm chèn quảng cáo ở trạng thái BREAK_STATE_SCHEDULED hoặc BREAK_STATE_DECISIONED.

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 đầy đủ dịch vụ.

Tìm hiểu quy trình phân phát Nhóm quảng cáo

Trong quy trình này, bạn quản lý tệp kê khai sự kiện phát trực tiếp nội dung hoặc sử dụng trình 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 Điểm chèn quảng cáo DAI trước thời gian bắt đầu dự kiến của điểm chèn quảng cáo để tạo một thực thể AdBreak trước khi bạn cần yêu cầu 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 phát hiện điểm đánh dấu quảng cáo trong tệp kê khai và gửi yêu cầu phân đoạn quảng cáo có mã điểm chèn quảng cáo, tính năng Chèn quảng cáo động (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 khách 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 tất của thực thể điểm chèn quảng cáo.

Thực hiện 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 bài viết Sử dụng DAI Ad Break API.