Pod Serving API는 사용자 대상 HLS 또는 MPEG DASH 미디어 재생목록에 직접 연결할 수 있는 방식으로 준비된 비트 전송률의 적응형 동영상 광고 모음에 대한 액세스를 제공합니다.
이 API는 고급 게시자 및 동영상 기술 파트너를 위해 만들어졌습니다. 이 API를 대규모로 사용하려면 이 문서에서 다루지 않는 정교한 미디어 제공 워크플로를 설계하고 구현해야 합니다.
기본 요건
DAI Podserving API를 통해 실시간 스트림을 처리하기 전에 Google Ad Manager UI 또는 실시간 이벤트 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 태그로 인코딩된 메타데이터입니다. 이 메타데이터는 광고 시작 또는 미드포인트와 같은 재생 중에 특정 광고 관련 이벤트가 발생한 시점을 식별하는 데 사용됩니다.