Sistem tanımlı yerel reklam biçimi görüntüleme
Yerel reklam yüklendiğinde uygulamanız GADAdLoaderDelegate
protokol mesajlarından biri aracılığıyla bir yerel reklam nesnesi alır. Bu durumda, reklamı görüntülemekten uygulamanız sorumludur (ancak bunu hemen yapmak zorunda değildir).
SDK, sistem tanımlı reklam biçimlerinin görüntülenmesini kolaylaştırmak için bazı faydalı kaynaklar sunar.
GADNativeAdView
GADNativeAd
için karşılık gelen bir "reklam görüntüleme" sınıfı vardır: GADNativeAdView
.
Bu reklam görüntüleme sınıfı, yayıncıların reklamı görüntülemek için kullanması gereken bir UIView
'dir.
Örneğin, tek bir GADNativeAdView
, tek bir GADNativeAd
örneğini görüntüleyebilir. Bu reklamın öğelerini görüntülemek için kullanılan UIView
nesnelerinin her biri, söz konusu GADNativeAdView
nesnesinin alt görünümleri olmalıdır.
Örneğin, UITableView
içinde bir reklam görüntülüyorsanız hücrelerden birinin görünüm hiyerarşisi aşağıdaki gibi görünebilir:
GADNativeAdView
sınıfı, her bir öğe için kullanılan görünümü kaydetmek için kullanılan IBOutlets
ve GADNativeAd
nesnesinin kendisini kaydetmek için bir yöntem de sağlar. Görünümlerin bu şekilde kaydedilmesi, SDK'nın aşağıdaki gibi görevleri otomatik olarak gerçekleştirmesini sağlar:
- Tıklama sayısı kaydediliyor.
- Gösterimleri kaydetme (ilk piksel ekranda göründüğünde).
- Reklam Seçenekleri yer paylaşımı gösteriliyor.
Reklam Seçenekleri yer paylaşımı
Ad Manager Dolaylı yerel reklamlar için (dolgu veya Ad Exchange ya da AdSense üzerinden yayınlanan) SDK tarafından bir Reklam Seçenekleri yer paylaşımı eklenir. Otomatik olarak eklenen Reklam Seçenekleri logosu için lütfen yerel reklam görünümünüzün tercih ettiğiniz köşesinde boşluk bırakın. Ayrıca, Reklam Seçenekleri yer paylaşımı simgesinin içeriğin üzerine kolayca görünmesini sağlayacak şekilde yerleştirildiğinden emin olun. Yer paylaşımının görünümü ve işlevi hakkında daha fazla bilgi için programatik yerel reklam uygulama yönergelerine bakın.
Programatik yerel reklamlar için reklam ilişkilendirmesi
Programatik yerel reklamları gösterirken, görünümün bir reklam olduğunu belirtmek için bir reklam ilişkilendirmesi göstermeniz gerekir. Politika yönergeleri için bu sayfayı inceleyin.
Kod örneği
xib dosyalarından dinamik olarak yüklenen görünümleri kullanarak yerel reklamların nasıl gösterileceğini inceleyelim. Birden fazla biçim istemek için yapılandırılmış GADAdLoaders
kullanılırken bu çok yararlı bir yaklaşım olabilir.
UIView öğelerini düzenleme
İlk adım, yerel reklam öğelerini gösterecek UIViews
öğesini düzenlemektir.
Bu işlemi, herhangi bir xib dosyası oluştururken yaptığınız gibi Arayüz Oluşturucu'da
yapabilirsiniz. Aşağıda, yerel reklam düzeninin
nasıl görünebileceğine ilişkin bir örnek verilmiştir:
Resmin sağ üst kısmındaki Özel Sınıf değerine dikkat edin. Ayarlandı:
GADNativeAdView
.
Bu, GADNativeAd
görüntülemek için kullanılan reklam görüntüleme sınıfıdır.
Reklama ait video veya resmi görüntülemek üzere kullanılan GADMediaView
için özel sınıfı da ayarlamanız gerekir.
Prizleri manzaraya bağlama
Görünümler oluşturulduktan ve düzene doğru reklam görüntüleme sınıfını atadıktan sonra, reklam görünümünün öğe çıkışlarını oluşturduğunuz UIViews
öğesine bağlayın.
Reklam görünümünün öğe çıkışlarını, bir reklam için oluşturulan UIViews
öğesine aşağıdaki şekilde bağlayabilirsiniz:
Priz panelinde, GADNativeAdView
bölgesindeki prizler Arayüz Oluşturucu'da belirtilen UIViews
'a bağlanmıştır. Bu, SDK'nın hangi UIView
öğeyi görüntülediğini bilmesini sağlar.
Bu çıkışların, reklamda tıklanabilen görüntülemeleri temsil ettiğinin unutulmaması da önemlidir.
Reklam gösteriliyor
Düzen tamamlandıktan ve prizler bağlandıktan sonra son adım, uygulamanıza yüklendikten sonra reklam görüntüleyecek bir kod eklemektir. Aşağıda, bir reklamı yukarıda tanımlanan görünümde görüntülemenin bir yöntemi açıklanmıştır:
Swift
// Mark: - GADNativeAdLoaderDelegate func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) { print("Received native ad: \(nativeAd)") refreshAdButton.isEnabled = true // Create and place ad in view hierarchy. let nibView = Bundle.main.loadNibNamed("NativeAdView", owner: nil, options: nil)?.first guard let nativeAdView = nibView as? GADNativeAdView else { return } setAdView(nativeAdView) // Set ourselves as the native ad delegate to be notified of native ad events. nativeAd.delegate = self // Populate the native ad view with the native ad assets. // The headline and mediaContent are guaranteed to be present in every native ad. (nativeAdView.headlineView as? UILabel)?.text = nativeAd.headline nativeAdView.mediaView?.mediaContent = nativeAd.mediaContent // This app uses a fixed width for the GADMediaView and changes its height to match the aspect // ratio of the media it displays. if let mediaView = nativeAdView.mediaView, nativeAd.mediaContent.aspectRatio > 0 { let heightConstraint = NSLayoutConstraint( item: mediaView, attribute: .height, relatedBy: .equal, toItem: mediaView, attribute: .width, multiplier: CGFloat(1 / nativeAd.mediaContent.aspectRatio), constant: 0) heightConstraint.isActive = true } // These assets are not guaranteed to be present. Check that they are before // showing or hiding them. (nativeAdView.bodyView as? UILabel)?.text = nativeAd.body nativeAdView.bodyView?.isHidden = nativeAd.body == nil (nativeAdView.callToActionView as? UIButton)?.setTitle(nativeAd.callToAction, for: .normal) nativeAdView.callToActionView?.isHidden = nativeAd.callToAction == nil (nativeAdView.iconView as? UIImageView)?.image = nativeAd.icon?.image nativeAdView.iconView?.isHidden = nativeAd.icon == nil (nativeAdView.starRatingView as? UIImageView)?.image = imageOfStars( fromStarRating: nativeAd.starRating) nativeAdView.starRatingView?.isHidden = nativeAd.starRating == nil (nativeAdView.storeView as? UILabel)?.text = nativeAd.store nativeAdView.storeView?.isHidden = nativeAd.store == nil (nativeAdView.priceView as? UILabel)?.text = nativeAd.price nativeAdView.priceView?.isHidden = nativeAd.price == nil (nativeAdView.advertiserView as? UILabel)?.text = nativeAd.advertiser nativeAdView.advertiserView?.isHidden = nativeAd.advertiser == nil // In order for the SDK to process touch events properly, user interaction should be disabled. nativeAdView.callToActionView?.isUserInteractionEnabled = false // Associate the native ad view with the native ad object. This is // required to make the ad clickable. // Note: this should always be done after populating the ad views. nativeAdView.nativeAd = nativeAd }
Objective-C
#pragma mark GADNativeAdLoaderDelegate implementation - (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd { NSLog(@"Received native ad: %@", nativeAd); self.refreshButton.enabled = YES; // Create and place ad in view hierarchy. GADNativeAdView *nativeAdView = [[NSBundle mainBundle] loadNibNamed:@"NativeAdView" owner:nil options:nil].firstObject; [self setAdView:nativeAdView]; // Set the mediaContent on the GADMediaView to populate it with available // video/image asset. nativeAdView.mediaView.mediaContent = nativeAd.mediaContent; // Populate the native ad view with the native ad assets. // The headline is guaranteed to be present in every native ad. ((UILabel *)nativeAdView.headlineView).text = nativeAd.headline; // These assets are not guaranteed to be present. Check that they are before // showing or hiding them. ((UILabel *)nativeAdView.bodyView).text = nativeAd.body; nativeAdView.bodyView.hidden = nativeAd.body ? NO : YES; [((UIButton *)nativeAdView.callToActionView)setTitle:nativeAd.callToAction forState:UIControlStateNormal]; nativeAdView.callToActionView.hidden = nativeAd.callToAction ? NO : YES; ((UIImageView *)nativeAdView.iconView).image = nativeAd.icon.image; nativeAdView.iconView.hidden = nativeAd.icon ? NO : YES; ((UIImageView *)nativeAdView.starRatingView).image = [self imageForStars:nativeAd.starRating]; nativeAdView.starRatingView.hidden = nativeAd.starRating ? NO : YES; ((UILabel *)nativeAdView.storeView).text = nativeAd.store; nativeAdView.storeView.hidden = nativeAd.store ? NO : YES; ((UILabel *)nativeAdView.priceView).text = nativeAd.price; nativeAdView.priceView.hidden = nativeAd.price ? NO : YES; ((UILabel *)nativeAdView.advertiserView).text = nativeAd.advertiser; nativeAdView.advertiserView.hidden = nativeAd.advertiser ? NO : YES; // In order for the SDK to process touch events properly, user interaction // should be disabled. nativeAdView.callToActionView.userInteractionEnabled = NO; // Associate the native ad view with the native ad object. This is // required to make the ad clickable. nativeAdView.nativeAd = nativeAd; }
GitHub depomuzda, hem Swift hem de Objective-C'de yazılmış yerel özel oluşturma reklamları için eksiksiz uygulamalar bulunmaktadır.
Google Ad Manager Özel Oluşturma Örneğini İndir
GADMediaView
Resim ve video öğeleri, kullanıcılara GADMediaView
aracılığıyla gösterilir.
Bu, xib dosyasında tanımlanabilen veya dinamik olarak oluşturulabilen bir UIView
'dir.
Diğer tüm öğe görünümlerinde olduğu gibi, GADNativeAdView
görünüm hiyerarşisine yerleştirilmelidir.
Tüm öğe görünümlerinde olduğu gibi, medya görünümünde de içeriğin doldurulması gerekir. Bu, GADMediaView
üzerinde mediaContent
özelliği kullanılarak ayarlanır. GADNativeAd
öğesinin mediaContent
özelliği, GADMediaView
'a aktarılabilen medya içeriği içerir.
Özel Oluşturma örneği
(Swift
| Objective-C)
GADMediaView
, GADNativeAd
için GADMediaContent
öğesini kullanarak yerel reklam öğeleriyle nasıl doldurulacağını gösterir:
Swift
nativeAdView.mediaView?.mediaContent = nativeAd.mediaContent
Objective-C
nativeAdView.mediaView.mediaContent = nativeAd.mediaContent;
Yerel reklam görünümünüz için arayüz oluşturucu dosyanızda, görünümler özel sınıfının GADMediaView
olarak ayarlandığından ve bu sınıfı mediaView
çıkışına bağladığınızdan emin olun.
Resim İçeriği Modunu Değiştirme
GADMediaView
sınıfı, resimleri görüntülerken UIView
contentMode
özelliğini dikkate alır. Bir resmin GADMediaView
öğesinde ölçeklenme şeklini değiştirmek isterseniz bunu elde etmek için GADMediaView
öğesinin contentMode
özelliğinde karşılık gelen UIViewContentMode
değerini ayarlayın.
Örneğin, bir resim gösterildiğinde (reklamda video olmadığında) GADMediaView
alanını doldurmak için:
Swift
nativeAdView.mediaView?.contentMode = .aspectFill
Objective-C
nativeAdView.mediaView.contentMode = UIViewContentModeAspectFill;
GADMediaContent
GADMediaContent
sınıfı, GADMediaView
sınıfı kullanılarak görüntülenen yerel reklamın medya içeriğiyle ilgili verileri barındırır. GADMediaView
mediaContent
özelliğinde ayarlandığında:
Video öğesi varsa arabelleğe alınır ve
GADMediaView
içinde oynatılmaya başlar. Bir video öğesinin kullanılıp kullanılamadığınıhasVideoContent
kontrol ederek öğrenebilirsiniz.Reklam bir video öğesi içermiyorsa
mainImage
öğesi indirilir ve bunun yerineGADMediaView
içine yerleştirilir.
Sonraki adımlar
Kullanıcı gizliliği hakkında daha fazla bilgi edinin.