결합 광고

GfpAdLoader 를 사용하면 광고 요청에서 배너 광고와 네이티브 광고 그리고 네이티브 심플 광고를 결합할 수 있습니다.

---

시작하기 앞서

• 광고 호출을 위해 Ad Unit ID 가 필요합니다.
  • NAM Admin 을 통해 광고 공급자 설정, Inventory 설정, 광고 유닛 등록 등의 과정을 마무리하여 주시기 바랍니다.
  • 관련 내용은 NAM 관리자에게 문의 부탁드립니다.
• 광고를 오버레이로 덮는 다른 View 가 있을 경우, 경우에 따라서 노출 측정이 제대로 되지 않아 성과 지표 측정에 불이익이 있을 수 있습니다.

---

광고 로드

GfpAdLoader 객체를 사용하면 배너, 네이티브, 네이티브 심플 광고를 포함한 다양한 형식의 광고 요청을 처리할 수 있습니다. GfpAdLoader 를 빌드하는 과정에서 각 광고 형식에 필요한 메서드를 추가하여 이를 구현할 수 있습니다.

다음 코드는 하나의 요청으로 배너, 네이티브, 네이티브 심플 광고를 모두 로드할 수 있는 GfpAdLoader 를 생성하는 방법을 보여줍니다.

Kotlin

// Create a new ad parameter.
val adParam = AdParam.Builder()
    .setAdUnitId("YOUR_AD_UNIT_ID")
    ...
    .build()

// Create a new ad loader.
val adLoader = GfpAdLoader.Builder(this, adParam)
    .withBannerAd { bannerAd ->
        // Show the banner ad.
    }
    .withNativeAd { nativeAd ->
        // Show the native ad.
    }
    .withNativeSimpleAd {
        // Show the native simple ad.
    }
    .withAdListener(object: AdEventListener() {
        ...
    })
    .build()

Java

// Create a new ad parameter.
AdParam adParam = new AdParam.Builder()
    .setAdUnitId("YOUR_AD_UNIT_ID")
    ...
    .build();

// Create a new ad loader.
GfpAdLoader adLoader = new GfpAdLoader.Builder(this, adParam)
    .withBannerAd(new GfpBannerAd.OnBannerAdViewLoadedListener() {
        @Override
        public void onBannerAdViewLoaded(GfpBannerAdView adView) {
            // Show the banner ad.
        }
    }
    .withNativeAd(new GfpNativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(GfpNativeAd nativeAd) {
            // Show the native ad.
        }
    })
    .withNativeSimpleAd(new GfpNativeSimpleAd.OnNativeSimpleAdLoadedListener() {
        @Override
        public void onNativeSimpleAdLoaded(GfpNativeSimpleAd ad) {
            // Show the native simple ad.
        }
    })
    .withAdListener(new AdEventListener() {
        ...
    })
    .build();

각 작업은 다음과 같습니다.

1. withBannerAd() 메서드

정보

배너 광고는 네이티브 또는 네이티브 심플 광고와 함께 요청된 경우에만 GfpAdLoader 객체를 통해 로드되는 것을 권장합니다. 배너에 대한 광고 요청만 하려면 배너 광고 에 설명된 단계를 따르세요.

withBannerAd() 메서드는 배너 광고를 수신하도록 GfpAdLoader 를 준비합니다. 배너 광고가 성공적으로 로드되면 지정된 리스너 객체의 onBannerAdViewLoaded() 메서드가 호출됩니다.

onBannerAdViewLoaded() 메서드의 인자로 전달되는 GfpBannerAdView 를 광고를 표시할 ViewGroup 에 추가하면 배너 광고를 노출 할 수 있습니다. 아래 예시는 adContainer 라는 변수명을 가지는 ViewGroup 에 로드된 GfpBannerAdView 를 치환하는 예시를 보여줍니다.

Kotlin

val adLoader = GfpAdLoader.Builder(this, adParam)
    .withBannerAd { bannerAd ->
        // Replace ad container with loaded banner ad view.
        adContainer.removeAllViews()
        adContainer.addView(bannerAd)
    }
    ...
    .build()

Java

GfpAdLoader adLoader = new GfpAdLoader.Builder(this, adParam)
    .withBannerAd(new GfpBannerAd.OnBannerAdViewLoadedListener() {
        @Override
        public void onBannerAdViewLoaded(GfpBannerAdView adView) {
            // Replace ad container with new banner ad view.
            adContainer.removeAllViews();
            adContainer.addView(bannerAd);
        }
    }
    ...
    .build();

2. withNativeAd() 메서드

withNativeAd() 메서드는 네이티브 광고를 수신하도록 GfpAdLoader 를 준비합니다. 네이티브 광고가 성공적으로 로드되면 지정된 리스너 객체의 onNativeAdLoaded() 메서드가 호출됩니다.

네이티브 광고가 로드된 후의 처리 과정은 네이티브 광고 섹션에서 설명하는 단계를 따릅니다.

3. withNativeSimpleAd() 메서드

withNativeSimpleAd() 메서드는 네이티브 심플 광고를 수신하도록 GfpAdLoader 를 준비합니다. 네이티브 심플 광고가 성공적으로 로드되면 지정된 리스너 객체의 onNativeSimpleAdLoaded() 메서드가 호출됩니다.

네이티브 심플 광고가 로드된 후의 처리 과정은 네이티브 심플 광고 섹션에서 설명하는 단계를 따릅니다.