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

API Điểm chèn quảng cáo Chèn quảng cáo động (DAI) cho phép bạn tạo và quản lý dữ liệu về thời gian và tiêu chí 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 chương trình 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ệ đáp ứng 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ụ Chèn quảng cáo động (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 sự kiện phát trực tiếp của bạn có tính đồ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ệ đáp ứng 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 không đủ 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 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 các 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 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 một thực thể LiveStreamEvent. Bạn có thể đặt thuộc tính expectedStartTime để lên lịch quyết định quảng cáo bắt đầu 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 khoảng thời gian 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. Việc này có thể gây ảnh hưởng tiêu cực đến các máy chủ quảng cáo.

Thận trọng: Việc huỷ một khoảng thời gian chèn quảng cáo trong trạng thái BREAK_STATE_DECISIONED sẽ ngăn các máy chủ quảng cáo phân phối quảng cáo, điều này có thể ảnh hưởng tiêu cực đến các chức năng lập ngân sách và giới hạn tần suất của 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 tiến trình của một thực thể AdBreak, 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 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 ít hơn 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ì 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ệ đáp ứng 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.

Lưu ý: Việc huỷ kích hoạt một sự kiện phát trực tiếp sẽ loại bỏ các điểm chèn quảng cáo ở trạng thái BREAK_STATE_SCHEDULED hoặc trạng thái BREAK_STATE_DECISIONED.

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 quy trình DAI Full Service và Pod Serving.

Tìm hiểu quy trình DAI (Chèn quảng cáo động) trọn gói

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 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 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ận trọng: Khi DAI của Google phát hiện thấy dấu hiệu quảng cáo trong tệp kê khai và thực thể AdBreak có trạng thái BREAK_STATE_SCHEDULED, hệ thống sẽ không sử dụng dữ liệu AdBreak. Thực thể AdBreak vẫn ở trạng thái BREAK_STATE_SCHEDULED cho đến khi bạn gọi phương thức xoá để huỷ điểm chèn quảng cáo.

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ụ chỉnh sửa 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 DAI Ad Break API 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 công cụ kết hợp video phát hiện điểm đánh dấu quảng cáo trong tệp kê khai và đưa ra yêu cầu về phân đoạn quảng cáo bằng mã nhận dạng điểm chèn 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.

Tạo yêu cầu đầu tiên

Để thiết lập quyền truy cập vào API và đưa ra yêu cầu đầu tiên, hãy xem phần Sử dụng API khoảng thời gian phát quảng cáo DAI.