3-1. Rewarded Video Ads

This is a video ad that rewards the user after they complete watching the video. Upon completion of the ad, the "Complete" event callback will be triggered to send the information of ad participation.

UserID Settings

It is used to identify the user for rewarding them upon completion of the rewarded video.

ONEAdMax.setUserId( context, UserID );

• Each user must have a unique user identifier, which should not be a variable value.

• It must not include personal information such as email, name, phone number, or identifiable user IDs.

• If it contains Korean characters, special characters, or spaces, it must be URL encoded before use.

• The user identifier must be set before the user enters the ad.

Creating a Rewarded Video Ad Instance

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

Setting the Rewarded Video Ad Placement ID

Make sure to replace "your_placement_id" with the actual placement ID you received from the ONE AdMax console.

rewardVideo.setPlacementId( PLACEMENT_ID );

Setting the Network Timeout for Rewarded Video Ad Request

Set the network timeout for the rewarded video ad request. When loading the rewarded video ad, a timeout is given for each ad network (mediation provider). If the ad is not received within the specified timeout, the request will move on to the next ad network.

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

Reward Video Load

You can request the rewarded video ad from the server by calling the Load() API.

rewardVideo.load();

Excessive calls to the load() API may result in being blocked.

Reward Video Show

Once the ad loading is complete, you can display the ad by calling the show() API at the desired point in your application:

rewardVideo.show();

To specify the Activity for displaying the rewarded video ad, you need to set it when calling the show() method.

rewardVideo.setCurrentActivity( activity );

To check whether the rewarded video ad has been successfully loaded, you can use the following method:

rewardVideo.isLoaded();

To set up an event listener for the rewarded video ad, you can use the following approach:

rewardVideo.setEventListener( new IOAMRewardVideoEventListener(){
    @Override
    public void onLoaded(){                         // 리워드 비디오 광고 loading 성공
        Log.d( Tag, "rewardVideo load success" );
    }
 
    @Override
    public void onLoadFailed( OAMError error ){     // 리워드 비디오 광고 loading 실패
        Log.d( Tag, "rewardVideo load failed " + error.toString() );
    }
 
    @Override
    public void onOpened(){                         // 리워드 비디오 광고 open 성공
        Log.d( Tag, "rewardVideo open success" );
    }
 
    @Override
    public void onOpenFailed( OAMError error ){     // 리워드 비디오 광고 open 실패
        Log.d( Tag, "rewardVideo open failed " + error.toString() );
    }
 
    @Override
    public void onClosed(){                         // 리워드 비디오 광고 종료
        Log.d( Tag, "rewardVideo closed " + event );
    }
 
    @Override
    public void onClicked(){                        // 리워드 비디오 광고 클릭. 일부 미디에이션 광고는 지원 안함
        Log.d( Tag, "rewardVideo clicked" );
    }
 
    @Override
    public void onCompleted( int adNetworkNo, boolean completed ){ // 리워드 비디오 광고 완료. on completed 에서 completed 가 true 일 때만 리워드 지급
        Log.d( Tag, "rewardVideo  completed " + completed  );
    }
 
} );

ONE AdMax SDK Error Codes

Call the CS page.

This is the API to call the rewarded video ad CS page. You need to pass the Activity context in order for the page to be displayed correctly.

ONEAdMax.openRewardVideoCSPage( Activity activity, String userID )

Here’s a sample code for integrating a rewarded video ad in your app:

private OAMRewardVideo rewardVideo;
 
@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.");      
                initRewardVideo( yourRewardPlacementID );
            }
        });
    }
 
    ...
}
 
 
public void initRewardVideo( String yourPlacementId ){
    rewardVideo = new  OAMRewardVideo( this );
 
    // placementID는 필수입니다.
    rewardVideo.setPlacementId( yourPlacementId );
 
    // optional   
    rewardVideo.setNetworkScheduleTimeout( 10 ); 
 
    // listener를 등록하지 않으면 이벤트를 받을 수 없습니다.
    rewardVideo.setEventListener( new IOAMRewardVideoEventListener(){
        @Override
        public void onLoaded(){                         // 리워드 비디오 광고 loading 성공
            Log.d( Tag, "rewardVideo load success" );
            // loading 성공 이후, showing.
            rewatdVideo.show();
        }
 
        @Override
        public void onLoadFailed( OAMError error ){     // 리워드 비디오 광고 loading 실패
          Log.d( Tag, "rewardVideo load failed " + error.toString() );
        }
 
        @Override
        public void onOpened(){                         // 리워드 비디오 광고 open 성공
            Log.d( Tag, "rewardVideo open success" );
        }
 
        @Override
        public void onOpenFailed( OAMError error ){     // 리워드 비디오 광고 open 실패
          Log.d( Tag, "rewardVideo open failed " + error.toString() );
        }
     
        @Override
        public void onClosed(){                         // 리워드 비디오 광고 종료
            Log.d( Tag, "rewardVideo closed " + event );
        }
 
        @Override
        public void onClicked(){                        // 리워드 비디오 광고 클릭. 일부 미디에이션 광고는 지원 안함
            Log.d( Tag, "rewardVideo clicked" );
        }
 
        @Override
        public void onCompleted( int adNetworkNo, boolean completed ){ // 리워드 비디오 광고 완료
            Log.d( Tag, "rewardVideo completed. " + completed );
        } 
    } );
 
    rewardVideo.load();
}
 
 
 
@Override
protected void onDestroy(){
    super.onDestroy();
    ONEAdMax.unInit();
}

Mediation Settings

For stable fill rate and eCPM, it is recommended to integrate mediation with AppLovin, Unity Ads, and Vungle. These networks can help maximize ad revenue by providing a broad range of ad inventory, improving ad fill rates, and optimizing eCPM.

📌Starting Mediation