Zwijane banery reklamowe

Zwijane banery reklamowe to banery reklamowe, które początkowo wyświetlają się jako większe nakładki z przyciskiem do ich zwijania do pierwotnie żądanego rozmiaru. Zwijane banery reklamowe zwiększają skuteczność reklam zakotwiczonych, które zwykle mają mniejsze rozmiary. Z tego przewodnika dowiesz się, jak włączyć zwijane banery reklamowe w istniejących miejscach docelowych banerów.

Wymagania wstępne

Implementacja

Upewnij się, że widok banera ma zdefiniowany rozmiar, który użytkownicy mają widzieć w stanie zwykłym (zwiniętym) banera. Uwzględnij w żądaniu reklamy parametr dodatków, w których kluczem jest collapsible, a jego wartością jest miejsce docelowe reklamy.

Zwijane miejsce docelowe określa, w jaki sposób rozwinięty region będzie zakotwiczony w banerze reklamowym.

Wartość: Placement Sposób działania Zamierzony przypadek użycia
top Górna część rozwiniętej reklamy jest wyrównana do góry zwiniętej reklamy. Reklama jest umieszczona na górze ekranu.
bottom Dolna część rozwiniętej reklamy przylega do dołu zwiniętej reklamy. Reklama jest umieszczona na dole ekranu.

Jeśli wczytana reklama jest banerem zwijanym, od razu po umieszczeniu w hierarchii widoku banera wyświetli tę zwijaną nakładkę.

Java

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)
}

Sposób odświeżania reklam

Odświeżanie zwijanych banerów reklamowych, które wyświetlają się co 30–120 sekund, może być zbyt częste i frustrować użytkowników. W przypadku aplikacji, które mają skonfigurowane automatyczne odświeżanie w interfejsie internetowym, AdMob zalecamy wyświetlanie tylko pierwszego żądania reklamy jako zwijanego, a kolejnych odświeżanych banerów reklamowych w tym boksie w rozmiarze pierwotnego żądania. W tym celu przekaż do żądania reklamy identyfikator UUID jako collapsible_request_id:

Java

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

Kotlin

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

Jeśli w dalszej części sesji zechcesz wczytać kolejny zwijany baner reklamowy, możesz wywołać funkcję loadAd() ręcznie, używając żądania zawierającego parametr zwijania.

Sprawdzanie, czy wczytana reklama można zwinąć

Wywołaj funkcję isCollapsible, aby sprawdzić, czy ostatnio wczytany baner można zwijać. Jeśli żądania nie uda się wczytać, a poprzedni baner można zwinąć, interfejs API zwraca wartość „prawda”.

Java

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.")
}

Mediacja

Zwijane banery reklamowe są dostępne tylko w przypadku źródeł ofert reklamowych Google w okresie testów beta. Reklamy wyświetlane za pomocą zapośredniczenia AdMob wyświetlają się jako zwykłe, niezwijane banery reklamowe.

Sposób wyświetlania reklam

Aby zmaksymalizować skuteczność banerów reklamowych, reklamy, które nie obsługują większych rozmiarów zwijanych nakładek, mogą zwracać niektóre żądania zwijanego banera i wyrenderować się od razu w standardowym rozmiarze banera.