조기 광고 시점 알림 보내기

Google 동적 광고 삽입 (DAI)은 높은 동시 실행 수준에서 라이브 스트림을 지원합니다. 조기 광고 시점 알림 (EABN)은 Google DAI에 예정된 광고 시점을 예약하거나 광고 결정을 즉시 시작하여 광고 게재율과 로드 시간을 모두 최적화하도록 요청하는 것입니다.

전체 서비스, 팟 게재 또는 서버 가이드 광고 삽입의 조기 광고 시점 알림을 시작하려면 AdBreaks 리소스를 사용하세요. 이 리소스를 사용하면 Google Ad Manager UI 또는 Google Ad Manager SOAP API LiveStreamEventService를 통해 만든 모든 라이브 스트림의 광고 시점을 만들고 관리할 수 있습니다.

이 페이지에서는 광고 시점을 광고 시점 초기 알림으로 예약하는 방법을 설명합니다.

기본 요건

광고 시점을 만들거나 관리하려면 라이브 스트림 시스템 생성 애셋 키 또는 맞춤 애셋 키가 필요합니다. 라이브 스트림 세부정보 페이지에서도 키를 확인할 수 있습니다. Google Ad Manager UI를 사용하여 DAI용 라이브 스트림 설정을 참고하세요.

광고 시점 예약하기

스트림 시청률이 증가하는 동안 광고 시점을 예약할 수 있습니다. 라이브 스트림 이벤트별로 Create 서비스 메서드를 사용하여 최대 6시간 전에 개별적으로 광고 시점 1개를 예약합니다. 예상 시작 시간 및 광고 시점 ID를 포함합니다. DAI는 예약된 시간에 가까워지면 광고 결정을 시작합니다. 즉각적인 광고 시점 결정의 경우 광고 시점 예상 시작 시간을 생략합니다.

Google DAI가 광고 결정을 즉시 시작하도록 하려면 Create를 호출할 때 광고 시점의 예상 시작 시간을 생략하면 됩니다.

다음 예에서는 Linear 유형의 라이브 스트림 이벤트에 대한 광고 시점이 2025년 3월 6일 오후 4시(협정세계시(UTC))에 시작되도록 예약합니다.

cURL Node.js

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"}'

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"
});

성공하면 다음 JSON 응답이 표시됩니다.

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

광고 시점을 쿼리하려면 List 메서드를 사용합니다. 광고 시점의 세부정보를 검사하려면 Get 메서드를 사용합니다.

다음 예에서는 라이브 스트림 이벤트의 모든 광고 시점을 나열합니다.

cURL Node.js

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

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

성공하면 다음 JSON 응답이 표시됩니다.

{
  "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"
    }
  ]
}

현재 광고 시점의 일정을 더 일찍으로 변경하려면 Patch 메서드를 사용하여 예상 시작 시간을 변경합니다. 현재 광고 시점을 취소하려면 상태가 COMPLETED이 되기 전에 Delete 메서드를 사용합니다.

광고 시점을 다시 만들려면 현재 광고 시점의 상태가 COMPLETED이 될 때까지 기다립니다.