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, ve yerel reklamların gelişmiş özelliklerini kullanmayı öğreneceksiniz.

Ö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.

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, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

Resim indirme kontrolü

Resim indirme kontrolü, resim öğelerinin mi yoksa yalnızca URI'lerin mi döndüren bir tanımlayıcıdır.

• 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 yalnızca URI'yı doldurarak verileri indirmenize olanak tanır. resimlere yer verebilirsiniz.

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, 'ca-app-pub-3940256099942544/2247696110')
                              .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.

• 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 için talimat verilmektedir.

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

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

Reklam Seçenekleri yerleşimleri

Reklam Seçenekleri konum kontrolleri

Reklam Seçenekleri konum denetimleri, reklam öğesinin hangi köşenin Reklam Seçenekleri simgesi.

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, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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.

Aşağıdaki örnekte, AdChoicesView içinde oluşturulan Reklam Seçenekleri simgesi.

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

Video kontrolleri

Yoksayma davranışını başlat

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

• Sesi kapalı 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, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

Özel oynatma kontrolleri

Bu, videosunu izleyin.

• Ö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. Ardından kontroller VideoController.

Aşağıdaki örnekte, özel oynatma kontrolleriyle nasıl video isteğinde bulunulacağı gösterilmektedir.

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

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

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .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.

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

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

Özel tıklama hareketleri

Ö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, özel tıklamanın nasıl etkinleştirileceği gösterilmektedir yerel reklamlarınızda parmak hareketlerini kullanabilirsiniz.

NativeAdOptions.Builder.enableCustomClickGestureDirection() numaralı telefonu arayın NativeAdOptions.SwipeGestureDirection ile ve dokunmalara tıklama olarak izin vermek isteyip istemediğinizi belirten bir boolean.

• Ö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, 'ca-app-pub-3940256099942544/2247696110')
    .withNativeAdOptions(adOptions);

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 Mobil Reklam SDK'sı oluşturulur. Şu özellikte reklam kaynakları: üçüncü taraf SDK'ları özel tıklama yol tarifi ayarına yanıt vermeyin.