Google 동적 광고 삽입 (DAI) 광고 모음 게재 API
광고 모음 게재 API는 사용자 대상 HLS 또는 MPEG DASH 미디어 재생목록에 직접 스티칭할 수 있는 방식으로 준비된 적응형 비트 전송률 동영상 광고 모음에 대한 액세스를 제공합니다.
이 API는 고급 게시자 및 동영상 기술 파트너를 대상으로 합니다. 이 API를 대규모로 사용하려면 이 문서의 범위를 벗어나는 정교한 미디어 제공 워크플로를 설계하고 구현해야 합니다.
기본 요건
DAI 광고 모음 게재 API를 통해 라이브 스트림을 처리하려면 먼저 Google Ad Manager UI 또는 live-event API를 사용하여 라이브 스트림 이벤트를 만들어야 합니다.
구성요소
광고 모음 게재 API의 구현을 구성하는 세 가지 구성요소는 Google Ad Manager, 클라이언트 동영상 플레이어, 매니페스트 조작 서버입니다.
Ad Manager
Ad Manager는 사용자에게 광고를 게재하는 역할을 하며 Ad Manager SDK 또는 웹 인터페이스를 통해 관리할 수 있습니다. 서비스에는 다음과 같은 책임이 있습니다.
- 클라이언트 동영상 플레이어에서 스트림 요청을 수신하고, 광고를 결정하고, 콘텐츠 인코딩 프로필과 일치하는 변환을 제공합니다.
- 클라이언트 동영상 플레이어의 광고 세그먼트 요청에 응답하고 지정된 사용자에게 적절한 광고 애드팟 부분을 제공
- 클라이언트 동영상 플레이어에서 추적 핑 수신 및 처리
클라이언트 동영상 플레이어
클라이언트 동영상 플레이어는 클라이언트가 결과 동영상 스트림을 재생하는 데 사용하는 앱 또는 웹사이트입니다. 플레이어의 책임은 다음과 같습니다.
- Ad Manager에서 스트림 리소스를 초기화하고 특정 라이브 스트림 이벤트의 단일 재생 세션을 나타내는 스트림 객체를 수신합니다.
- 재생을 시작하는 매니페스트 조작 서버에서 스트림 매니페스트 요청
- 스트림의 광고 세그먼트에 삽입된 광고 이벤트를 설명하는 Ad Manager의 광고 애드 메타데이터를 주기적으로 폴링
- 광고 미디어 ID가 포함된 플레이어에서 발생한 시간 제한 메타데이터 이벤트를 수신 대기합니다. 이러한 이벤트가 발생하면 플레이어는 광고 이벤트가 성공적으로 발생했는지 확인하기 위해 Ad Manager로 전달합니다.
클라이언트 동영상 플레이어의 올바른 구현에 대해 자세히 알아보려면 플랫폼의 광고 모음 게재 가이드를 참고하세요.
맞춤 구현의 경우 DAI API용 광고 모음 게재 클라이언트 가이드를 참고하세요.
매니페스트 조작 서버
매니페스트 조작 서버는 클라이언트 동영상 플레이어에 제공되는 스트림 매니페스트를 호스팅하는 서버입니다. 서버에는 다음과 같은 책임이 있습니다.
- 클라이언트 동영상 플레이어에 매니페스트 전송 처리
- 광고 세그먼트로 채우기 위해 Ad Manager에서 기간 템플릿을 요청합니다 (MPEG DASH 스트림만 해당).
- 광고 시점에 Ad Manager 호스팅 광고 세그먼트 URL을 동영상 스트림 매니페스트(HLS의 경우) 또는 광고 기간 (MPEG DASH의 경우)에 삽입합니다.
- 수정된 매니페스트를 클라이언트 동영상 플레이어에 제공합니다.
맞춤 매니페스트 조작기 서버 구현에 관한 자세한 내용은 매니페스트 조작 가이드를 참고하세요.
용어 설명
- 라이브 스트림 이벤트: 인코딩 프로필과 같은 라이브 스트림의 중요한 구성 데이터를 저장하는 이벤트입니다. 라이브 스트림 이벤트는 Ad Manager를 사용하여 생성됩니다.
- 스트림 객체: 특정 동영상 애셋의 단일 재생 세션을 나타내는 객체입니다. 주요 속성에는 스트림 ID와 미디어 확인 URL이 포함됩니다.
- 광고 모음: 광고 시점에 표시되는 광고 동영상의 그룹
- 광고 세그먼트: 광고 시점의 미디어 세그먼트 파일
- 광고 모음 메타데이터: 클라이언트에서 광고 UI를 렌더링하는 데 사용되는 광고 시점의 메타데이터입니다(예: 광고 중에 탐색 버튼 숨기기).
- 광고 미디어 ID: 광고 세그먼트 파일 내에 ID3 태그로 인코딩된 메타데이터입니다. 이 메타데이터는 재생 중에 광고 시작 또는 중간 지점과 같은 특정 광고 관련 이벤트가 발생한 시점을 식별하는 데 사용됩니다.