ใช้พารามิเตอร์ช่วงพักโฆษณา

Ad Break API ช่วยให้คุณตั้งค่าพารามิเตอร์แท็กโฆษณาได้โดยใช้พารามิเตอร์ช่วงพักโฆษณา ซึ่งจะช่วยเพิ่มความแม่นยําในการกำหนดเป้าหมายโฆษณาและการผสานรวมกับเซิร์ฟเวอร์โฆษณา

ลบล้างพารามิเตอร์แท็กโฆษณา

หากต้องการลบล้างพารามิเตอร์แท็กโฆษณาของสตรีม Google DAI ให้ตั้งค่าฟิลด์ breakParams.adTagParams ของช่วงพักโฆษณา ดูข้อมูลเพิ่มเติมได้ที่ จัดเตรียมพารามิเตอร์การกำหนดเป้าหมายไปยังสตรีมของคุณ และ พารามิเตอร์แท็กโฆษณา VAST ทั้งหมด

ตัวอย่างต่อไปนี้แสดงแท็กโฆษณาของสตรีม DAI ที่มีพารามิเตอร์การค้นหา mridx (หมายเลขโฆษณากลาง)

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

คำขอตัวอย่างต่อไปนี้สร้างช่วงพักโฆษณาที่ลบล้าง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"}]
    }
  }'

แทนที่ค่าต่อไปนี้

NETWORK_CODE: รหัสเครือข่าย Google Ad Manager ดูข้อมูลเพิ่มเติมได้ที่รหัสเครือข่าย Ad Manager
ASSET_KEY: คีย์เนื้อหาของกิจกรรมไลฟ์สด ดูข้อมูลเพิ่มเติมได้ที่ ค้นหา URL ของสตรีมเชิงเส้นแบบสดและคีย์เนื้อหา
OAUTH_TOKEN: โทเค็นเพื่อการเข้าถึง ดูข้อมูลเพิ่มเติมได้ที่ตรวจสอบสิทธิ์ด้วย OAuth2

ขยายแท็กโฆษณาด้วยมาโคร DAI

Google DAI รองรับมาโครแท็กโฆษณาในรูปแบบ %%DAI_PATTERN:MACRO_NAME%% ชื่อมาโครต้องอยู่ในรูปแบบ UPPER_CASE โดยมีเฉพาะตัวอักษรพิมพ์ใหญ่ ตัวเลข และขีดล่างเท่านั้น

คุณแทรกมาโครเหล่านี้ในแท็กโฆษณาของสตรีม DAI ของ Google หรือคำขอสตรีม DAI เพื่อตั้งค่ามาโครที่มีค่าในฟิลด์ breakParams.macros ได้

ตัวอย่างต่อไปนี้แสดงแท็กโฆษณาของสตรีม DAI ของ Google ที่มีมาโคร BREAK_TYPE

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

คำขอต่อไปนี้จะอัปเดตช่วงพักโฆษณาและตั้งค่า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"}]
  }
}'

แทนที่ AD_BREAK_ID ด้วยรหัสช่วงพักโฆษณา

DAI ของ Google จะแก้ไขแท็กโฆษณาด้วยมาโครดังนี้

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

ขยายแท็กโฆษณาด้วยมาโคร SCTE-35

เมื่อตั้งค่าเหตุการณ์ไลฟ์สดของ Google DAI คุณจะวาง SCTE-35มาโคร ในแท็กโฆษณาหลักได้

เมื่อกิจกรรมไลฟ์สดเริ่มขึ้น คุณจะแทรกข้อมูล SCTE-35 ในไฟล์ Manifest ของเนื้อหา หรือเรียกใช้ DAI Ad Break API โดยมีข้อมูล SCTE-35 อยู่ในพารามิเตอร์ scte35CueOut ได้ DAI ของ Google ใช้ข้อมูลที่ถอดรหัสแล้วเพื่อสร้างSCTE-35มาโครในแท็กโฆษณา

ตัวอย่างต่อไปนี้ใช้มาโคร %%TIME_SIGNAL_UPID_RAW%%

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

ตัวอย่างต่อไปนี้ใช้ JSON เพื่อแสดงข้อมูลสัญญาณที่กำหนดเวลาของ 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
          …
        }
      }
    ]
  }
}

DAI ของ Google จะแก้ไขแท็กโฆษณาด้วยมาโคร SCTE-35 ดังนี้

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