배너 광고

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

이 가이드에서는 앵커 광고 적응형 배너 광고 이렇게 하면 맞춤 타겟팅 매개변수를 사용하여 각 기기에 맞게 광고 크기를 지정할 수 있습니다.

앵커 적응형 배너 광고는 일반 광고가 아닌 고정된 가로세로 비율의 광고입니다. 고정 크기 광고를 사용할 수 있습니다. 가로세로 비율은 업계 표준 320x50과 유사합니다. 한 번 사용할 수 있는 전체 너비를 지정하면 설정합니다. 최적의 높이는 광고가 게재될 때 주변 뷰가 이동하지 않아도 됩니다. 새로고침이 실행됩니다

기본 요건

• 시작 가이드를 모두 읽어보세요.

항상 테스트 광고로 테스트

앱을 빌드하고 테스트할 때는 만들 수 있습니다. 이렇게 하지 않으면 계정이 정지될 수 있습니다.

테스트 광고를 로드하는 가장 쉬운 방법은 Android 배너:

/6499/example/adaptive-banner

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

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

레이아웃에 AdManagerAdView 추가

배너를 표시하는 첫 번째 단계는 AdManagerAdView를 배치하는 것입니다. 표시하려는 Activity 또는 Fragment의 레이아웃 .

private AdSize getAdSize() {
  // Determine the screen width (less decorations) to use for the ad width.
  Display display = getWindowManager().getDefaultDisplay();
  DisplayMetrics outMetrics = new DisplayMetrics();
  display.getMetrics(outMetrics);

  float density = outMetrics.density;

  float adWidthPixels = adContainerView.getWidth();

  // If the ad hasn't been laid out, default to the full screen width.
  if (adWidthPixels == 0) {
    adWidthPixels = outMetrics.widthPixels;
  }

  int adWidth = (int) (adWidthPixels / density);
  return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
}

private void loadBanner() {
  
  // Create a new ad view.
  AdManagerAdView adView = new AdManagerAdView(this);
  adView.setAdSizes(getAdSize());
  adView.setAdUnitId("/6499/example/adaptive-banner");

  // Replace ad container with new ad view.
  adContainerView.removeAllViews();
  adContainerView.addView(adView);

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

// Determine the screen width (less decorations) to use for the ad width.
// If the ad hasn't been laid out, default to the full screen width.
private val adSize: AdSize
  get() {
    val display = windowManager.defaultDisplay
    val outMetrics = DisplayMetrics()
    display.getMetrics(outMetrics)

    val density = outMetrics.density

    var adWidthPixels = binding.adViewContainer.width.toFloat()
    if (adWidthPixels == 0f) {
      adWidthPixels = outMetrics.widthPixels.toFloat()
    }

    val adWidth = (adWidthPixels / density).toInt()
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
  }

private fun loadBanner() {
  
  // Create a new ad view.
  val adView = AdManagerAdView(this)
  adView.adSizes = adSize
  adView.adUnitId = "/6499/example/adaptive-banner"

  // Create an ad request.
  val adRequest = AdManagerAdRequest.Builder().build()

  // Start loading the ad in the background.
  adView.loadAd(adRequest)
}

광고 로드

AdManagerAdView가 배치되었으면 다음 단계는 광고를 로드합니다. loadAd()를 사용하면 됩니다. 메서드를 호출합니다.AdManagerAdView AdManagerAdRequest 매개변수에는 타겟팅 정보와 같은 단일 광고 요청을 생성할 수 있습니다.

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

private void loadBanner() {
  // 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);

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

private fun loadBanner() {
  // This is an ad unit ID for a test ad. Replace with your own banner ad unit ID.
  adView.adUnitId = "/6499/example/banner"
  adView.setAdSize(adSize)
  
  // Create an ad request.
  val adRequest = AdManagerAdRequest.Builder().build()

  // Start loading the ad in the background.
  adView.loadAd(adRequest)
}

광고가 로드되지 않는 경우 광고 단위가 새로고침되도록 설정한 경우에만 Google 모바일 광고 SDK에서 Ad Manager에서 지정한 새로고침 빈도를 있습니다. 새로고침을 사용 설정하지 않은 경우 새 요청을 수행합니다.

작업이 끝났습니다. 이제 앱에서 배너 광고를 게재할 수 있습니다.

광고 이벤트

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

AdManagerAdView.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 클래스

하드웨어 가속 사용 설정

하드웨어 가속을 사용 설정한 상태에서 앱이 제대로 작동하지 않는 경우 개별 활동에 대해서도 제어할 수 있습니다 사용 설정 또는 하드웨어 가속을 사용하지 않으려면 android:hardwareAccelerated 속성을 <application> 및 <activity> 요소(AndroidManifest.xml). 다음 예시는 하드웨어를 가속하고 있지만 한 활동에서는 사용 중지합니다.

<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에서 직접 트래피킹된 광고 소재가 포함된 캠페인을 만들 수 있습니다 보안상 백업 광고 또는 제3자 네트워크 광고에 사용됩니다. 자세한 내용은 집계 노출수 및 클릭수가 포함됩니다.

특별한 이유가 있는 경우 수동으로 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>

앱 이벤트 구현을 보려면 Ad Manager 앱 이벤트 예시를 API 데모 앱

자바 Kotlin

추가 리소스

GitHub의 예

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

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

다음 단계

접을 수 있는 배너

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

인라인 적응형 배너

인라인 적응형 배너는 앵커 적응형 배너에 비해 더 크고 더 긴 배너입니다. 배너 광고 이 배너는 높이가 가변적이며 기기 화면 높이만큼 높을 수도 있습니다. 다음 광고주의 경우 스크롤 가능한 콘텐츠에 배너 광고를 배치하는 앱 자세한 내용은 인라인 적응형 배너 배너를 참고해 확인하세요.

다른 주제 살펴보기

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