Daraltılabilir banner reklamlar

Platform seçin: Android iOS Unity Flutter Android (Eski)

Daraltılabilir banner reklamlar, başlangıçta daha büyük bir yer paylaşımı olarak sunulan ve orijinal olarak istenen banner boyutuna daraltma düğmesi içeren banner reklamlardır. Daraltılabilir banner reklamlar, normalde daha küçük boyutta olan sabit reklamların performansını artırmak için tasarlanmıştır. Bu kılavuzda, mevcut banner yerleşimleri için daraltılabilir banner reklamların nasıl etkinleştirileceği gösterilmektedir.

Ön koşullar

• Banner reklamlar başlangıç kılavuzunu tamamlayın.

Uygulama

Banner görünümünüzün, kullanıcıların normal (daraltılmış) banner durumunda görmesini istediğiniz boyutta tanımlandığından emin olun. Reklam isteğine, anahtar olarak collapsible ve değer olarak reklamın yerleşimini içeren bir ekstralar parametresi ekleyin.

Daraltılabilir yerleşim, genişletilmiş bölgenin banner reklama nasıl sabitleneceğini tanımlar.

Placement değer	Davranış	Kullanım amacı
top	Genişletilmiş reklamın üst kısmı, daraltılmış reklamın üst kısmıyla hizalanır.	Reklam, ekranın üst kısmına yerleştirilir.
bottom	Genişletilmiş reklamın alt kısmı, daraltılmış reklamın alt kısmıyla hizalanır.	Reklam, ekranın alt kısmına yerleştirilir.

Yüklenen reklam daraltılabilir bir banner ise banner, görünüm hiyerarşisine yerleştirildikten hemen sonra daraltılabilir yer paylaşımını gösterir:

Kotlin

private fun loadCollapsibleBannerAd(adView: AdView, activity: Activity) {
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)

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

  val adRequest =
    BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.i(
          TAG,
          "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
        )
      }


      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

Java

private void loadCollapsibleBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);

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

  BannerAdRequest adRequest =
      new BannerAdRequest.Builder(AD_UNIT_ID, adSize).setGoogleExtrasBundle(extras).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          Log.i(
              TAG,
              String.format(
                  "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
        }


        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

AD_UNIT_ID yerine reklam birimi kimliğinizi yazın.

Reklam yenileme davranışı

AdMob web arayüzünde banner reklamlar için otomatik yenilemeyi yapılandıran uygulamalarda, bir banner alanı için daraltılabilir banner reklam istendiğinde daha sonra reklam yenilenirken daraltılabilir banner reklamlar istenmez. Bunun nedeni, her yenilemede daraltılabilir banner göstermenin kullanıcı deneyimini olumsuz etkileyebilmesidir.

Oturumda daha sonra başka bir daraltılabilir banner reklam yüklemek isterseniz daraltılabilir parametresini içeren bir istekle manuel olarak reklam yükleyebilirsiniz.

Yüklenen bir reklamın daraltılabilir olup olmadığını kontrol etme

Daraltılamayan banner reklamlar, performansı artırmak için daraltılabilir banner istekleri için döndürülmeye uygundur. İstek yüklenemezse ve önceki banner daraltılabilirse API, true değerini döndürür. Yüklenen son banner'ın daraltılabilir olup olmadığını kontrol etmek için isCollapsible yöntemini çağırın:

Kotlin

override fun onAdLoaded(ad: BannerAd) {
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
  )
}
BannerSnippets.kt

Java

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  Log.i(
      TAG,
      String.format(
          "The last loaded banner is %scollapsible.", ad.isCollapsible() ? "" : "not "));
}
BannerSnippets.java

Uyumlulaştırma

Daraltılabilir banner reklamlar yalnızca Google talebi için kullanılabilir. Uyumlulaştırma aracılığıyla yayınlanan reklamlar, normal ve daraltılamayan banner reklamlar olarak gösterilir.