Yerel reklamlar, platformun yerel kullanıcı arayüzü bileşenleri üzerinden kullanıcılara sunulan reklam öğeleridir. Bu örnekler, 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 kendi öğelerini içeren bir reklam nesnesi alır ve bu öğeleri görüntülemekten Google Mobile Ads SDK'sı yerine uygulama sorumlu olur.
Genel olarak, yerel reklamları başarıyla uygulamanın iki bölümü vardır: SDK kullanarak bir reklam yüklemek ve ardından reklam içeriğini uygulamanızda görüntülemek.
Bu sayfada, yerel reklamları kullanın.
Ön koşullar
- Başlangıç kılavuzunu tamamlayın.
Her zaman test reklamlarıyla test etme
Uygulamalarınızı oluştururken ve test ederken canlı, üretim reklamları yerine test reklamlarını kullandığınızdan emin olun.
Test reklamlarını yüklemenin en kolay yolu, iOS'ta yerel reklamlara özel test reklam birimi kimliğimizi kullanmaktır:
/6499/example/native
Bu kod, 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 bu reklam öğesini kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce bu kimliği kendi reklam birimi kimliğinizle değiştirdiğinizden emin olmanız yeterlidir.
Google Mobile Ads SDK'sının test reklamlarının nasıl çalıştığı hakkında daha fazla bilgi için Test reklamları konusuna bakın.
Reklamları yükle
Yerel reklamlar GADAdLoader
sınıfıyla yüklenir. Bu sınıf, yetki verdikleri kullanıcılara GADAdLoaderDelegate
protokolüne uygun şekilde mesaj gönderir.
Sistem tanımlı yerel biçimin yanı sıra, doğrudan satılan yerel reklamlar için kullanılabilen 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 gösterilir.
Reklam yükleyiciyi başlatma
Reklam yükleyebilmek için ö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;
Bir reklam birimi kimliğine (test kimliğini kullanabilirsiniz), istemek istediğiniz yerel biçimleri belirtmek için adTypes
dizisinde iletilecek sabit değerlere ve options
parametresinde ayarlamak istediğiniz diğer seçeneklere ihtiyacınız olacaktır. options
parametresi için olası değerlerin listesini Yerel Reklam Seçeneklerini Ayarlama sayfasında bulabilirsiniz.
adTypes
dizisi, aşağıdaki sabitlerden biri veya daha fazlasını içermelidir
:
Reklam yükleyici yetkisini uygulama
Reklam yükleyici temsilcisinin reklam türünüze özel protokolleri uygulaması gerekir.
Yerel reklamlar için GADNativeAdLoaderDelegate
protokolü, yerel bir reklam yüklendiğinde yetki verene 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 kişiye 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
GADAdLoader
başlatıldıktan sonra reklam istemek için cihazın 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ı ile aynı GAMRequest
nesnelerini kabul eder. Diğer reklam türlerinde olduğu gibi hedefleme bilgileri eklemek için istek nesnelerini kullanabilirsiniz.
Yüklemenin ne zaman sona erdiğini belirleme
Bir uygulama loadRequest:
işlevini çağırdıktan sonra, aşağıdaki çağrıları kullanarak isteğin sonuçlarını alabilir:
GADAdLoaderDelegate
adlı kuruluş birimindeadLoader:didFailToReceiveAdWithError:
GADNativeAdLoaderDelegate
adlı kuruluş birimindeadLoader:didReceiveNativeAd:
Tek bir reklam için yapılan istek, 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 bir 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;
Yerel reklam etkinlikleri hakkında bildirim alın
Yerel reklam etkileşimleriyle ilgili etkinlikler hakkında bildirim almak için yerel reklamın temsilci ö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.
Listede yerel reklam 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 kadarGADAdLoader
içinloadRequest:
yöntemini tekrar çağırmayın.
Reklamınızı gösterin
Reklamı yükledikten sonra, tek yapmanız gereken reklamı kullanıcılarınıza göstermektir. Nasıl yapıldığını görmek için Yerel Gelişmiş kılavuzumuza gidin.