IMA 광고

TV SDK에서 Google IMA(Interactive Media Ads) 광고를 연동하는 방법을 안내합니다.

네이티브 빌드 설정 (필수)

IMA 광고를 사용하려면 네이티브 빌드 플래그를 활성화해야 합니다.

tvOS - ios/Podfile

$RNVideoUseGoogleIMA = true

설정 후 pod install을 실행합니다.

Android TV - android/gradle.properties

RNVideo_useExoplayerIMA=true

플래그 변경 후 앱 리빌드가 필수입니다. Metro 핫 리로드로는 반영되지 않습니다.

광고 설정

options.ads 속성으로 VAST/VMAP 광고 태그를 설정합니다.

<VpePlayer
    accessKey="YOUR_ACCESS_KEY"
    options={{
        playlist: [{
            file: 'https://example.com/video.m3u8',
            poster: 'https://example.com/poster.jpg',
        }],
        autostart: true,
        ads: {
            tagUrl: 'https://pubads.g.doubleclick.net/gampad/ads?...',
            enabled: true,  // 기본: true, false로 비활성화
        },
    }}
    onEvent={(event) => {
        switch (event.type) {
            case 'adStart':
                console.log('광고 시작');
                break;
            case 'adComplete':
                console.log('광고 완료');
                break;
            case 'adSkip':
                console.log('광고 스킵');
                break;
            case 'adError':
                console.log('광고 에러', event.data);
                break;
        }
    }}
    onBack={() => navigation.goBack()}
/>

광고 동작

광고 재생 중 컨트롤바 자동 숨김 + 리모컨 입력 무시
네이티브 IMA SDK가 자체 UI 렌더링
광고 완료/스킵/에러 후 콘텐츠 자동 재생

광고 이벤트

이벤트	설명
`adStart` / `adStarted`	광고 시작
`adComplete`	광고 완료
`adSkip` / `adSkipped`	광고 스킵
`adError`	광고 에러
`adLoaded`	광고 로드 완료
`adBreakStart` / `adBreakEnd`	광고 브레이크 시작/종료