네이티브

네이티브 광고 생성

Java

AdWhaleMediationNativeAdView 클래스 API 설명

public AdWhaleMediationNativeAdView(Context context)

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

public void setAdWhaleMediationNativeAdViewListener(AdWhaleMediationNativeAdViewListener listener)

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

public void loadAdWithBinder(AdWhaleNativeAdBinder binder) // 미디에이션 커스텀 바인딩 네이티브 광고로드 시 호출

파라미터 타입	파라미터 값
net.adwhale.sdk.mediation.ads. AdWhaleNativeAdBinder	커스텀 바인딩 네이티브 광고 로드를 위한 바인더

public void loadAdWithTemplate(ADWHALE_NATIVE_TEMPLATE template) // 미디에이션 고정 템플릿 네이티브 광고로드 시 호출

파라미터 타입	파라미터 값
net.adwhale.sdk.mediation.ads. ADWHALE_NATIVE_TEMPLATE	고정 템플릿 네이티브 광고 사이즈(사이즈 종류: SMALL, MEDIUM, FULLSCREEN)

public void setTemplateStyle(AdWhaleMediationNativeTemplateStyle style) // 고정 템플릿 네이티브 광고 요소에 스타일 적

파라미터 타입	파라미터 값
net.adwhale.sdk.mediation.ads.AdWhaleMediationNativeTemplateStyle	(Optional) 고정 템플릿 네이티브 이용 시 스타일 적용

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

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

public void setDebugEnabled(boolean isDebugEnabled) // 광고검사기 활성/비활성

파라미터 타입	파라미터 값
Boolean	개발 모드에서 네이티브 광고 검사기 활성/비활성

public void show() // 네이티브 광고 표시

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

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

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

AdWhaleMediationNativeAdViewListener 클래스 API 설명

public void onNativeAdLoaded() // 미디에이션 네이티브 광고로드 성공 시

public void onNativeAdFailedToLoad(int statusCode, String message) // 미디에이션 네이티브 광고로드 실패 시

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

public void onNativeAdShowFailed(int statusCode, String message) // 미디에이션 네이티브 광고표시 실패 시

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

public void onNativeAdClicked() // 미디에이션 네이티브 광고클릭 시

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

AdWhaleNativeAdBinder.Builder 클래스 API 설명

사용자는 2가지 형태의 네이티브 광고를 호출 및 표시할 수 있습니다 :

• 커스텀 바인딩 네이티브 광고와

• 고정형 템플릿 네이티브 광고

커스텀 바인딩 네이티브 광고는 사용자가 직접 네이티브 광고 레이아웃을 정의하여 사용합니다.

커스텀 바인딩 네이티브 광고를 로드할 때(loadAdWithBinder 메서드) 함께 사용하는 API 입니다.

public Builder(Context context, int layoutResId) // 커스텀 바인딩 네이티브 광고 로드를 위한 바인더 빌더

파라미터 타입	파라미터 값
android.content.Context	Android Main Activity 클래스
Int	사용자가 직접 정의한 커스텀 네이티브 레이아웃 resoure id

public AdWhaleNativeAdBinder.Builder setIconViewId(int IconViewResId) // 사용자가 직접 정의한 아이콘 뷰 설정

파라미터 타입	파라미터 값
Int	사용자가 직접 정의한 아이콘 뷰 resoure id

public AdWhaleNativeAdBinder.Builder setTitleViewID(int titleViewResId) // 사용자가 직접 정의한 타이틀 뷰 설정

파라미터 타입	파라미터 값
Int	사용자가 직접 정의한 타이틀 뷰 resoure id

public AdWhaleNativeAdBinder.Builder setBodyTextViewId(int bodyTextViewResId) // 사용자가 직접 정의한 바디 텍스트 설명 뷰 설정

파라미터 타입	파라미터 값
Int	사용자가 직접 정의한 바디 텍스트 설명 뷰 resoure id

public AdWhaleNativeAdBinder.Builder setCallToActionViewId(int callToActionViewResId) // 사용자가 직접 정의한 CTA 버튼 설정

파라미터 타입	파라미터 값
Int	사용자가 직접 정의한 CTA 버튼 resoure id

public AdWhaleNativeAdBinder.Builder setMediaViewGroupId(int mediaViewGroupResId) // 사용자가 직접 정의한 미디어 뷰 그룹 설정

파라미터 타입	파라미터 값
Int	사용자가 직접 정의한 미디어 뷰 그룹 resoure id

public AdWhaleNativeAdBinder build() // AdWhaleNativeAdBinder 객체를 리턴

AdWhaleMediationNativeTemplateStyle.Builder 클래스 주요 API 설명

고정형 템플릿 네이티브 광고는 ADwhale에서 제공하는 사이즈 별 템플릿 (SMALL, MEDIUM, FULLSCREEN)을 사용합니다.

이 때, 사용자 앱의 look & feel 에 맞추어 템플릿의 요소들에 스타일을 변경 적용할 수 있습니다.

고정형 템플릿 네이티브 광고를 로드할 때(loadAdWithTemplate 메서드) 함께 사용하는 API 입니다.

public Builder() // 고정형 템플릿 네이티브 광고 스타일 적용을 위한 옵션 빌더

public AdWhaleMediationNativeTemplateStyle.Builder withMainBackgroundColor(ColorDrawable colorDrawable) // 고정형 템플릿 메인 색상 선택

파라미터 타입	파라미터 값
android.graphics.drawable.ColorDrawable	컬러 색상 값

public AdWhaleMediationNativeTemplateStyle.Builder withPrimaryTextTypefaceColor(int color) // 헤드라인 뷰 텍스트 색상 설정
public AdWhaleMediationNativeTemplateStyle.Builder withSecondaryTextTypefaceColor(int color) // 세컨더리 뷰 텍스트 색상 설정
public AdWhaleMediationNativeTemplateStyle.Builder withTertiaryTextTypefaceColor(int color) // 바디 텍스트 뷰 텍스트 색상 설정
public AdWhaleMediationNativeTemplateStyle.Builder withCallToActionTypefaceColor(int color) // CTA 버튼 텍스트 색상 설정

파라미터 타입	파라미터 값
Int	텍스트 색상 값

public AdWhaleMediationNativeTemplateStyle.Builder withPrimaryTextSize(float size) // 헤드라인 뷰 텍스트 사이즈 설정
public AdWhaleMediationNativeTemplateStyle.Builder withSecondaryTextSize(float size) // 세컨더리 뷰 텍스트 사이즈 설정
public AdWhaleMediationNativeTemplateStyle.Builder withTertiaryTextSize(float size) // 바디 텍스트 뷰 텍스트 사이즈 설정
public AdWhaleMediationNativeTemplateStyle.Builder withCallToActionTextSize(float size) // CTA 버튼 텍스트 사이즈 설정

파라미터 타입	파라미터 값
Float	텍스트 사이즈 값

public AdWhaleMediationNativeTemplateStyle.Builder withPrimaryTextTypeface(Typeface typeface) // 헤드라인 뷰 텍스트 폰트 설정
public AdWhaleMediationNativeTemplateStyle.Builder withSecondaryTextTypeface(Typeface typeface) // 세컨더리 뷰 텍스트 폰트 설정
public AdWhaleMediationNativeTemplateStyle.Builder withTertiaryTextTypeface(Typeface typeface) // 바디 텍스트 뷰 텍스트 폰트 설정
public AdWhaleMediationNativeTemplateStyle.Builder withCallToActionTextTypeface(Typeface typeface) // CTA 버튼 텍스트 폰트 설정

파라미터 타입	파라미터 값
android.graphics.Typeface	텍스트 폰트 값

public AdWhaleMediationNativeTemplateStyle.Builder withPrimaryTextBackgroundColor(ColorDrawable colorDrawable) // 헤드라인 뷰 텍스트 백그라운드 색상 설정
public AdWhaleMediationNativeTemplateStyle.Builder withSecondaryTextBackgroundColor(ColorDrawable colorDrawable) // 세컨더리 뷰 텍스트 백그라운드 색상 설정
public AdWhaleMediationNativeTemplateStyle.Builder withTertiaryTextBackgroundColor(ColorDrawable colorDrawable) // 바디 텍스트 뷰 텍스트 백그라운드 색상 설정
public AdWhaleMediationNativeTemplateStyle.Builder withCallToActionBackgroundColor(ColorDrawable colorDrawable) // CTA 버튼 백그라운드 색상 설정

파라미터 타입	파라미터 값
android.graphics.drawable.ColorDrawable	컬러 색상 값

public AdWhaleMediationNativeTemplateStyle build() // AdWhaleMediationNativeTemplateStyle 객체를 리턴

네이티브 구현 샘플은 아래와 같습니다.

import androidx.appcompat.app.AppCompatActivity;

import android.graphics.Color;
import android.graphics.Typeface;
import android.graphics.drawable.ColorDrawable;
import android.os.Bundle;
import android.util.Log;

import net.adwhale.sdk.mediation.ads.ADWHALE_NATIVE_TEMPLATE;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationAds;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationNativeAdView;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationNativeAdViewListener;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationNativeTemplateStyle;
import net.adwhale.sdk.mediation.ads.AdWhaleMediationOnInitCompleteListener;
import net.adwhale.sdk.mediation.ads.AdWhaleNativeAdBinder;
import net.adwhale.sdk.utils.AdWhaleLog;

public class MainActivity extends AppCompatActivity {

    private AdWhaleMediationNativeAdView adWhaleMediationNativeAdView;

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

        // 로거 설정
        AdWhaleLog.setLogLevel(AdWhaleLog.LogLevel.None);
        
        // 초기화 코드
        AdWhaleMediationAds.init(this, AdWhaleMediationOnInitCompleteListener {
            statusCode, message ->
                Log.i(MainActivity::class.simpleName, ".onInitComplete($statusCode, $message)")
        })

        // 네이티브 광고 생성
        adWhaleMediationNativeAdView = AdWhaleMediationNativeAdView(this)
        
        // 네이티브 광고 지면 설정
        adWhaleMediationNativeAdView.setPlacementUid("발급 받은 placement uid 값");
        
        // 네이티브 콜백 리스너 등록
        adWhaleMediationNativeAdView.setAdWhaleMediationNativeAdViewListener(new AdWhaleMediationNativeAdViewListener() {
            @Override
            public void onNativeAdLoaded() {
                Log.i(MainActivity.class.getSimpleName(), ".onAdClicked();");
                // 네이티브 광고 표시
                adWhaleMediationNativeAdView.show();
            }

            @Override
            public void onNativeAdFailedToLoad(int errorCode, String errorMessage) {
                Log.e(MainActivity.class.getSimpleName(), ".onNativeAdFailedToLoad(" + errorCode + ", " + errorMessage + ")");
            }

            @Override
            public void onNativeAdShowFailed(int errorCode, String errorMessage) {
                Log.e(MainActivity.class.getSimpleName(), ".onNativeAdShowFailed(" + errorCode + ", " + errorMessage + ")");
            }

            @Override
            public void onNativeAdClicked() {
                Log.i(MainActivity.class.getSimpleName(), ".onNativeAdClicked()");
            }

            @Override
            public void onNativeAdClosed() {
                Log.i(MainActivity.class.getSimpleName(), ".onNativeAdClosed()");
            }
        });


        // 네이티브 광고 로드 방법1(택1): 커스텀 바인딩으로 네이티브 광고 로드
        // custom native AdBinder 생성(custom_native_ad_layout.xml)
        AdWhaleNativeAdBinder adWhaleNativeAdBinder = new AdWhaleNativeAdBinder.Builder(this, R.layout.custom_native_ad_layout)
                .setIconViewId(R.id.view_icon)
                .setTitleViewId(R.id.view_title)
                .setBodyTextViewId(R.id.view_body)
                .setCallToActionViewId(R.id.button_cta)
                .setMediaViewGroupId(R.id.view_media)
                .build();
        
        // 커스텀 바인딩으로 광고 로드
        adWhaleMediationNativeAdView.loadAdWithBinder(adWhaleNativeAdBinder);
        
        
        // 네이티브 광고 로드 방법2(택1): ADwhale에서 제공하는 고정 템플릿으로 네이티브 광고 로드         
        // 고정 템플릿 요소들을 사용자 앱의 look&feel 에 맞게 스타일 적용
        AdWhaleMediationNativeTemplateStyle style = new AdWhaleMediationNativeTemplateStyle.Builder()
                .withMainBackgroundColor(new ColorDrawable(Color.parseColor("#2C2C2C")))
                .withPrimaryTextTypefaceColor(Color.WHITE)
                .withPrimaryTextTypeface(Typeface.DEFAULT_BOLD)
                .withPrimaryTextBackgroundColor(new ColorDrawable(Color.parseColor("#4CAF50")))
                .withPrimaryTextSize(15.0f)
                .build();
        adWhaleMediationNativeAdView.setTemplateStyle(style);
        
        // 고정 템플릿으로 광고 로드
        adWhaleMediationNativeAdView.loadAdWithTemplate(ADWHALE_NATIVE_TEMPLATE.SMALL); // ADWHALE_NATIVE_TEMPLATE.MEDIUM, ADWHALE_NATIVE_TEMPLATE.FULLSCREEN
        
    }

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

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

사용자 지정 커스텀 네이티브 레이아웃 예시(custom_native_ad_layout.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="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    android:background="@android:color/white"
    android:elevation="4dp">

    <!-- 앱 아이콘 -->
    <ImageView
        android:id="@+id/view_icon"
        android:layout_width="48dp"
        android:layout_height="48dp"
        android:layout_marginEnd="12dp"
        android:scaleType="centerCrop"
        app:layout_constraintBottom_toBottomOf="@id/view_title"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="@id/view_title" />

    <!-- 제목 -->
    <TextView
        android:id="@+id/view_title"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:textSize="16sp"
        android:textStyle="bold"
        android:textColor="@android:color/black"
        android:ellipsize="end"
        android:maxLines="2"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toEndOf="@id/view_icon"
        app:layout_constraintTop_toTopOf="parent"
        tools:text="광고 제목입니다" />

    <!-- 설명 -->
    <TextView
        android:id="@+id/view_body"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="4dp"
        android:textSize="14sp"
        android:textColor="@android:color/darker_gray"
        android:ellipsize="end"
        android:lines="2"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="@id/view_title"
        app:layout_constraintTop_toBottomOf="@id/view_title"
        tools:text="광고 설명입니다. 이 앱을 다운로드하세요!" />

    <!-- CTA 버튼 -->
    <Button
        android:id="@+id/button_cta"
        android:layout_width="wrap_content"
        android:layout_height="36dp"
        android:layout_marginTop="8dp"
        android:textSize="12sp"
        android:backgroundTint="#009688"
        android:textColor="@android:color/white"
        android:text="설치하기"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toBottomOf="@id/view_body" />

    <!-- 미디어 뷰 -->
    <FrameLayout
        android:id="@+id/view_media"
        android:layout_width="match_parent"
        android:layout_height="300dp"
        android:layout_marginTop="12dp"
        app:layout_constraintTop_toBottomOf="@id/button_cta" />

</androidx.constraintlayout.widget.ConstraintLayout>

Kotlin

Compose