Doğal reklamlar

Doğal reklamlar, kullanıcılara sunulan kullanıcı arayüzü bileşenleri üzerinden platformda yerleşik olarak bulunuyor. Hâlihazırda kullandığınız sınıflar kullanılarak gösterilirler kullanabilir ve uygulamanızın görsel tasarımına uyacak şekilde biçimlendirilebilir.

Yerel reklam yüklendiğinde uygulamanız reklam öğesini içeren bir reklam nesnesi alır. Google Mobile Ads SDK'sı yerine uygulama göstermekten sorumludur.

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

Bu sayfada, Google Etiket Yöneticisi'ni kullanarak yerel reklamlar.

Ön koşullar

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

Her zaman test reklamlarıyla test etme

Uygulamalarınızı oluştururken ve test ederken, uygulamalarınızın yanı sıra üretim reklamlarıdır.

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

/21775744923/example/native

Her istek için test reklamları döndürecek şekilde özel olarak yapılandırılmıştır. Kodlama, test etme ve hata ayıklama sırasında kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce bu kimliği 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ı.

Reklamları yükle

Yerel reklamlar GADAdLoader yetki verilmiş kullanıcılarına ileti gönderen bir e-posta alırsınız. GADAdLoaderDelegate protokolü.

Sistem tanımlı yerel biçimin yanı sıra kendi Kendi özel yerel reklam biçimleri doğrudan satılan doğal reklamlar için kullanılabilen bir reklam etiketidir. Özel doğal reklam biçimleri, uygulamanıza rastgele yapılandırılmış veriler iletin. Bu reklamlar, GADCustomNativeAd sınıf.

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: "/21775744923/example/native",
    // The UIViewController parameter is optional.
    rootViewController: rootViewController,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/21775744923/example/native"
    // The UIViewController parameter is nullable.
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

Bir reklam birimi kimliği (test kimliğini kullanabilirsiniz), İstediğiniz yerel biçimleri belirtmek için adTypes dizisi ve options parametresinde ayarlamak istediğiniz seçeneklerdir. Olasılık listesi options parametresinin değerleri, Yerel Reklam Ayarlama Seçenekler sayfası.

adTypes dizisi, aşağıdaki sabit değerlerden birini veya daha fazlasını içermelidir :

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

Reklam yükleyici yetkisini uygulama

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

Swift

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

Objective-C

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

GADCustomNativeAdLoaderDelegate protokolü, özel şablon reklam yüklendiğinde yetki verin.

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ısından önce, önceden yüklenmiş reklamların önbelleğini oluşturmak için gerektiğinde reklamların sıfır gecikmeyle gösterilebilmesi için bunları göstermektir. Reklamların süresi bir saat sonra dolduğu için bu önbelleği temizlemeli ve yeni reklam görebilirsiniz.

GADAdLoader cihazınız başlatıldıktan sonra aşağıdaki işlemleri yapmak için loadRequest: yöntemini çağırın: bir reklam isteyin:

Swift

adLoader.load(GAMRequest())

Objective-C

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

İlgili içeriği oluşturmak için kullanılan loadRequest: yöntemindeki GADAdLoader aynısını kabul eder GAMRequest banner ve geçiş reklamı olarak kullanın. Dosya eklemek için istek nesnelerini kullanabilirsiniz. hedefleme bilgilerini kullanabilirsiniz. diğer reklam türlerinde olduğu gibidir.

Not: Ad Manager, GADMultipleAdsAdLoaderOptions ve kullanılırsa yalnızca tek bir reklam döndürür.

Yüklemenin ne zaman bittiğini belirleme

Bir uygulama loadRequest: çağırdıktan sonra isteğin sonuçlarını şunu kullanarak alabilir: loadRequest: şunu arar:

• GADAdLoaderDelegate alt bölgesinde adLoader:didFailToReceiveAdWithError:
• adLoader:didReceiveNativeAd: GADNativeAdLoaderDelegate içinde

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 GADAdLoaderDelegate protokolünü genişletir. Bu protokol mesajı gönderilir.

Swift

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

Objective-C

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

Uyarı: adLoader:didFailToReceiveAdWithError: delege yöntemi kesinlikle önerilmez. adLoader:didFailToReceiveAdWithError: alanından bir reklam yüklemeniz gerekiyorsa reklamı sınırlandırın Şu durumlarda sürekli başarısız reklam isteklerini önlemek için yükleme yeniden denemeleri: sınırlı ağ bağlantısı.

Doğal reklam etkinliklerinden haberdar olun

Doğal reklam etkileşimleriyle ilgili etkinlikler hakkında bildirim almak için yetki verilmiş kullanıcıyı ayarlayın özelliği:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

Daha sonra GADNativeAdDelegate için aşağıdaki delege çağrılarını alabilirsiniz:

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.

• Önceki isteğe kadar GADAdLoader üzerinden loadRequest: adlı kişiyi bir daha aramayın Yüklemeyi bitirir (adLoaderDidFinishLoading: ile belirtildiği gibi).

Reklamınızı gösterin

Bir reklamı yükledikten sonra geriye kalan tek şey onu kullanıcılarınıza göstermektir. Yerel Gelişmiş rehberimizi inceleyin.