Doğal reklamlar

Doğal reklamlar, platformda yerleşik olan kullanıcı arayüzü bileşenleri aracılığıyla kullanıcılara sunulan reklam öğeleridir. Bu şemalar, resimli taslaklarınızda halihazırda kullandığınız sınıflar kullanılarak gösterilir ve uygulamanızın görsel tasarımına uyacak şekilde biçimlendirilebilir.

Yerel reklam yüklendiğinde uygulamanız reklam nesnesinin öğelerini içeren bir reklam nesnesi alır ve bu durumda bunları göstermekten Google Mobile Ads SDK'sı yerine uygulama sorumlu olur.

Genel olarak, doğal reklamları başarıyla uygulamanın iki aşaması vardır: SDK kullanarak reklam yükleme ve ardından reklam içeriğini uygulamanızda gösterme.

Bu sayfada, doğal reklamlar.

Ön koşullar

• Başlangıç kılavuzunu tamamlayın.

Her zaman test reklamlarıyla test etme

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

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

/6499/example/native

Özel olarak her istek için test reklamı döndürecek şekilde yapılandırılmıştır. Kodlama, test etme ve hata ayıklama sırasında bu özelliği kendi uygulamalarınızda kullanabilirsiniz. Sadece uygulamanızı yayınlamadan önce bunu kendi reklam birimi kimliğinizle değiştirdiğinizden emin olun.

Google Mobile Ads SDK'sının test reklamlarının işleyiş şekli hakkında daha fazla bilgi için Test reklamları konusuna bakın.

Reklamları yükle

Doğal reklamlar, GADAdLoader sınıfıyla yüklenir. Bu sınıf, yetki verilmiş kullanıcılara GADAdLoaderDelegate protokolüne göre mesaj gönderir.

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

Reklam yükleyiciyi başlatma

Bir reklamı yüklemeden önce reklam yükleyiciyi başlatmanız gerekir. Aşağıdaki kod, bir GADAdLoader öğesinin nasıl başlatılacağını gösterir:

Swift

adLoader = GADAdLoader(adUnitID: "/6499/example/native",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/6499/example/native"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

Reklam birimi kimliğine (test kimliğini kullanabilirsiniz), istekte bulunmak istediğiniz yerel biçimleri belirtmek için adTypes dizisinde iletilecek sabit değerlere ve options parametresinde ayarlamak istediğiniz tüm seçeneklere ihtiyacınız vardır. options parametresi için olası değerlerin listesini Yerel Reklam Seçeneklerini Ayarlama sayfasında bulabilirsiniz.

adTypes dizisi, aşağıdaki sabit değerlerden en az birini içermelidir:

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

Reklam yükleyici yetkisini uygulama

Yetki verilmiş reklam yükleyicisinin, reklam türünüze özel protokolleri uygulaması gerekir. Doğal reklamlarda GADNativeAdLoaderDelegate protokolü, yerel reklam yüklendiğinde yetki verilen kullanıcıya gönderilen bir mesajı içerir.

Swift

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

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

Swift

func adLoader(_ adLoader: GADAdLoader,
  Receive customNativeAd: GADCustomNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;

Reklam isteğinde bulun

İpucu: Reklam yükleme çağrılarını kullanarak reklam gösterilmeden önce önceden yüklenmiş reklamların önbelleğini oluşturabilirsiniz. Böylece, reklamlar gerektiğinde gecikme olmadan gösterilebilir. Reklamların süresi bir saat sonra sona erdiği için bu önbelleği temizlemeniz ve saat başı yeni reklamlarla yeniden yüklemeniz gerekir.

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

Swift

adLoader.load(GAMRequest())

Objective-C

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

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

Not: Ad Manager, GADMultipleAdsAdLoaderOptions ile birden fazla reklam yüklemeyi desteklemez ve kullanılırsa yalnızca tek bir reklam döndürür.

Yüklemenin ne zaman bittiğini belirleme

Bir uygulama loadRequest: çağrısından sonra, şunları yapmak için yapılan çağrıları kullanarak isteğin sonuçlarını alabilir:

• GADAdLoaderDelegate konumunda adLoader:didFailToReceiveAdWithError:
• GADNativeAdLoaderDelegate konumunda adLoader:didReceiveNativeAd:

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

Başarısız istekleri işleme

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

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

Uyarı: adLoader:didFailToReceiveAdWithError: yetki verme yönteminden yeni bir reklam yüklemeye çalışılması kesinlikle önerilmez. adLoader:didFailToReceiveAdWithError: sitesinden 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ükü yeniden deneme sayısını sınırlayın.

Doğal reklam etkinliklerinden haberdar olun

Doğal reklam etkileşimleriyle ilgili etkinlikler hakkında bildirim almak için yerel reklamın yetki verme özelliğini ayarlayın:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

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

Swift

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

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

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

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

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

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

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

En iyi uygulamalar

Reklamları yüklerken bu kurallara uyun.

• Listedeki yerel reklamlar kullanan uygulamalar, reklam listesini önbelleğe almalıdır.

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

• adLoaderDidFinishLoading: ile belirtildiği gibi, önceki isteğin yüklenmesi bitene kadar GADAdLoader üzerinden loadRequest: öğesini tekrar çağırmayın.

Reklamınızı gösterin

Bir reklamı yükledikten sonra geriye kalan tek şey onu kullanıcılarınıza göstermektir. Nasıl yapıldığını görmek için Yerel Gelişmiş kılavuzumuza gidin.