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 özelliklerinin nasıl kullanılacağı gösterilmektedir.

Ön koşullar

Öğ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 bir en-boy oranı ve resim öğelerinin nasıl indirileceğini ve görüntüleneceğ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.

GADNativeAdMediaAdLoaderOptions mediaAspectRatio değerini GADMediaAspectRatio ile ayarlayı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ını belirterek kullanıcı deneyimini iyileştirebilirsiniz.

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

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];

nativeAdUnitID yerine reklam birimi kimliğinizi yazın.

Resim indirme kontrolü

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.

GADNativeAdImageAdLoaderOptions disableImageLoading değerini BOOL olarak ayarlayın.

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

  • Devre dışı bırakıldığında Google Mobile Ads 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'nın yalnızca URI'yi döndürmesi talimatı verilmektedir.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];

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östereceğini 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 bir dizi 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.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];

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.

GADNativeAdViewAdOptions preferredAdChoicesPosition değerini GADAdChoicesPosition olarak ayarlayı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.

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];

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

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 AdChoices konum kontrollerinden farklıdır.

Oluşturmadan önce GADNativeAd.adChoicesView özelliğini bir GADAdChoicesView ile ayarlayın. Reklam Seçenekleri içeriği GADAdChoicesView içinde oluşturulur.

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

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}

Video kontrolleri

Bu bölümde, video reklamlar için oynatma deneyiminin nasıl özelleştirileceği ayrıntılı olarak açıklanmaktadır. İlk sessize alma 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.

GADVideoOptions startMuted değerini BOOL olarak ayarlayın.

  • Başlangıçta sesi kapatma davranışı varsayılan olarak etkindir.

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

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

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

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];

Özel oynatma kontrolleri

Bu sayede, videoyu oynatmak, duraklatmak veya videonun sesini kapatmak için özel video giriş kontrolleri isteyebilirsiniz.

GADVideoOptions customControlsRequested değerini BOOL olarak 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 kontroller etkinleştirilmişse reklamda herhangi bir kontrol gösterilmeyeceğinden özel kontrollerinizi reklamla birlikte göstermeniz gerekir. Denetimler daha sonra ilgili yöntemleri

GADVideoController.

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

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];

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

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}

Ö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 dost 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, kontrolleri sığdıracak kadar küçük bir yer paylaşımı oluşturun.

Özel tıklama hareketleri

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

Seçtiğiniz kaydırma yönüyle bir GADNativeAdCustomClickGestureOptions örneği başlatın. Dokunmaların tıklama olarak sayılıp sayılmayacağını da belirtmeniz gerekir.

  • Özel tıklama hareketleri varsayılan olarak devre dışıdır.

  • Devre dışı bırakıldığında, yalnızca dokunmalar tıklama olarak sayılır.

  • Bu ayar etkinleştirildiğinde kaydırma hareketleri tıklama olarak sayılır ve dokunma hareketlerinin de tıklama olarak sayılıp sayılmayacağını belirleyebilirsiniz.

Aşağıdaki örnekte, sağa doğru özel bir kaydırma hareketi uygulamanın ve normal dokunma davranışını korumanın yolu gösterilmektedir.

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];

Kaydırma hareketi etkinliklerini dinleme

Kaydırma hareketiyle tıklama kaydedildiğinde Google Mobile Ads SDK, mevcut nativeAdDidRecordClick: temsilci yöntemine ek olarak GADNativeAdDelegate üzerinde nativeAdDidRecordSwipeGestureClick: temsilci yöntemini çağırır.

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}

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.