이 가이드에서는 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> 요소에서 찾을 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Ad metadata\n\nThis guide describes the supported ad metadata feature of the\nVideo Stitcher API. Ad metadata is extracted from a VAST ad in an ad tag\nresponse, containing ad tracking events and companion ads. The ad tag url is\nconfigured in the session creation request. For more information, see\n[Manage a live session](/video-stitcher/docs/how-to/managing-live-sessions) and\n[Manage a VOD session](/video-stitcher/docs/how-to/managing-vod-sessions).\n\nBefore you begin\n----------------\n\nMake sure you are familiar with the introductory concepts and terminology in the\nVideo Stitcher API. For more information, see the technical\n[overview](/video-stitcher/docs/concepts/overview).\n\nIntroduction\n------------\n\nAd metadata contains ad tracking events and companion ads associated with a\nstitched ad. An ad tracking event contains a callback ping used to track the VAST ad\nand viewer interaction. A companion ad is an ad to supplement the parent VAST\nad. In client-side tracking mode, you are responsible to trigger events based on\nthe viewer's behavior.\n\nServer-side ad tracking\n-----------------------\n\nIn server-side tracking mode, each ad segment URI is wrapped in a\nredirect URI and the Video Stitcher API will handle the processing of progress\nevents whenever the player requests those segments. However, activity events,\nsuch as `pause`, are not handled by the Video Stitcher API.\n\nClient-side ad tracking\n-----------------------\n\nIn client-side tracking mode, the client is responsible for triggering the\nevents. For more details, see the [event documentation](/video-stitcher/docs/reference/rest/v1/Event).\n\nProgress events are events that should be triggered when the specified time has\nelapsed during the ad. For example, event `Start` should be triggered at the\nbeginning of the ad. For more details about progress events, see the\n[progress event object](/video-stitcher/docs/reference/rest/v1/ProgressEvent).\n\nActivity events are events that should be triggered when a viewer conducts a\nspecific activity. For example, event `pause` should be triggered when the\nviewer pauses the ad video. For more details about activity events, see the\n[activity event object](/video-stitcher/docs/reference/rest/v1/Event).\n\n### VOD client-side ad tracking\n\nAn interstitials object is returned in the response of a VOD session create\nrequest. For instruction on how to create a VOD session, see how to\n[create a VOD session](/video-stitcher/docs/how-to/managing-vod-sessions#create-session).\n\nInterstitials contains the metadata for each inserted ad. When client ad\ntracking mode is enabled, the client is responsible for triggering tracking\nevents when necessary. For more details, see the\n[interstitials object](/video-stitcher/docs/reference/rest/v1/Interstitials).\n\n### Live client-side ad tracking\n\nThe Video Stitcher API continuously inserts ads into a livestream; ad\nmetadata information is generated whenever a new ad is inserted.\n\nFor HLS, the `AdMetadataURI` to fetch ad metadata can be found in the\n`#EXT-X-DATERANGE` tag.\n\nFor DASH, the `AdMetadataURI` to fetch ad metadata can be found in the\n`\u003cEventStream\u003e` element for each `\u003cPeriod\u003e` element.\n\nFor more details, see [how to handle live client-side tracking](/video-stitcher/docs/how-to/managing-live-sessions#handle-client-side-ad-tracking).\n\nCompanion ads\n-------------\n\nCompanion ads are supplemental ads that may appear along with inserted linear\nads. For more details, see the [companion ads object](/video-stitcher/docs/reference/rest/v1/CompanionAds).\n\nWhat's next\n-----------\n\n- Learn how to complete specific [Video Stitcher API tasks](/video-stitcher/docs/how-to)."]]
