Google Mobile Ads SDK'sı bakım modundadır. En son güncellemeler ve özellikler için migrate ve ayarlayın.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Gelişmiş özellikleri ayarlama

Platform seçin: Android iOS Android (Eski)

Doğal reklamlar, ek özelleştirmeler yapmanıza ve mümkün olan en iyi reklam deneyimini sunmanıza olanak tanıyan birçok ileri seviye özelliğe sahiptir. Bu kılavuzda, doğal reklamların ileri seviye özelliklerinin nasıl kullanılacağı gösterilmektedir.

Ön koşullar

Doğal reklam biçimini entegre edin.

Öğe kontrolleri

Bu bölümde, doğal reklamlarınızdaki reklam öğesi varlıklarını nasıl özelleştireceğiniz açıklanmaktadır. Medya öğeleri için tercih edilen bir en-boy oranı ve resim öğelerinin nasıl indirileceğini ve görüntüleneceğini belirtebilirsiniz.

Tercih edilen medya en-boy oranı kontrolleri

Medya en-boy oranı kontrolleri, reklam öğelerinin en-boy oranı için bir tercih belirtmenize olanak tanır.

NativeAdOptions.Builder.setMediaAspectRatio() değerini NativeAdOptions.MediaAspectRatio ile çağırın.

Ayar yapılmadığında döndürülen reklamın herhangi bir medya en-boy oranı olabilir.
Bu ayar yapıldığında, tercih edilen en-boy oranını belirterek kullanıcı deneyimini iyileştirebilirsiniz.

Aşağıdaki örnekte, SDK'nın belirli bir en-boy oranına sahip bir resim veya video döndürmeyi tercih etmesi talimatı verilmektedir.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

AD_UNIT_ID yerine reklam birimi kimliğinizi yazın.

Resim indirme kontrolü

Resim indirme kontrolü, SDK tarafından resim öğelerinin mi yoksa yalnızca URI'lerin mi döndürüleceğine karar vermenizi sağlar.

NativeAdOptions.Builder.setReturnUrlsForImageAssets() işlevini boolean değeriyle çağırın.

Resim indirme kontrolü varsayılan olarak devre dışıdır.
Devre dışı bırakıldığında Google Mobile Ads SDK (Legacy) hem resmi hem de URI'yi sizin için doldurur.
Etkinleştirildiğinde SDK yalnızca URI'yi doldurur. Böylece, gerçek görüntüleri istediğiniz zaman indirebilirsiniz.

Aşağıdaki örnekte, SDK'nın yalnızca URI'yi döndürmesi talimatı verilmektedir.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID")
        .withNativeAdOptions(nativeAdOptions)
        .forNativeAd(
            nativeAd -> {
              List<Uri> imageUris = new ArrayList<>();
              for (Image image : nativeAd.getImages()) {
                imageUris.add(image.getUri());
              }
            })
        .build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build()

val loader =
  AdLoader.Builder(context, "AD_UNIT_ID")
    .withNativeAdOptions(nativeAdOptions)
    .forNativeAd { nativeAd ->
      val imageUris = nativeAd.images.mapNotNull { it.uri }
    }
    .build()NativeAdOptionsSnippets.kt

Görsel yükü denetimi

Bazı reklamlarda tek bir resim yerine bir dizi resim bulunur. Uygulamanızın tüm resimleri mi yoksa yalnızca bir resmi mi göstereceğini belirtmek için bu özelliği kullanın.

NativeAdOptions.Builder.setRequestMultipleImages() işlevini boolean değeriyle çağırın.

Görsel yükü denetimleri varsayılan olarak devre dışıdır.
Devre dışı bırakıldığında uygulamanız, SDK'ya bir dizi içeren tüm öğeler için yalnızca ilk resmi sağlaması talimatını verir.
Etkinleştirildiğinde uygulamanız, birden fazla öğe içeren tüm öğelerin resimlerini göstermeye hazır olduğunu belirtir.

Aşağıdaki örnekte, SDK'nın birden fazla resim öğesi döndürmesi talimatı verilmektedir.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setRequestMultipleImages(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setRequestMultipleImages(true).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Reklam Seçenekleri yerleşimleri

Bu bölümde, AdChoices yer paylaşımının nasıl konumlandırılacağı açıklanmaktadır. Yerleşimini dört köşeden birine ayarlayabilir veya özel bir görünümde oluşturabilirsiniz.

Reklam Seçenekleri konum kontrolleri

AdChoices konumu kontrolleri, Reklam Seçenekleri simgesinin hangi köşede oluşturulacağını seçmenize olanak tanır.

NativeAdOptions.Builder.setAdChoicesPlacement() değerini NativeAdOption.AdChoicesPlacement ile çağırın.

Ayarlanmamışsa Reklam Seçenekleri simgesinin konumu sağ üst olarak belirlenir.
Ayarlanırsa AdChoices, istenen özel konuma yerleştirilir.

Aşağıdaki örnekte, özel bir AdChoices resim konumunun nasıl ayarlanacağı gösterilmektedir.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Reklam Seçenekleri özel görünümü

Reklam Seçenekleri özel görünüm özelliği, Reklam Seçenekleri simgesini özel bir konuma yerleştirmenize olanak tanır. Bu, yalnızca dört köşeden birinin belirtilmesine izin veren Reklam Seçenekleri konum kontrollerinden farklıdır.

NativeAdView.setAdChoicesView() değerini AdChoicesView ile çağırın.

Aşağıdaki örnekte, AdChoicesView içinde oluşturulan Reklam Seçenekleri simgesiyle özel bir Reklam Seçenekleri görünümünün nasıl ayarlanacağı gösterilmektedir.

Java

NativeAdView nativeAdView = new NativeAdView(context);
AdChoicesView adChoicesView = new AdChoicesView(context);
nativeAdView.setAdChoicesView(adChoicesView);NativeAdOptionsSnippets.java

Kotlin

val nativeAdView = NativeAdView(context)
val adChoicesView = AdChoicesView(context)
nativeAdView.adChoicesView = adChoicesViewNativeAdOptionsSnippets.kt

Video kontrolleri

Bu bölümde, video reklamlar için oynatma deneyiminin nasıl özelleştirileceği ayrıntılı olarak açıklanmaktadır. İlk sessize alma durumunu ayarlayabilir ve özel oynatma kontrolleri uygulayabilirsiniz.

Sesi kapalı başlatma davranışı

Başlangıçta sessiz başlatma özelliği, videonun başlangıçtaki sesini devre dışı bırakmanıza veya etkinleştirmenize olanak tanır.

VideoOptions.Builder.setStartMuted() işlevini boolean değeriyle çağırın.

Başlangıçta sesi kapatma davranışı varsayılan olarak etkindir.
Devre dışı bırakıldığında uygulamanız, videonun sesle başlamasını ister.
Etkinleştirildiğinde uygulamanız, videonun sesi kapalı olarak başlatılmasını ister.

Aşağıdaki örnekte, videonun sesi açık olarak nasıl başlatılacağı gösterilmektedir.

Java

VideoOptions videoOptions = new VideoOptions.Builder().setStartMuted(false).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setStartMuted(false).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Özel oynatma kontrolleri

Bu sayede, videoyu oynatmak, duraklatmak veya sessize almak için özel video girişi kontrolleri isteyebilirsiniz.

VideoOptions.Builder.setCustomControlsRequested() işlevini boolean değeriyle çağırın.

Özel oynatma kontrolü varsayılan olarak devre dışıdır.
Devre dışı bırakıldığında videonuzda SDK tarafından oluşturulan giriş kontrolleri gösterilir.

Reklamda video içeriği varsa ve özel kontroller etkinleştirilmişse reklamın kendisinde herhangi bir kontrol gösterilmeyeceğinden özel kontrollerinizi reklamla birlikte göstermeniz gerekir. Denetimler daha sonra ilgili yöntemleri

VideoController.

Aşağıdaki örnekte, özel oynatma kontrolleri içeren bir videonun nasıl isteneceği gösterilmektedir.

Java

VideoOptions videoOptions = new VideoOptions.Builder().setCustomControlsRequested(true).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val videoOptions = VideoOptions.Builder().setCustomControlsRequested(true).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Özel kontrollerin etkin olup olmadığını kontrol etme

Döndürülen reklamın, istek sırasında özel video kontrollerine izin verip vermeyeceği bilinmediğinden özel kontrollerin etkin olup olmadığını kontrol etmeniz gerekir.

Java

MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
  VideoController videoController = mediaContent.getVideoController();
  boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}NativeAdOptionsSnippets.java

Kotlin

val mediaContent = nativeAd.mediaContent
if (mediaContent != null) {
  val videoController = mediaContent.videoController
  val canShowCustomControls = videoController.isCustomControlsEnabled
}NativeAdOptionsSnippets.kt

Özel video kontrolleri oluşturma

Aşağıdaki en iyi uygulamaları kullanarak özel video kontrolleri oluşturun:

Özel kontroller görünümünü, doğal reklam görünümünün alt öğesi olarak oluşturun. Bu yaklaşım, açık ölçüm görüntülenebilirlik hesaplamalarının özel kontrolleri dost engel olarak değerlendirmesine olanak tanır.
Görünmez bir yer paylaşımını medya merkezinin tamamında oluşturmaktan kaçının. Yer paylaşımları, medya merkezindeki tıklamaları engeller ve doğal reklamların performansını olumsuz etkiler. Bunun yerine, kontrolleri sığdıracak kadar büyük küçük bir yer paylaşımı oluşturun.

Özel tıklama hareketleri

Özel tıklama hareketleri, reklam görüntülemelerindeki kaydırmaları reklam tıklaması olarak kaydetmenize olanak tanıyan bir doğal reklam özelliğidir. İçeriklerde gezinmek için kaydırma hareketlerini kullanan uygulamalarda çalışır. Bu kılavuzda, doğal reklamlarınızda özel tıklama hareketlerini nasıl etkinleştireceğiniz gösterilmektedir.

Dokunmaların tıklama olarak kabul edilip edilmeyeceğini belirtmek için NativeAdOptions.Builder.enableCustomClickGestureDirection() işlevini NativeAdOptions.SwipeGestureDirection ve boolean ile birlikte çağırın.

Özel tıklama hareketleri varsayılan olarak devre dışıdır.
Devre dışı bırakıldığında uygulamanız normal tıklama davranışını destekler.
Etkinleştirildiğinde uygulamanız özel kaydırma hareketlerini destekler.

Aşağıdaki örnekte, sağa doğru özel bir kaydırma hareketi uygulanmakta ve normal dokunma davranışı korunmaktadır.

Java

NativeAdOptions adOptions =
    new NativeAdOptions.Builder()
        .enableCustomClickGestureDirection(
            NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, /* tapsAllowed= */ true)
        .build();

// ca-app-pub-3940256099942544/2247696110 is a sample ad unit ID that has custom click
// gestures enabled.
AdLoader.Builder builder =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions);NativeAdOptionsSnippets.java

Kotlin

val adOptions =
  NativeAdOptions.Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, true)
    .build()

val builder = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions)NativeAdOptionsSnippets.kt

Kaydırma hareketi etkinliklerini dinleme

Bir kaydırma hareketi tıklaması kaydedildiğinde Google Mobile Ads SDK (Legacy), mevcut onAdClicked() yöntemine ek olarak AdListener üzerinde onAdSwipeGestureClicked() yöntemini çağırır.

Java

AdLoader adLoader =
    new AdLoader.Builder(context, AD_UNIT_ID)
        .withAdListener(
            new AdListener() {
              // Called when a swipe gesture click is recorded.
              @Override
              public void onAdSwipeGestureClicked() {
                // Called when a swipe gesture click is recorded.
                Log.d(TAG, "A swipe gesture click has occurred.");
              }

              @Override
              public void onAdClicked() {
                // Called when a swipe gesture click or a tap click is recorded, as
                // configured in NativeAdOptions.
                Log.d(TAG, "A swipe gesture click or a tap click has occurred.");
              }
            })
        .build();NativeAdOptionsSnippets.java

Kotlin

val adLoader =
  AdLoader.Builder(context, AD_UNIT_ID)
    .withAdListener(
      object : AdListener() {
        override fun onAdSwipeGestureClicked() {
          // Called when a swipe gesture click is recorded.
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        override fun onAdClicked() {
          // Called when a swipe gesture click or a tap click is recorded, as
          // configured in NativeAdOptions.
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      }
    )
    .build()NativeAdOptionsSnippets.kt

Uyumlulaştırma

Özel tıklama hareketleri yalnızca Google Mobile Ads SDK'sının oluşturduğu doğal reklamlarda çalışır. Oluşturma için üçüncü taraf SDK'ları gerektiren reklam kaynakları, özel tıklama yönlendirmeleri ayarına yanıt vermez.

Gelişmiş özellikleri ayarlama Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Ön koşullar

Öğe kontrolleri

Tercih edilen medya en-boy oranı kontrolleri

Java

Kotlin

Resim indirme kontrolü

Java

Kotlin

Görsel yükü denetimi

Java

Kotlin

Reklam Seçenekleri yerleşimleri

Reklam Seçenekleri konum kontrolleri

Java

Kotlin

Reklam Seçenekleri özel görünümü

Java

Kotlin

Video kontrolleri

Sesi kapalı başlatma davranışı

Java

Kotlin

Özel oynatma kontrolleri

Java

Kotlin

Özel kontrollerin etkin olup olmadığını kontrol etme

Java

Kotlin

Özel video kontrolleri oluşturma

Özel tıklama hareketleri

Java

Kotlin

Kaydırma hareketi etkinliklerini dinleme

Java

Kotlin

Uyumlulaştırma

Gelişmiş özellikleri ayarlama