Özel yerel reklam biçimlerini kullanma

Platform seçin: Android iOS Android (Eski)

Özel reklam biçimleri

Sistem tarafından tanımlanan benzerleri gibi, özel doğal reklam biçimleri de GADAdLoader nesneleri kullanılarak yüklenir. GADAdLoaderAdTypeCustomNative sabitini GADAdLoader başlatılırken adTypes dizisine eklemek, reklamlar yüklenirken özel doğal biçimler isteyecek şekilde yapılandırır.

Not: Birden fazla reklam biçimi yayınlayacak şekilde yapılandırılmış bir reklam biriminiz varsa tek bir GADAdLoader ile özel doğal biçimler ve sistem tarafından tanımlanan biçimler isteyebilirsiniz. Ad Manager, istediğiniz biçimlerden biriyle ilişkili en iyi doğal reklam öğesini seçer.

GADCustomNativeAdLoaderDelegate

Özel biçimleri yükleme protokolünün iki yöntemi vardır. Birincisi, GADAdLoader tarafından hangi biçim kimliklerinin istenmesi gerektiğini öğrenmek için kullanılır:

Swift

public func customNativeAdFormatIDs(for adLoader: AdLoader) -> [Any]

Objective-C

- (NSArray *)customNativeAdFormatIDsForAdLoader:(AdLoader *)adLoader;

Her özel doğal reklam biçiminin, kendisini tanımlayan bir biçim kimliği vardır. Bu yöntem çağrıldığında uygulamanız, göstermeye hazır olduğu reklamların biçim kimliklerini içeren bir dizi döndürmelidir.

İkinci mesaj, özel doğal reklam yüklendiğinde sistem tanımlı biçimlerdeki gibi gönderilir:

Swift

public func adLoader(_ adLoader: AdLoader,
    didReceive customNativeAd: CustomNativeAd)

Objective-C

- (void)adLoader:(AdLoader *)adLoader
    didReceiveCustomNativeAd:(CustomNativeAd *)customNativeAd;

Biçim kimlikleri

Özel doğal reklam biçimlerine benzersiz şekilde referans vermek için kullanılan biçim kimlikleri, Ad Manager kullanıcı arayüzündeki Yayın açılır listesindeki Doğal bölümünde bulunabilir:

Her özel doğal reklamın biçim kimliği, adının yanında gösterilir. Adlardan birini tıkladığınızda, biçimin alanlarıyla ilgili bilgileri gösteren bir ayrıntılar ekranına yönlendirilirsiniz:

Buradan tek tek alanlar eklenebilir, düzenlenebilir ve kaldırılabilir. Öğelerin her birinin Adı'nı not edin. Ad, özel doğal reklam biçiminizi görüntülerken her öğenin verilerini almak için kullanılan anahtardır.

Özel doğal reklam biçimlerini görüntüleme

Özel doğal reklam biçimleri, yayıncıların bir reklamı oluşturan kendi öğe listesini tanımlama gücüne sahip olması bakımından sistem tarafından tanımlananlardan farklıdır. Bu nedenle, özel doğal reklamların gösterilme süreci, sistem tanımlı biçimlerin gösterilme sürecinden birkaç açıdan farklıdır:

1. GADCustomNativeAd, oluşturduğunuz özel doğal reklam biçimlerinin tümünü işlemek üzere tasarlandığından adlandırılmış öğe erişimcileri yoktur. Bunun yerine, alanın adını bağımsız değişken olarak alan imageForKey: ve stringForKey: gibi yöntemler sunar.
2. GADCustomNativeAd ile kullanılacak GADNativeAdView gibi özel bir reklam görüntüleme sınıfı yoktur. Kullanıcı deneyiminiz için mantıklı olan görünümü kullanabilirsiniz.
3. Özel bir reklam görüntüleme sınıfı olmadığından, reklam öğelerini göstermek için kullandığınız görünümlerden herhangi birini kaydetmeniz gerekmez.

Aşağıda, basit bir özel doğal reklamı gösterebilen bir reklam görüntüleme örneği verilmiştir:

MySimpleNativeAdView.h

Swift

import UIKit
import GoogleMobileAds

/// Custom native ad view class with format ID 10063170.
class MySimpleNativeAdView: UIView {

  /// Weak references to this ad's asset views.
  @IBOutlet weak var headlineView: UILabel!
  @IBOutlet weak var mainImageView: UIImageView!
  @IBOutlet weak var captionView: UILabel!

  ...

  /// Populates the ad view with the custom native ad object.
  func populateWithCustomNativeAd(_ customNativeAd: CustomNativeAd) {
    ...
  }
}

Objective-C

@import UIKit;
@import GoogleMobileAds;

/// View representing a custom native ad format with format ID 10063170.
@interface MySimpleNativeAdView : UIView

// Weak references to this ad's asset views.
@property(weak, nonatomic) IBOutlet UILabel *headlineView;
@property(weak, nonatomic) IBOutlet UIImageView *mainImageView;
@property(weak, nonatomic) IBOutlet UILabel *captionView;

/// Populates the ad view with the custom native ad object.
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd;

@end

MySimpleNativeAdView.m (alıntı)

Swift

...
func populateWithCustomNativeAd(_ customNativeAd: CustomNativeAd) {
  self.customNativeAd = customNativeAd

  // Populate the custom native ad assets.
  headlineView.text = self.customNativeAd.stringForKey("Headline")
  mainImageView.image = self.customNativeAd.imageForKey("MainImage")?.image
  captionView.text = self.customNativeAd.stringForKey("Caption")
}
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  self.customNativeAd = customNativeAd;

  // Populate the custom native ad assets.
  self.headlineView.text = [customNativeAd stringForKey:@"Headline"];
  self.mainImageView.image = [customNativeAd imageForKey:@"MainImage"].image;
  self.captionView.text = [customNativeAd stringForKey:@"Caption"];
}
...

Reklam Seçenekleri simgesini oluşturma

Dijital Hizmetler Yasası'nı (DSA) destekleme kapsamında, Avrupa Ekonomik Alanı'nda (AEA) yayınlanan rezervasyon reklamlarında bir Reklam Seçenekleri simgesi ve Google'ın "Bu reklam hakkında" sayfasına bir bağlantı bulunması gerekir. Özel doğal reklamları uygularken Reklam Seçenekleri simgesini oluşturma sorumluluğu size aittir. Ana reklam öğelerini oluştururken Reklam Seçenekleri simgesi için tıklama işleyici oluşturmak ve ayarlamak üzere bazı adımlar atmanız önemlidir.

Aşağıdaki örnekte, Reklam Seçenekleri simgesi oluşturulur ve uygun tıklama davranışı yapılandırılır.

Önemli: AdChoices simgesini en az 15 piksel x 15 piksel olarak ayarlayın.

Swift

class MySimpleNativeAdView: UIView {
  @IBOutlet weak var adChoicesView: UIImageView!

  override func awakeFromNib() {
    super.awakeFromNib()

    // Enable clicks on AdChoices.
    adChoicesView.addGestureRecognizer(
      UITapGestureRecognizer(
        target: self,
        action: #selector(performClickOnAdChoices(_:))))
    adChoicesView.isUserInteractionEnabled = true
  }

  @objc func performClickOnAdChoices(_ sender: UIImage!) {
    customNativeAd.performClickOnAsset(withKey:
      NativeAssetIdentifier.adChoicesViewAsset.rawValue)
  }

  func populate(withCustomNativeAd customNativeAd: CustomNativeAd) {

    // Render the AdChoices image.
    let adChoicesKey = NativeAssetIdentifier.adChoicesViewAsset.rawValue
    let adChoicesImage = customNativeAd.image(forKey: adChoicesKey)?.image
    adChoicesView.image = adChoicesImage
    adChoicesView.isHidden = adChoicesImage == nil
    ...
  }
}

Objective-C

@interface MySimpleNativeAdView ()

@property(nonatomic, weak) IBOutlet UIImageView *adChoicesView;

@end

@implementation MySimpleNativeAdView

- (void)awakeFromNib {
  [super awakeFromNib];
  // Enable clicks on AdChoices.
  [self.adChoicesView addGestureRecognizer:[[UITapGestureRecognizer alloc]
                                            initWithTarget:self
                                            action:@selector(performClickOnAdChoices:)]];
  self.adChoicesView.userInteractionEnabled = YES;
}

- (void)performClickOnAdChoices:(UITapGestureRecognizer *)sender {
    [self.customNativeAd performClickOnAssetWithKey:GADNativeAdChoicesViewAsset];
}

- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  // Render the AdChoices image.
  GADNativeAdImage *adChoicesAsset = [customNativeAd
    imageForKey:GADNativeAdChoicesViewAsset];
  self.adChoicesView.image = adChoicesAsset.image;
  self.adChoicesView.hidden = (adChoicesAsset == nil);
  ...
}

Önemli nokta: Yalnızca resim URL'lerini istemek için Resim indirme kontrolü'nü kullanırsanız Reklam Seçenekleri öğesi bu ayara uyar ve yalnızca resim URL'sini döndürür.

Özel doğal reklam biçimleri için doğal video reklam

Özel biçim oluştururken biçimi video için uygun hale getirebilirsiniz.

Uygulama uygulamanızda, videonun görüntülemesini almak için GADCustomNativeAd.mediaView özelliğini kullanabilirsiniz. Ardından bu görünümü görünüm hiyerarşinize ekleyin. Reklamda video içeriği yoksa reklamı videosuz göstermek için alternatif planlar yapın.

Not: Video kullanılamadığında medya görünümünde resim içeren doğal reklamlardan farklı olarak, video içermeyen özel doğal reklamların medya görünümünde içerik bulunmaz.

Aşağıdaki örnekte, reklamda video içeriği olup olmadığı kontrol edilir ve video yoksa reklamın yerine bir resim gösterilir:

Swift

...
  /// Populates the ad view with the custom native ad object.
  func populate(withCustomNativeAd customNativeAd: CustomNativeAd) {
    if customNativeAd.videoController.hasVideoContent(),
      let mediaView = customNativeAd.mediaView {
      updateMainView(mediaView)
    } else {
      // Assumes your native format has an image asset with the name MainImage.
      let image: UIImage? = customNativeAd.image(forKey: "MainImage")?.image
      updateMainView(UIImageView(image: image))
    }
  }

  private func updateMainView(_ mainView:UIView) {
    // Assumes you have a placeholder view for your media content.
    // Remove all the placeholder's subviews.
    for subview: UIView in mainPlaceholder.subviews {
      subview.removeFromSuperview()
    }
    mainPlaceholder.addSubview(mainView)
    // Size the media view to fill our container size.
    mainView.translatesAutoresizingMaskIntoConstraints = false
    let viewDictionary: [AnyHashable: Any] = ["mainView":mainView]
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "H:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "V:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
  }
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)ad {
  UIView *mainView = nil;
  if (ad.videoController.hasVideoContent) {
    mainView = ad.mediaView;
  } else {
    // Assumes your native format has an image asset with the name MainImage.
    UIImage *image = [ad imageForKey:@"MainImage"].image;
    mainView = [[UIImageView alloc] initWithImage:image];
  }
  // Assumes you have a placeholder view for your media content.
  for (UIView *subview in self.mainPlaceholder.subviews) {
    [subview removeFromSuperview];
  }
  [self.mainPlaceholder addSubview:mainView];

  // Size the main view to fill our container size.
  [mainView setTranslatesAutoresizingMaskIntoConstraints:NO];
  NSDictionary *viewDictionary = NSDictionaryOfVariableBindings(mainView);
  [self.mainPlaceholder
      addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"H:|[mainView]|"
                                                             options:0
                                                             metrics:nil
                                                               views:viewDictionary]];
}
...

Özel bir yerel reklamın video deneyimini nasıl özelleştirebileceğiniz hakkında daha fazla bilgi için GADVideoController'a bakın.

Yerel videonun nasıl çalıştığını gösteren bir örnek için Ad Manager Özel Oluşturma örneğini indirin.

Özel doğal reklam tıklamalarını ve gösterimlerini işleme

Özel doğal reklam biçimlerinde, gösterimleri kaydetmek ve tıklama etkinliklerini SDK'ya bildirmek uygulamanızın sorumluluğundadır.

Kayıt gösterimleri

Özel bir doğal reklam için gösterim kaydetmek üzere ilgili GADCustomNativeAd üzerinde recordImpression yöntemini çağırmanız yeterlidir:

Swift

myCustomNativeAd.recordImpression()

Objective-C

[myCustomNativeAd recordImpression];

SDK, uygulamanız aynı reklam için yöntemi yanlışlıkla birden çok kez çağırırsa tek bir istek için yinelenen gösterimlerin kaydedilmesini önler.

Tıklamaları raporlama

Bir öğe görünümünde tıklama gerçekleştiğini SDK'ya bildirmek için ilgili GADCustomNativeAd üzerinde performClickOnAssetWithKey: yöntemini çağırın ve tıklanan öğenin adını iletin. Örneğin, özel biçiminizde "MainImage" adlı bir öğeniz varsa ve bu öğeye karşılık gelen görünümdeki bir tıklamayı raporlamak istiyorsanız kodunuz şu şekilde görünür:

Swift

myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[myCustomNativeAd performClickOnAssetWithKey:@"MainImage"];

Bu yöntemi, reklamınızla ilişkili her öğe görünümü için çağırmanız gerekmediğini unutmayın. Örneğin, "Altyazı" adlı başka bir öğeniz varsa ve bu öğenin gösterilmesi ancak kullanıcı tarafından tıklanmaması veya dokunulmaması gerekiyorsa uygulamanızın bu görünüm için performClickOnAssetWithKey: çağırması gerekmez.

Özel tıklama işlemlerine yanıt verme

GADCustomNativeAd, türü GADNativeAdCustomClickHandler olan bir customClickHandler özelliğine sahip

Swift

typealias NativeAdCustomClickHandler = (assetID: String) -> Void

Objective-C

typedef void (^GADNativeAdCustomClickHandler)(NSString *assetID);

Bu, tıklanan öğeyi tanımlayan bir assetID giriş parametresi olarak kabul eden bir bloktur (Objective-C) / kapatmadır (Swift).

Özel bir doğal reklam tıklandığında SDK'dan şu üç olası yanıt sırayla denenir:

1. Ayarlanmışsa Objective-C'de customClickHandler bloğunu veya Swift'te kapatmayı çağırın.
2. Reklamın derin bağlantı URL'lerinde döngü oluşturun ve eşleşen bir uygulamanın bulunabildiği ilk URL'yi açın.
3. Bir tarayıcı açın ve reklamın geleneksel hedef URL'sine gidin.

customClickHandler özelliği, Objective-C'de bir blok, Swift'te ise bir kapatma kabul eder. Bir engelleme veya kapatma ayarlarsanız SDK bunu uygular ve başka işlem yapmaz. Ancak sıfır değer ayarlarsanız SDK, reklamla kaydedilen derin bağlantı ve/veya hedef URL'lere geri döner.

Özel tıklama işleyicileri, uygulamanızın tıklamaya yanıt olarak gerçekleştirilecek en iyi işlemi (ör. kullanıcı arayüzünü güncelleme, başka bir görünüm denetleyicisi sunma veya yalnızca tıklamayı kaydetme) kendisinin belirlemesine olanak tanır. Aşağıda bir uyarı gösteren örnek verilmiştir:

Swift

myCustomNativeAd.customClickHandler = { assetID in
  if assetID == "MainImage" {
    let alertView = UIAlertView(title: "Custom Click",
        message: "You just clicked on the image!",
        delegate: self,
        cancelButtonTitle: "OK")
    alertView.alertViewStyle = .default
    alertView.show()
  }
}
myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[self.customNativeAd setCustomClickHandler:^(NSString *assetID){
  if ([assetID isEqualToString:@"MainImage"]) {
    [[[UIAlertView alloc] initWithTitle:@"Custom Click"
                                message:@"You just clicked on the image!"
                               delegate:self
                      cancelButtonTitle:@"OK"
                      otherButtonTitles:nil] show];
  }
}];
[self.customNativeAd performClickOnAssetWithKey:@"MainImage"];

İlk başta, özel tıklama işleyicilerin varlığı garip görünebilir. Sonuçta uygulamanız SDK'ya bir tıklama olduğunu bildirdi. Bu durumda SDK neden dönüp bunu uygulamaya bildirmelidir?

Bu bilgi akışı birkaç nedenden dolayı faydalıdır ancak en önemlisi, SDK'nın tıklamaya verilen yanıtı kontrol etmesine olanak tanımasıdır. Örneğin, reklam öğesi için ayarlanan üçüncü taraf izleme URL'lerine otomatik olarak ping gönderebilir ve ek kod olmadan diğer görevleri arka planda gerçekleştirebilir.

Doğal reklam kodunu test etme

Doğrudan satılan reklamlar

Doğrudan satılan doğal reklamların nasıl olduğunu test etmek isterseniz şu Ad Manager reklam birimi kimliğini kullanabilirsiniz:

/21775744923/example/native

Aşağıdaki öğeleri içeren özel bir doğal reklam biçiminin yanı sıra örnek uygulama yükleme ve içerik reklamları yayınlayacak şekilde yapılandırılmıştır:

• Başlık (metin)
• MainImage (resim)
• Başlık (metin)

Doğal yedek reklamlar

Doğal yedek reklamların davranışını test etmek için şu Ad Manager reklam birimini kullanın:

/21775744923/example/native-backfill

Reklam Seçenekleri yer paylaşımını içeren örnek uygulama yükleme ve içerik reklamları yayınlar.

Yayınlamadan önce kodunuzu gerçek reklam birimi ve biçim kimliklerinizi referans verecek şekilde güncellemeyi unutmayın.