Android 네이티브 광고

네이티브 광고는 앱의 디자인과 자연스럽게 어울리는 맞춤형 광고입니다. 광고의 각 요소(제목, 본문, 이미지 등)를 개별적으로 받아 앱의 UI에 맞게 배치할 수 있습니다. 이 가이드에서는 Adrop 네이티브 광고를 Android 앱에 통합하는 방법을 설명합니다.

시작하기 전에

Android SDK 설치 를 완료하세요
Adrop 콘솔에서 배너 광고 유닛을 생성하고 Unit ID를 확인하세요

광고 Unit ID 준비

Adrop 콘솔에서 생성한 광고 Unit ID를 준비하세요. 개발 중에는 테스트 ID를 사용할 수 있습니다.

// 테스트용 Unit ID
val unitId = "PUBLIC_TEST_UNIT_ID_NATIVE"

// 프로덕션용 Unit ID (콘솔에서 발급)
val unitId = "YOUR_UNTI_ID"

테스트 Unit ID 목록

형식

테스트 Unit ID

Native

PUBLIC_TEST_UNIT_ID_NATIVE

Native Video (16:9)

PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_16_9

Native Video (9:16)

PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_9_16

주의: 테스트 Unit ID는 개발 중에만 사용하세요. 앱 출시 전 반드시 콘솔에서 발급받은 실제 Unit ID로 교체해야 합니다.

레이아웃 구성

네이티브 광고 레이아웃을 XML로 정의합니다. AdropNativeAdView를 루트로 사용하고, 광고 요소들을 자유롭게 배치하세요.

<!-- res/layout/layout_native_ad.xml -->
<?xml version="1.0" encoding="utf-8"?>
<io.adrop.ads.nativead.AdropNativeAdView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/native_ad_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical">

        <!-- 광고주 정보 영역 -->
        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="horizontal"
            android:gravity="center_vertical">

            <!-- 프로필 로고 -->
            <ImageView
                android:id="@+id/ad_profile_logo"
                android:layout_width="40dp"
                android:layout_height="40dp" />

            <LinearLayout
                android:layout_width="0dp"
                android:layout_height="wrap_content"
                android:layout_weight="1"
                android:layout_marginStart="8dp"
                android:orientation="vertical">

                <!-- 광고주 이름 -->
                <TextView
                    android:id="@+id/ad_advertiser"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    android:textStyle="bold" />

                <!-- 헤드라인 -->
                <TextView
                    android:id="@+id/ad_headline"
                    android:layout_width="wrap_content"
                    android:layout_height="wrap_content"
                    android:textSize="12sp" />

            </LinearLayout>

        </LinearLayout>

        <!-- 미디어 콘텐츠 (이미지/비디오) -->
        <io.adrop.ads.nativead.AdropMediaView
            android:id="@+id/ad_media"
            android:layout_width="match_parent"
            android:layout_height="200dp"
            android:layout_marginTop="12dp" />

        <!-- 본문 -->
        <TextView
            android:id="@+id/ad_body"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginTop="8dp" />

        <!-- CTA 버튼 -->
        <TextView
            android:id="@+id/ad_call_to_action"
            android:layout_width="match_parent"
            android:layout_height="48dp"
            android:layout_marginTop="12dp"
            android:background="@color/purple_500"
            android:gravity="center"
            android:textColor="@android:color/white"
            android:textStyle="bold" />

    </LinearLayout>

</io.adrop.ads.nativead.AdropNativeAdView>

레이아웃 요소 설명

요소

뷰 타입

필수

설명

헤드라인

TextView

권장

광고 제목

본문

TextView

권장

광고 본문

미디어

AdropMediaView

권장

이미지 또는 비디오

프로필 로고

ImageView

선택

광고주 로고/아이콘

프로필 이름

TextView

선택

광고주 이름

CTA 버튼

TextView

선택

"자세히 보기" 등의 액션 버튼

네이티브 광고 로드

Activity에서 네이티브 광고를 생성하고 로드합니다.

import io.adrop.ads.model.AdropAds
import io.adrop.ads.nativead.AdropNativeAd
import io.adrop.ads.nativead.AdropNativeAdListener
import io.adrop.ads.model.AdropErrorCode

class NativeAdActivity : AppCompatActivity() {
    private var nativeAd: AdropNativeAd? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_native_ad)

        // 네이티브 광고 생성
        nativeAd = AdropNativeAd(this, AdropAds.PUBLIC_TEST_UNIT_ID_NATIVE)

        // 리스너 설정
        nativeAd?.listener = object : AdropNativeAdListener {
            override fun onAdReceived(ad: AdropNativeAd) {
                // 광고 로드 성공 → 뷰에 표시
                displayNativeAd(ad)
            }

            override fun onAdFailedToReceive(ad: AdropNativeAd, errorCode: AdropErrorCode) {
                // 광고 로드 실패
                Log.e("Adrop", "광고 로드 실패: $errorCode")
            }

            override fun onAdClicked(ad: AdropNativeAd) {
                // 광고 클릭됨
            }

            override fun onAdImpression(ad: AdropNativeAd) {
                // 광고 노출됨
            }
        }

        // 광고 로드
        nativeAd?.load()
    }

    override fun onDestroy() {
        super.onDestroy()
        nativeAd?.destroy()
    }
}

import io.adrop.ads.model.AdropAds;
import io.adrop.ads.nativead.AdropNativeAd;
import io.adrop.ads.nativead.AdropNativeAdListener;
import io.adrop.ads.model.AdropErrorCode;

public class NativeAdActivity extends AppCompatActivity {
    private AdropNativeAd nativeAd;

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

        // 네이티브 광고 생성
        nativeAd = new AdropNativeAd(this, AdropAds.PUBLIC_TEST_UNIT_ID_NATIVE);

        // 리스너 설정
        nativeAd.setListener(new AdropNativeAdListener() {
            @Override
            public void onAdReceived(AdropNativeAd ad) {
                // 광고 로드 성공 → 뷰에 표시
                displayNativeAd(ad);
            }

            @Override
            public void onAdFailedToReceive(AdropNativeAd ad, AdropErrorCode errorCode) {
                // 광고 로드 실패
                Log.e("Adrop", "광고 로드 실패: " + errorCode);
            }

            @Override
            public void onAdClicked(AdropNativeAd ad) {
                // 광고 클릭됨
            }

            @Override
            public void onAdImpression(AdropNativeAd ad) {
                // 광고 노출됨
            }
        });

        // 광고 로드
        nativeAd.load();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (nativeAd != null) {
            nativeAd.destroy();
        }
    }
}

광고 데이터를 뷰에 연결

광고가 로드되면 각 요소를 뷰에 연결합니다.

private fun displayNativeAd(ad: AdropNativeAd) {
    // 레이아웃 inflate
    val adView = findViewById<AdropNativeAdView>(R.id.native_ad_view)

    // 각 뷰 찾기
    val profileLogoView = adView.findViewById<ImageView>(R.id.ad_profile_logo)
    val advertiserView = adView.findViewById<TextView>(R.id.ad_advertiser)
    val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
    val mediaView = adView.findViewById<AdropMediaView>(R.id.ad_media)
    val bodyView = adView.findViewById<TextView>(R.id.ad_body)
    val ctaView = adView.findViewById<TextView>(R.id.ad_call_to_action)

    // 광고 데이터 설정
    ad.profile.displayLogo?.let { profileLogoView.setImageDrawable(it) }
    advertiserView.text = ad.advertiser
    headlineView.text = ad.headline
    bodyView.text = ad.body
    ctaView.text = ad.callToAction

    // AdropNativeAdView에 뷰 등록
    adView.setProfileLogoView(profileLogoView)
    adView.setAdvertiserView(advertiserView)
    adView.setHeadlineView(headlineView)
    adView.setMediaView(mediaView)
    adView.setBodyView(bodyView)
    adView.setCallToActionView(ctaView)

    // 광고 객체 연결 (반드시 마지막에 호출)
    adView.setNativeAd(ad)

    // 컨테이너에 추가
    val container = findViewById<FrameLayout>(R.id.native_ad_container)
    container.removeAllViews()
    container.addView(adView)
}

private void displayNativeAd(AdropNativeAd ad) {
    // 레이아웃 inflate
    AdropNativeAdView adView = (AdropNativeAdView) getLayoutInflater().inflate(
        R.layout.layout_native_ad,
        null
    );

    // 각 뷰 찾기
    ImageView profileLogoView = adView.findViewById(R.id.ad_profile_logo);
    TextView advertiserView = adView.findViewById(R.id.ad_advertiser);
    TextView headlineView = adView.findViewById(R.id.ad_headline);
    AdropMediaView mediaView = adView.findViewById(R.id.ad_media);
    TextView bodyView = adView.findViewById(R.id.ad_body);
    TextView ctaView = adView.findViewById(R.id.ad_call_to_action);

    // 광고 데이터 설정
    if (ad.getProfileLogo() != null) {
        profileLogoView.setImageDrawable(ad.getProfileLogo());
    }
    advertiserView.setText(ad.getAdvertiser());
    headlineView.setText(ad.getHeadline());
    bodyView.setText(ad.getBody());
    ctaView.setText(ad.getCallToAction());

    // AdropNativeAdView에 뷰 등록
    adView.setProfileLogoView(profileLogoView);
    adView.setAdvertiserView(advertiserView);
    adView.setHeadlineView(headlineView);
    adView.setMediaView(mediaView);
    adView.setBodyView(bodyView);
    adView.setCallToActionView(ctaView);

    // 광고 객체 연결 (반드시 마지막에 호출)
    adView.setNativeAd(ad);

    // 컨테이너에 추가
    FrameLayout container = findViewById(R.id.native_ad_container);
    container.removeAllViews();
    container.addView(adView);
}

광고 데이터 속성

속성

타입

설명

headline

String

광고 제목

body

String

광고 본문

profile.displayLogo

String

광고주 로고 이미지 URL

profile.displayName

String

광고주 이름

callToAction

String

CTA 버튼 텍스트

extra

JSONObject

커스텀 필드

주의: setNativeAd() 는 반드시 모든 뷰 등록이 완료된 후 마지막에 호출하세요.

리소스 해제

Activity가 종료될 때 광고와 뷰를 정리하여 메모리 누수를 방지합니다.

override fun onDestroy() {
    super.onDestroy()

    // 광고 객체 정리
    nativeAd?.destroy()

    // AdropNativeAdView 정리
    val adView = findViewById<AdropNativeAdView>(R.id.native_ad_view)
    adView?.destroy()
}

@Override
protected void onDestroy() {
    super.onDestroy();

    // 광고 객체 정리
    if (nativeAd != null) {
        nativeAd.destroy();
    }

    // AdropNativeAdView 정리
    AdropNativeAdView adView = findViewById(R.id.native_ad_view);
    if (adView != null) {
        adView.destroy();
    }
}

전체 코드 예시

import android.os.Bundle
import android.util.Log
import android.widget.FrameLayout
import android.widget.ImageView
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
import io.adrop.ads.model.AdropAds
import io.adrop.ads.model.AdropErrorCode
import io.adrop.ads.nativead.AdropMediaView
import io.adrop.ads.nativead.AdropNativeAd
import io.adrop.ads.nativead.AdropNativeAdListener
import io.adrop.ads.nativead.AdropNativeAdView

class NativeAdActivity : AppCompatActivity() {
    private var nativeAd: AdropNativeAd? = null
    private lateinit var nativeAdView: AdropNativeAdView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_native_ad)

        nativeAdView = findViewById<AdropNativeAdView>(R.id.native_ad_view)

        loadNativeAd()
    }

    private fun loadNativeAd() {
        nativeAd = AdropNativeAd(this, AdropAds.PUBLIC_TEST_UNIT_ID_NATIVE).apply {
            listener = object : AdropNativeAdListener {
                override fun onAdReceived(ad: AdropNativeAd) {
                    Log.d("Adrop", "네이티브 광고 로드 성공")
                    displayNativeAd(ad)
                }

                override fun onAdFailedToReceive(ad: AdropNativeAd, errorCode: AdropErrorCode) {
                    Log.e("Adrop", "네이티브 광고 로드 실패: $errorCode")
                }

                override fun onAdClicked(ad: AdropNativeAd) {
                    Log.d("Adrop", "네이티브 광고 클릭됨")
                }

                override fun onAdImpression(ad: AdropNativeAd) {
                    Log.d("Adrop", "네이티브 광고 노출됨")
                }
            }
        }
        nativeAd?.load()
    }

    private fun displayNativeAd(ad: AdropNativeAd) {
        nativeAdView.apply {
            // 뷰 찾기
            val profileLogoView = findViewById<ImageView>(R.id.ad_profile_logo)
            val advertiserView = findViewById<TextView>(R.id.ad_advertiser)
            val headlineView = findViewById<TextView>(R.id.ad_headline)
            val mediaView = findViewById<AdropMediaView>(R.id.ad_media)
            val bodyView = findViewById<TextView>(R.id.ad_body)
            val ctaView = findViewById<TextView>(R.id.ad_call_to_action)

            // 광고 데이터 설정
            Glide.with(this).load(ad.profile.displayLogo).into(profileLogoView)
            advertiserView.text = ad.profile.displayName
            headlineView.text = ad.headline
            bodyView.text = ad.body
            ctaView.text = ad.callToAction

            // 뷰 등록
            setProfileLogoView(profileLogoView)
            setAdvertiserView(advertiserView)
            setHeadlineView(headlineView)
            setMediaView(mediaView)
            setBodyView(bodyView)
            setCallToActionView(ctaView)

            // 광고 연결
            setNativeAd(ad)
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        nativeAd?.destroy()
        nativeAdView?.destroy()
    }
}

import android.os.Bundle;
import android.util.Log;
import android.widget.FrameLayout;
import android.widget.ImageView;
import android.widget.TextView;
import androidx.appcompat.app.AppCompatActivity;
import io.adrop.ads.model.AdropAds;
import io.adrop.ads.model.AdropErrorCode;
import io.adrop.ads.nativead.AdropMediaView;
import io.adrop.ads.nativead.AdropNativeAd;
import io.adrop.ads.nativead.AdropNativeAdListener;
import io.adrop.ads.nativead.AdropNativeAdView;

public class NativeAdActivity extends AppCompatActivity {
    private AdropNativeAd nativeAd;
    private AdropNativeAdView nativeAdView;

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

        nativeAdView = findViewById(R.id.native_ad_view);

        loadNativeAd();
    }

    private void loadNativeAd() {
        nativeAd = new AdropNativeAd(this, AdropAds.PUBLIC_TEST_UNIT_ID_NATIVE);
        nativeAd.setListener(new AdropNativeAdListener() {
            @Override
            public void onAdReceived(AdropNativeAd ad) {
                Log.d("Adrop", "네이티브 광고 로드 성공");
                displayNativeAd(ad);
            }

            @Override
            public void onAdFailedToReceive(AdropNativeAd ad, AdropErrorCode errorCode) {
                Log.e("Adrop", "네이티브 광고 로드 실패: " + errorCode);
            }

            @Override
            public void onAdClicked(AdropNativeAd ad) {
                Log.d("Adrop", "네이티브 광고 클릭됨");
            }

            @Override
            public void onAdImpression(AdropNativeAd ad) {
                Log.d("Adrop", "네이티브 광고 노출됨");
            }
        });
        nativeAd.load();
    }

    private void displayNativeAd(AdropNativeAd ad) {
        // 뷰 찾기
        ImageView profileLogoView = nativeAdView.findViewById(R.id.ad_profile_logo);
        TextView advertiserView = nativeAdView.findViewById(R.id.ad_advertiser);
        TextView headlineView = nativeAdView.findViewById(R.id.ad_headline);
        AdropMediaView mediaView = nativeAdView.findViewById(R.id.ad_media);
        TextView bodyView = nativeAdView.findViewById(R.id.ad_body);
        TextView ctaView = nativeAdView.findViewById(R.id.ad_call_to_action);

        // 광고 데이터 설정
        Glide.with(this).load(ad.getProfile().getDisplayLogo()).into(profileLogoView);
        advertiserView.setText(ad.getProfile().getDisplayName());
        headlineView.setText(ad.getHeadline());
        bodyView.setText(ad.getBody());
        ctaView.setText(ad.getCallToAction());

        // 뷰 등록
        nativeAdView.setProfileLogoView(profileLogoView);
        nativeAdView.setAdvertiserView(advertiserView);
        nativeAdView.setHeadlineView(headlineView);
        nativeAdView.setMediaView(mediaView);
        nativeAdView.setBodyView(bodyView);
        nativeAdView.setCallToActionView(ctaView);

        // 광고 연결
        nativeAdView.setNativeAd(ad);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (nativeAd != null) {
            nativeAd.destroy();
        }
        if (nativeAdView != null) {
            nativeAdView.destroy();
        }
    }
}

추가 옵션

전체 영역 클릭 활성화

광고 뷰 전체를 클릭 가능하게 설정할 수 있습니다.

nativeAdView.isEntireClick = true

커스텀 클릭 처리

SDK에서 네이티브 광고 클릭 시 destination url로 이동을 막고 직접 클릭을 처리할 수 있습니다.

// 기본값: false (SDK가 자동 처리)
// true로 설정하면 직접 클릭 처리 필요
nativeAd.useCustomClick = true

커스텀 필드 사용

광고주가 추가로 제공한 커스텀 데이터에 접근할 수 있습니다.

예를 들어, t1, t2, t3 라는 커스텀 필드가 추가 되었을 경우에 대해 알아보겠습니다. * 텍스트 라벨은 광고주 콘솔에 입력되는 라벨입니다.

findViewById<TextView>(R.id.t1).text = ad.extra.optString("t1")
findViewById<TextView>(R.id.t2).text = ad.extra.optString("t2")
findViewById<TextView>(R.id.t3).text = ad.extra.optString("t3")

((TextView) findViewById(R.id.t1)).setText(nativeAd.getExtra().optString("t1"));
((TextView) findViewById(R.id.t2)).setText(nativeAd.getExtra().optString("t2"));
((TextView) findViewById(R.id.t3)).setText(nativeAd.getExtra().optString("t3"));

PreviousAndroid 배너 광고 NextAndroid 전면 광고

Last updated 2 months ago

hashtag시작하기 전에

hashtag광고 Unit ID 준비

hashtag테스트 Unit ID 목록

hashtag레이아웃 구성

hashtag레이아웃 요소 설명

hashtag네이티브 광고 로드

hashtag광고 데이터를 뷰에 연결

hashtag광고 데이터 속성

hashtag리소스 해제

hashtag전체 코드 예시

hashtag추가 옵션

hashtag전체 영역 클릭 활성화

hashtag커스텀 클릭 처리

hashtag커스텀 필드 사용

시작하기 전에

광고 Unit ID 준비

테스트 Unit ID 목록

레이아웃 구성

레이아웃 요소 설명

네이티브 광고 로드

광고 데이터를 뷰에 연결

광고 데이터 속성

리소스 해제

전체 코드 예시

추가 옵션

전체 영역 클릭 활성화

커스텀 클릭 처리

커스텀 필드 사용