보상형

보상형 광고 생성

Java

AdWhaleMediationRewardAd 클래스 API 설명

public AdWhaleMediationRewardAd(String placementUid)

파라미터 타입	파라미터 값
String	placementUid 값(발급 필요)

public void setAdWhaleMediationFullScreenContentCallback(AdWhaleMediationFullScreenContentCallback listener)

파라미터 타입	파라미터 값
net.adwhale.sdk.mediation.ads. AdWhaleMediationFullScreenContentCallback	보상형 미디에이션 광고 호출 콜백 리스너

public void loadAd(AdWhaleMediationRewardAdLoadCallback listener) // 미디에이션 보상형 전면 광고로드 시 호출

파라미터 타입	파라미터 값
net.adwhale.sdk.mediation.ads. AdWhaleMediationRewardAdLoadCallback	보상형 미디에이션 광고 로드 콜백 리스너

public void showAd(AdWhaleMediationUserEarnedRewardListener listener) // 미디에이션 보상형 전면 광고로드 후 표시할 때 호출

파라미터 타입	파라미터 값
net.adwhale.sdk.mediation.ads. AdWhaleMediationUserEarnedRewardListener	보상형 미디에이션 광고 리워드 지급 콜백 리스너

public void showAd(Activity activity, AdWhaleMediationUserEarnedRewardListener listener) // 미디에이션 보상형 전면 광고로드 후 표시할 때 호출

파라미터 타입	파라미터 값
android.app.Activity	Android Activity 클래스
net.adwhale.sdk.mediation.ads. AdWhaleMediationUserEarnedRewardListener	보상형 미디에이션 광고 리워드 지급 콜백 리스너

public void destroy() // onDestroy() 시 호출

AdWhaleMediationFullScreenContentCallback 클래스 API 설명

public void onAdClicked() // 미디에이션 보상형 광고클릭 시

public void onAdDismissed() // 미디에이션 보상형 광고닫기 시

public void onFailedToShow(int statusCode, String message) // 미디에이션 보상형 광고표시 실패 시

파라미터 타입	파라미터 값
Int	광고표시 결과 코드
String	광고표시 결과 메시지

public void onAdShowed() // 미디에이션 보상형 광고표시 후

AdWhaleMediationRewardAdLoadCallback 클래스 API 설명

public void onAdLoaded(AdWhaleMediationRewardAd adWhaleMediationRewardAd, String message) // 미디에이션 보상형 광고로드 성공 시

파라미터 타입	파라미터 값
AdWhaleMediationRewardAd	AdWhaleMediationRewardAd 객체
String	광고로드 결과 메시지

public void onFailedToLoad(int statusCode, String message) // 미디에이션 보상형 광고로드 실패 시

파라미터 타입	파라미터 값
Int	광고로드 결과 코드
String	광고로드 결과 메시지

AdWhaleMediationUserEarnedRewardListener 클래스 API 설명

public void onUserRewarded(AdWhaleMediationRewardItem rewardItem) // 미디에이션 보상형 리워드지급 성공 시

파라미터 타입	파라미터 값
AdWhaleMediationRewardtem	리워드 타입, 리워드 금액 값을 지니는 객체

보상형 구현 샘플은 아래와 같습니다.

import android.os.Bundle;
import android.util.Log;

import androidx.appcompat.app.AppCompatActivity;

import net.adwhale.sdk.mediation.ads.AdWhaleMediationAds;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationFullScreenContentCallback;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationOnInitCompleteListener;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationRewardAd;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationRewardedAdLoadCallback;
import net.adwhale.sdk.utils.AdWhaleLog;

public class MainActivity extends AppCompatActivity {

    private AdWhaleMediationRewardAd adWhaleMediationRewardAd;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 로거 설정
        AdWhaleLog.setLogLevel(AdWhaleLog.LogLevel.None);
        
        // 초기화 코드
        AdWhaleMediationAds.init(this, new AdWhaleMediationOnInitCompleteListener() {
            @Override
            public void onInitComplete(int statusCode, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onInitComplete(" + statusCode + ", " + message + ");");             
            }
        });

        // 보상형광고 생성
        adWhaleMediationRewardAd = new AdWhaleMediationRewardAd("발급받은 placement uid 값");
        
        // 보상형광고 콜백 리스너 등록
        adWhaleMediationRewardAd.setAdWhaleMediationFullScreenContentCallback(new AdWhaleMediationFullScreenContentCallback() {
        
            @Override
            public void onAdClicked() {
                Log.i(MainActivity.class.getSimpleName(), ".onAdClicked();");
            }

            @Override
            public void onAdDismissed() {
                Log.i(MainActivity.class.getSimpleName(), ".onAdDismissed();");
            }
            
            @Override
            public void onFailedToShow(int statusCode, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onFailedToShow(" + statusCode + ", " + message + ");");
            }
                        
            @Override
            public void onAdShowed() {
                Log.e(MainActivity.class.getSimpleName(), ".onAdShowed();");
            }
        });

        // 보상형광고 로드
        adWhaleMediationRewardAd.loadAd(new AdWhaleMediationRewardedAdLoadCallback() {
            @Override
            public void onAdLoaded(AdWhaleMediationRewardAd adWhaleMediationRewardAd, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onAdLoaded(" + message + ")");
                
                if(adWhaleMediationRewardAd != null) {
                    // 보상형광고 표시
                    adWhaleMediationRewardAd.showAd(adWhaleMediationRewardItem -> {
                        Log.i(MainActivity.class.getSimpleName(), ".onUserRewarded(" + adWhaleMediationRewardItem.toString() + ")");
                    });                
                }         
            }

            @Override
            public void onAdFailedToLoad(int statusCode, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onAdFailedToLoad(" + statusCode + ", " + message + ")");
            }
        });           

    }
    
    // 라이프사이클 onDestroy 콜백 시 반드시 onDestroy 호출 필요
    @Override
    protected void onDestroy() {
        super.onDestroy();
        if(adWhaleMediationRewardAd != null) {
            adWhaleMediationRewardAd.destroy();
        }
    }    
}

Kotlin

Compose