Doğal reklam seçenekleri

Yerel reklamlar, ek gelir elde etmenize olanak tanıyan birçok gelişmiş en iyi reklam deneyimini sunmamızı sağlıyor. Bu kılavuzda, doğal reklamların gelişmiş özelliklerinin nasıl kullanılacağı gösterilmektedir.

Ön koşullar

• Yerel reklam biçimini entegre edin.

Öğe kontrolleri

Tercih edilen medya en boy oranı kontrolleri

Medya En Boy Oranı Denetimleri, videonun en boy oranı için bir tercih belirtmenizi sağlar: reklam öğeleridir.

Önemli: Bu API'nin kullanılması, tüm reklam öğelerinin uygun olmasını garanti etmez belirtilen tercihe göre değişir.

NativeAdOptions.Builder.setMediaAspectRatio() numaralı telefonu arayın NativeAdOptions.MediaAspectRatio ile değer.

• Politika ayarlanmadan bırakılırsa döndürülen reklam herhangi bir medya en boy oranına sahip olabilir.

• Bu özellik ayarlandığında tercih edilen en boy oranı türünü seçin.

Aşağıdaki örnek, SDK'ya belirli bir en boy oranı var.

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

Resim indirme kontrolü

Resim indirme kontrolü, SDK'nın resim öğelerini mi yoksa yalnızca URI'leri mi döndüreceğine karar vermenize olanak tanır.

NativeAdOptions.Builder.setReturnUrlsForImageAssets() numaralı telefonu arayın boolean değerine sahip olacak şekilde ayarlayın.

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

• Devre dışı bırakıldığında, Google Mobile Ads SDK'sı hem resmi hem de URI'yı sizin için doldurur.

• Etkinleştirildiğinde SDK, URI'yi doldurur ve gerçek resimleri istediğiniz zaman indirmenize olanak tanır.

Aşağıdaki örnek, SDK'ya yalnızca URI döndürmesi talimatını verir.

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .forNativeAd(nativeAd -> {
                                List<Uri> imageUris = new ArrayList<>();
                                for (Image image : nativeAd.getImages()) {
                                  imageUris.add(image.getUri());
                                }
                              })
                              .build();

Görüntü yükü kontrolleri

Bazı reklamlarda tek bir resim yerine bir dizi resim bulunur. Bu özelliği kullanarak uygulamanızın tüm resimleri mi yoksa yalnızca bir resmi mi göstermeye hazır olduğunu belirtir.

NativeAdOptions.Builder.setRequestMultipleImages() numaralı telefonu arayın boolean değerine sahip olacak şekilde ayarlayın.

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

• Devre dışı bırakıldığında, uygulamanız SDK'ya yalnızca seri içeren öğelerin ilk resminde yer alır.

• Etkinleştirildiğinde, uygulamanız tüm resimleri görüntülemeye hazır olduğunu belirtir için birden fazla öğe listeleyebilirsiniz.

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

Reklam Seçenekleri yerleşimleri

Reklam Seçenekleri konum kontrolleri

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

NativeAdOptions.Builder.setAdChoicesPlacement() numaralı telefonu arayın NativeAdOption.AdChoicesPlacement ile değer.

• Politika ayarlanmadan bırakılırsa Reklam Seçenekleri simgesi konumu sağ üste ayarlanır.

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .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 sağlayabilir. Bu, yalnızca belirli bir konumu kullanan dört köşeden birinin belirlenmesine olanak tanır.

AdChoicesView değeriyle NativeAdView.setAdChoicesView() işlevini ç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.

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

Video kontrolleri

Sessiz modu başlatma davranışı

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

VideoOptions.Builder.setStartMuted() numaralı telefonu arayın boolean değerine sahip olacak şekilde ayarlayın.

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

• Devre dışı bırakıldığında, uygulamanız videonun ses'e dokunun.

• Etkinleştirildiğinde, uygulamanız videonun sesi kapalı olarak başlamasını ister.

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(adOptions).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, videosunu izleyin.

boolean değeriyle VideoOptions.Builder.setCustomControlsRequested() işlevini ç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 denetimler etkinse sonra reklamla birlikte özel kontrollerinizi de görüntüleyin, çünkü reklam sahip olduğu anlamına gelir. Kontroller daha sonra VideoController üzerinde ilgili yöntemleri çağırabilir.

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(adOptions).build();

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

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

Java

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

Kotlin

NativeAd.OnNativeAdLoadedListener { ad ->
  val mediaContent = ad.mediaContent
  if (mediaContent != null) {
    val videoController = mediaContent.videoController
    val canShowCustomControls = videoController.isCustomControlsEnabled
  }
}

Ö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, bir yerel reklam özelliğidir. Bu özellik, reklam görünümlerinde reklam tıklamaları olarak kaydedilmelidir. Kaydırma işlevini kullanan uygulamalarla çalışacak şekilde tasarlanmıştır. içerikte gezinme için hareketler. Bu kılavuzda, doğal reklamlarınızda özel tıklama hareketlerinin nasıl etkinleştirileceği gösterilmektedir.

Dokunma işlemlerine tıklama olarak izin verilip verilmeyeceğini belirtmek için NativeAdOptions.SwipeGestureDirection ve boolean ile birlikte NativeAdOptions.Builder.enableCustomClickGestureDirection() değerini ç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 uygulanır ve normal sekme davranışını korur.

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

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
AdLoader.Builder builder = new AdLoader
    .Builder(this, '/21775744923/example/native')
    .withNativeAdOptions(adOptions);

Uyarı: Hesabınızda özel tıklama hareketleri etkin değilse reklam istekleri "no-fill" değerini döndürür.

Kaydırma hareketi etkinliklerini dinle

Kaydırma hareketiyle tıklama kaydedildiğinde Google Mobile Ads SDK'sı şunu çağırır: Mevcut yönteme ek olarak AdListener üzerinde onAdSwipeGestureClicked() yöntemi onAdClicked() yöntemi.

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

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

Uyumlulaştırma

Özel tıklama hareketleri yalnızca Google Mobile Ads SDK'sının oluşturduğu doğal reklamlarda çalışır. Şu özellikte reklam kaynakları: üçüncü taraf SDK'ları özel tıklama yol tarifi ayarına yanıt vermeyin.