nend in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen mithilfe der Vermittlung über die Vermittlungsabfolge zu laden und einzublenden. Sie erfahren, wie Sie der Vermittlungskonfiguration eines Anzeigenblocks Nend hinzufügen und das Nend SDK und den Adapter in eine App einbinden.

Die Dashboard-Oberfläche für Nend verwendet für ihre Beschriftungen, Schaltflächen und Beschreibungen japanischer Text. Die unten angezeigten Screenshots wurden nicht übersetzt. In diesem Leitfaden werden die Beschriftungen und Schaltflächen mit ihren englischen Entsprechungen bezeichnet. "URL 인キーム" zum Beispiel ist "URL-Schema" und so weiter.

Unterstützte Integrationen und Anzeigenformate

Der Ad Manager -Vermittlungsadapter für Nend hat folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Nativ

Voraussetzungen

  • iOS-Bereitstellungsziel 12.0 oder höher

  • Das aktuelle Google Mobile Ads SDK

  • Arbeiten Sie den Startleitfaden zur Vermittlung ab.

Schritt 1: Konfigurationen in der Nend-Benutzeroberfläche einrichten

Registriere dich oder melde dich in deinem Google End-Konto an.

Klicken Sie zum Hinzufügen Ihrer Anwendung zum Nend-Dashboard zuerst auf den Tab Placement-Verwaltung und wählen Sie Website/App aus. Klicken Sie auf die Schaltfläche App hinzufügen, um Ihre Anwendung hinzuzufügen.

Anwendung erstellen

Geben Sie den Namen Ihrer App ein und wählen Sie als Anwendungstyp Ihre App-Plattform aus. Geben Sie die URL ein und prüfen Sie, ob Ihre Anwendung im entsprechenden App-Shop aufgeführt ist

Falls Ihre App noch nicht veröffentlicht wurde, finden Sie weitere Informationen unter Häufig gestellte Fragen zu unveröffentlichten Apps von nend. Wählen Sie eine Kategorie für Ihre App aus und klicken Sie abschließend auf Erstellen.

Android

iOS

Ihre Anwendung wird auf dem Dashboard angezeigt, sobald sie erstellt ist.

Android

iOS

Placement erstellen

Sobald die App registriert ist, können Sie mit dem Erstellen eines Placements fortfahren. Um ein Placement für Banneranzeigen zu erstellen, rufen Sie den Tab Placement-Verwaltung auf und klicken Sie auf Placement. Klicken Sie dann auf die Schaltfläche Neues Placement erstellen.

Wählen Sie Ihre App im Drop-down-Menü aus. Folgen Sie anschließend der Anleitung für Ihr bevorzugtes Anzeigenformat.

Wählen Sie als Anzeigentyp die Option Standbild und als Inventartyp Banner aus. Geben Sie danach einen Placement-Namen ein, füllen Sie die Einführung in das Inventar aus, wählen Sie ein Inventarformat und schließlich eine Inventargröße aus. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Erstellen, um Ihr Placement zu erstellen.

Interstitial

Wählen Sie als Anzeigentyp die Option Standbild und als Inventartyp Interstitial aus. Geben Sie anschließend einen Placement-Namen ein, füllen Sie die Einführung in das Inventar aus und wählen Sie in der Drop-down-Liste eine Häufigkeit der Anzeigenauslieferung aus. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Erstellen, um Ihr Placement zu erstellen.

Wählen Sie für Interstitial-Videoanzeigen den Anzeigentyp Video und als Inventartyp Interstitial aus. Geben Sie anschließend einen Placement-Namen ein, füllen Sie die Einführung in das Inventar aus und wählen Sie eine geeignete Kategorie aus der Drop-down-Liste aus. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Erstellen, um Ihr Placement zu erstellen.

Verfügbar

Wählen Sie als Anzeigentyp Video und als Inventartyp Prämie aus. Geben Sie anschließend einen Placement-Namen ein, füllen Sie die Einführung in das Inventar aus und wählen Sie eine geeignete Kategorie aus der Drop-down-Liste aus.

Wählen Sie unter Prämieneinstellungen einen Prämieninhalt aus der Drop-down-Liste aus und geben Sie den gewünschten Namen der virtuellen Währung ein. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Erstellen, um Ihr Placement zu erstellen.

Nativ

Wählen Sie als Anzeigentyp die Option Standbild und als Inventartyp Nativ aus. Geben Sie anschließend einen Placement-Namen ein, füllen Sie die Einführung in das Inventar aus und wählen Sie eine Anzeigenbildauswahl aus. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Erstellen, um Ihr Placement zu erstellen.

Wählen Sie für native Videoanzeigen als Anzeigentyp die Option Video und als Inventartyp Nativ (benutzerdefiniert) aus. Geben Sie anschließend einen Placement-Namen ein, füllen Sie die Einführung in das Inventar aus und wählen Sie eine geeignete Kategorie aus der Drop-down-Liste aus.

Wählen Sie unter Native Einstellungen in der Liste eine Ausrichtung von Videoanzeigen und einen Nativen Anzeigentyp aus. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Erstellen, um Ihr Placement zu erstellen.

Um den Anzeigenblock Ad Manager im nächsten Abschnitt einzurichten, benötigen Sie den apiKey und die spotID für jedes Placement. Rufen Sie dazu den Tab Placement-Verwaltung auf und wählen Sie unter dem Namen Ihrer App die Schaltfläche SDK aus.

Notieren Sie sich den apiKey und die spotID.

Sie benötigen außerdem Ihren API-Schlüssel für die Reporting API von Nend, die als API-Schlüssel zum Scraping bezeichnet wird. Sie finden dieses Tool auf dem Tab Tools.

Schritt 2: Nend-Nachfrage auf der Ad Manager Benutzeroberfläche einrichten

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

Android

Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.

iOS

Eine Anleitung dazu finden Sie in Schritt 2 der Anleitung für iOS.

Schritt 3: Nend SDK und Adapter importieren

  • Fügen Sie der Podfile-Datei Ihres Projekts die folgende Zeile hinzu:

    pod 'GoogleMobileAdsMediationNend'

  • Führen Sie über die Befehlszeile folgenden Befehl aus:

    pod install --repo-update

Manuelle Integration

Laden Sie die neueste Version des nend iOS SDK herunter und verknüpfen Sie nendSDK.framework in Ihrem Projekt. Laden Sie den aktuellen Nend-Adapter über den Download-Link im Änderungsprotokoll herunter und verknüpfen Sie NendAdapter.framework in Ihrem Projekt.

Fügen Sie Ihrem Projekt die folgenden Frameworks hinzu:

  • AdSupport.framework
  • Security.framework
  • ImageIO.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • SystemConfiguration.framework
  • WebKit.framework

Durch Hinzufügen der folgenden Frameworks können Sie außerdem detaillierte Informationen für die Anzeigenauslieferung verwenden.

  • CoreLocation.framework
  • CoreMotion.framework
  • CoreTelephony.framework

Schritt 5: Erforderlichen Code hinzufügen

Für die Nend-Integration ist kein zusätzlicher Code erforderlich.

SKAdNetwork-Integration

Folgen Sie der Nend-Dokumentation, um die SKAdNetwork-IDs in die Datei Info.plist Ihres Projekts einzufügen.

Projekteinstellungen

Fügen Sie das Flag -ObjC zu Other Linker Flags (Weitere Verknüpfungs-Flags) unter Application Target > Build Settings (Anwendungsziel > Build-Einstellungen) hinzu.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager. Um Testanzeigen für Banner, Interstitials und Anzeigen mit Prämie zu erhalten, empfiehlt es sich, die API-Schlüssel und Spot-IDs zu verwenden, die auf der Seite nend test ad unit verfügbar sind. Diese können beim Testen als API-Schlüssel und Spot-IDs für Ihre AdMob-Anzeigenblöcke eingegeben und dann durch einen tatsächlichen API-Schlüssel und eine Spot-ID ersetzt werden, wenn Ihre App für die Produktion bereit ist.

Testanzeigen überprüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen vonnenderhalten, aktivieren Sie im Anzeigenprüftool mithilfe der nend (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.

Optionale Schritte

Netzwerkspezifische Parameter

Der Nend-Adapter unterstützt zusätzliche Anfrageparameter, die mithilfe der Klasse GADMAdapterNendExtras an den Adapter übergeben werden können. Diese Klasse enthält die folgenden Attribute:

  • interstitialType: Nend bietet die Möglichkeit, entweder TypeNormal für normale Interstitial-Anzeigen oder TypeVideo für Interstitial-Videoanzeigen auszuwählen. Nend verwendet standardmäßig TypeNormal als Interstitial-Typ, wenn dieser zusätzliche Parameter nicht hinzugefügt wird.
  • nativeType: Nend bietet die Möglichkeit, entweder TypeNormal für normale native Anzeigen oder TypeVideo für native Videoanzeigen auszuwählen. Nend verwendet standardmäßig TypeNormal als nativen Anzeigentyp, wenn dieser zusätzliche Parameter nicht hinzugefügt wird.

Beispiele für die Festlegung dieser Parameter für Anzeigenanfragen:

Swift 

let request = GAMRequest()
let extras = GADMAdapterNendExtras()
extras.interstitialType = GADMAdapterNendInterstitialType.normal
extras.nativeType = GADMAdapterNendNativeType.normal
request.registerAdNetworkExtras(extras)

Objective-C 

GAMRequest *request = [GAMRequest request];
GADMAdapterNendExtras *extras = [[GADMAdapterNendExtras alloc] init];
extras.interstitialType = GADMAdapterNendInterstitialTypeNormal;
extras.nativeType = GADMAdapterNendNativeTypeNormal;
[request registerAdNetworkExtras:extras];

Native Anzeigen verwenden

Anzeigen-Rendering

Der Nend-Adapter gibt native Anzeigen als GADNativeAd Objekte zurück. Es füllt die folgenden Felder für eine GADNativeAd

Field Wird vom Nend-Adapter ausgefüllt
Anzeigentitel
Bild 1
Text
App-Symbol 2
Call-to-Action
Name des Werbetreibenden
Bewertung
Speichern
Preis

1 Nur Nend stellt ein Bild-Asset für native Placements zur Verfügung, die mit einer Anzeigenbildauswahl auf Horizontal (5: 3) großes Werbebild konfiguriert sind.

2 Nend stellt kein Symbol-Asset für native Placements bereit, die mit einer Anzeigenbildauswahl auf Kein Bild (nur Text) konfiguriert sind.

Fehlercodes

Wenn der Adapter keine Anzeige von Nend empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen:

Format Klassenname
Banner GADMAdapterNend
Interstitial GADMAdapterNend
Verfügbar GADMAdapterNendRewarded
Nativ GADMediationAdapterNend

Im Folgenden sind die Codes und Begleitmeldungen aufgeführt, die vom End-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Fehlercode Domain Grund
101 com.google.ads.mediation.nend Nend benötigt zum Laden und Einblenden von Anzeigen einen Aktivitätskontext.
102 com.google.ads.mediation.nend nend-Server-Parameter, die in der Ad Manager Benutzeroberfläche konfiguriert wurden, fehlen oder sind ungültig.
103 com.google.ads.mediation.nend Die nend-Anzeige ist noch nicht zur Schaltung bereit.
104 com.google.ads.mediation.nend die Anzeige konnte nicht wiedergegeben werden.
105 com.google.ads.mediation.nend Die angeforderte Anzeigengröße stimmt nicht mit einer von Nend unterstützten Bannergröße überein.
106 com.google.ads.mediation.nend Die Kontextobjektreferenz lautet null und/oder wurde vor Kurzem aus dem Arbeitsspeicher freigegeben.
200-299 net.nend.android nend SDK hat einen Fehler beim Laden der Interstitial-Anzeige zurückgegeben. Weitere Informationen finden Sie unter Code.
300-399 net.nend.android Das nend SDK hat einen Fehler bei der Auslieferung der Anzeige durch eine Interstitial-Anzeige zurückgegeben. Weitere Informationen finden Sie unter Code.
400-499 net.nend.android nend SDK hat einen Anzeigenfehler zurückgegeben. Weitere Informationen finden Sie unter Code.
101 com.google.mediation.nend Nend SDK hat einen Ladefehler-Callback ohne zusätzliche Fehlerinformationen zurückgegeben.
102 com.google.mediation.nend Nend SDK hat einen Callback für einen Showfehler ohne zusätzliche Fehlerinformationen zurückgegeben.
103 com.google.mediation.nend nend-Server-Parameter, die in der Ad Manager Benutzeroberfläche konfiguriert wurden, fehlen oder sind ungültig.
104 com.google.mediation.nend Die Bild-Assets für native Anzeigen konnten nicht geladen werden.
105 com.google.mediation.nend Anzeigen konnten nicht eingeblendet werden, da die Anzeige nicht bereit ist.
106 com.google.mediation.nend Die angeforderte Größe für die Banneranzeige stimmt nicht mit einer von Nend unterstützten Bannergröße überein.
200-699 Vom Nend SDK gesendet. nend SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie im Dokument von Nend.

Änderungsprotokoll für den iOS-Vermittlungsadapter

Nächste Version

  • Die eingestellte "willBackgroundApplication"-Delegatmethode wurde aus dem nativen Anzeigenladeprogramm entfernt.
  • Mindestens iOS-Version 12.0 erforderlich.
  • Erfordert jetzt Version 11.0 oder höher des Google Mobile Ads SDK.
  • Info.plist wurde in die Frameworks in NendAdapter.xcframework aufgenommen.

Version 8.2.0.0

  • Bestätigte Kompatibilität mit Nend SDK 8.2.0.

Erstellt und getestet mit:

  • Google Mobile Ads SDK: Version 10.11.0.
  • Nend SDK Version 8.2.0.

Version 8.1.0.0

  • Die Unterstützung der armv7-Architektur wurde entfernt.
  • Mindestens iOS-Version 11.0 erforderlich.
  • Erfordert jetzt Version 10.4.0 oder höher des Google Mobile Ads SDK.

Erstellt und getestet mit:

  • Google Mobile Ads SDK: Version 10.8.0
  • Nend SDK Version 8.1.0.

Version 8.0.1.0

  • Bestätigte Kompatibilität mit Nend SDK 8.0.1.

Erstellt und getestet mit:

  • Google Mobile Ads SDK: Version 10.3.0.
  • Nend SDK Version 8.0.1.

Version 8.0.0.0

  • Bestätigte Kompatibilität mit Nend SDK 8.0.0.

Erstellt und getestet mit:

  • Version 10.2.0 des Google Mobile Ads SDK
  • Nend SDK Version 8.0.0.

Version 7.4.0.1

  • Erfordert jetzt Version 10.0.0 oder höher des Google Mobile Ads SDK.

Erstellt und getestet mit:

  • Google Mobile Ads SDK: Version 10.0.0.
  • Nend SDK Version 7.4.0.

Version 7.4.0.0

  • Bestätigte Kompatibilität mit Nend SDK 7.4.0.
  • Der Adapter wurde aktualisiert, um die didRewardUser API zu verwenden.
  • Erfordert jetzt das Google Mobile Ads SDK, Version 9.8.0 oder höher.

Erstellt und getestet mit:

  • Version 9.10.0 des Google Mobile Ads SDK
  • Nend SDK Version 7.4.0.

Version 7.3.0.0

  • Bestätigte Kompatibilität mit Nend SDK 7.3.0.

Erstellt und getestet mit:

  • Google Mobile Ads SDK: Version 9.3.0.
  • Nend SDK Version 7.3.0.

Version 7.2.0.0

  • Bestätigte Kompatibilität mit Nend SDK 7.2.0.
  • Die Architektur des arm64-Simulators wird jetzt unterstützt.

Erstellt und getestet mit:

  • Version 9.1.0 des Google Mobile Ads SDK
  • Nend SDK Version 7.2.0.

Version 7.1.0.1

  • Bestätigte Kompatibilität mit Version 9.0.0 des Google Mobile Ads SDK.
  • Erfordert jetzt Version 9.0.0 oder höher des Google Mobile Ads SDK.

Erstellt und getestet mit:

  • Version 9.0.0 des Google Mobile Ads SDK.
  • Nend SDK Version 7.1.0.

Version 7.1.0.0

  • Bestätigte Kompatibilität mit Nend SDK 7.1.0.
  • Mindestens iOS-Version 10.0 erforderlich.

Erstellt und getestet mit

  • Version 8.12.0 des Google Mobile Ads SDK
  • Nend SDK Version 7.1.0.

Version 7.0.6.1

  • Der adDidRecordClick-Callback für Interstitial-Anzeigen wurde nicht weitergeleitet. Das Problem wurde behoben.

Erstellt und getestet mit

  • Version 8.9.0 des Google Mobile Ads SDK.
  • Nend SDK Version 7.0.6.

Version 7.0.6.0

  • Bestätigte Kompatibilität mit nend SDK 7.0.6.
  • Standardisierte Adapterfehlercodes und -meldungen hinzugefügt.

Erstellt und getestet mit

  • Google Mobile Ads SDK: Version 8.8.0
  • Nend SDK Version 7.0.6.

Version 7.0.5.0

  • Bestätigte Kompatibilität mit Nend SDK 7.0.5.

Erstellt und getestet mit

  • Version 8.5.0 des Google Mobile Ads SDK.
  • Nend SDK Version 7.0.5.

Version 7.0.4.0

  • Bestätigte Kompatibilität mit Nend SDK 7.0.4.
  • Einfache Abhängigkeit von Version 8.0.0 oder höher des Google Mobile Ads SDK
  • Der Adapter wurde aktualisiert, um das Format .xcframework zu verwenden.

Erstellt und getestet mit

  • Version 8.5.0 des Google Mobile Ads SDK.
  • Nend SDK Version 7.0.4.

Version 7.0.2.0

  • Bestätigte Kompatibilität mit nend SDK 7.0.2.
  • Die Medienansicht wurde manchmal an der falschen Position angezeigt. Dieses Problem wurde behoben.

Erstellt und getestet mit

  • Version 7.69.0 des Google Mobile Ads SDK
  • Nend SDK Version 7.0.2.

Version 7.0.1.0

  • Bestätigte Kompatibilität mit nend SDK 7.0.1.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 7.69.0 aktualisiert.

Erstellt und getestet mit

  • Version 7.69.0 des Google Mobile Ads SDK
  • Nend SDK Version 7.0.1.

Version 7.0.0.0

  • Bestätigte Kompatibilität mit Nend SDK 7.0.0.

Erstellt und getestet mit

  • Version 7.65.0 des Google Mobile Ads SDK
  • Nend SDK Version 7.0.0.

Version 6.0.3.0

  • Bestätigte Kompatibilität mit Nend SDK 6.0.3.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 7.65.0 aktualisiert.

Erstellt und getestet mit

  • Version 7.65.0 des Google Mobile Ads SDK
  • Nend SDK-Version 6.0.3.

Version 6.0.2.0

  • Bestätigte Kompatibilität mit Nend SDK 6.0.2.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 7.64.0 aktualisiert.

Erstellt und getestet mit

  • Version 7.64.0 des Google Mobile Ads SDK
  • Nend SDK Version 6.0.2.

Version 6.0.1.0

  • Bestätigte Kompatibilität mit Nend SDK 6.0.1.

Erstellt und getestet mit

  • Version 7.62.0 des Google Mobile Ads SDK
  • Nend SDK Version 6.0.1.

Version 6.0.0.0

  • Bestätigte Kompatibilität mit Nend SDK 6.0.0.
  • Die Klasse GADNendRewardedNetworkExtras wurde entfernt. Wenn Sie Netzwerkfunktionen an den iOS-Nend-Adapter übergeben möchten, verwenden Sie die Klasse GADMAdapterNendExtras.
  • Die folgenden Enums wurden aus der Klasse GADMAdapterNendExtras umbenannt:
    • GADMNendInterstitialType zu GADMAdapterNendInterstitialType.
    • GADMNendNativeType zu GADMAdapterNendNativeType.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 7.62.0 aktualisiert.

Erstellt und getestet mit

  • Version 7.62.0 des Google Mobile Ads SDK
  • Nend SDK-Version 6.0.0.

Version 5.4.1.0

  • Bestätigte Kompatibilität mit Nend SDK 5.4.1.
  • Native Anzeigen werden jetzt unterstützt.
  • Die Unterstützung der i386-Architektur wurde entfernt.

Erstellt und getestet mit

  • Version 7.58.0 des Google Mobile Ads SDK
  • Nend SDK Version 5.4.1.

Version 5.3.1.0

  • Bestätigte Kompatibilität mit Nend SDK 5.3.1.

Entwickeln und getestet mit

  • Version 7.52.0 des Google Mobile Ads SDK
  • Nend SDK Version 5.3.1.

Version 5.3.0.0

  • Bestätigte Kompatibilität mit Nend SDK 5.3.0.

Erstellt und getestet mit:

  • Version 7.50.0 des Google Mobile Ads SDK
  • Nend SDK Version 5.3.0.

Version 5.1.1.0

  • Der Adapter wurde aktualisiert, um die neue Prämien-API zu verwenden.
  • Erfordert jetzt das Google Mobile Ads SDK 7.42.2 oder höher.
  • Bestätigte Kompatibilität mit Nend SDK 5.1.1.
  • Die Bedingung zur Überprüfung der Bannergröße wurde geändert. Geeignete Größe für SmartBanner
    • kGADAdSizeSmartBannerPortrait
      • iPhone: 320×50
      • iPad: 728 × 90 oder 320 × 50
    • kGADAdSizeSmartBannerLandscape
      • iPad: 728 × 90 oder 320 × 50
  • Flexible Banneranzeigengrößen werden jetzt unterstützt.

Version 5.1.0.0

  • Bestätigte Kompatibilität mit Nend SDK 5.1.0.

Version 5.0.3.0

  • Bestätigte Kompatibilität mit nend SDK 5.0.3.

Version 5.0.2.0

  • Bestätigte Kompatibilität mit nend SDK 5.0.2.

Version 5.0.1.0

  • Bestätigte Kompatibilität mit nend SDK 5.0.1.

Version 5.0.0.0

  • Bestätigte Kompatibilität mit Nend SDK 5.0.0.

Version 4.0.6.0

  • Bestätigte Kompatibilität mit nend SDK 4.0.6.
  • Entfernen, um die „userFeature“-Eigenschaft festzulegen.

Version 4.0.5.0

  • Bestätigte Kompatibilität mit Nend SDK 4.0.5.

Version 4.0.4.0

  • Bestätigte Kompatibilität mit Nend SDK 4.0.4.

Version 4.0.3.0

  • Bestätigte Kompatibilität mit nend SDK 4.0.3.

Version 4.0.2.0

  • Erste Version im Open-Source-Projekt „Google Mobile Ads-Vermittlung“
  • Prämienbasierte Videoanzeigen werden jetzt unterstützt.

Vorherige Versionen

  • Unterstützt Banner- und Interstitial-Anzeigen.