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.
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 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.
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 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.
NativeAdView.setAdChoicesView()
numaralı telefonu arayın
AdChoicesView
ile
değer.
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.
VideoOptions.Builder.setStartMuted()
numaralı telefonu arayın
boolean
değerine sahip olacak şekilde ayarlayın.
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.
VideoOptions.Builder.setCustomControlsRequested()
numaralı telefonu arayın
boolean
değerine sahip olacak şekilde ayarlayı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. 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, 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.