배너 광고

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

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

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

기본 요건

항상 테스트 광고로 테스트

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

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

ca-app-pub-3940256099942544/9214589741

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

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

레이아웃에 AdView 추가

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

  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)
  }

    MainActivity.kt

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

    자바

    // Create a new ad view.
adView = new AdView(this);
adView.setAdUnitId(AD_UNIT_ID);
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 = AdView(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)
    MainActivity.kt

광고 로드

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

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

자바

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

Kotlin

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

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

광고 새로고침

광고 단위가 새로고침되도록 구성한 경우 광고가 로드되지 않을 때 다른 광고를 요청할 필요가 없습니다. Google 모바일 광고 SDK는 AdMob 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.
    }
});

Kotlin

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에서 재정의할 수 있는 각 메서드는 광고 수명 주기에서 발생하는 이벤트 하나에 해당합니다.

재정의 가능한 메서드
onAdClicked() onAdClicked() 메서드는 광고 클릭이 기록되면 호출됩니다.
onAdClosed() onAdClosed() 메서드는 사용자가 광고의 도착 URL을 조회한 후 앱으로 돌아가면 호출됩니다. 앱에서 이 메서드를 사용해 정지된 활동을 재개하거나 상호작용 준비에 필요한 다른 작업을 처리할 수 있습니다. Android API 데모 앱에서 광고 리스너 메서드를 구현하려면 AdMob AdListener 예를 참고하세요.
onAdFailedToLoad() onAdFailedToLoad() 메서드는 매개변수를 포함하는 유일한 메서드입니다. LoadAdError 유형의 오류 매개변수는 발생한 오류를 설명합니다. 자세한 내용은 광고 로드 오류 디버깅 문서를 참고하세요.
onAdImpression() onAdImpression() 메서드는 광고 노출이 기록될 때 호출됩니다.
onAdLoaded() onAdLoaded() 메서드는 광고 로드가 완료되면 실행됩니다. 예를 들어 광고 로드가 확실하게 완료될 때까지 AdView가 활동 또는 프래그먼트에 추가되지 않게 하려면 여기에서 설정하세요.
onAdOpened() onAdOpened() 메서드는 광고에서 화면을 가리는 오버레이를 열 때 호출됩니다.

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

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

하드웨어 가속은 기본적으로 사용 설정되어 있지만, 일부 앱에서 이를 사용 중지할 수 있습니다. 앱에서 하드웨어 가속이 사용 중지되었다면 광고를 사용하는 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>

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

추가 리소스

GitHub의 예

다음 단계

접을 수 있는 배너

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

인라인 적응형 배너

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

기타 주제 살펴보기