Yerel gelişmiş

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.

Önemli Bilgi: Yerel reklamlar hakkında daha fazla bilgiyi Yerel Reklamlar Başucu Kitabımızda bulabilirsiniz. Ayrıca, Yerel reklam politikalarını ve yönergelerini inceleyin inceleyin.

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

Not: Gördüğünüz gibi, yukarıdaki kod örneği harekete geçirici mesajın gösterildiği UIButton için kullanıcı etkileşimini devre dışı bırakıyor. Yerel reklam öğelerini görüntülemek için UIButtons kullanıyorsanız Google Mobile Ads SDK'sının kullanıcı arayüzü etkinliklerini düzgün bir şekilde alıp işleyebilmesi için kullanıcı etkileşimlerini de devre dışı bırakmanız gerekir. Bu ilave adım nedeniyle UIButton'lardan tamamen kaçınmak ve bunun yerine UILabel ve UIImageView kullanmak en iyisidir.

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 İndir

GADMediaView

Önemli Nokta: Yerel reklamınızın düzenine ana resim öğesi eklemek istiyorsanız UIImageView öğesi yerine GADMediaView öğesini kullanmanız gerekir.

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 yerine GADMediaView içine yerleştirilir.

Önemli Nokta: Varsayılan olarak mainImage, indirilen ilk resim öğesidir. disableImageLoading kullanılıyorsa mainImage değeri nil şeklindedir ve bu özelliği manuel olarak indirdiğiniz resme ayarlamanız gerekir. Bu resmin yalnızca video öğesi olmadığında kullanılacağını unutmayın.

Sonraki adımlar

Kullanıcı gizliliği hakkında daha fazla bilgi edinin.