배너

ADwhale Mediation 배너 광고는 Programmatic 방식과 XML 방식 2가지 형태의 구현과 사용이 가능합니다.

배너뷰 생성

Java

AdWhaleMediationAdView 클래스 API 설명

public AdWhaleMediationAdView(Context context)

파라미터 타입	파라미터 값
android.content.Context	Android Main Activity 클래스

public void loadAd() // 미디에이션 배너광고로드

public void setPlacementUid(String placementUid) // 지면 등록

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

public void setAdwhaleAdSize(ADWHALE_AD_SIZE adWhaleAdSize) // 미디에이션 배너사이즈 설정

파라미터 타입	파라미터 값
net.adwhale.sdk.mediation.ads.ADWHALE_AD_SIZE	배너 광고 사이즈(사이즈 종류: BANNER320x50, BANNER320x100, BANNER300x250, BANNER250x250, ADAPTIVE_ANCHOR)

public void setAdWhaleMediationAdViewListener(AdWhaleMediationAdViewListener listener) // 리스너 등록

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

public void setAdaptiveAnchorWidth(int width) // 디바이스 width 입력. ADAPTIVE_ANCHOR 적응형 배너 적용시 사용.

파라미터 타입	파라미터 값
int	디바이스 width 입력 0을 입력할 경우 디바이스 전체 가로 길이 적용됨

public void resume() // resume 콜백 시 호출필요

public void pause() // pause 콜백 시 호출필요

public void destroy() // onDestroy 콜백 시 호출필요

AdWhaleMediationAdViewListener 클래스 API 설명

public void onAdLoaded() // 배너 광고요청 성공 시

public void onAdLoadFailed(int statusCode, String message) // 미디에이션 배너광고요청 실패 시

파라미터 타입	파라미터 값
int	초기화 결과 코드 (200 또는 300)
String	초기화 결과 메시지 ("Internal error occurred..." 또는 "Mediation network error occurred...")

public void onAdClicked() // 배너 클릭 시

배너 구현 샘플은 아래와 같습니다.

2가지 방식으로 배너 구현을 지원합니다(Programmatic 방식, XML 방식).

Programmatic 방식

import androidx.appcompat.app.AppCompatActivity;
import androidx.constraintlayout.widget.ConstraintLayout;

import android.os.Bundle;
import android.os.Handler;
import android.os.Looper;
import android.util.Log;
import android.widget.LinearLayout;
import android.widget.RelativeLayout;

import net.adwhale.sdk.mediation.ads.ADWHALE_AD_SIZE;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationAdView;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationAdViewListener;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationAds;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationOnInitCompleteListener;
import net.adwhale.sdk.utils.AdWhaleLog;

public class MainActivity extends AppCompatActivity {

    private ConstraintLayout root;

    private AdWhaleMediationAdView adWhaleMediationAdView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        root = (ConstraintLayout) findViewById(R.id.root);      
    
        // 로거 설정
        AdWhaleLog.setLogLevel(AdWhaleLog.LogLevel.None);
            
        // 배너광고 뷰 생성
        adWhaleMediationAdView = new AdWhaleMediationAdView(this);
        adWhaleMediationAdView.setPlacementUid("발급받은 placement uid 값");
        adWhaleMediationAdView.setAdwhaleAdSize(ADWHALE_AD_SIZE.BANNER320x50);
        // 적응형 배너 뷰를 적용할 경우 
        // adWhaleMediationAdView.setAdwhaleAdSize(ADWHALE_AD_SIZE.ADAPTIVE_ANCHOR);
        // adWhaleMediationAdView.setAdaptiveAnchorWidth(360); // 디바이스 width 입력. 0을 입력할 경우 디바이스 전체 가로 길이 적용됨.
        

        
        // 배너광고 뷰 콜백 리스너 등록
        adWhaleMediationAdView.setAdWhaleMediationAdViewListener(new AdWhaleMediationAdViewListener() {
            @Override
            public void onAdLoaded() {
                Log.i(MainActivity.class.getSimpleName(), ".onAdLoaded();");
            }

            @Override
            public void onAdLoadFailed(int statusCode, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onAdLoadFailed(" + statusCode + ", " + message + ");");
            }
            
            @Override
            public void onAdClicked() {
                Log.i(MainActivity.class.getSimpleName(), ".onAdClicked();");
            }
        });
        
        // LayoutParams 적용 및 root view에 add
        RelativeLayout.LayoutParams params = new RelativeLayout.LayoutParams(
                LinearLayout.LayoutParams.WRAP_CONTENT, LinearLayout.LayoutParams.WRAP_CONTENT);
        params.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);
        params.addRule(RelativeLayout.CENTER_HORIZONTAL);
        root.addView(adWhaleMediationAdView, params);
                
        // 초기화 코드
        AdWhaleMediationAds.init(this, new AdWhaleMediationOnInitCompleteListener() {
            @Override
            public void onInitComplete(int statusCode, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onInitComplete(" + statusCode + ", " + message + ");");
                if(adWhaleMediationAdView != null) {
                    // 배너광고 뷰 로드
                    new Handler(Looper.getMainLooper()).postDelayed(() -> {
                        adWhaleMediationAdView.loadAd();
                    },0);                    
                }
            }
        });  
    }

    // 라이프사이클 onResume 콜백 시 반드시 onResume 호출 필요(미호출 시 불이익 발생)
    @Override
    protected void onResume() {
        super.onResume();
        if(adWhaleMediationAdView != null) {
            adWhaleMediationAdView.resume();        
        }
    }


    // 라이프사이클 onPause 콜백 시 반드시 onPause 호출 필요(미호출 시 불이익 발생)
    @Override
    protected void onPause() {
        super.onPause();
        if(adWhaleMediationAdView != null) {
            adWhaleMediationAdView.pause();
        }    
    }

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

XML 방식

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    tools:context=".MainActivity">

    <net.adwhale.sdk.mediation.ads.AdWhaleMediationAdView
        android:id="@+id/adWhaleMediationAdView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:placementUid="발급받은 placement uid 값"
        app:bannerSize="BANNER320x50"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

import androidx.appcompat.app.AppCompatActivity;

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

import net.adwhale.sdk.mediation.ads.AdWhaleMediationAdView;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationAdViewListener;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationAds;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationOnInitCompleteListener;
import net.adwhale.sdk.utils.AdWhaleLog;

public class MainActivity extends AppCompatActivity {

    private AdWhaleMediationAdView adWhaleMediationAdView;

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

        // 로거 설정
        AdWhaleLog.setLogLevel(AdWhaleLog.LogLevel.None);
        
        // 배너 뷰 바인딩
        adWhaleMediationAdView = findViewById(R.id.adWhaleMediationAdView);
        
        // 배너 뷰 콜백 리스너 등록
        adWhaleMediationAdView.setAdWhaleMediationAdViewListener(new AdWhaleMediationAdViewListener() {
            @Override
            public void onAdLoaded() {
                Log.i(MainActivity.class.getSimpleName(), ".onAdLoaded();");
            }

            @Override
            public void onAdLoadFailed(int statusCode, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onAdLoadFailed(" + statusCode + ", " + message + ");");
            }
            
            @Override
            public void onAdClicked() {
                Log.i(MainActivity.class.getSimpleName(), ".onAdClicked();");
            }
        });
        
        // 초기화 코드
        AdWhaleMediationAds.init(this, new AdWhaleMediationOnInitCompleteListener() {
            @Override
            public void onInitComplete(int statusCode, String message) {
                Log.i(MainActivity.class.getSimpleName(), ".onInitComplete(" + statusCode + ", " + message + ");");
                if(adWhaleMediationAdView != null) {
                    // 배너 뷰 로드
                    new Handler(Looper.getMainLooper()).postDelayed(() -> {
                        adWhaleMediationAdView.loadAd();
                    },0);  
                }
            }
        });        
    }

    // 라이프사이클 onResume 콜백 시 반드시 onResume 호출 필요(미호출 시 불이익 발생)
    @Override
    protected void onResume() {
        super.onResume();
        if(adWhaleMediationAdView != null) {
            adWhaleMediationAdView.resume();        
        }
    }


    // 라이프사이클 onPause 콜백 시 반드시 onPause 호출 필요(미호출 시 불이익 발생)
    @Override
    protected void onPause() {
        super.onPause();
        if(adWhaleMediationAdView != null) {
            adWhaleMediationAdView.pause();
        }    
    }

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

Kotlin

Compose