배너 광고

배너 광고는 기기 화면의 상단이나 하단에 있는 앱의 레이아웃 안에 게재됩니다. 사용자가 앱과 상호작용하는 동안 화면에 계속 표시되며 일정 시간이 지나면 자동으로 새로고침될 수 있습니다. 모바일 광고가 처음이라면 배너 광고부터 시작하세요.

이 가이드에서는Ad Manager 의 배너 광고를 Android 앱에 통합하는 방법을 설명합니다. 코드 스니펫과 안내 외에도 배너 크기 조정에 대한 정보와 추가 리소스 링크가 포함되어 있습니다.

기본 요건

• 시작 가이드에 따라 필요한 과정을 완료합니다.

레이아웃에 AdManagerAdView 추가

배너 광고를 게재하려면 먼저 광고를 게재할 Activity 또는 Fragment 레이아웃에 AdManagerAdView를 넣으세요. 가장 쉬운 방법은 상응하는 XML 레이아웃 파일에 넣는 것입니다. 다음은 활동의 AdManagerAdView를 보여주는 예입니다.

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="/6499/example/banner">
  </com.google.android.gms.ads.admanager.AdManagerAdView>
...

다음 필수 속성에 유의하세요.

• ads:adSize: 사용할 광고 크기로 설정합니다. 상수로 정의된 표준 크기를 사용하지 않으려면 맞춤 크기를 설정하세요. 자세한 내용은 아래의 배너 크기 섹션을 참고하세요.
• ads:adUnitId: 광고가 게재되는 앱의 광고 단위에 지정할 고유 식별자로 설정합니다. 여러 활동에서 배너 광고를 게재하려면 활동별로 광고 단위가 필요합니다.

또는 프로그래매틱 방식으로 AdManagerAdView를 만들 수 있습니다.

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);

adView.setAdUnitId("/6499/example/banner");
// TODO: Add adView to your view hierarchy.

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER

adView.adUnitId = "/6499/example/banner"
// TODO: Add adView to your view hierarchy.

항상 테스트 광고로 테스트

앱을 제작하고 테스트할 때는 운영 중인 실제 광고가 아닌 테스트 광고를 사용해야 합니다. 이렇게 하지 않으면 계정이 정지될 수 있습니다.

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

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

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

광고 로드

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

다음은 Activity의 onCreate() 메서드에서 광고를 로드하는 방법을 보여주는 예입니다.

MainActivity (발췌)

package ...

import ...
import com.google.android.gms.ads.admanager.AdManagerAdRequest;
import com.google.android.gms.ads.admanager.AdManagerAdView;

public class MainActivity extends AppCompatActivity {
    private AdManagerAdView mAdManagerAdView;

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

        mAdManagerAdView = findViewById(R.id.adManagerAdView);
        AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
        mAdManagerAdView.loadAd(adRequest);
    }
}

package ...

import ...
import com.google.android.gms.ads.admanager.AdManagerAdRequest
import com.google.android.gms.ads.admanager.AdManagerAdView

class MainActivity : AppCompatActivity() {

    lateinit var mAdManagerAdView : AdManagerAdView

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

        mAdManagerAdView = findViewById(R.id.adManagerAdView)
        val adRequest = AdManagerAdRequest.Builder().build()
        mAdManagerAdView.loadAd(adRequest)
    }
}

이제 완료됐습니다. 이제 앱에서 배너 광고를 게재할 수 있습니다.

광고 이벤트

광고의 작동 방식을 추가로 맞춤설정하려는 경우 광고의 수명 주기에서 여러 이벤트(예: 로드, 열기, 닫기)에 연결하면 됩니다. AdListener 클래스를 통해 이러한 이벤트를 수신 대기할 수 있습니다.

AdListener를 AdManagerAdView와 함께 사용하려면 setAdListener() 메서드를 호출하세요.

mAdManagerAdView.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.
    }
});

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

배너 크기

아래 표에는 표준 배너 크기가 나와 있습니다.

맞춤 배너 크기를 지정하려면 다음과 같이 원하는 AdSize를 설정하세요.

AdSize adSize = new AdSize(300, 50);

val adSize = AdSize(300, 50)

맞춤 광고 크기

Google Ad Manager를 사용하면 일반 광고 단위 외에도 모든 크기의 광고 단위를 애플리케이션에 게재할 수 있습니다. 광고 요청에 대해 정의된 광고 크기 (너비, 높이)가 애플리케이션에 표시되는 광고 보기의 크기(다음 예에서는 AdManagerAdView)와 일치해야 합니다.

예:

// Define custom AdSize of 250x250 for AdManagerAdView

AdSize customAdSize = new AdSize(250, 250);
AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(customAdSize);

// Define custom AdSize of 250x250 for AdManagerAdView

val customAdSize = AdSize(250, 250)
val adView = AdManagerAdView(this)
adView.setAdSizes(customAdSize)

Android API 데모 앱에 맞춤 광고 크기를 구현하려면 Ad Manager의 광고 크기 예시를 참고하세요.

다양한 광고 크기

Ad Manager를 사용하면 AdManagerAdView에 게재할 수 있는 광고 크기를 여러 개 지정할 수 있습니다. SDK에서 이 기능을 구현하기 전에 크기가 다양한 광고 소재와 연결된 광고 단위를 타겟팅하는 광고 항목을 만드세요.

애플리케이션에서 여러 AdSize 매개변수를 setAdSizes에 전달하기만 하면 됩니다.

AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(AdSize.BANNER, new AdSize(120, 20), new AdSize(250, 250));

val adView = AdManagerAdView(this)
adView.setAdSizes(AdSize.BANNER, AdSize(120, 20), AdSize(250, 250))

새로고침 시 AdManagerAdView에 따라 크기가 변경되면 레이아웃이 새 크기에 자동으로 적응할 수 있어야 합니다.

애플리케이션에서 지원되는 광고 크기를 변경하려면 새로운 광고 크기 목록을 이용해 setAdSizes를 호출하세요.

// Drop support for 120x20 ad size.
adView.setAdSizes(AdSize.BANNER, new AdSize(250, 250));

// Drop support for 120x20 ad size.
adView.setAdSizes(AdSize.BANNER, AdSize(250, 250))

AdManagerAdView는 다음 광고가 반환될 때까지 첫 번째 매개변수에서 전달되는 크기로 기본 설정됩니다.

XML 레이아웃 파일의 ads:adSizes 속성을 사용하여 여러 광고 크기를 지정할 수도 있습니다.

<com.google.android.gms.ads.admanager.AdManagerAdView
   android:id="@+id/multiple_ad_sizes_view"
   android:layout_width="wrap_parent"
   android:layout_height="wrap_content"
   android:layout_alignParentBottom="true"
   android:layout_centerHorizontal="true"
   ads:adSizes="BANNER,120x20,250x250"
   ads:adUnitId="ad unit ID" />

Android API 데모 앱에 여러 광고 크기를 구현하려면 Ad Manager의 광고 크기 예시를 참고하세요.

수동 노출수 계산

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

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

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

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

mAdManagerAdView.recordManualImpression();

mAdManagerAdView.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에 전달됩니다.

mAdManagerAdView.setAppEventListener(this);

mAdManagerAdView.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>

Android API 데모 앱에 앱 이벤트를 구현하려면 Ad Manager 앱 이벤트 예시를 참고하세요.

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

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

하드웨어 가속은 기본적으로 사용 설정되어 있지만 일부 앱에서는 사용 중지할 수 있습니다. 이 경우에 해당한다면 광고를 사용하는 활동 클래스에 하드웨어 가속을 사용 설정하는 것이 좋습니다.

하드웨어 가속 사용 설정

앱이 하드웨어 가속이 전역적으로 사용 설정된 상태에서 제대로 작동하지 않으면 개별 활동에 맞게 제어할 수도 있습니다. 하드웨어 가속을 사용하거나 사용 중지하려면 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>

하드웨어 가속을 설정하는 옵션에 관한 자세한 내용은 HW 가속 가이드를 참고하세요. 활동이 사용 중지된 경우에는 개별 광고 보기에 하드웨어 가속을 사용 설정할 수 없으므로 활동 자체에 하드웨어 가속이 사용 설정되어 있어야 합니다.

추가 리소스

GitHub의 예

• 배너 광고 최소 구현의 예: 자바 | Kotlin

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

Mobile Ads Garage 동영상 가이드

• 배너 구현
• 배너 권장사항