4-4. Interstitial Video ADs (Non Reward)

전면비디오 광고는 전면광고와 동일하며, 동영상이 재생되는 광고입니다.(Interstitial video ads are similar to interstitial ads but play video content.)

전면 비디오 광고 인스턴스 생성(Creating an Interstitial Video Ad Instance)

아래 코드를 추가하여 전면 비디오 광고 인스턴스를 생성합니다. 다음을 참고하세요. (Add the following code to create an instance of an interstitial video ad. Refer to the guide below:)

private OAMInterstitialVideo    interstitialVideo;
 
@Override
protected void onCreate(Bundle savedInstanceState) {
    ...
 
    interstitialVideo = new OAMInterstitialVideo( this );
}

전면 비디오 광고 PLACEMENT ID(Interstitial Video Ad PLACEMENT ID Settings)

아래 코드를 추가하여 전면 비디오 광고의 PLACEMENT ID 를 설정합니다. (Include the following code to set the PLACEMENT ID for your interstitial video ad.)

전면 비디오 광고의 PLACEMENT ID 는 ONE AdMax 콘솔에서 생성이 가능합니다. (The PLACEMENT ID can be generated in the ONE AdMax console.)

interstitialVideo.setPlacementId( PLACEMENT_ID );

전면 비디오 광고 네트워크 스케줄 타임아웃(Network Schedule Timeout for Interstitial Video Ads)

전면 비디오 광고에 대한 네트워크 스케줄 타임아웃을 설정합니다. (Set a network schedule timeout for the interstitial video ad.)

전면 비디오 광고 로딩 시 각 네트워크( 미디에이션 업체 )별로 타임아웃 시간을 주어 해당 시간 안에 광고를 받지 못할 경우 , 다음 네트워크로 넘어가게 됩니다. (If an ad is not received within the timeout period from each network (mediation company), it will move on to the next network.)

interstitialVideo.setNetworkScheduleTimeout( 10 ); // default 10 sec

전면 비디오 광고 요청(Requesting Interstitial Video Ads)

전면 비디오 광고의 load를 요청합니다. (Request the loading of the interstitial video ad.)

interstitialVideo.load();

* load() 호출에 대한 결과로 광고 수신에 실패한 경우에는 load() 재호출 하시면 안됩니다. 과도한 load() api 호출은 block 사유가 됩니다. (Note: If you fail to receive ad upon calling load(), do not re-call load() as excessive API calls can lead to blocks.)

전면 비디오 광고 노출(Interstitial Video Ad Exposal)

전면 비디오 광고를 보여줍니다. (Show the interstitial video ad.)

interstitialVideo.show();

전면 비디오 광고 노출 Activity 지정(Specifying Activity for Interstitial Video Ad Exposal)

전면 비디오 광고의 load api 를 호출한 activity 가 아닌 다른 activity에서 나타내고자할 경우 사용합니다. (Use this if you want the interstitial video ad to appear in a different activity from the one that called the load API.)

interstitialVideo.setCurrentActivity( activity );

전면 비디오 광고 로드 여부 확인(Checking if Interstitial Video Ad is Loaded)

전면 비디오 광고 로드 시 로드 유/무를 파악할 때 호출 합니다. (Call this to determine if the interstitial video ad is loaded and ready to be exposed.)

interstitialVideo.isLoaded();

전면 비디오 광고 이벤트 리스너(Interstitial Video Ad Event Listener)

전면 비디오 광고를 불러올 때 발생하는 이벤트에 대한 리스너를 설정합니다. 제공되는 리스너와 구현 예시는 다음과 같습니다. (Set up listeners for events that occur when loading the interstitial video ad. The available listeners and implementation examples are as follows:)

interstitalVideo.setEventListener( new IOAMInterstitialVideoEventListener(){
    @Override
    public void onLoaded(){                         // 전면 비디오 광고 loading 성공
        Log.d( Tag, "interstitalVideo load success" );
    }
 
    @Override
    public void onLoadFailed( OAMError error ){     // 전면 비디오 광고 loading 실패
        Log.d( Tag, "interstitalVideo load failed " + error.toString() );
    }
 
    @Override
    public void onOpened(){                         // 전면 비디오 광고 open 성공
        Log.d( Tag, "interstitalVideo open success" );
    }
 
    @Override
    public void onOpenFailed( OAMError error ){     // 전면 비디오 광고 open 실패
        Log.d( Tag, "interstitalVideo open failed " + error.toString() );
    }
 
    @Override
    public void onClosed(){                         // 전면 비디오 광고 종료
        Log.d( Tag, "interstitalVideo closed " + event );
    }
 
    @Override
    public void onClicked(){                        // 전면 비디오 광고 클릭. 일부 미디에이션 광고는 지원 안함
        Log.d( Tag, "interstitalVideo clicked" );
    }
} );

* OAMError 는 (링크) 를 참고하세요 (Note: For OAMError, please refer to link)

전면 비디오 광고 샘플 코드(Interstitial Video Ad Sample Code)

전면 비디오 광고 사용에 관련된 sample code 입니다. 다음을 참고하세요. (Refer to the following for sample code related to the use of interstitial video ads.)

private OAMInterstitalVideo interstitialVideo;
 
@Override
protected void onCreate( Bundle savedInstanceState ){
    super.onCreate( savedInstanceState );
    ...
     
    // ONEAdMax 로그 활성화. apk release시에는 삭제해야 합니다.
    ONEAdMax.setLogEnable( true );
 
    //ONEAdMax SDK 초기화
    if( ONEAdMax.isInit( MyActivity.this ) == false ){
        ONEAdMax.init( MyActivity.this, new IOAMInitListener() {
            @Override
            public void onInitialized() {
                Log.d( Tag, "ONEAdMax SDK Initialized.");      
                    initInterstitialVideo( yourInterstitialViceoPlacementID );
            }
        });
    }
 
    ...
}
 
 
public void initInterstitialVideo( String youtPlacementId ){
    interstitialVideo = new OAMInterstitalVideo( this );
 
    // placementID는 필수입니다.
    interstitialVideo.setPlacementId( youtPlacementId );
 
    // optional   
    interstitialVideo.setNetworkScheduleTimeout( 10 ); 
 
    // listener를 등록하지 않으면 이벤트를 받을 수 없습니다.
    interstitialVideo.setEventListener( new IOAMInterstitialVideoEventListener(){
        @Override
        public void onLoaded(){                         // 전면 비디오 광고 loading 성공
            Log.d( Tag, "interstitalVideo load success" );
            // loading 성공 이후, showing.
            interstitialVideo.show();
        }
 
        @Override
        public void onLoadFailed( OAMError error ){     // 전면 비디오 광고 loading 실패
          Log.d( Tag, "interstitalVideo load failed " + error.toString() );
        }
 
        @Override
        public void onOpened(){                         // 전면 비디오 광고 open 성공
            Log.d( Tag, "interstitalVideo open success" );
        }
 
        @Override
        public void onOpenFailed( OAMError error ){     // 전면 비디오 광고 open 실패
          Log.d( Tag, "interstitalVideo open failed " + error.toString() );
        }
     
        @Override
        public void onClosed(){                         // 전면 비디오 광고 종료
            Log.d( Tag, "interstitalVideo closed " + event );
        }
 
        @Override
        public void onClicked(){                        // 전면 비디오 광고 클릭
            Log.d( Tag, "interstitalVideo clicked" );
        }
    } );
 
    interstitalVideo.load();
}
 
 
 
@Override
protected void onDestroy(){
    super.onDestroy();
    ONEAdMax.unInit();
}