Benutzerdefinierte native Anzeigenformate verwenden

Benutzerdefinierte Anzeigenformate

Wie ihre systemdefinierten Pendants werden auch benutzerdefinierte native Anzeigenformate mit GADAdLoader-Objekten geladen. Wenn Sie beim Initialisieren eines GADAdLoader die GADAdLoaderAdTypeCustomNative Konstante in das adTypes Array einfügen, wird es so konfiguriert, dass beim Laden von Anzeigen benutzerdefinierte native Formate angefordert werden.

GADCustomNativeAdLoaderDelegate

Das Protokoll zum Laden benutzerdefinierter Formate hat zwei Methoden. Die erste wird von GADAdLoader verwendet, um herauszufinden, welche Format-IDs angefordert werden sollen:

Swift

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

Objective-C

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

Jedes benutzerdefinierte native Anzeigenformat hat eine entsprechende Format-ID, mit der es identifiziert wird. Wenn diese Methode aufgerufen wird, sollte Ihre App ein Array mit den Format-IDs der Anzeigen zurückgeben, die sie präsentieren kann.

Die zweite Nachricht wird gesendet, wenn die benutzerdefinierte native Anzeige geladen wurde, ähnlich wie bei systemdefinierten Formaten:

Swift

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

Objective-C

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

Format-IDs

Die Format-IDs, die verwendet werden, um eindeutig auf benutzerdefinierte native Anzeigenformate zu verweisen, finden Sie in der Ad Manager-Benutzeroberfläche im Drop-down-Menü Auslieferung unter Native:

Die Format-ID jeder benutzerdefinierten nativen Anzeige wird neben ihrem Namen angezeigt. Wenn Sie auf einen der Namen klicken, gelangen Sie zu einem Detailbildschirm mit Informationen zu den Feldern des Formats:

Hier können einzelne Felder hinzugefügt, bearbeitet und entfernt werden. Beachten Sie den Namen jedes Assets. Der Name ist der Schlüssel, der verwendet wird, um die Daten für jedes Asset abzurufen, wenn Sie Ihr benutzerdefiniertes natives Anzeigenformat präsentieren.

Benutzerdefinierte native Anzeigenformate präsentieren

Benutzerdefinierte native Anzeigenformate unterscheiden sich von systemdefinierten Formaten dadurch, dass Publisher ihre eigene Liste von Assets definieren können, aus denen eine Anzeige besteht. Aus diesem Grund unterscheidet sich der Prozess zum Präsentieren benutzerdefinierter nativer Anzeigen in einigen Punkten von dem für systemdefinierte Formate:

Da GADCustomNativeAd für alle von Ihnen erstellten benutzerdefinierten nativen Anzeigenformate verwendet werden soll, hat es keine benannten Asset-Accessors. Stattdessen bietet es Methoden wie imageForKey: und stringForKey:, die den Namen des Felds als Argument akzeptieren.
Es gibt keine spezielle Anzeigenansichtsklasse wie GADNativeAdView, die mit GADCustomNativeAd verwendet werden kann. Sie können jede Ansicht verwenden, die für Ihre Nutzerfreundlichkeit sinnvoll ist.
Da es keine spezielle Anzeigenansichtsklasse gibt, müssen Sie keine der Ansichten registrieren, die Sie zum Präsentieren der Assets der Anzeige verwenden.

Hier ist ein Beispiel für eine Anzeigenansicht, in der eine einfache benutzerdefinierte native Anzeige präsentiert werden kann:

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 (Auszug)

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"];
}
...

Datenschutzinfo-Symbol rendern

Im Rahmen der Unterstützung des Gesetzes über digitale Dienste (Digital Services Act, DSA) müssen Reservierungsanzeigen, die im Europäischen Wirtschaftsraum (EWR) ausgeliefert werden, ein Datenschutzinfo-Symbol und einen Link zur Google-Seite „Infos zu dieser Anzeige“ enthalten. Wenn Sie benutzerdefinierte native Anzeigen implementieren, sind Sie für das Rendern des Datenschutzinfo‑Symbols verantwortlich. Beim Rendern der Haupt‑Anzeigen‑Assets ist es wichtig, dass Sie Schritte unternehmen, um den Click Listener für das Datenschutzinfo‑Symbol zu rendern und einzurichten.

Im folgenden Beispiel wird das Datenschutzinfo-Symbol gerendert und das entsprechende Klickverhalten konfiguriert.

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

Native Videoanzeigen für benutzerdefinierte native Anzeigenformate

Wenn Sie ein benutzerdefiniertes Format erstellen, haben Sie die Möglichkeit, das Format für Videos zu aktivieren.

In Ihrer App-Implementierung können Sie die GADCustomNativeAd.mediaView Eigenschaft verwenden, um die Ansicht des Videos abzurufen. Fügen Sie diese Ansicht dann Ihrer Ansichtshierarchie hinzu. Wenn die Anzeige keine Videoinhalte enthält, müssen Sie alternative Pläne erstellen, um die Anzeige ohne Video zu präsentieren.

Im folgenden Beispiel wird geprüft, ob die Anzeige Videoinhalte enthält. Wenn kein Video verfügbar ist, wird stattdessen ein Bild präsentiert:

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

Weitere Informationen zum Anpassen der Videoanzeigen für benutzerdefinierte native Anzeigen finden Sie unter GADVideoController.

Laden Sie das Beispiel für benutzerdefiniertes Rendering in Ad Manager herunter , um ein funktionierendes Beispiel für native Videoanzeigen in Aktion zu sehen.

Klicks und Impressionen für benutzerdefinierte native Anzeigen verarbeiten

Bei benutzerdefinierten nativen Anzeigenformaten ist Ihre App für das Erfassen von Impressionen und das Melden von Klickereignissen an das SDK verantwortlich.

Impressionen erfassen

Wenn Sie eine Impression für eine benutzerdefinierte native Anzeige erfassen möchten, rufen Sie einfach die Methode recordImpression für die entsprechende GADCustomNativeAd auf:

Swift

myCustomNativeAd.recordImpression()

Objective-C

[myCustomNativeAd recordImpression];

Das SDK verhindert, dass für eine einzelne Anfrage doppelte Impressionen erfasst werden, falls Ihre App die Methode versehentlich mehrmals für dieselbe Anzeige aufruft.

Klicks melden

Wenn Sie dem SDK melden möchten, dass auf eine Asset-Ansicht geklickt wurde, rufen Sie die Methode performClickOnAssetWithKey: für die entsprechende GADCustomNativeAd auf und übergeben Sie den Namen des Assets, auf das geklickt wurde. Wenn Sie beispielsweise ein Asset mit dem Namen „MainImage“ in Ihrem benutzerdefinierten Format haben und einen Klick auf die Ansicht melden möchten, die diesem Asset entspricht, sieht Ihr Code so aus:

Swift

myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[myCustomNativeAd performClickOnAssetWithKey:@"MainImage"];

Sie müssen diese Methode nicht für jede Asset-Ansicht aufrufen, die mit Ihrer Anzeige verknüpft ist. Wenn Sie beispielsweise ein weiteres Asset mit dem Namen „Caption“ haben, das präsentiert werden soll, auf das der Nutzer aber nicht klickt oder tippt, muss Ihre App performClickOnAssetWithKey: für diese Ansicht nicht aufrufen.

Auf benutzerdefinierte Klickaktionen reagieren

GADCustomNativeAd hat eine Eigenschaft customClickHandler vom Typ GADNativeAdCustomClickHandler.

Swift

typealias NativeAdCustomClickHandler = (assetID: String) -> Void

Objective-C

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

Dies ist ein Block (Objective-C) / eine Closure (Swift), der eine assetID als Eingabeparameter akzeptiert, die das Asset identifiziert, auf das geklickt wurde.

Wenn auf eine benutzerdefinierte native Anzeige geklickt wird, gibt es drei mögliche Antworten vom SDK, die in dieser Reihenfolge versucht werden:

Rufen Sie den Block customClickHandler in Objective-C oder die Closure in Swift auf, falls eine festgelegt wurde.
Durchlaufen Sie die Deeplink-URLs der Anzeige und öffnen Sie die erste, für die eine passende App gefunden werden kann.
Öffnen Sie einen Browser und rufen Sie die herkömmliche Ziel-URL der Anzeige auf.

Die Eigenschaft customClickHandler akzeptiert einen Block in Objective-C und eine Closure in Swift. Wenn Sie einen Block oder eine Closure festlegen, wird sie vom SDK ausgeführt und es werden keine weiteren Maßnahmen ergriffen. Wenn Sie jedoch einen Nullwert festlegen, greift das SDK auf die Deeplink- und/oder Ziel-URLs zurück, die für die Anzeige registriert sind.

Mit benutzerdefinierten Klick-Handlern kann Ihre App selbst entscheiden, welche Aktion als Reaktion auf einen Klick am besten geeignet ist, z. B. die Benutzeroberfläche aktualisieren, einen anderen Ansichtscontroller präsentieren oder einfach den Klick protokollieren. Hier ist ein Beispiel, in dem eine Benachrichtigung angezeigt wird:

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"];

Code für native Anzeigen testen

Direkt verkaufte Anzeigen

Wenn Sie testen möchten, wie direkt verkaufte native Anzeigen aussehen, können Sie diese Ad Manager-Anzeigenblock-ID verwenden:

/21775744923/example/native

Sie ist so konfiguriert, dass Beispiel-App-Installationsanzeigen und -Contentanzeigen sowie ein benutzerdefiniertes natives Anzeigenformat mit den folgenden Assets ausgeliefert werden:

Anzeigentitel (Text)
Hauptbild (Bild)
Bildunterschrift (Text)

Native Backfill-Anzeigen

Wenn Sie das Verhalten von nativen Backfill-Anzeigen testen möchten, verwenden Sie diesen Ad Manager-Anzeigenblock:

/21775744923/example/native-backfill

Es werden Beispiel-App-Installationsanzeigen und -Contentanzeigen ausgeliefert, die das Datenschutzinfo-Overlay enthalten.

Denken Sie daran, Ihren Code zu aktualisieren, damit er auf Ihre tatsächlichen Anzeigenblock- und Format-IDs verweist, bevor Sie live gehen.

Benutzerdefinierte native Anzeigenformate verwenden Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Benutzerdefinierte Anzeigenformate

GADCustomNativeAdLoaderDelegate

Swift

Objective-C

Swift

Objective-C

Format-IDs

Benutzerdefinierte native Anzeigenformate präsentieren

MySimpleNativeAdView.h

Swift

Objective-C

MySimpleNativeAdView.m (Auszug)

Swift

Objective-C

Datenschutzinfo-Symbol rendern

Swift

Objective-C

Native Videoanzeigen für benutzerdefinierte native Anzeigenformate

Swift

Objective-C

Klicks und Impressionen für benutzerdefinierte native Anzeigen verarbeiten

Impressionen erfassen

Swift

Objective-C

Klicks melden

Swift

Objective-C

Auf benutzerdefinierte Klickaktionen reagieren

Swift

Objective-C

Swift

Objective-C

Code für native Anzeigen testen

Direkt verkaufte Anzeigen

Native Backfill-Anzeigen

Benutzerdefinierte native Anzeigenformate verwenden