접을 수 있는 배너 광고

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

기본 요건

구현

배너 보기가 사용자에게 표시하려는 크기로 정의되었는지 확인합니다. 일반 (접힌) 배너 상태로 표시됩니다. 광고에 추가 매개변수 포함 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)
}

광고 새로고침 동작

접을 수 있는 배너 광고가 30~120초마다 게재되도록 새로고침하는 것이 너무 잦아 사용자 경험을 떨어뜨립니다. Cloud SDK를 구성하는 앱의 경우 Ad Manager 웹 인터페이스에서 자동 새로고침 기능을 사용하는 경우 첫 번째 광고 요청만 접을 수 있는 것으로 표시하고 그 이후에는 새로고침된 배너 광고를 원래 요청의 크기로 해당 슬롯에 게재합니다. 받는사람 이렇게 하려면 UUID를 collapsible_request_id로 광고 요청에 전달합니다.

자바

extras.putString("collapsible_request_id", UUID.randomUUID().toString());

Kotlin

extras.putString("collapsible_request_id", UUID.randomUUID().toString())

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

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

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 광고 수요에만 사용할 수 있습니다. 있습니다. 미디에이션을 통해 게재되는 광고는 접을 수 없는 일반적인 배너 광고로 표시됩니다.

광고 게재 동작

배너 광고의 실적을 극대화하기 위해 더 큰 크기를 지원하지 않는 광고는 접을 수 있는 오버레이는 일부 접을 수 있는 배너 요청을 반환하고 일반 배너 크기로 즉시 사용할 수 있습니다.