광고 연동

The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

Classic/VPC 환경에서 이용 가능합니다.

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

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

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

tvOS(ios/Podfile)

tvOS는 Podfile에 다음 플래그를 추가합니다.

$RNVideoUseGoogleIMA = true

설정 후 pod install을 실행해 주십시오.

Android TV(android/gradle.properties)

Android TV는 gradle.properties에 다음 플래그를 추가합니다.

RNVideo_useExoplayerIMA=true

광고 설정

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 광고의 동작 방식은 다음과 같습니다.

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

광고 이벤트

수신할 수 있는 광고 이벤트는 다음과 같습니다.