Yerel gelişmiş

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:

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

#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:

nativeAdView.mediaView?.mediaContent = nativeAd.mediaContent

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:

nativeAdView.mediaView?.contentMode = .aspectFill

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

Sonraki adımlar

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