DAI 광고 시점 API 알아보기

동적 광고 삽입 (DAI) 광고 시점 API를 사용하면 라이브 스트림에서 예정된 광고 시점의 타이밍과 광고 타겟팅 데이터를 만들고 관리할 수 있습니다.

DAI 광고 시점 API를 사용하면 다음 작업을 할 수 있습니다.

  • 트래픽이 많은 시간대에 광고 게재율 향상: 동적 광고 삽입 (DAI) 서비스가 라이브 이벤트에 가장 수익성이 높은 광고를 선택할 수 있는 시간을 늘립니다. 실시간 스트리밍 이벤트의 동시 접속자 수가 많거나, 동적 광고 태그가 있거나, 지연 시간이 긴 광고가 있는 경우 DAI 광고 시점 API를 사용하는 것이 좋습니다.
  • 광고 시점을 완전히 제어: 미리 광고 시점을 만들고, 업데이트하고, 삭제하여 매니페스트 내 광고 신호보다 유연성을 높이고 적시 결정에 비해 포드 게재율을 높입니다.
  • 끊김 없는 시청자 경험 제공: 정확한 광고 시점 정보를 제공하여 광고 관련 재생 오류(예: 광고 애드팟이 부족하거나 과도함)를 최소화합니다.

이 가이드에서는 DAI 광고 시점 API 메서드를 설명하고 DAI 전체 서비스 및 광고 모음 게재 흐름의 광고 시점 수명 주기를 안내합니다.

DAI 광고 시점 API 메서드 알아보기

API는 AdBreak 리소스 관리를 위해 다음과 같은 표준 메서드를 노출합니다.

  • Create: LiveStreamEvent 항목의 새 AdBreak 항목을 정의합니다. 선택적으로 expectedStartTime 속성을 설정하여 광고 시점이 시작되기 60초 이내에 광고 결정을 시작하도록 예약합니다.
  • Get: 광고 시점 상태 및 타이밍 메타데이터를 비롯한 특정 AdBreak 항목의 세부정보를 가져옵니다.
  • List: 지정된 LiveStreamEvent 항목에 대해 API로 이전에 생성된 AdBreak 항목 목록을 반환하며, 역시간순으로 정렬됩니다. API는 콘텐츠 스트림 매니페스트에만 정의된 광고 시점을 반환하지 않습니다.
  • Update: 광고 결정이 시작되기 전에 기존 AdBreak 항목을 수정합니다.
  • Delete: 이전에 생성된 AdBreak 항목의 광고 결정을 취소합니다.

광고 시점 수명 주기 이해

AdBreak 항목에는 다음과 같은 상태가 있습니다.

  • BREAK_STATE_UNSPECIFIED: 기본 상태입니다.
  • BREAK_STATE_SCHEDULED: 광고 시점이 생성되고 광고 결정을 위해 예약되었습니다.
  • BREAK_STATE_DECISIONED: DAI 서비스가 광고 시점의 광고 선택 프로세스를 시작했습니다. 광고 시점은 수정할 수 없지만 광고 서버에 부정적인 영향을 미칠 수 있는 광고 시점을 취소할 수는 있습니다.
  • BREAK_STATE_COMPLETE: 광고 시점이 사용자에게 게재되었습니다.

다음 다이어그램은 생성부터 완료까지 AdBreak 엔티티의 타임라인을 보여줍니다.

생성부터 완료까지의 광고 시점 항목

광고 시점이 시작되기 1~300분 전에 AdBreak 엔티티를 만들 수 있습니다.

  • 광고 결정에 충분한 시간이 없어 광고 게재율이 낮아질 수 있으므로 광고 시점의 예상 시작 시간 1분 전에 광고 시점을 만들지 마세요.
  • 광고 서버에서 요청된 광고를 무효화할 수 있으므로 광고 시점의 예상 시작 시간보다 6시간 이상 전에 광고 시점을 만들지 마세요.

다음 섹션에서는 DAI 전체 서비스 및 광고 모음 게재 흐름의 광고 시점 상태 전환을 설명합니다.

전체 서비스 DAI 흐름 이해하기

Google 전체 서비스 DAI는 콘텐츠 매니페스트와 광고 모음을 모두 관리합니다.

맞춤 광고 타겟팅의 경우 DAI 광고 시점 API를 사용하여 콘텐츠 라이브 스트림 매니페스트의 해당 광고 마커 앞에 AdBreak 엔티티를 만듭니다.

  • 이 리드 타임을 통해 Google DAI 서비스는 광고 결정을 위해 AdBreak 데이터를 사용할 수 있습니다.
  • Google DAI가 매니페스트 광고 마커를 감지하면 시스템은 AdBreak 엔티티 데이터로 광고 결정을 사용하고 엔티티의 상태를 BREAK_STATE_COMPLETE로 전환합니다.

포드 게재 흐름에서 생성부터 완료까지의 광고 시점 엔티티 중단 엔티티입니다.

포드 제공 흐름 이해

이 흐름에서는 콘텐츠 라이브 스트림 매니페스트를 관리하거나 서드 파티 매니페스트 조작 서비스를 사용하여 매니페스트에서 광고 마커를 감지합니다.

광고 애드팟 세그먼트 또는 광고 매니페스트를 요청해야 하는 시점보다 먼저 AdBreak 엔티티를 만들려면 광고 애드팟 예상 시작 시간 전에 DAI 광고 애드팟 API를 호출하세요.

동영상 스티처가 매니페스트 광고 마커를 감지하고 광고 시점 ID를 사용하여 광고 세그먼트 요청을 하면 Google DAI는 광고 결정을 위해 동일한 ID의 AdBreak 데이터를 사용합니다.

클라이언트가 광고 미디어를 요청하면 API를 통해 만든 AdBreak 항목이 BREAK_STATE_COMPLETE 상태로 전환됩니다.

광고 시점 항목 완료 상태

첫 번째 요청하기

API 액세스를 설정하고 첫 번째 요청을 실행하려면 DAI 광고 시점 API 사용을 참고하세요.