광고 시점 매개변수 사용

광고 시간 API를 사용하면 광고 시간 매개변수를 사용하여 광고 태그 매개변수를 설정할 수 있으므로 광고 타겟팅 정확도와 광고 서버와의 통합이 향상됩니다.

광고 태그 매개변수 재정의

Google DAI 스트림의 광고 태그 매개변수를 재정의하려면 광고 시점의 breakParams.adTagParams 필드를 설정합니다. 자세한 내용은 타겟팅 매개변수를 스트림에 공급하기 및 모든 VAST 광고 태그 매개변수를 참고하세요.

다음 예는 mridx (미드롤 번호) 쿼리 매개변수가 포함된 DAI 스트림의 광고 태그를 보여줍니다.

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 형식이어야 하며 대문자, 숫자, 밑줄만 포함해야 합니다.

Google DAI 스트림의 광고 태그 또는 DAI 스트림 요청에 이러한 매크로를 삽입하여 breakParams.macros 필드의 값으로 매크로를 설정할 수 있습니다.

다음 예는 BREAK_TYPE 매크로가 포함된 Google DAI 스트림의 광고 태그를 보여줍니다.

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를 광고 시점 ID로 바꿉니다.

Google DAI는 다음과 같이 매크로를 사용하여 광고 태그를 확인합니다.

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

SCTE-35 매크로로 광고 태그 확장

Google DAI 라이브 스트림 이벤트를 설정할 때 마스터 광고 태그에 SCTE-35 매크로를 배치할 수 있습니다.

라이브 스트림 이벤트가 시작되면 콘텐츠 매니페스트에 SCTE-35 데이터를 삽입하거나 scte35CueOut 매개변수에 포함된 SCTE-35 데이터로 DAI 광고 시점 API를 호출할 수 있습니다. Google DAI는 디코딩된 데이터를 사용하여 광고 태그의 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
          …
        }
      }
    ]
  }
}

Google DAI는 다음과 같이 SCTE-35 매크로를 사용하여 광고 태그를 확인합니다.

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