Gửi thông báo điểm chèn quảng cáo sớm

Tính năng Chèn quảng cáo động (DAI) của Google hỗ trợ các sự kiện phát trực tiếp ở mức độ đồng thời cao. Thông báo điểm chèn quảng cáo sớm (EABN) là các yêu cầu để Google DAI lên lịch cho một điểm chèn quảng cáo sắp tới hoặc bắt đầu ngay các quyết định về quảng cáo, tối ưu hoá cả tỷ lệ đáp ứng quảng cáo và thời gian tải.

Để bắt đầu thông báo điểm chèn quảng cáo sớm cho dịch vụ đầy đủ, phân phát nhóm quảng cáo hoặc chèn quảng cáo do máy chủ hướng dẫn, hãy sử dụng tài nguyên AdBreaks. Tài nguyên này có thể tạo và quản lý các điểm chèn quảng cáo cho tất cả sự kiện phát trực tiếp mà bạn tạo thông qua giao diện người dùng Google Ad Manager hoặc API SOAP của Google Ad Manager LiveStreamEventService.

Trang này trình bày cách lên lịch chèn quảng cáo dưới dạng thông báo điểm chèn quảng cáo sớm.

Điều kiện tiên quyết

Để tạo hoặc quản lý các điểm chèn quảng cáo, bạn cần có khoá thành phần do hệ thống tạo cho sự kiện phát trực tiếp hoặc khoá thành phần tuỳ chỉnh. Bạn cũng có thể tìm thấy các khoá này trên trang chi tiết của sự kiện phát trực tiếp. Xem phần Thiết lập chương trình phát trực tiếp cho DAI bằng giao diện người dùng Google Ad Manager.

Lên lịch chèn quảng cáo

Bạn có thể lên lịch chèn quảng cáo khi số người xem sự kiện phát trực tiếp tăng lên. Đối với mỗi sự kiện phát trực tiếp, hãy lên lịch một điểm chèn quảng cáo riêng lẻ trước tối đa 6 giờ bằng cách sử dụng phương thức dịch vụ Create. Cung cấp thời gian bắt đầu dự kiến và mã điểm chèn quảng cáo. DAI bắt đầu đưa ra quyết định về quảng cáo gần với thời gian đã lên lịch. Đối với các quyết định chèn quảng cáo ngay lập tức, hãy bỏ qua thời gian bắt đầu dự kiến của điểm chèn quảng cáo.

Để Google DAI bắt đầu đưa ra quyết định về quảng cáo ngay lập tức, bạn có thể bỏ qua thời gian bắt đầu dự kiến của khoảng nghỉ quảng cáo khi gọi Create.

Ví dụ sau đây lên lịch một điểm chèn quảng cáo cho sự kiện phát trực tiếp thuộc loại Linear bắt đầu vào lúc 4:00 chiều ngày 6 tháng 3 năm 2025 theo giờ phối hợp quốc tế (UTC):

cURL 

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

Node.js 

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

Nếu thành công, bạn sẽ thấy phản hồi JSON sau:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

Để truy vấn các điểm chèn quảng cáo, hãy sử dụng phương thức List. Để kiểm tra thông tin chi tiết về điểm chèn quảng cáo, hãy sử dụng phương thức Get.

Ví dụ sau đây liệt kê tất cả các điểm chèn quảng cáo cho một sự kiện phát trực tiếp:

cURL 

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

Node.js 

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

Nếu thành công, bạn sẽ thấy phản hồi JSON sau:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

Nếu bạn muốn lên lịch lại điểm chèn quảng cáo hiện tại sớm hơn, hãy sử dụng phương thức Patch để thay đổi thời gian bắt đầu dự kiến. Nếu bạn muốn huỷ khoảng nghỉ quảng cáo hiện tại, hãy sử dụng phương thức Delete trước khi trạng thái của khoảng nghỉ quảng cáo là COMPLETED.

Để tạo một điểm chèn quảng cáo khác, hãy đợi cho đến khi trạng thái của điểm chèn quảng cáo hiện tại là COMPLETED.