Kaydırılan banner'lar için satır içi uyarlanabilir banner kullanma

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

Uyarlanabilir banner'lar, her cihaz için optimum reklam boyutunu belirlemek üzere reklam genişliğini belirtmenize olanak tanır. Sabit uyarlanabilir banner'lardan farklı olarak satır içi uyarlanabilir banner'lar daha büyük ve daha uzundur ve sabit yükseklikler kullanmaz. Satır içi uyarlanabilir banner'lar değişken yüksekliğe sahiptir. Bu banner'lar ekranın tamamını veya belirttiğiniz maksimum yüksekliği kaplayabilir.

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ılan içerikteki satır içi uyarlanabilir banner'lar gösterilmektedir:

Uyarlanabilir ve satır içi uyarlanabilir banner'lardaki farkları gösteren şema

Başlamadan önce

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

Tam bir satır içi uyarlanabilir banner örneğini 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 ayarlarsınız, bir reklam isteği oluşturursunuz ve reklamı yüklersiniz.

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

  • Tam ekran genişliğini kullanma.
  • Reklamı içeren üst yerleşimin genişliğini kullanır.
  • Cihaz güvenli alanlarını hesaba katmak için genişliği ayarlama.

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

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

Kotlin

private fun loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()

  // Step 2 - Load the ad.
  BannerAd.load(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // Assign the loaded ad to the BannerAd object.
        bannerAd = ad
        // Step 3 - Call BannerAd.getView() to get the View and add it
        // to view hierarchy on the UI thread.
        activity?.runOnUiThread {
          binding.bannerViewContainer.addView(ad.getView(requireActivity()))
        }
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        bannerAd = null
      }
    }
  )
}

Java

private void loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
      adSize).build();

  // Step 2 - Load the ad.
  BannerAd.load(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // Assign the loaded ad to the BannerAd object.
          bannerAd = ad;
          // Step 3 - Call BannerAd.getView() to get the View and add it
          // to view hierarchy on the UI thread.
          if (getActivity() != null) {
            getActivity()
                .runOnUiThread(() ->
                    binding.bannerViewContainer.addView(ad.getView(getActivity())));
          }
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          bannerAd = null;
        }
      });
}

Uyarlanabilir banner'ları kullanmak için satır öğelerini güncellemeniz veya oluşturmanız gerekiyorsa Uyarlanabilir banner'lar için satır öğelerini ayarlama başlıklı makaleyi inceleyin.

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

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

Uygulamanız dikey ve yatay görünümleri destekliyorsa ve mevcut düzende uyarlanabilir bir banner reklamı önceden yüklemek istiyorsanız AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) yöntemini kullanın. Bu yöntem, mevcut düzene 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.