Sistem tarafından tanımlanmış yerel reklam biçimi gösterme
Bir yerel reklam yüklendiğinde uygulamanız, GADAdLoaderDelegate
protokol mesajlarından biri üzerinden yerel reklam nesnesi alır. Ardından, reklamın görüntülenmesinden uygulamanız sorumludur (ancak bunu hemen yapması gerekmez).
SDK, sistem tarafından tanımlanan reklam biçimlerinin gösterilmesini 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ı bulunur:
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
, GADNativeAd
öğesinin tek bir örneğini görüntüleyebilir. Söz konusu reklamın öğelerini görüntülemek için kullanılan UIView
nesnelerinin her biri, ilgili GADNativeAdView
nesnesinin alt görünümleri olmalıdır.
Örneğin, bir UITableView
öğesinde 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ı, bağımsız öğeler için kullanılan görünümü kaydetmek için kullanılan IBOutlets
yöntemini ve GADNativeAd
nesnesini kaydetmek için bir yöntem de sunar. Görünümleri bu şekilde kaydetmek, SDK'nın aşağıdakilere benzer görevleri otomatik olarak gerçekleştirmesini sağlar:
- Tıklamalar 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ı
Dolaylı yerel reklamlar ( AdMob dolgusu ya da Ad Exchange veya AdSense üzerinden yayınlanan) için SDK tarafından bir AdChoices yer paylaşımı eklenir. Otomatik olarak eklenen Reklam Seçenekleri logosu için lütfen yerel reklam görünümünün tercih ettiğiniz köşesinde boşluk bırakın. Ayrıca, AdChoices yer paylaşımı simgesinin içeriğin üzerinde 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.
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.
Kod örneği
Xib dosyalarından dinamik olarak yüklenen görünümleri kullanarak yerel reklamların nasıl görüntüleneceğine göz atalım. Birden fazla biçim istemek için yapılandırılmış GADAdLoaders
kullanırken bu yöntem çok yararlı olabilir.
UIViews'ı yerleştirme
İlk adım, yerel reklam öğelerini gösterecek UIViews
koymaktır.
Bu işlemi diğer oluşturucu dosyaları oluştururken Arayüz Oluşturucu'da yaptığınız gibi yapabilirsiniz. Yerel reklam düzeni aşağıdaki gibi görünebilir:
Resmin sağ üst kısmındaki Özel Sınıf değerini not edin. Şu şekilde ayarlandı:
GADNativeAdView
.
Bu, GADNativeAd
görüntülemek için kullanılan reklam görüntüleme sınıfıdır.
Ayrıca, reklamın videosunu veya resmini görüntülemek için kullanılan GADMediaView
özel sınıfını da ayarlamanız gerekir.
Prizleri görünümlere bağlama
Görünümler oluşturulduktan ve düzene doğru reklam görüntüleme sınıfını atadığınızda, 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 şu şekilde bağlayabilirsiniz:
Çıkış panelindeki GADNativeAdView
bağlantısında yer alan arayüzler, Arayüz Oluşturucu'da belirtilen UIViews
ile bağlantılıdır. Bu, SDK'nın hangi öğeyi UIView
görüntülediğini öğrenmesini sağlar.
Bu satış noktalarının reklamda tıklanabilen görüntülemeleri temsil ettiğini de unutmayın.
Reklamı gösterme
Düzen tamamlandıktan ve prizler bağlandıktan sonra son adım, yüklendikten sonra reklamı gösteren bir kodu uygulamanıza eklemektir. Yukarıda tanımlanan görünümde reklam göstermenin bir yöntemi aşağıda verilmiştir:
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 depomuz, Yerel Gelişmiş reklamlar Hem Swift hem de Targetive-C'de yazıldığı şekilde eksiksiz olarak uygulanır.
Yerel Gelişmiş Örneği İndirGADMediaView
Resim ve video öğeleri, kullanıcılara GADMediaView
üzerinden gösterilir.
Bu bir xib dosyasında tanımlanabilir veya dinamik olarak oluşturulabilir. UIView
Diğer tüm öğe görünümlerinde olduğu gibi bir GADNativeAdView
öğesinin görünüm hiyerarşisine yerleştirilmelidir.
Tüm öğe görünümlerinde olduğu gibi, medya görünümündeki içeriklerin de doldurulması gerekir. Bu, GADMediaView
mülkündeki mediaContent
özelliği kullanılarak ayarlanır. GADNativeAd
özelliğinin mediaContent
özelliği, GADMediaView
'e iletilebilecek medya içeriği içerir.
Yerel Gelişmiş örnekten bir snippet
Swift |
Objective-C)
, GADNativeAd
üzerinden GADMediaContent
kullanarak yerel reklam öğeleriyle nasıl doldurulacağını gösterir:GADMediaView
Swift
nativeAdView.mediaView?.mediaContent = nativeAd.mediaContent
Objective-C
nativeAdView.mediaView.mediaContent = nativeAd.mediaContent;
Yerel reklam görünümü için arayüz oluşturucu dosyanızdaki görünüm özel sınıfının GADMediaView
olarak ayarlandığından ve bunu mediaView
çıkışına bağladığınızdan emin olun.
Resim İçerik Modu'nu Değiştirme
GADMediaView
sınıfı, resimleri gösterirken UIView
contentMode
özelliğine uyar. Bir resmin GADMediaView
ürününde ölçeklendirilme şeklini değiştirmek istiyorsanız GADMediaView
, contentMode
özelliğinde ilgili UIViewContentMode
değerini ayarlayın.
Örneğin, bir resim gösterildiğinde (reklamda video olmadığında) GADMediaView
öğesini doldurmak için:
Swift
nativeAdView.mediaView?.contentMode = .aspectFill
Objective-C
nativeAdView.mediaView.contentMode = UIViewContentModeAspectFill;
GADMediaİçerikleri
GADMediaContent
sınıfı, GADMediaView
sınıfı kullanılarak görüntülenen yerel reklamın medya içeriğiyle ilgili verileri içerir. GADMediaView
mediaContent
özelliğinde ayarlandığında:
Video öğesi varsa arabelleğe alınır ve
GADMediaView
içinde oynatılmaya başlar. Video öğesinin kullanılıp kullanılamadığınıhasVideoContent
kontrol ederek öğrenebilirsiniz.Reklamda video öğesi yoksa
mainImage
öğesi indirilir ve bunun yerineGADMediaView
içine yerleştirilir.
Sonraki adımlar
Kullanıcı gizliliği hakkında daha fazla bilgi edinin.