Sử dụng thông số điểm chèn quảng cáo

Ad Break API cho phép bạn đặt các tham số thẻ quảng cáo bằng cách sử dụng tham số điểm chèn quảng cáo. Điều này giúp tăng độ chính xác của tiêu chí nhắm mục tiêu quảng cáo và khả năng tích hợp với các máy chủ quảng cáo.

Ghi đè các thông số thẻ quảng cáo

Để ghi đè các tham số thẻ quảng cáo của luồng DAI của Google, hãy đặt trường breakParams.adTagParams của khoảng thời gian quảng cáo. Để biết thêm thông tin, hãy xem bài viết Cung cấp các thông số nhắm mục tiêu cho luồng của bạn và Tất cả tham số của thẻ quảng cáo VAST.

Ví dụ sau đây cho thấy thẻ quảng cáo của luồng DAI có tham số truy vấn mridx (số quảng cáo chèn giữa):

https://pubads.g.doubleclick.net/gampad/live/ads?mridx=3&…

Yêu cầu ví dụ sau đây sẽ tạo một điểm chèn quảng cáo ghi đè giá trị nhắm mục tiêu mridx:

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate",
    "breakParams": {
      "adTagParams": [{"key": "mridx", "value": "7"}]
    }
  }'

Thay thế nội dung sau:

Mở rộng thẻ quảng cáo bằng macro DAI

DAI của Google hỗ trợ macro thẻ quảng cáo ở định dạng %%DAI_PATTERN:MACRO_NAME%%. Tên macro phải ở định dạng UPPER_CASE, chỉ chứa chữ cái viết hoa, số và dấu gạch dưới.

Bạn có thể chèn các macro này vào thẻ quảng cáo của luồng DAI của Google hoặc yêu cầu luồng DAI để đặt các macro bằng các giá trị trong trường breakParams.macros.

Ví dụ sau đây minh hoạ thẻ quảng cáo của luồng DAI của Google có chứa macro BREAK_TYPE:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%DAI_PATTERN:BREAK_TYPE%%&…

Yêu cầu sau đây sẽ cập nhật một thời điểm hiển thị quảng cáo và đặt giá trị macro BREAK_TYPE:

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{
  "name": "networks/…/assets/…/adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:10:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
  "breakParams": {
    "macros": [{"key": "BREAK_TYPE", "value": "national"}]
  }
}'

Thay thế AD_BREAK_ID bằng mã nhận dạng điểm chèn quảng cáo.

Google DAI phân giải thẻ quảng cáo bằng macro như sau:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…

Mở rộng thẻ quảng cáo bằng macro SCTE-35

Khi thiết lập sự kiện phát trực tiếp DAI của Google, bạn có thể đặt macro SCTE-35 trong thẻ quảng cáo chính.

Khi sự kiện phát trực tiếp bắt đầu, bạn có thể chèn dữ liệu SCTE-35 vào tệp kê khai nội dung hoặc gọi API Điểm chèn quảng cáo DAI có dữ liệu SCTE-35 trong tham số scte35CueOut. DAI của Google sử dụng dữ liệu đã giải mã để điền các macro SCTE-35 vào thẻ quảng cáo.

Ví dụ sau đây sử dụng macro %%TIME_SIGNAL_UPID_RAW%%:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%TIME_SIGNAL_UPID_RAW%%&…

Ví dụ sau đây sử dụng JSON để minh hoạ dữ liệu tín hiệu có dấu thời gian SCTE-35:

{
  "splice_info_section": {
    …
    "splice_command": {
      "command_name": "time_signal",
      "splice_time": {
        "time_specified_flag": 1,
        "pts_time": "123456789"
      }
    },
    "splice_descriptors": [
      {
        …
        "segmentation_upid": {
          "raw_hex": "0x6E6174696F6E616C", // UTF8 value: national
          …
        }
      }
    ]
  }
}

Google DAI phân giải thẻ quảng cáo bằng macro SCTE-35 như sau:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…