SDK 아키텍처 알아보기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드에서는 SDK 수명 주기와 동영상 플레이어, IMA SDK, 광고 서버 간의 상호작용을 간략하게 설명합니다.
기본 상호작용
다음 다이어그램은 동영상 플레이어, IMA SDK, 광고 서버 간의 상호작용을 보여주고 주석을 추가합니다. 광고 서버는 Ad Manager, 동영상용 애드센스 (AFV) 또는 Ad Exchange (AdX)를 사용할 수 있습니다.
웹페이지나 앱에서 다음을 사용하여 IMA SDK를 로드합니다.
- HTML5용 삽입된 스크립트 태그
- Android, Google Cast, iOS 또는 tvOS용 앱
IMA SDK는 광고 서버에서 특정 광고 단위에 대한 VAST 응답을 요청합니다. 호출된 광고 서버(Ad Manager 대 AFV 또는 AdX)는 광고 태그 URL에 따라 결정됩니다.
광고 서버가 최적의 광고를 선택하고 IMA SDK에 VAST 응답을 전송합니다.
광고는 다음 방법 중 하나를 사용하여 선택됩니다.
- Ad Manager 광고 단위가 광고 항목 후보를 필터링함
- 애드센스 또는 Ad Exchange에서 입찰을 실행합니다.
IMA SDK는 VAST 응답을 파싱하고, 환경에 따라 올바른 미디어 유형을 결정하고, 인라인 동영상 광고 소재 (필요한 경우 컴패니언 광고)를 웹페이지 또는 앱에 제공합니다.
동영상 플레이어가 IMA SDK와 재생 세부정보를 협상하고 광고를 재생합니다.
IMA SDK는 필요에 따라 노출 핑과 VAST 추적 이벤트를 실행합니다.
Lifecycle
이 다이어그램은 IMA SDK의 전체 수명 주기를 보여줍니다. 생성자 및 메서드 호출은 파란색으로 강조 표시되고, 이벤트는 빨간색으로 강조 표시되며, 오류 조건은 빨간색 커넥터와 빨간색 텍스트로 표시됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThis guide explains the lifecycle of the Interactive Media Ads (IMA) SDK and how it facilitates communication between your video player, the SDK, and an ad server (Ad Manager, AdSense for Video, or Ad Exchange).\u003c/p\u003e\n"],["\u003cp\u003eThe process involves the IMA SDK requesting ads from the ad server based on the provided ad tag URL, the ad server selecting and sending a VAST response, and the SDK parsing this response to deliver ads to the video player.\u003c/p\u003e\n"],["\u003cp\u003eThe video player then handles ad playback while the IMA SDK manages tracking events like impressions and VAST events for reporting purposes.\u003c/p\u003e\n"],["\u003cp\u003eThis guide also visually illustrates the entire IMA SDK lifecycle including constructor calls, method calls, events, and potential errors.\u003c/p\u003e\n"]]],[],null,["Select platform: [HTML5](/interactive-media-ads/docs/sdks/html5/client-side/architecture \"View this page for the HTML5 platform docs.\") [Android](/interactive-media-ads/docs/sdks/android/client-side/architecture \"View this page for the Android platform docs.\") [iOS](/interactive-media-ads/docs/sdks/ios/client-side/architecture \"View this page for the iOS platform docs.\") [tvOS](/interactive-media-ads/docs/sdks/tvos/client-side/architecture \"View this page for the tvOS platform docs.\")\n\n\u003cbr /\u003e\n\nThis guide provides an overview of the SDK lifecycle and the interactions\nbetween your video player, the IMA SDK, and an ad server.\n\nBasic interactions\n\nThe following diagram illustrates and annotates the interactions between\nyour video player, the IMA SDK, and an ad server. The ad server can use\nAd Manager, AdSense for Video (AFV), or Ad Exchange (AdX).\n\n1. The web page or app loads the IMA SDK using:\n\n - an embedded script tag for HTML5\n - an app for Android, Google Cast, iOS, or tvOS\n2. The IMA SDK requests a VAST Response for the specific Ad Unit on the ad\n server. The ad server called, which can be either Ad Manager versus AFV or\n AdX, is determined by the ad tag URL.\n\n3. The ad server selects the best ad and sends a VAST response to the IMA SDK.\n Ads are selected using one of the following methods:\n\n - Ad Manager Ad Unit filters Line Item candidates\n - AdSense or Ad Exchange runs an auction\n4. The IMA SDK parses the VAST response, determines the correct media type based\n on environment, and delivers the inline video creative (and\n companion ads if needed) to the web page or app.\n\n5. The video player negotiates the playback details with the IMA SDK and plays\n the ads.\n\n6. The IMA SDK fires an impression ping and VAST tracking events, as needed.\n\nLifecycle\n\nThis diagram shows the full lifecycle of the IMA SDK. Constructor and method\ncalls are highlighted in blue, events are highlighted in red, and error\nconditions are shown with red connectors and red text."]]
