Satır içi uyarlanabilir banner reklamlar

Uyarlanabilir banner'lar, her cihaz için en uygun reklam boyutunu belirlemek üzere bir reklamın genişliğini belirtmenize olanak tanır. Sabit uyarlanabilir banner'ların aksine satır içi uyarlanabilir banner'lar daha büyük ve daha uzundur, ayrıca sabit yükseklikler kullanmaz. Satır içi uyarlanabilir banner'ların yüksekliği değişkendir. Bu banner'lar ekranın tamamını veya belirttiğiniz maksimum yüksekliği doldurabilir.

Bu kılavuzda, satır içi uyarlanabilir banner'lar oluşturma ve banner boyutunu ayarlama konuları ele alınmaktadır.

Aşağıdaki resimde, kaydırılabilir içerikteki satır içi uyarlanabilir banner'lar gösterilmektedir:

Uyarlanabilir ve satır içi uyarlanabilir banner'lar arasındaki farkları gösteren diyagram

Başlamadan önce

Devam etmeden önce banner reklamları ayarladığınızdan emin olun.

Satır içi uyarlanabilir banner örneğinin tamamını görüntülemek için aşağıdaki örnek uygulamayı indirin:

Satır içi uyarlanabilir banner'ları uygulama

Satır içi uyarlanabilir banner'ları uygulamak için reklam boyutunu ayarlar, bir reklam isteği oluşturur ve reklamı yüklersiniz.

Satır içi uyarlanabilir banner'ı boyutlandırmak için reklam genişliğini belirleyin. Yaygın yaklaşımlar arasında şunlar yer alır:

  • Tam ekran genişliğini kullanma
  • Reklamı içeren üst yerleşimin genişliğini kullanma.
  • Genişlik, cihazın güvenli alanlarına göre ayarlanıyor.

Reklam boyutu nesnesini oluştururken bu hesaplanan genişliği kullanın.

Aşağıdaki örnekte reklam boyutu ayarlanır, bir reklam isteği oluşturulur ve reklam yüklenir:

Kotlin

private fun loadInlineAdaptiveBannerAd(adView: AdView, activity: Activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val bannerWidth = 320
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Inline adaptive banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Inline adaptive banner ad failed to load: $adError")
      }
    },
  )
}

Java

private void loadInlineAdaptiveBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  int bannerWidth = 320;
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Inline adaptive banner ad loaded.");
        }

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

AD_UNIT_ID yerine reklam birimi kimliğinizi yazın.

Cihaz ekranı boyutundan küçük veya ona eşit bir reklam boyutu ayarlayın. Maksimum ekran boyutunu belirlemek için Resources.getDisplayMetrics yöntemini kullanın. AdSize nesne boyutları, yoğunluktan bağımsız pikseller (dp) kullanır. Karşılaştırma yaparken ekran boyutunu pikselden dp'ye dönüştürün. Boyut kısıtlamaları hakkında ayrıntılı bilgi için Reklam isteği boyutu koşulları başlıklı makaleyi inceleyin.

Satır içi uyarlanabilir banner düzenini ayarlama

Belirli bir düzen için satır içi uyarlanabilir banner reklamı önceden yüklemek istiyorsanız aşağıdaki yöntemleri kullanın:

Uygulamanız dikey ve yatay görünümleri destekliyorsa ve mevcut düzende uyarlanabilir banner reklamı önceden yüklemek istiyorsanız AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) yöntemini kullanın. Bu yöntem, mevcut düzende bir reklam yükler.

Satır içi uyarlanabilir banner yüksekliğini sınırlama

Varsayılan olarak, maxHeight değeri olmadan oluşturulan satır içi uyarlanabilir banner'ların maksimum yüksekliği, cihaz yüksekliğine eşittir. Satır içi uyarlanabilir banner yüksekliğini sınırlamak için AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) yöntemini kullanın.