Native Anzeigen

Native Anzeigen sind Anzeigen-Assets, die Nutzern über Komponenten der Benutzeroberfläche sind plattformspezifisch. Sie werden in den Klassen angezeigt, die Sie bereits verwenden in Ihren Storyboards verwenden und so formatiert werden, dass sie zum visuellen Design Ihrer App passen.

Beim Laden einer nativen Anzeige erhält Ihre App ein Anzeigenobjekt, das die zugehörigen Assets enthält. die App und nicht das Google Mobile Ads SDK, für die Anzeige verantwortlich.

Grundsätzlich gibt es zwei Schritte für die erfolgreiche Implementierung nativer Anzeigen: Laden einer Anzeige mithilfe des SDK und anschließendes Anzeigen des Anzeigeninhalts in Ihrer App

Auf dieser Seite erfahren Sie, wie Sie mit dem SDK native Anzeigen.

Vorbereitung

• Arbeiten Sie den Startleitfaden durch.

Immer mit Testanzeigen testen

Verwenden Sie beim Entwickeln und Testen Ihrer Apps nur Testanzeigen, Live-Produktionsanzeigen.

Die einfachste Methode zum Laden von Testanzeigen ist die Verwendung unserer speziellen Test-Anzeigenblock-ID für native Anzeigen auf iOS-Geräten:

/6499/example/native

Sie ist speziell so konfiguriert, dass bei jeder Anfrage Testanzeigen zurückgegeben werden. beim Programmieren, Testen und Debuggen in Ihren eigenen Apps verwenden. Achten Sie nur darauf, Ersetzen Sie sie vor dem Veröffentlichen Ihrer App durch Ihre Anzeigenblock-ID.

Weitere Informationen zur Funktionsweise von Testanzeigen des Google Mobile Ads SDK finden Sie unter Testen Sie Anzeigen.

Anzeigen laden

Native Anzeigen werden mit dem GADAdLoader -Klasse, die Nachrichten an ihre Bevollmächtigten gemäß den GADAdLoaderDelegate Protokoll.

Neben dem systemdefinierten nativen Format können Sie eigene benutzerdefinierte native Anzeigenformate die für direkt verkaufte native Anzeigen verwendet werden können. Mit benutzerdefinierten nativen Anzeigenformaten Beliebige strukturierte Daten an Ihre App übergeben. Diese Anzeigen werden durch das Klasse GADCustomNativeAd.

Ad Loader initialisieren

Bevor Sie eine Anzeige laden können, müssen Sie das Ad Loader initialisieren. Der folgende Code zeigt, wie ein GADAdLoader initialisiert wird:

adLoader = GADAdLoader(adUnitID: "/6499/example/native",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/6499/example/native"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

Sie benötigen eine Anzeigenblock-ID (Sie können die Test-ID verwenden), Konstanten zur Übergabe der adTypes-Array, um anzugeben, welche nativen Formate Sie anfordern möchten, sowie alle Optionen, die Sie im options-Parameter festlegen möchten. Die Liste der möglichen Die Werte für den Parameter options finden Sie unter Native Anzeige einrichten Seite „Optionen“.

Das Array adTypes sollte Mindestens eine der folgenden Konstanten :

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

Ad Loader-Delegate implementieren

Der Ad Loader-Delegaten muss für Ihren Anzeigentyp spezifische Protokolle implementieren. Bei nativen Anzeigen GADNativeAdLoaderDelegate-Protokoll eine Nachricht, die an den wenn eine native Anzeige geladen wurde.

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

Das Protokoll GADCustomNativeAdLoaderDelegate enthält eine Nachricht, die an Delegiert, wenn eine benutzerdefinierte Vorlagenanzeige geladen wurde.

func adLoader(_ adLoader: GADAdLoader,
  Receive customNativeAd: GADCustomNativeAd)

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;

Anzeigenanfrage senden

Sobald Ihr GADAdLoader initialisiert ist, rufen Sie seine loadRequest:-Methode auf Anzeige anfordern:

adLoader.load(GAMRequest())

[self.adLoader loadRequest:[GAMRequest request]];

Die loadRequest: Methode in GADAdLoader akzeptiert dieselben GAMRequest Objekte als Banner und Interstitials. Sie können Anfrageobjekte verwenden, um Ausrichtungsinformationen, genau wie Sie wie bei anderen Anzeigentypen.

Abschluss des Ladevorgangs ermitteln

Nachdem eine Anwendung loadRequest: aufgerufen hat, kann sie die Ergebnisse der Anfrage mithilfe von Aufrufe an:

• adLoader:didFailToReceiveAdWithError: in GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: in GADNativeAdLoaderDelegate

Eine Anfrage für eine einzelne Anzeige führt zu einem Aufruf einer dieser Methoden.

Fehlgeschlagene Anfragen verarbeiten

Die oben genannten Protokolle erweitern das GADAdLoaderDelegate-Protokoll, das ein die gesendet wird, wenn Anzeigen nicht geladen werden.

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

Benachrichtigungen zu nativen Anzeigenereignissen erhalten

Legen Sie den Bevollmächtigten fest, um über Ereignisse im Zusammenhang mit den Interaktionen mit nativen Anzeigen informiert zu werden. Eigenschaft der nativen Anzeige:

nativeAd.delegate = self

nativeAd.delegate = self;

Implementieren Sie dann GADNativeAdDelegate um die folgenden Delegiertenaufrufe zu erhalten:

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Best Practices

Halten Sie sich beim Laden von Anzeigen an die folgenden Regeln.

• Apps, in denen native Anzeigen in einer Liste verwendet werden, sollten die Liste der Anzeigen vorab im Cache speichern.

• Wenn Sie Anzeigen vorab im Cache speichern, leeren Sie Ihren Cache und laden Sie ihn nach einer Stunde neu.

• loadRequest: bis zur vorherigen Anfrage für GADAdLoader nicht noch einmal aufrufen geladen wird, wie durch adLoaderDidFinishLoading: angegeben.

Anzeige schalten

Nachdem Sie eine Anzeige geladen haben, müssen Sie sie nur noch für die Nutzer schalten. Dann sehen Sie sich unsere erweiterten nativen Anzeigen , um zu erfahren, wie das geht.