이 가이드에서는 Video Stitcher API에서 지원되는 광고 메타데이터 기능을 설명합니다. 광고 메타데이터는 광고 추적 이벤트 및 컴패니언 광고가 포함된 광고 태그 응답의 VAST 광고에서 추출됩니다. 광고 태그 URL은 세션 생성 요청에서 구성됩니다. 자세한 내용은 라이브 세션 관리 및 VOD 세션 관리를 참고하세요.
시작하기 전에
Video Stitcher API의 입문 개념과 용어를 익혀야 합니다. 자세한 내용은 기술 개요를 참고하세요.
소개
광고 메타데이터에는 스티치된 광고와 연결된 광고 추적 이벤트 및 컴패니언 광고가 포함됩니다. 광고 추적 이벤트에는 VAST 광고 및 시청자 상호작용을 추적하는 데 사용되는 콜백 핑이 포함됩니다. 컴패니언 광고는 상위 VAST 광고를 보완하는 광고입니다. 클라이언트 측 추적 모드에서는 시청자의 동작에 따라 이벤트를 트리거해야 합니다.
서버 측 광고 추적
서버 측 추적 모드에서는 각 광고 세그먼트 URI가 리디렉션 URI로 래핑되며 플레이어가 이러한 세그먼트를 요청할 때마다 Video Stitcher API가 진행 상황 이벤트 처리를 처리합니다. 그러나 pause
와 같은 활동 이벤트는 Video Stitcher API에서 처리하지 않습니다.
클라이언트 측 광고 추적
클라이언트 측 추적 모드에서는 클라이언트가 이벤트를 트리거합니다. 자세한 내용은 이벤트 문서를 참고하세요.
진행 이벤트는 광고 중에 지정된 시간이 경과하면 트리거되어야 하는 이벤트입니다. 예를 들어 Start
이벤트는 광고 시작 시 트리거되어야 합니다. 진행 이벤트에 관한 자세한 내용은 진행 이벤트 객체를 참고하세요.
활동 이벤트는 시청자가 특정 활동을 할 때 트리거되어야 하는 이벤트입니다. 예를 들어 시청자가 광고 동영상을 일시중지하면 pause
이벤트가 트리거되어야 합니다. 활동 이벤트에 관한 자세한 내용은 활동 이벤트 객체를 참고하세요.
VOD 클라이언트 측 광고 추적
전면 광고 객체는 VOD 세션 생성 요청의 응답으로 반환됩니다. VOD 세션을 만드는 방법에 관한 안내는 VOD 세션을 만드는 방법을 참고하세요.
전면 광고에는 삽입된 각 광고의 메타데이터가 포함됩니다. 클라이언트 광고 추적 모드가 사용 설정된 경우 클라이언트는 필요한 경우 추적 이벤트를 트리거해야 합니다. 자세한 내용은 전면 광고 객체를 참고하세요.
실시간 클라이언트 측 광고 추적
Video Stitcher API는 라이브 스트림에 광고를 지속적으로 삽입합니다. 새 광고가 삽입될 때마다 광고 메타데이터 정보가 생성됩니다.
HLS의 경우 광고 메타데이터를 가져오는 AdMetadataURI
는 #EXT-X-DATERANGE
태그에서 찾을 수 있습니다.
DASH의 경우 광고 메타데이터를 가져오는 AdMetadataURI
는 각 <Period>
요소의 <EventStream>
요소에서 찾을 수 있습니다.
자세한 내용은 실시간 클라이언트 측 추적을 처리하는 방법을 참고하세요.
컴패니언 광고
컴패니언 광고는 삽입된 선형 광고와 함께 표시될 수 있는 보조 광고입니다. 자세한 내용은 컴패니언 광고 객체를 참고하세요.
다음 단계
- 특정 Video Stitcher API 태스크를 완료하는 방법 알아보기