Gelişmiş yerel ö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 özelliklerini nasıl kullanacağınız gösterilmektedir.

Ö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 ayrıntılı olarak açıklanmaktadır. Medya öğeleri için tercih edilen en-boy oranını ve resim öğelerinin nasıl indirilip gösterileceğini belirtebilirsiniz.

Tercih edilen medya en-boy oranı kontrolleri

Medya En-Boy Oranı Kontrolleri, reklam öğelerinin en-boy oranı için tercih belirlemenize olanak tanır.

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

NativeAdRequest.Builder.setMediaAspectRatio() yöntemini NativeAd.NativeMediaAspectRatio değeriyle çağırın.

• Ayarlanmadığında, döndürülen reklam herhangi bir medya en boy oranına sahip olabilir.

• Bu ayar yapıldığında, tercih edilen en boy oranı türünü belirterek kullanıcı deneyimini iyileştirebilirsiniz.

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

Kotlin

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build();

Resim indirme denetimi

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

NativeAdRequest.Builder.disableImageDownloading() numaralı telefonu arayın.

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

• Devre dışı bırakıldığında GMA Next-Gen SDK hem resmi hem de URI'yi sizin için doldurur.

• Bu özellik etkinleştirildiğinde SDK, yalnızca URI'yi doldurur ve gerçek resimleri istediğiniz zaman indirmenize olanak tanır.

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

Kotlin

val adRequest = NativeAdRequest.Builder(
    "ca-app-pub-3940256099942544/2247696110",
    listOf(NativeAd.NativeAdType.NATIVE))
    .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .disableImageDownloading()
    .build()

val adCallback: NativeAdLoaderCallback =
  object : NativeAdLoaderCallback {
    override fun onNativeAdLoaded(nativeAd: NativeAd) {
      // Get the image uri.
      val imageUri = nativeAd.image?.uri
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .disableImageDownloading()
  .build();

NativeAdLoaderCallback adLoaderCallback =
  new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
      // Get the image uri.
      Uri imageUri = nativeAd.getImage().getUri();
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

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örüntülemeye hazır olduğunu belirtmek için bu özelliği kullanın.

• Görsel yükü denetimi varsayılan olarak devre dışıdır.

• Devre dışı bırakıldığında uygulamanız, SDK'ya seri içeren öğeler için yalnızca ilk resmi sağlaması talimatını verir.

• Bu özellik etkinleştirildiğinde uygulamanız, birden fazla resim içeren öğelerin tüm resimlerini göstermeye hazır olduğunu belirtir.

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

Reklam Seçenekleri yerleşimleri

Bu bölümde, Reklam Seçenekleri 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 konum kontrolleri, Reklam Seçenekleri simgesinin hangi köşede oluşturulacağını seçmenize olanak tanır.

NativeAdRequest.Builder.setAdChoicesPlacement() yöntemini NativeAdRequest.AdChoicesPlacement değeriyle çağırın.

• Ayarlanmazsa Reklam Seçenekleri simgesinin konumu sağ üst olarak ayarlanır.

• Ayarlanırsa Reklam Seçenekleri, istendiği gibi özel konuma yerleştirilir.

Aşağıdaki örnekte, özel bir Reklam Seçenekleri resim konumunun nasıl ayarlanacağı gösterilmektedir.

Kotlin

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build();

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 Reklam Seçenekleri konum kontrollerinden farklıdır.

NativeAdView.setAdChoicesView() yöntemini AdChoicesView değeriyle çağırın.

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

Kotlin

override fun onNativeAdLoaded(nativeAd: NativeAd) {
  val nativeAdView = NativeAdView(applicationContext)
  val adChoicesView = AdChoicesView(this)
  nativeAdView.adChoicesView = adChoicesView
}

Java

public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
  NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
  AdChoicesView adChoicesView = new AdChoicesView(this);
  nativeAdView.setAdChoicesView(adChoicesView);
}

Video kontrolleri

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

Sesi kapalı başlatma davranışı

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

boolean değeriyle VideoOptions.Builder.setStartMuted() yöntemini ve NativeAdOptions.Builder.setVideoOptions() yöntemini çağırın.

• Sessiz başlatma davranışı varsayılan olarak etkindir.

• Devre dışı bırakıldığında uygulamanız, videonun sesle başlamasını ister.

• Bu seçenek etkinleştirildiğinde uygulamanız, videonun sesinin kapalı olarak başlatılmasını ister.

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

Kotlin

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

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Ö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 sayede, videoyu oynatmak, duraklatmak veya videonun sesini kapatmak için özel video giriş kontrolleri isteyebilirsiniz.

Reklamların başlangıçtaki ses durumunu ayarlamak için VideoOptions.Builder.setCustomControlsRequested() yöntemini çağırı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. Ardından kontroller,

VideoOptions.Builder.setCustomControlsRequested().

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

Kotlin

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

val adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

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

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

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        val mediaContent = nativeAd.mediaContent;
        if (mediaContent != null) {
          val videoController = mediaContent.videoController;
          val canShowCustomControls = videoController?.isCustomControlsEnabled();
        }
      }
    };

Java

NativeAdLoaderCallback adCallback =
  new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
      MediaContent mediaContent = nativeAd.getMediaContent();
      if (mediaContent != null) {
        VideoController videoController = mediaContent.getVideoController();
        if (videoController != null) {
          boolean canShowCustomControls = videoController.isCustomControlsEnabled();
        }
      }
    }
  };

Özel video kontrolleri oluşturma

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

1. Ö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 dostane bir engel olarak değerlendirmesine olanak tanır.
2. Medya merkezinin tamamında görünmez bir yer paylaşımı oluşturmaktan kaçının. Yer paylaşımları, medya görüntülemesindeki tıklamaları engelleyerek doğal reklam performansını olumsuz etkiler. Bunun yerine, yalnızca kontrolleri sığdıracak kadar büyük olan küçük bir yer paylaşımı oluşturun.

Not: Açık ölçüm görüntülenebilirlik standardının geliştirilmesini taahhüt eden ölçüm ve doğrulama sağlayıcıları hakkında bilgi edinmek için Açık Ölçüm Çalışma Grubu'nu inceleyin.

Özel tıklama hareketleri

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.

Özel tıklama hareketleri, reklam görüntülemelerindeki kaydırmaları reklam tıklamaları olarak kaydetmenize olanak tanıyan bir doğal reklam özelliğidir. İçerikte 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.

NativeAdRequest.Builder.enableCustomClickGestureDirection() yöntemini NativeAd.SwipeGestureDirection ve boolean değeriyle ç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.

• Bu özellik 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.

Kotlin

val adRequest =
  NativeAdRequest.Builder(AD_UNIT_ID, listOf(NativeAdType.NATIVE))
    .enableCustomClickGestureDirection(
      SwipeGestureDirection.RIGHT,
      /* customClickGestureAllowTaps= */ true,
    )
    .build()

Java

NativeAdRequest adRequest =
    new NativeAdRequest.Builder(AD_UNIT_ID, List.of(NativeAdType.NATIVE))
        .enableCustomClickGestureDirection(
            SwipeGestureDirection.RIGHT, /* customClickGestureAllowTaps= */ true)
        .build();

Uyarı: Hesabınızda özel tıklama hareketleri etkinleştirilmemişse reklam istekleri doldurulmaz.

Kaydırma hareketi etkinliklerini dinleme

Kaydırma hareketi etkinliklerini dinlemek için NativeAd.setAdEventCallback() yöntemini NativeAdEventCallback ile çağırın ve onAdSwipeGestureClicked() yöntemini uygulayın.

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        val nativeAdCallback: NativeAdEventCallback = object : NativeAdEventCallback {
          override fun onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        }
      }
    }
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback)

Java

  NativeAdLoaderCallback adCallback =
    new NativeAdLoaderCallback() {
      @Override
      public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        NativeAdEventCallback nativeAdCallback = new NativeAdEventCallback() {
          @Override
          public void onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        };
      }
    };
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback);

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 talimatları ayarına yanıt vermez.