배너 광고

배너 광고는 앱 레이아웃의 일부를 차지하는 직사각형 광고입니다. 사용자가 앱과 상호작용하는 동안 배너 광고가 화면의 상단이나 하단에 앵커 형식으로 표시되거나 스크롤할 때 인라인 형식으로 콘텐츠와 함께 화면에 표시됩니다. 배너 광고는 일정 시간이 지나면 자동으로 새로고침될 수 있습니다. 자세한 내용은 배너 광고 개요를 참고하세요.

이 가이드에서는 지정된 광고 너비를 사용하여 각 기기의 광고 크기를 최적화하여 실적을 극대화하는 고정된 적응형 배너 광고를 시작하는 방법을 보여줍니다.

고정된 적응형 배너 광고는 일반 고정 크기 광고가 아닌 고정 가로세로 비율 광고입니다. 가로세로 비율은 320x50 업계 표준과 유사합니다. 사용 가능한 전체 너비를 지정하면 해당 너비에 최적의 높이가 있는 광고가 반환됩니다. 최적의 높이는 동일한 기기의 요청 간에 변경되지 않으며 광고가 새로고침될 때 주변 뷰를 이동할 필요가 없습니다.

기본 요건

• 시작 가이드를 완료합니다.

항상 테스트 광고로 테스트

앱을 빌드하고 테스트할 때는 운영 중인 실제 광고 대신 테스트 광고를 사용하세요. 이렇게 하지 않으면 계정이 정지될 수 있습니다.

테스트 광고를 로드하는 가장 쉬운 방법은 Android 배너 광고 테스트 전용 광고 단위 ID를 사용하는 것입니다.

/21775744923/example/adaptive-banner

이 ID는 모든 요청에 대해 테스트 광고를 반환하도록 특별히 구성되었으며, 코딩, 테스트, 디버깅 중에 앱에서 사용할 수 있습니다. 앱을 게시하기 전에 이 ID를 자체 광고 단위 ID로 바꿔야 합니다.

모바일 광고 SDK의 테스트 광고가 작동하는 방식을 자세히 알아보려면 테스트 광고를 참고하세요.

레이아웃에 AdManagerAdView 추가

광고 크기를 결정하여 배너를 만듭니다. 다음 단계를 완료합니다.

1. 전체 너비 고정 적응형 광고 크기를 만듭니다.

   자바

   // Get the ad size with screen width.
   public AdSize getAdSize() {
     DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
     int adWidthPixels = displayMetrics.widthPixels;
   
     if (VERSION.SDK_INT >= VERSION_CODES.R) {
       WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
       adWidthPixels = windowMetrics.getBounds().width();
     }
   
     float density = displayMetrics.density;
     int adWidth = (int) (adWidthPixels / density);
     return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
   }
   MyActivity.java
   

   Kotlin

   // Get the ad size with screen width.
   private val adSize: AdSize
     get() {
       val displayMetrics = resources.displayMetrics
       val adWidthPixels =
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
           val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
           windowMetrics.bounds.width()
         } else {
           displayMetrics.widthPixels
         }
       val density = displayMetrics.density
       val adWidth = (adWidthPixels / density).toInt()
       return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
     }
   MyActivity.kt
   

2. 광고 크기를 사용하여 AdManagerAdView를 만들고 앱의 레이아웃에 추가합니다.

   자바

   // Create a new ad view.
   adView = new AdManagerAdView(this);
   adView.setAdUnitId(AD_UNIT);
   adView.setAdSize(getAdSize());
   
   // Replace ad container with new ad view.
   adContainerView.removeAllViews();
   adContainerView.addView(adView);
   MyActivity.java
   

   Kotlin

   // Create a new ad view.
   val adView = AdManagerAdView(this)
   adView.adUnitId = AD_UNIT_ID
   adView.setAdSize(adSize)
   this.adView = adView
   
   // Replace ad container with new ad view.
   binding.adViewContainer.removeAllViews()
   binding.adViewContainer.addView(adView)
   MyActivity.kt
   

광고 로드

AdManagerAdView가 배치되었으면 이제 광고를 로드합니다. AdManagerAdView 클래스의 loadAd() 메서드를 사용하면 됩니다. 단일 광고 요청에 대한 런타임 정보(예: 타겟팅 정보)가 포함된 AdManagerAdRequest 매개변수가 사용됩니다.

다음은 광고를 로드하는 방법을 보여주는 예입니다.

// Start loading the ad in the background.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
adView.loadAd(adRequest);
MyActivity.java

// Start loading the ad in the background.
val adRequest = AdManagerAdRequest.Builder().build()
adView.loadAd(adRequest)
MyActivity.kt

성공하면 앱에서 배너 광고를 게재할 수 있습니다.

광고 새로고침

광고 단위가 새로고침되도록 구성한 경우 광고가 로드되지 않을 때 다른 광고를 요청할 필요가 없습니다. Google 모바일 광고 SDK는 Ad Manager UI에 지정된 새로고침 빈도를 따릅니다. 새로고침을 사용 설정하지 않았다면 새로 요청하세요. 새로고침 빈도 설정 등 광고 단위 새로고침에 관한 자세한 내용은 모바일 앱 광고의 새로고침 빈도를 참고하세요.

광고 이벤트

adView.setAdListener(new AdListener() {
    @Override
    public void onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    @Override
    public void onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    @Override
    public void onAdFailedToLoad(LoadAdError adError) {
      // Code to be executed when an ad request fails.
    }

    @Override
    public void onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    @Override
    public void onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    @Override
    public void onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
});

adView.adListener = object: AdListener() {
    override fun onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    override fun onAdFailedToLoad(adError : LoadAdError) {
      // Code to be executed when an ad request fails.
    }

    override fun onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    override fun onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    override fun onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
}

AdListener에서 재정의할 수 있는 각 메서드는 광고 수명 주기에서 발생하는 이벤트 하나에 해당합니다.

동영상 광고의 하드웨어 가속

배너 광고 뷰에 동영상 광고가 제대로 표시되려면 하드웨어 가속이 사용 설정되어 있어야 합니다.

하드웨어 가속은 기본적으로 사용 설정되어 있지만, 일부 앱에서 이를 사용 중지할 수 있습니다. 앱에서 하드웨어 가속이 사용 중지되었다면 광고를 사용하는 Activity 클래스에 하드웨어 가속을 사용하시기 바랍니다.

하드웨어 가속 사용 설정

하드웨어 가속이 전역적으로 사용 설정된 상태에서 앱이 제대로 작동하지 않으면 개별 활동에 맞게 제어할 수도 있습니다. 하드웨어 가속을 사용 또는 중지하려면 AndroidManifest.xml에서 <application> 및 <activity> 요소에 android:hardwareAccelerated 속성을 적용하세요. 다음 예에서는 앱 전체에서 하드웨어 가속을 사용하고 있지만, 활동 하나에 대해서는 하드웨어 가속을 사용 중지했습니다.

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

하드웨어 가속을 설정하는 옵션에 대해 자세히 알아보려면 하드웨어 가속 관련 가이드를 참고하세요. 활동이 사용 중지된 경우에는 개별 광고 보기에서 하드웨어 가속을 사용할 수 없으므로 활동 자체에 하드웨어 가속이 사용 설정되어야 합니다.

노출수 수동 집계

수동 노출수 집계는 Ad Manager에서 직접 트래피킹된 광고 소재가 있는 직접 판매 및 하우스 캠페인에서만 사용할 수 있습니다. 백업 광고 또는 서드 파티 네트워크 광고에는 사용하면 안 됩니다. 자세한 내용은 노출수 및 클릭수 집계를 참고하세요.

노출수를 기록해야 하는 특별한 상황이면 수동으로 Ad Manager에 노출 핑을 보낼 수 있습니다. 이렇게 하려면 광고를 로드하기 전에 수동 노출을 위한 AdManagerAdRequest를 사용 설정하세요.

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setManualImpressionsEnabled(true)
    .build();

val adRequest = AdManagerAdRequest.Builder()
    .setManualImpressionsEnabled(true)
    .build()

광고가 반환되어 화면에 표시된 것이 확인되면 수동으로 노출을 기록할 수 있습니다.

{ ad_view }.recordManualImpression();

AdManagerAdView.recordManualImpression()

앱 이벤트

앱 이벤트를 사용하면 앱 코드에 메시지를 전송하는 광고를 만들 수 있습니다. 메시지가 전송되면 앱에서 이 메시지를 기반으로 작업을 처리할 수 있습니다.

AppEventListener를 사용하여 Ad Manager 관련 앱 이벤트를 수신할 수 있습니다. 이러한 이벤트는 onAdLoaded()가 호출되기 전을 포함해 광고 주기 중에 언제든지 발생할 수 있습니다.

public interface AppEventListener {
  void onAppEvent(String name, String info);
}

interface AppEventListener {
    fun onAppEvent(name: String, info: String)
}

void onAppEvent(String name, String info)는 광고에서 앱 이벤트가 발생할 때 호출됩니다. 이 인터페이스는 다음과 같이 활동 또는 기타 다른 객체에 의해 구현될 수 있습니다.

import com.google.android.gms.ads.admanager.*;

public class BannerExample extends Activity implements AppEventListener {
}

import com.google.android.gms.ads.admanager.*

class BannerExample : Activity(), AppEventListener {
}

그런 다음 AdManagerAdView로 전달됩니다.

AdManagerAdView.setAppEventListener(this);

AdManagerAdView.appEventListener = this

다음은 색상 이름이 적용된 앱 이벤트에 따라 앱의 배경색을 변경하는 방법의 예입니다.

@Override
public void onAppEvent(String name, String info) {
  if ("color".equals(name)) {
    if ("green".equals(info)) {
      // Set background color to green.
    } else if ("blue".equals(info)) {
      // Set background color to blue.
    } else {
      // Set background color to black.
    }
  }
}

override fun onAppEvent(name: String?, info: String?) {
    if (name == "color") {
        when (info) {
            "green" -> {
                // Set background color to green.
            }
            "blue" -> {
                // Set background color to blue.
            }
            else -> {
                // Set background color to black.
            }
        }
    }
}

다음은 색상 앱 이벤트 메시지를 리스너에 보내는 해당 광고 소재입니다.

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

API 데모 앱에 앱 이벤트를 구현하는 방법을 보여주는 Ad Manager 앱 이벤트 예를 참고하세요.

Java Kotlin

추가 리소스

GitHub의 예

• 앵커 적응형 배너 광고의 예: 자바 | Kotlin

• 고급 기능 데모: 자바 | Kotlin

다음 단계

접을 수 있는 배너

접을 수 있는 배너 광고는 처음에는 더 큰 오버레이로 표시되며, 광고를 더 작은 크기로 접을 수 있는 버튼이 있습니다. 이를 사용하여 실적을 더욱 최적화해 보세요. 자세한 내용은 접을 수 있는 배너 광고를 참고하세요.

인라인 적응형 배너

인라인 적응형 배너는 앵커 적응형 배너와 비교할 때 더 크고 더 높은 배너입니다. 이 배너는 높이가 가변적이며 기기 화면 전체 높이를 차지할 수 있습니다. 스크롤 가능한 콘텐츠에 배너 광고를 게재하는 앱의 경우 앵커 적응형 배너 광고보다 인라인 적응형 배너를 사용하는 것이 좋습니다. 자세한 내용은 인라인 적응형 배너를 참고하세요.

기타 주제 살펴보기

• 사용자 개인 정보 보호
• SDK 초기화 및 광고 로드 최적화(베타)