Gelişmiş yerel özellikleri ayarlama

Platform seçin: Android (beta) Android iOS

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

Ön koşullar

• Doğal reklam biçimini entegre edin.

Öğe kontrolleri

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

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.

Önemli: Bu API'nin kullanılması, tüm reklam öğelerinin belirtilen tercihi karşılayacağını garanti etmez.

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

• Ayarlanmadığı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 örnek, SDK'ya belirli bir en-boy oranına sahip bir döndürme resmi veya videosunu tercih etmesini bildirir.

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.

boolean değeriyle NativeAdOptions.Builder.setReturnUrlsForImageAssets()'ı arayın.

• Resim indirme denetimi varsayılan olarak devre dışıdır.

• Devre dışı bırakıldığında Google Mobile Ads SDK 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 örnek, SDK'ya yalnızca URI'yi döndürmesi talimatını verir.

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

Resim yükü kontrolleri

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

boolean değeriyle NativeAdOptions.Builder.setRequestMultipleImages()'ı arayın.

• Resim yükü kontrolleri varsayılan olarak devre dışıdır.

• Devre dışı bırakıldığında uygulamanız, SDK'ya bir dizi içeren öğ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 örnek, SDK'ya birden fazla resim öğesi döndürmesi talimatını veriyor.

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ğı ayrıntılı olarak 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

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

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

• Ayarlanmamışsa Reklam Seçenekleri simgesi sağ üst kısma yerleştirilir.

• 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ü

Uyarı: Bu özelliğe erişim sınırlıdır. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

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 AdChoices konum kontrollerinden farklıdır.

NativeAdView.setAdChoicesView() ile AdChoicesView değerini ç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 = adChoicesView
NativeAdOptionsSnippets.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.

Sessize alma davranışını başlatma

Sessiz başlatma davranışı, bir videonun başlangıç sesini devre dışı bırakmanıza veya etkinleştirmenize olanak tanır.

boolean değeriyle VideoOptions.Builder.setStartMuted()'ı arayın.

• Başlangıçta sessize alma 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

Uyarı: Bu özelliğe erişim sınırlıdır. Erişim isteğinde bulunmak için hesap yöneticinizle iletişime geçin.

Bu, videoyu oynatmak, duraklatmak veya sessize almak için özel video giriş kontrolleri istemenize olanak tanır.

boolean değeriyle VideoOptions.Builder.setCustomControlsRequested()'ı arayın.

• Özel oynatma kontrolleri 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 reklamda herhangi bir kontrol gösterilmeyeceğinden özel kontrollerinizi reklamla birlikte göstermeniz gerekir. Kontroller daha sonra

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 denetimlerine izin verip vermeyeceği bilinmediğinden özel denetimlerin 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 kontrollerini oluşturma

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

1. Özel kontroller görünümünü, yerel 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.
2. Tüm medya görünümünde görünmez bir yer paylaşımı oluşturmaktan kaçının. Yer paylaşımları, medya görünümündeki tıklamaları engeller ve doğal reklamların performansını olumsuz etkiler. Bunun yerine, kontrolleri sığdıracak kadar küçük bir yer paylaşımı oluşturun.

Not: Açık ölçüm görüntülenebilirlik standardının geliştirilmesine katkıda bulunan ölçüm ve doğrulama sağlayıcıları hakkında bilgi edinmek için Open Measurement Çalışma Grubu'na bakın.