접을 수 있는 배너 광고

접을 수 있는 배너 광고는 처음에는 더 큰 오버레이로 표시되며, 원래 요청된 배너 크기로 접을 수 있는 버튼이 있습니다. 접을 수 있는 배너 광고는 스크롤 없이 볼 수 있는 부분인 그 외의 경우에는 더 작은 크기입니다. 이 가이드에는 접을 수 있는 배너를 사용 설정하는 방법이 나와 있습니다. 기존 배너 게재위치에 게재할 수 없습니다.

기본 요건

구현

배너 보기가 사용자에게 표시하려는 크기로 정의되었는지 확인합니다. 일반 (접힌) 배너 상태로 표시됩니다. 광고에 추가 매개변수 포함 collapsible를 키로 사용하고 광고의 게재위치를 값으로 사용하여 요청을 전송합니다.

접을 수 있는 게재위치는 확장된 영역이 배너 광고에 고정되는 방식을 정의합니다.

Placement 동작 의도된 사용 사례
top 펼쳐진 광고의 상단이 접힌 광고의 상단에 맞춰집니다. 광고가 화면 상단에 게재됩니다.
bottom 펼쳐진 광고의 하단이 접힌 광고의 하단에 정렬됩니다. 광고가 화면 하단에 배치됩니다.

로드된 광고가 접을 수 있는 배너인 경우 배너에 접을 수 있는 즉시 오버레이됩니다.

자바

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

광고 새로고침 동작

Ad Manager 웹 인터페이스에서 배너 광고의 자동 새로고침을 구성하는 앱의 경우 배너 슬롯에 접을 수 있는 배너 광고가 요청되면 이후 광고 새로고침에서 접을 수 있는 배너 광고가 요청되지 않습니다. 접을 수 있는 배너를 게재할 때마다 사용자 경험에 부정적인 영향을 미칠 수 있습니다.

세션에서 나중에 접을 수 있는 다른 배너 광고를 로드하려는 경우 접을 수 있는 매개변수가 포함된 요청으로 광고를 수동으로 로드하기

로드된 광고를 접을 수 있는지 확인

접을 수 없는 배너 광고는 실적을 극대화하기 위해 접을 수 있는 배너 요청에 대해 반환될 수 있습니다. isCollapsible를 호출하여 로드된 마지막 배너가 접을 수 있는지 확인합니다. 요청이 로드되지 않고 이전 요청이 접을 수 있는 경우 API는 true를 반환합니다.

자바

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

미디에이션

접을 수 있는 배너 광고는 베타 기간 동안 Google 수요에만 사용할 수 있습니다. 미디에이션을 통해 게재되는 광고는 접을 수 없는 일반적인 배너 광고로 게재됩니다.