접을 수 있는 배너 광고

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

기본 요건

구현

배너 보기가 사용자에게 표시하려는 크기로 정의되었는지 확인합니다. 일반 (접힌) 배너 상태로 표시됩니다. 광고에 추가 매개변수 포함 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 수요에만 사용할 수 있습니다. 미디에이션을 통해 게재되는 광고는 접을 수 없는 일반적인 배너 광고로 게재됩니다.