Doğal reklam yükleme

Platform seçin: Android iOS Flutter Unity Android (Eski)

Doğal reklamlar, platforma özgü kullanıcı arayüzü bileşenleri aracılığıyla kullanıcılara sunulan reklam öğeleridir. Bu reklamlar, storyboard'larınızda kullandığınız sınıflar kullanılarak gösterilir ve uygulamanızın görsel tasarımına uyacak şekilde biçimlendirilebilir.

Doğal reklam yüklendiğinde uygulamanız, öğelerini içeren bir reklam nesnesi alır ve bu öğeleri göstermekten Google Mobile Ads SDK değil, uygulama sorumlu olur.

Genel olarak, doğal reklamları başarılı bir şekilde uygulamak için iki bölüm vardır: SDK kullanarak reklam yükleme ve ardından reklam içeriğini uygulamanızda gösterme.

Bu sayfada, doğal reklamları yüklemek için SDK'nın nasıl kullanılacağı gösterilmektedir.

Ön koşullar

Devam etmeden önce Google Mobile Ads SDK ayarlarını yapın.

Her zaman test reklamlarıyla test edin

Uygulamalarınızı oluşturup test ederken canlı ve üretim reklamları yerine test reklamlarını kullandığınızdan emin olun.

Test reklamlarını yüklemenin en kolay yolu, iOS'teki doğal reklamlar için özel test reklam birimi kimliğimizi kullanmaktır:

/21775744923/example/native

Bu kimlik, her istek için test reklamları döndürecek şekilde özel olarak yapılandırılmıştır. Kodlama, test ve hata ayıklama sırasında bu kimliği kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce bu kimliği kendi reklam birimi kimliğinizle değiştirmeyi unutmayın.

Google Mobile Ads SDK test reklamları hakkında ayrıntılı bilgi için Test reklamlarını etkinleştirme başlıklı makaleyi inceleyin.

Reklamları yükleme

Doğal reklamlar, GADAdLoader sınıfıyla yüklenir. Bu sınıf, GADAdLoaderDelegate protokolüne göre temsilcilerine mesaj gönderir.

Sistem tarafından tanımlanan doğal biçime ek olarak, doğrudan satılan doğal reklamlar için kullanılabilecek kendi özel doğal reklam biçimlerinizi de oluşturabilirsiniz. Özel doğal reklam biçimleri, uygulamanıza rastgele yapılandırılmış veriler iletmenize olanak tanır. Bu reklamlar GADCustomNativeAd sınıfıyla temsil edilir.

Reklam yükleyiciyi başlatma

Reklam yükleyebilmek için reklam yükleyiciyi başlatmanız gerekir. Aşağıdaki kodda GADAdLoader nasıl başlatılacağı gösterilmektedir:

Swift

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  // To receive native ads, the ad loader's delegate must
  // conform to the NativeAdLoaderDelegate protocol.
  adTypes: [.native],
  // Use nil for default options.
  options: nil)
// Set the delegate before making an ad request.
adLoader.delegate = self
NativeAdSnippets.swift

nativeAdUnitID yerine reklam birimi kimliğinizi yazın.

Objective-C

self.adLoader =
    [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                       // The UIViewController parameter is optional.
                       rootViewController:self
                                  // To receive native ads, the ad loader's delegate must
                                  // conform to the NativeAdLoaderDelegate protocol.
                                  adTypes:@[ GADAdLoaderAdTypeNative ]
                                  // Use nil for default options.
                                  options:nil];
// Set the delegate before making an ad request.
self.adLoader.delegate = self;
NativeAdSnippets.m

kNativeAdUnitID yerine reklam birimi kimliğinizi yazın.

Bir reklam birimi kimliğine (test kimliğini kullanabilirsiniz), hangi yerel biçimleri istediğinizi belirtmek için adTypes dizisine iletilecek sabitlere ve options parametresinde ayarlamak istediğiniz seçeneklere ihtiyacınız vardır. options parametresi için olası değerlerin listesini Doğal Reklam Seçeneklerini Ayarlama sayfasında bulabilirsiniz.

adTypes dizisi aşağıdaki sabitlerden birini veya daha fazlasını içermelidir :

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

Reklam yükleyici temsilcisini uygulama

Reklam yükleyici temsilcisinin, reklam türünüze özel protokolleri uygulaması gerekir. Doğal reklamlar için GADNativeAdLoaderDelegate protokolü, doğal reklam yüklendiğinde temsilciye gönderilen bir mesaj içerir.

Swift

func adLoader(_ adLoader: AdLoader, didReceive nativeAd: NativeAd) {
  // Set the delegate to receive notifications for interactions with the native ad.
  nativeAd.delegate = self

  // TODO: Display the native ad.
}
NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // Set the delegate to receive notifications for interactions with the native ad.
  nativeAd.delegate = self;

  // TODO: Display the native ad.
}
NativeAdSnippets.m

GADCustomNativeAdLoaderDelegate protokolü, özel şablon reklam yüklendiğinde yetki verilmiş kullanıcıya gönderilen bir ileti içerir.

Swift

func adLoader(_ adLoader: AdLoader, didReceive customNativeAd: CustomNativeAd) {
  // To be notified of events related to the custom native ad interactions, set the delegate
  // property of the native ad
  customNativeAd.delegate = self

  // TODO: Display the custom native ad.
}
NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  // To be notified of events related to the custom native ad interactions, set the delegate
  // property of the native ad
  customNativeAd.delegate = self;

  // TODO: Display the custom native ad.
}
NativeAdSnippets.m

Reklam isteğinde bulun

İpucu: Reklamları göstermeyi planlamadan önce önceden yüklenmiş reklamların önbelleğini oluşturmak için reklam yükleme çağrılarını kullanabilirsiniz. Böylece reklamlar gerektiğinde sıfır gecikmeyle gösterilebilir. Reklamların süresi bir saat sonra dolduğundan bu önbelleği temizlemeniz ve her saat yeni reklamlarla yeniden yüklemeniz gerekir.

GADAdLoader başlatıldıktan sonra reklam istemek için loadRequest: yöntemini çağırın:

Swift

adLoader.load(AdManagerRequest())
NativeAdSnippets.swift

Objective-C

[self.adLoader loadRequest:[GAMRequest request]];
NativeAdSnippets.m

GADAdLoader içindeki loadRequest: yöntemi, banner'lar ve geçiş reklamlarıyla aynı GAMRequest nesnelerini kabul eder. Diğer reklam türlerinde olduğu gibi, hedefleme bilgileri eklemek için istek nesnelerini kullanabilirsiniz.

Birden fazla reklam yükleme (isteğe bağlı)

Tek bir istekte birden fazla reklam yüklemek için GADAdLoader başlatılırken GADMultipleAdsAdLoaderOptions nesnesini ayarlayın.

Swift

let multipleAdOptions = MultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5
adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  adTypes: [.native],
  options: [multipleAdOptions])
NativeAdSnippets.swift

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdOptions = [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdOptions.numberOfAds = 5;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                                   // The UIViewController parameter is optional.
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ multipleAdOptions ]];
NativeAdSnippets.m

İstek başına reklam sayısı beş ile sınırlıdır ve SDK'nın istenen reklam sayısını döndüreceği garanti edilmez.

Döndürülen Google reklamlarının tümü birbirinden farklı olacaktır ancak ayrılmış envanterden veya üçüncü taraf alıcılardan gelen reklamların benzersiz olacağı garanti edilmez.

Uyumlulaştırma kullanıyorsanız GADMultipleAdsAdLoaderOptions sınıfını kullanmayın. Birden fazla doğal reklam isteği, uyumlulaştırma için yapılandırılmış reklam birimi kimliklerinde çalışmaz.

Yüklemenin ne zaman tamamlandığını belirleme

Bir uygulama loadRequest: işlevini çağırdıktan sonra aşağıdaki işlevleri çağırarak isteğin sonuçlarını alabilir:

• GADAdLoaderDelegate içinde adLoader:didFailToReceiveAdWithError:
• GADNativeAdLoaderDelegate içinde adLoader:didReceiveNativeAd:

Tek bir reklam isteği, bu yöntemlerden birine yapılan tek bir çağrıyla sonuçlanır.

Birden fazla reklam isteği, yukarıdaki yöntemlere en az bir geri çağırma ile sonuçlanır ancak istenen maksimum reklam sayısından fazla olmaz.

Ayrıca GADAdLoaderDelegate, adLoaderDidFinishLoading geri çağırma işlevini sunar. Bu temsilci yöntemi, bir reklam yükleyicinin reklam yüklemeyi tamamladığını ve istek için başka reklam veya hata bildirilmeyeceğini gösterir. Aşağıda, aynı anda birden fazla doğal reklam yüklerken bu yöntemin nasıl kullanılacağına dair bir örnek verilmiştir:

Swift

func adLoaderDidFinishLoading(_ adLoader: AdLoader) {
  // The adLoader has finished loading ads.
}
NativeAdSnippets.swift

Objective-C

- (void)adLoaderDidFinishLoading:(GADAdLoader *)adLoader {
  // The adLoader has finished loading ads.
}
NativeAdSnippets.m

Başarısız istekleri işleme

Protokoller, reklamlar yüklenemediğinde gönderilen bir mesajı tanımlayan GADAdLoaderDelegate protokolünü genişletir.

Swift

func adLoader(_ adLoader: AdLoader, didFailToReceiveAdWithError error: any Error) {
  // The adLoader failed to receive an ad.
}
NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didFailToReceiveAdWithError:(NSError *)error {
  // The adLoader failed to receive an ad.
}
NativeAdSnippets.m

Uyarı: adLoader:didFailToReceiveAdWithError: temsilci yönteminden yeni bir reklam yüklemeye çalışmanız kesinlikle önerilmez. adLoader:didFailToReceiveAdWithError: üzerinden reklam yüklemeniz gerekiyorsa sınırlı ağ bağlantısı gibi durumlarda sürekli başarısız reklam isteklerini önlemek için reklam yükleme yeniden denemelerini sınırlayın.

Doğal reklam etkinlikleri hakkında bildirim alma

Yerel reklam etkileşimleriyle ilgili etkinliklerden haberdar olmak için yerel reklamın temsilci özelliğini ayarlayın:

Swift

nativeAd.delegate = self
NativeAdSnippets.swift

Objective-C

nativeAd.delegate = self;
NativeAdSnippets.m

Ardından, aşağıdaki temsilci çağrılarını almak için GADNativeAdDelegate öğesini uygulayın:

Swift

func nativeAdDidRecordImpression(_ nativeAd: NativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: NativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: NativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: NativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: NativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}
NativeAdSnippets.swift

Objective-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}
NativeAdSnippets.m

En iyi uygulamalar

Reklam yüklerken aşağıdaki kurallara uyun.

• Bir listede doğal reklamlar kullanan uygulamalar, reklam listesini önceden önbelleğe almalıdır.

• Reklamları önceden önbelleğe alırken önbelleğinizi temizleyin ve bir saat sonra yeniden yükleyin.

• adLoaderDidFinishLoading: ile belirtildiği gibi, önceki istek yüklenene kadar GADAdLoader tarihinde loadRequest:'yı tekrar çağırmayın.

• Yerel reklam önbelleğe almayı yalnızca gerekli olanlarla sınırlayın. Örneğin, önbelleğe alma işlemi sırasında yalnızca ekranda hemen görünen reklamları önbelleğe alın. Doğal reklamlar bellekte çok yer kaplar ve doğal reklamların yok edilmeden önbelleğe alınması aşırı bellek kullanımına neden olur.

• Artık kullanılmayan doğal reklamları imha edin.

Reklamınızı gösterme

Bir reklamı yükledikten sonra yapmanız gereken tek şey, reklamı kullanıcılarınıza göstermektir. Daha fazla bilgi için Doğal gelişmiş reklamlar veya Tam ekran doğal reklamlar bölümüne bakın.