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ı Kontrolleri, reklam öğelerinin en boy oranı için tercih belirtmenize olanak tanır.
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ü, 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 denetimi 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 örnekte, SDK'ya yalnızca URI'yi döndürmesi talimatı verilmektedir.
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. Uygulamanızın tüm resimleri mi yoksa yalnızca birini mi göstermeye hazır olduğunu belirtmek için bu özelliği kullanın.
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.
Bu özellik etkinleştirildiğinde uygulamanız, birden fazla öğesi olan tüm öğelerin tüm resimlerini göstermeye hazır olduğunu belirtir.
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.
AdChoicesView değeriyle NativeAdView.setAdChoicesView() işlevini çağırın.
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.
boolean değeriyle VideoOptions.Builder.setStartMuted() işlevini çağırı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 sesinin açık olarak 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.
boolean değeriyle VideoOptions.Builder.setCustomControlsRequested() işlevini çağırın.
Özel oynatma kontrolü varsayılan olarak devre dışıdır.
Bu seçenek 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.
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
Özel tıklama hareketleri, reklam görüntülemelerinde kaydırma işlemlerinin reklam tıklaması olarak kaydedilmesini sağlayan bir yerel reklam özelliğidir. 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 hareketler.
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.
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 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. Oluşturma için üçüncü taraf SDK'ları gerektiren reklam kaynakları, özel tıklama yönleri ayarına yanıt vermez.