라이브 스트림 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
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 태그로 인코딩된 메타데이터입니다. 이 메타데이터는 광고 시작 또는 미드포인트와 같은 재생 중에 특정 광고 관련 이벤트가 발생한 시점을 식별하는 데 사용됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-01(UTC)
[null,null,["최종 업데이트: 2025-08-01(UTC)"],[[["\u003cp\u003eThe Pod Serving API facilitates the integration of adaptive-bitrate video ad pods directly into HLS or MPEG DASH media playlists for advanced publishers and video technology partners.\u003c/p\u003e\n"],["\u003cp\u003eImplementing the Pod Serving API involves three core components: Google Ad Manager, which handles ad delivery and tracking; a client video player, which manages stream initialization and playback; and a manifest manipulation server, which modifies and serves the stream manifest.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, a livestream event must be created via the Google Ad Manager UI or the live-event API, serving as a configuration resource for the livestream.\u003c/p\u003e\n"],["\u003cp\u003eThe client video player is responsible for initializing the stream, requesting the manifest, polling for ad pod metadata, and forwarding timed metadata events to Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThe manifest manipulation server handles manifest delivery, requests ad period templates, and inserts Ad Manager-hosted ad segment URLs or ad periods into the stream manifest during ad breaks.\u003c/p\u003e\n"]]],[],null,["# Overview for live streams\n\nThe Pod Serving API provides access to adaptive-bitrate video ad pods prepared\nin such a way that they can be stitched directly into a user-facing HLS or MPEG\nDASH media playlist.\n\nThis API is intended for advanced publishers and video technology partners.\nUsing this API at scale requires design and implementation of a sophisticated\nmedia serving workflow which is outside the scope of this documentation.\n\nPrerequisites\n-------------\n\nBefore processing a livestream through the DAI Podserving API, you\nwill need to create a\n[livestream event](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator#livestreamevent)\nusing the Google Ad Manager UI, or the live-event API.\n\nComponents\n----------\n\nThere are three components that make up any implementation of the Pod Serving\nAPI: Google Ad Manager, a client video player, and a manifest manipulation\nserver.\n\n### Ad Manager\n\nAd Manager is responsible for delivering ads to the user and can be managed\nthrough either the Ad Manager SDK or its web interface. The service has these\nresponsibilities:\n\n- Receiving stream requests from the client video player, decisioning ads, and providing renditions to match your content encoding profiles\n- Responding to ad segment requests from the client video player and providing the appropriate portion of the ad pod for the given user\n- Receiving and processing tracking pings from the client video player\n\n### Client video player\n\nThe client video player is the app or website that clients use to play the\nresulting video stream. The player has these responsibilities:\n\n- Initializing a stream resource from Ad Manager and receiving a stream object that represents a single playback session of a specific livestream event.\n- Requesting a stream manifest from the manifest manipulation server, which starts playback\n- Periodically polling ad pod metadata from Ad Manager that describes the ad events embedded in the stream's ad segments\n- Listening for timed metadata events raised by the player that contain ad media IDs. Upon encountering these events, the player forwards them to Ad Manager to verify that ad events have successfully occurred.\n\nTo learn more about the proper implementation of the client video player, see\nthe pod serving guide for your platform:\n\n- [Android](/ad-manager/dynamic-ad-insertion/sdk/android?service=pod)\n- [HTML5](/ad-manager/dynamic-ad-insertion/sdk/html5?service=pod)\n- [iOS](/ad-manager/dynamic-ad-insertion/sdk/ios?service=pod)\n- [tvOS](/ad-manager/dynamic-ad-insertion/sdk/tvos?service=pod)\n\nFor custom implementations, see our [pod serving client guide for the DAI\nAPI](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/client).\n\n### Manifest manipulation server\n\nThe manifest manipulation server is the server in charge of hosting the\nstream manifest provided to the client video player. The server has these\nresponsibilities:\n\n- Handling manifest delivery to the client video player\n- Requesting a period template from Ad Manager (for MPEG DASH streams only), to populate with ad segments.\n- Inserting Ad Manager-hosted ad segment URLs into the video stream manifest (for HLS) or ad period (for MPEG DASH) during ad breaks.\n- Serving the modified manifest to the client video player.\n\nTo learn more about implementing a custom manifest manipulator server, see the\n[manifest manipulation\nguide](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator).\n\nGlossary\n--------\n\n- **Livestream event**: An event that stores important configuration data for livestream, such as encoding profiles. Livestream events are created using Ad Manager.\n- **Stream object**: An object that represents a single playback session of a specific video asset. Notable properties include the stream ID and the media verification URL.\n- **Ad pod**: Grouping of ad videos shown in an ad break\n- **Ad segments**: Media segment files for the ad break\n- **Ad pod metadata**: Metadata for the ad break used to render ad UI on the client; for example, hide seek buttons during ad\n- **Ad media ID**: Metadata encoded as ID3 tags within ad segment files. This metadata is used to identify when specific ad-related events have occurred during playback, such as ad start or midpoint."]]