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 Nend der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Nend-SDK und den Adapter in eine Unity-App einbinden.
Die Dashboard-Oberfläche für Nend verwendet für seine Beschriftungen, Schaltflächen und Beschreibungen japanischer Text. Die unten angezeigten Screenshots wurden nicht übersetzt. In diesem Leitfaden werden Labels und Schaltflächen jedoch mit ihren englischen Namen bezeichnet. "URL 인キーム" zum Beispiel ist "URL-Schema" und so weiter.
Unterstützte Integrationen und Anzeigenformate
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar |
Voraussetzungen
- Unity 4 oder höher
- Das aktuelle Google Mobile Ads SDK
- Für die Bereitstellung unter Android
- Android API-Level 19 oder höher
- Für die Bereitstellung unter iOS
- iOS-Bereitstellungsziel 12.0 oder höher
- Ein funktionierendes Unity-Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde. Weitere Informationen finden Sie unter Erste Schritte.
- 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.
Banner
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 AdMob 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 AdMob 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
Laden Sie über den Downloadlink im Änderungsprotokoll die neueste Version des Vermittlungs-Plug-ins für Google Mobile Ads für nend herunter und extrahieren Sie das GoogleMobileAdsNendMediation.unitypackage
-Paket aus der Datei zip
.
Wählen Sie im Unity-Projekteditor Assets > Paket importieren > Benutzerdefiniertes Paket aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsNendMediation.unitypackage
. Prüfen Sie, ob alle Dateien ausgewählt sind, und klicken Sie auf Importieren.
Wählen Sie dann Assets > Play Services Resolver > Android Resolver > Force Resolver aus. Die Unity Play Services Resolver-Bibliothek führt die Abhängigkeitsauflösung von Grund auf durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android
Ihrer Unity-Anwendung.
Schritt 4: Erforderlichen Code hinzufügen
Android
Für die Nend-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation von Nend, um die SKAdNetwork-IDs in die Datei Info.plist
Ihres Projekts einzufügen.
Schritt 5: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob. 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.
Fehlercodes
Wenn der Adapter keine Anzeige von Nend empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo
in den folgenden Klassen prüfen:
Android
com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter
iOS
GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend
Im Folgenden sind die Codes und Begleitmeldungen aufgeführt, die vom End-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
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 AdMob 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. |
iOS
Fehlercode | Domain | Grund |
---|---|---|
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 AdMob 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 des Unity-Mediation-Plug-ins
Version 8.0.0
- Unterstützt nend Android-Adapterversion 10.0.0.0.
- Unterstützt nend iOS Adapter Version 8.2.0.0.
- Das Unity-Plug-in wurde in Version 8.6.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 7.0.0
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/Nend/
verschoben. - Adapter-Namespace zur Verwendung von
GoogleMobileAds.Mediation.Nend
überarbeitet. - Unterstützt nend Android-Adapterversion 9.0.1.0.
- Unterstützt nend iOS-Adapterversion 8.0.1.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 8.1.0, entwickelt und getestet.
Version 6.0.1
- Unterstützt nend Android-Adapterversion 9.0.0.0.
- Unterstützt iOS-Adapterversion 7.4.0.1.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.4.1, entwickelt und getestet.
Version 6.0.0
- Unterstützt nend Android-Adapterversion 9.0.0.0.
- Unterstützt nend iOS Adapter Version 7.4.0.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.2.0, entwickelt und getestet.
Version 5.2.0
- Unterstützt nend Android-Adapterversion 8.1.0.1.
- Unterstützt nend iOS Adapter Version 7.3.0.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.2. entwickelt und getestet.
Version 5.1.0
- Unterstützt nend Android-Adapterversion 8.1.0.0.
- Unterstützt nend iOS Adapter Version 7.2.0.0.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.0, entwickelt und getestet.
Version 5.0.0
- Unterstützt nend Android-Adapterversion 8.0.1.0.
- Unterstützt iOS-Adapterversion 7.1.0.0.
Version 4.0.1
- Unterstützt nend Android-Adapterversion 7.0.3.0.
- Unterstützt iOS-Adapterversion 7.0.5.0.
Version 4.0.0
- Unterstützt nend Android-Adapterversion 7.0.0.0.
- Unterstützt nend iOS Adapter Version 7.0.0.0.
Version 3.0.0
- Unterstützt nend Android-Adapterversion 6.0.1.0.
- Unterstützt nend iOS Adapter Version 6.0.1.0.
Version 2.3.0
- Unterstützt nend Android-Adapterversion 5.4.2.0.
- Unterstützt nend iOS Adapter Version 5.4.1.0.
Version 2.2.0
- Unterstützt nend Android-Adapterversion 5.3.0.0.
- Unterstützt nend iOS Adapter Version 5.3.0.0.
Version 2.1.0
- Das Plug-in wurde aktualisiert, um die neue Reward API zu unterstützen.
- Unterstützt Android-Adapterversion 5.1.0.2.
- Unterstützt nend iOS Adapter Version 5.1.1.0.
Version 2.0.3
- Unterstützt Android-Adapterversion 5.0.2.1.
- Unterstützt End-iOS-Adapterversion 5.0.2.0.
Version 2.0.2
- Unterstützt Android-Adapterversion 5.0.2.0.
- Unterstützt End-iOS-Adapterversion 5.0.2.0.
Version 2.0.1
- Unterstützt Android-Adapterversion 5.0.2.0.
- Unterstützt End-iOS-Adapterversion 5.0.1.0.
Version 2.0.0
- Unterstützt Android-Adapterversion 5.0.0.0.
- Unterstützt End-iOS-Adapterversion 5.0.0.0.
Version 1.0.2
- Unterstützt Android-Adapterversion 4.0.5.0.
- Unterstützt End-iOS-Adapterversion 4.0.6.0.
Version 1.0.1
- Unterstützt Nend Android SDK Version 4.0.4.
- Unterstützt Nend iOS SDK Version 4.0.4.
Version 1.0.0
- Erste Version!
- Unterstützt Nend Android SDK Version 4.0.2.
- Unterstützt Nend iOS SDK Version 4.0.2.