IMA (Interactive Media Ads) SDK 개념

이 문서는 무엇을 정리하나

Google IMA(Interactive Media Ads)를 Android에서 붙일 때, 문서/샘플에서 용어가 섞여 보여서(“extension”, “library”, “Media3”) 헷갈리기 쉽다.
이 문서는 공식 문서에서 실제로 쓰는 용어를 기준으로 다음을 자연스럽게 이해할 수 있도록 정리한다.

IMA SDK가 “무엇을” 해주는지
ExoPlayer(ExoPlayer2 vs Media3)와 IMA가 “어떻게” 연결되는지
“플레이어가 몇 개냐?”를 정확히 어떤 의미로 봐야 하는지
(비교) WebView + IMA HTML5로 광고만 분리했을 때 구조가 어떻게 달라지는지

1) IMA SDK는 무엇인가

IMA SDK는 동영상 광고를 붙이기 위한 SDK다. (Client-side/Server-side(DAI) 모두 지원)
Client-side 관점에서 IMA는 보통 다음을 담당한다.

VAST/VMAP 같은 ad tag 기반으로 광고 요청
광고 재생의 라이프사이클(로드/시작/스킵/클릭/완료/에러) 이벤트 제공
광고 UI(스킵 버튼 등) 및 측정/트래킹 흐름

공식 문서(가이드 시작점): IMA SDKs 개요

개발자 관점 요약: “광고 자체(요청·재생·측정) 파이프라인을 표준화해서 SDK로 제공한다.”

2) “ExoPlayer + IMA” 관계를 이해하기 위한 가장 중요한 질문

Q. IMA는 ExoPlayer를 “대체”하는 플레이어인가?

A. 아니다.

ExoPlayer는 콘텐츠(본편) 재생 엔진(ABR/DRM/트랙 선택/버퍼링/디코딩 출력 등)이다.
IMA는 광고 요청/광고 재생 플로우/광고 이벤트·측정을 제공한다.

즉, “IMA vs ExoPlayer”가 아니라 “ExoPlayer(플레이어)에 IMA(광고 기능)를 어떻게 붙이냐”의 문제다. 추가로, IMA는 특정 플레이어에 종속된 개념이 아니어서 ExoPlayer가 아닌 플레이어에도 통합할 수 있다. 다만 ExoPlayer(특히 Media3)는 IMA를 쉽게 붙이기 위한 통합 모듈이 잘 정리돼 있어 실무에서 많이 선택된다.

3) 공식 용어 정리: “ExoPlayer IMA extension” vs “ExoPlayer IMA library”

여기서부터가 가장 헷갈리는 지점인데, 아래 두 표현은 공식 문서에 실제로 등장하는 공식 용어다.

3.1 (Google IMA 문서 용어) ExoPlayer IMA extension

Google IMA(Android) 문서에는 **“Get started with the ExoPlayer IMA extension”**라는 가이드가 있고, 여기서 말하는 “ExoPlayer IMA extension”은 IMA SDK를 ExoPlayer에 쉽게 붙이도록 만든 통합 레이어를 뜻한다.

Google IMA(Android): Get started with the ExoPlayer IMA extension

또한 DAI(서버사이드) 쪽 문서에서도 “ExoPlayer IMA extension”이란 표현을 그대로 사용하며, “extension이 IMA DAI SDK를 래핑(wrap)한다”고 설명한다.

Google Ad Manager DAI(Android): Get started with ExoPlayer IMA extension

한 줄: “ExoPlayer IMA extension”은 Google IMA 문서에서 쓰는 통합 레이어 이름이다.

3.2 (Android Developers / Media3 문서 용어) ExoPlayer IMA library

Android Developers(= Media3 문서)에서는 “ExoPlayer IMA library라는 표현을 사용한다. 문서에는 이 라이브러리가 ImaAdsLoader를 제공하고, client-side IMA SDK 기능을 래핑해서 VAST/VMAP 광고 삽입을 쉽게 한다고 설명되어 있다.

한 줄: “ExoPlayer IMA library”는 Media3(AndroidX) 문서에서 쓰는 공식 명칭이다.

3.3 둘의 차이를 “한 문장”으로

“ExoPlayer IMA extension”은 Google IMA 문서가 사용하는 통합 레이어 표현이고,
“ExoPlayer IMA library”는 Media3(AndroidX) 문서가 사용하는 통합 레이어 표현이다.

실무적으로는 “ExoPlayer2(구 패키지) 생태계 vs Media3(AndroidX) 생태계” 차이로 함께 이해하면 가장 빠르다.

4) ExoPlayer2 vs Media3 ExoPlayer: 왜 갈라졌고 무엇이 다른가

Q. ExoPlayer2와 Media3 ExoPlayer는 “다른 플레이어”야?

A. 기능적으로는 후속/이전 관계에 가깝고, 가장 큰 차이는 ‘배포 채널(=AndroidX로 이동)’과 네임스페이스다.

Android Developers의 migration guide는 ExoPlayer의 새 홈이 Jetpack Media3로 이동했고, ExoPlayer2(com.google.android.exoplayer2)에서 Media3(androidx.media3)로 마이그레이션하는 경로를 안내한다.

Android Developers: Media3 ExoPlayer migration guide

Media3는 AndroidX 리포지토리에서 계속 릴리즈된다.

androidx/media GitHub (Jetpack Media3)

개발자 관점 요약: “ExoPlayer의 현재/미래는 Media3(AndroidX) 쪽에 있고, IMA 통합도 그 흐름을 따라간다.”

5) 가장 많이 나오는 실전 질문: “플레이어는 몇 개야?”

여기서 “플레이어”라는 단어가 무엇을 뜻하는지부터 정해야 오해가 없다.

(A) 앱 코드 관점의 Player 인스턴스(ExoPlayer 객체)
(B) 화면에 보이는 뷰(렌더링 뷰)
(C) 재생 엔진(네이티브 ExoPlayer vs 웹 비디오)

Q. ExoPlayer + IMA(통합 레이어)면 Player 인스턴스는 2개인가?

A. 보통 1개다.
여기서 “통합 레이어”는 공식 문서에서 말하는

(ExoPlayer2 계열) ExoPlayer IMA extension 또는
(Media3 계열) ExoPlayer IMA library 처럼, IMA SDK를 ExoPlayer에 붙이기 쉽게 만든 통합 모듈을 의미한다.

Media3 문서에서 설명하는 ad insertion 구조는 “광고 구간을 플레이어 타임라인에 통합”하는 방식이고, ExoPlayer IMA library가 IMA SDK를 래핑하여 광고 삽입을 쉽게 한다고 명시한다.

Ad insertion — ExoPlayer IMA library

즉 권장 통합(ExoPlayer IMA extension / ExoPlayer IMA library)에서는 일반적으로:

ExoPlayer 인스턴스 1개
광고 구간/콘텐츠 구간을 같은 플레이어가 재생
IMA는 광고 요청/이벤트/측정을 제공(통합 레이어가 연결해줌)

Q. “IMA SDK를 직접 붙이면” 2개 플레이어가 될 수도 있어?

A. 가능하다(하지만 필수는 아님). 또한 “직접 통합”은 ExoPlayer에 한정되지 않는다. IMA SDK는 광고 요청/이벤트/측정을 제공하는 SDK이므로, ExoPlayer가 아닌 다른 플레이어(예: 커스텀 플레이어/기존 레거시 플레이어) 에 붙이는 형태도 가능하다. 단, 아래 예시는 Android 앱에서 가장 흔한 “ExoPlayer 기반” 시나리오로 설명한다.

“직접 통합”은 IMA 이벤트(광고 시작/종료 등)를 앱이 직접 받아서 전환을 제어하기 때문에, 구현 선택에 따라 1-player도 되고 2-player도 될 수 있다.

(예시 1) 직접 통합 + 1 Player(가능)
광고 시작 이벤트를 받으면 같은 ExoPlayer 인스턴스에 광고 소스를 붙여 재생하고, 광고 완료 이벤트 후 다시 콘텐츠 소스로 교체해 본편을 재생한다.
→ Player 인스턴스는 1개지만, 광고/콘텐츠 전환 로직을 앱이 직접 구현해야 한다.
(예시 2) 직접 통합 + 2 Player(가끔 선택)
contentPlayer(본편)와 adPlayer(광고)를 따로 두고, 광고 중에는 adPlayer의 PlayerView를 오버레이로 보여주고 끝나면 숨긴 뒤 contentPlayer를 재생한다.
→ Player 인스턴스가 2개가 되면서 오디오 포커스/풀스크린/회전/백그라운드/전환 타이밍 같은 상태 동기화를 앱이 책임져야 한다.

그래서 ExoPlayer 기반 앱에서는 보통 “ExoPlayer IMA extension / ExoPlayer IMA library” 같은 통합 레이어를 써서 1-player 모델로 운영 복잡도를 줄이는 쪽이 일반적이다.

6) (CSAI) Pre-roll 흐름을 “1 Player 모델”로 이해하기

sequenceDiagram
  autonumber
  participant App as App (Player 화면)
  participant Player as ExoPlayer/Media3 (1개)
  participant Ads as Ads 삽입 레이어(IMA 통합)
  participant IMA as IMA SDK (Client-side)
  participant ADS as Ad Server (VAST/VMAP)

  App->>Player: 콘텐츠 준비 (MediaItem + AdsConfiguration(adTagUri))
  Player->>Ads: 광고 삽입 흐름 시작
  Ads->>IMA: IMA로 광고 요청/이벤트 연결
  IMA->>ADS: VAST/VMAP 요청
  ADS-->>IMA: 광고 응답
  IMA-->>Ads: 광고 재생 상태/이벤트
  Ads-->>Player: 타임라인에 광고 구간 반영
  Player-->>App: 광고 재생 -> 본편 재생 (같은 Player 인스턴스)

7) WebView + IMA HTML5(광고) + ExoPlayer(본편)로 바꾸면 뭐가 달라지나

WebView 방식은 “플레이어 개수”를 (C) 재생 엔진 관점에서 보면 답이 명확해진다.

Q. WebView로 광고만 돌리면 “재생 엔진”이 몇 개야?

A. 사실상 2개다.

본편: 네이티브 ExoPlayer 엔진
광고: WebView 내부 HTML5 <video> + IMA HTML5 SDK 엔진

IMA HTML5 가이드는 “간단한 video player를 만들고 IMA SDK를 붙여라”는 전제다.

IMA SDK for HTML5: Get started

Q. 그럼 광고 뷰 크기가 ExoPlayer PlayerView에 자동으로 맞춰지나?

A. 자동으로 ‘붙어서’ 맞춰지는 개념은 아니다. 개발자가 맞춰야 한다.
실무에서 가장 흔한 패턴은:

동일 컨테이너(FrameLayout 등)에 PlayerView와 WebView를 오버레이로 올리고
광고 중엔 WebView를 VISIBLE, 광고 끝나면 GONE
두 뷰 모두 match_parent로 동일 레이아웃 규칙을 공유 → 이렇게 하면 “같이 리사이즈되는 것처럼” 만들 수 있다(하지만 설계는 개발자 책임).

8) 결론(실무 선택 기준)

ExoPlayer 기반으로 앱을 운영한다면, 광고 삽입은 보통 “ExoPlayer IMA extension / ExoPlayer IMA library”처럼 IMA를 래핑한 통합 레이어를 사용하는 1-player 모델이 가장 자연스럽다.
WebView 광고 분리는 재생 엔진이 2개가 되어 전환/상태 동기화/레이아웃/정책(모바일 웹 제약) 부담이 커질 수 있다.

Explorer

날짜별 보기

2026년 (44)

2025년 (4)