Dieser Leitfaden richtet sich an Publisher, die das Google Mobile Ads SDK verwenden möchten, um Anzeigen über Unity-Anzeigen über die Vermittlung zu laden und einzublenden. Sie erfahren, wie Sie Unity-Anzeigen zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen, die Werbenetzwerkoptimierung (ANO), dieeinrichten und das Unity Ads SDK sowie den Adapter in eineAndroid App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der AdMob Vermittlungsadapter für Unity-Anzeigen hat folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Nativ |
Voraussetzungen
- Android API-Level 16 oder höher
- Neuestes Google Mobile Ads SDK
Schritt 1: Unity-Anzeigen einrichten
Registrieren Sie sich in Unity Ads oder melden Sie sich in diesem an.
Wechseln Sie im Unity Ads-Dashboard zum Tab Projekt und klicken Sie auf die Schaltfläche Neues Projekt.
Wenn Sie Ihr Projekt in das Unity-Dashboard einfügen möchten, füllen Sie das Formular aus und klicken Sie unten auf der Seite auf Projekt hinzufügen.
Rufe nach der Erstellung des Projekts den Tab Monetarisierung &Placements auf und notiere die Spiel-ID.
Wenn Sie ein neues Placement erstellen möchten, klicken Sie auf die Schaltfläche Placement hinzufügen.
Falls Sie weitere Informationen zum Erstellen eines Anzeigen-Placements benötigen, wählen Sie den entsprechenden Tab aus.
Banner
Geben Sie die gewünschte Placement-ID ein, wählen Sie als Banner Banner aus und klicken Sie auf Placement erstellen.
Interstitial
Geben Sie die gewünschte Placement-ID ein, wählen Sie als Anzeigenformat Interstitial-Video aus und klicken Sie auf Placement erstellen.
Verfügbar
Geben Sie die gewünschte Placement-ID ein, wählen Sie Anzeigen mit Prämie als Anzeigenformat aus und klicken Sie auf Placement erstellen.
Neben der Spiel-ID und der Placement-ID benötigen Sie auch den API-Schlüssel und die Core-ID der Organisation, um die Anzeigenblock-IDAdMob einzurichten.
Rufen Sie im Unity Ads-Dashboard den Tab Ads Datenexport &API-Zugriff auf und notieren Sie sich den API-Zugriffsschlüssel für die Monetarisierungsstatistik.
Wechseln Sie dann im Unity Ads-Dashboard zum Tab Settings (Einstellungen) und notieren Sie sich die Core-ID der Organisation.
Schritt 2: Vermittlungseinstellungen für den AdMob Anzeigenblock konfigurieren
Sie müssen der Vermittlungskonfiguration des Anzeigenblocks Unity-Anzeigen hinzufügen. Melden Sie sich in Ihrem AdMob-Konto an.
Rufen Sie dann den Tab Vermittlung auf. Wenn Sie eine Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten. Fahren Sie dann mit der Anleitung Unity-Anzeigen als Anzeigenquelle hinzufügen fort.
Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Vermittlungsgruppe erstellen aus.
Geben Sie ein Anzeigenformat und eine Plattform ein und klicken Sie auf Weiter.
Geben Sie einen Namen für die Vermittlungsgruppe ein und wählen Sie Standorte für die Ausrichtung aus. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest. Klicken Sie dann auf Anzeigenblöcke hinzufügen, um das Overlay zur Auswahl des Anzeigenblocks zu öffnen.
Verknüpfen Sie diese Vermittlungsgruppe mit Ihrem bestehenden AdMob-Anzeigenblock. Klicken Sie dann auf Fertig.
Die Karte „Anzeigenblöcke“ sollte jetzt mit den von Ihnen ausgewählten Anzeigenblöcken ausgefüllt sein.
Unity-Anzeigen als Anzeigenquelle hinzufügen
Wählen Sie auf der Karte Anzeigenquellen die Option Werbenetzwerk hinzufügen aus. Wählen Sie dann Unity Ads aus.
Aktivieren Sie den Schieberegler Optimize. Geben Sie Ihren API-Schlüssel und die Core-ID Ihrer Organisation ein, die Sie im vorherigen Abschnitt erhalten haben, um ANO für Unity-Anzeigen einzurichten. Geben Sie dann einen eCPM-Wert für Unity-Anzeigen ein und klicken Sie auf Weiter.
Geben Sie dann die Spiel-ID und die Placement-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie anschließend auf Fertig.
Klicken Sie abschließend auf Speichern.
Anzeigen mit Prämie verwenden
Geben Sie in den Einstellungen für Ihren Anzeigenblock für Anzeigen mit Prämie Werte für den Prämienbetrag und Prämientyp an. Klicken Sie dann auf das Kästchen Auf alle Netzwerke in Vermittlungsgruppen anwenden, damit die Nutzer unabhängig von ihrem Werbenetzwerk dieselben Prämien erhalten.
Wenn Sie diese Einstellung nicht anwenden, wird der Unity-Adapter standardmäßig auf eine Prämie des Typs ""
(leerer String) mit dem Wert 1
eingestellt. Das Unity Ads SDK bietet für Anzeigen mit Prämie keine spezifischen Prämienwerte.
Schritt 3: Unity Ads SDK und Adapter importieren
Integration von Android Studio (empfohlen)
Fügen Sie die folgenden Gradle-Abhängigkeiten mit den neuesten Versionen des Unity Ads SDK und Adapters in der Datei build.gradle
auf App-Ebene hinzu:
repositories { google() mavenCentral() } ... dependencies { implementation 'com.google.android.gms:play-services-ads:20.6.0' implementation 'com.unity3d.ads:unity-ads:4.1.0' implementation 'com.google.ads.mediation:unity:4.1.0.0' } ...
Manuelle Integration
Laden Sie das neueste Unity Ads SDK (
unity-ads.aar
) aus seinem GitHub-Repository herunter und fügen Sie es Ihrem Projekt hinzu.Rufen Sie im Maven-Repository von Google die Unity Ads-Adapterartefakte auf. Wählen Sie die neueste Version aus, laden Sie die
.aar
-Datei von Unity Ads-Adapter herunter und fügen Sie sie Ihrem Projekt hinzu.
Schritt 4: Zusätzlicher Code erforderlich
Für die Einbindung von Unity-Anzeigen ist kein zusätzlicher Code erforderlich.
Schritt 5: Implementierung testen
Es gibt zwei Möglichkeiten, Testanzeigen über das Unity Ads-Dashboard zu aktivieren.
Wenn Sie Testanzeigen für alle Geräte aktivieren möchten, rufen Sie den Tab Einstellungen &Projekteinstellungen Ihres Projekts auf. Bearbeiten Sie im Abschnitt Testmodus den Abschnitt Clienttestmodus nicht überschrieben, klicken Sie auf das Kästchen Clienttestmodus überschreiben, wählen Sie Testmodus aktivieren aus und klicken Sie auf Speichern.

Wenn Sie Testanzeigen nur für bestimmte Geräte aktivieren möchten, rufen Sie den Tab Ads Datenexport &Testgeräte auf. Klicken Sie im Abschnitt Testgeräte auf die Schaltfläche Neues Gerät hinzufügen und füllen Sie das entsprechende Formular aus.
Optionale Schritte
EU-Nutzereinwilligung und DSGVO
Gemäß der Richtlinie zur EU-Nutzereinwilligung von Google müssen Sie gewährleisten, dass Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen in Bezug auf die Verwendung von Gerätekennungen und personenbezogenen Daten offengelegt werden und Einwilligungen dieser Nutzer einholen. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Wenn Sie eine Einwilligung einholen, müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das personenbezogene Daten erfassen, empfangen oder verwenden kann. Außerdem müssen Sie Informationen zur Verwendung der Netzwerke angeben. Google kann die Einwilligungseinstellung des Nutzers derzeit nicht automatisch an diese Netzwerke weitergeben.
Folgen Sie der Anleitung unten, um personalisierte Anzeigen für Unity-Anzeigen zu aktivieren oder zu deaktivieren.
Unity Ads stellt einen Leitfaden zur Einhaltung der DSGVO bereit, in dem sowohl automatische als auch manuelle Lösungen zur Nutzereinwilligung beschrieben werden.
Im folgenden Beispielcode sehen Sie, wie Sie Einwilligungsinformationen manuell an das Unity Ads SDK übergeben. Wenn Sie Einwilligungsinformationen manuell an das Unity Ads SDK übergeben möchten, sollten Sie diesen Code aufrufen, bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
Fehlercodes
Wenn der Adapter eine Anzeige von Unity-Anzeigen nicht erhält, können Publisher den zugrunde liegenden Fehler in der Anzeigenantwort mit
ResponseInfo.getAdapterResponse()
unter folgenden Klassen prüfen:
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
Im Folgenden sehen Sie die Codes und zugehörige Mitteilungen, die vom UnityAds-Adapter gesendet werden, wenn eine Anzeige nicht geladen werden kann:
Fehlercode | Grund |
---|---|
0-10 | Das UnityAds-SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code. |
101 | Die in der AdMob Benutzeroberfläche konfigurierten Server von UnityAds fehlen oder sind ungültig. |
102 | UnityAds hat ein Placement mit dem Status NO_FILL zurückgegeben. |
103 | UnityAds hat ein Placement mit dem Status DISABLED zurückgegeben. |
104 | UnityAds hat versucht, eine Anzeige ohne Kontext zu präsentieren. |
105 | Der Kontext, der zum Initialisieren, Laden und/oder Ausliefern von Anzeigen aus Unity-Anzeigen verwendet wird, ist keine Aktivitätsinstanz. |
106 | UnityAds hat versucht, eine Anzeige zu präsentieren, die noch nicht zu sehen ist. |
107 | UnityAds wird auf dem Gerät nicht unterstützt. |
108 | UnityAds kann nur eine Anzeige pro Placement laden. |
109 | UnityAds wurde mit dem Status ERROR abgeschlossen. |
200-204 | Fehler mit UnityAds-Banner. Weitere Informationen findest du unter Code. |
0-9 | Das UnityAds-SDK hat einen Fehler zurückgegeben. Weitere Informationen findest du in der Dokumentation von Unity. |
101 | Die in der AdMob Benutzeroberfläche konfigurierten Server von UnityAds fehlen oder sind ungültig. |
102 | Gerät wird von UnityAds nicht unterstützt. |
103 | UnityAds-Präsentation mit dem Fehlerstatus „kUnityAdsFinishStateError“ beendet. |
104 | Das Unity-Anzeigenobjekt ist nach dem Aufrufen seines Initialisers null. |
105 | Unity-Anzeigen konnten nicht ausgeliefert werden, weil die Anzeige nicht bereit ist. |
106 | UnityAds, ein sogenanntes Placement, hat einen Callback mit dem Placement-Status „kUnityAdsPlacementStateNoFill“ geändert. |
107 | UnityAds, ein sogenanntes Placement, hat einen Callback mit dem Placement-Status „kUnityAdsPlacementStateDisabled“ geändert. |
108 | Für dieses Placement wurde bereits eine Anzeige geladen. Das UnityAds SDK unterstützt nicht das Laden mehrerer Anzeigen für dasselbe Placement. |
Änderungsprotokoll für den Android Mediation-Adapter von Unity Ads
Version 4.2.1.0 (In Bearbeitung)
- Verifizierter Kompatibilität mit Unity Ads SDK 4.2.1
Entwickelt und getestet mit:
- Version 20.6.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 4.2.1
Version 4.1.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 4.1.0
Entwickelt und getestet mit:
- Version 20.6.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 4.1.0
Version 4.0.1.0
- Verifizierter Kompatibilität mit Unity Ads SDK 4.0.1
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 20.6.0 aktualisiert.
Entwickelt und getestet mit:
- Version 20.6.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 4.0.1
Version 4.0.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 4.0.0
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 20.5.0 aktualisiert.
Entwickelt und getestet mit:
- Version 20.5.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 4.0.0.
Version 3.7.5.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.7.5
Entwickelt und getestet mit:
- Version 20.2.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.7.5
Version 3.7.4.0
- Verifizierter Kompatibilität mit Unity Ads SDK 3.7.4
Entwickelt und getestet mit:
- Version 20.2.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.7.4
Version 3.7.2.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.7.2.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 20.2.0 aktualisiert.
Entwickelt und getestet mit:
- Version 20.2.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.7.2
Version 3.7.1.0
- Verifizierter Kompatibilität mit Unity Ads SDK 3.7.1
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 20.1.0 aktualisiert.
Entwickelt und getestet mit:
- Version 20.1.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.7.1
Version 3.6.2.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.6.2.
- Anzeigen mit Prämie brachten keine Klick-Callbacks weiter. Dieses Problem wurde behoben.
- Das UnityAds-SDK wurde aus dem gebündelten Adapter-Build entfernt. Publisher müssen das UnityAds SDK jetzt manuell als zusätzliche Abhängigkeit einfügen.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.8.0 aktualisiert.
Entwickelt und getestet mit:
- Version 19.8.0 des Google Mobile Ads SDKs.
- Unity Ads SDK-Version 3.6.2.
Version 3.6.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 3.6.0.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.6.0 aktualisiert.
Entwickelt und getestet mit:
- Version 19.6.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.6.0
Version 3.5.1.1
- Bei Anfragen für mehrere Interstitial-Anzeigen und Anzeigen mit Prämie wurde ein Problem behoben.
Entwickelt und getestet mit:
- Version 19.5.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.5.1
Version 3.5.1.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.5.1.
- Smart-Banner-Anfragen schlugen fehl. Dieses Problem wurde behoben.
Entwickelt und getestet mit:
- Version 19.5.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.5.1
Version 3.5.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 3.5.0.
- Adaptive Banner werden jetzt unterstützt.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.5.0 aktualisiert.
Entwickelt und getestet mit:
- Version 19.5.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.5.0
Version 3.4.8.0
- Ein
NullPointerException
-Fehler wurde behoben, der beim Löschen einer Banneranzeige auftrat. - Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.3.0 aktualisiert.
Entwickelt und getestet mit:
- Version 19.3.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.4.8
Version 3.4.6.1
- Es wurde ein Adapter-Build erstellt, der das enthaltene Unity Ads SDK nicht enthält.
Publisher haben dann die Möglichkeit, bei der Vermittlung an Unity die Dienste von Unity zu verwenden, um Konflikte mit Konflikten zu vermeiden.
- Publisher können diese Option verwenden, indem sie die
com.google.ads.mediation:unity-adapter-only:x.y.z.p
-Abhängigkeit in die Dateibuild.gradle
auf App-Ebene aufnehmen.
- Publisher können diese Option verwenden, indem sie die
Entwickelt und getestet mit:
- Version 19.1.0 des Google Mobile Ads SDKs.
- Unity Ads SDK-Version 3.4.6.
Version 3.4.6.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.4.6.
- Der Adapter leitet jetzt den Callback
onAdOpened()
weiter, wenn auf eine Banneranzeige geklickt wird.
Entwickelt und getestet mit:
- Version 19.1.0 des Google Mobile Ads SDKs.
- Unity Ads SDK-Version 3.4.6.
Version 3.4.2.3
- Wir haben beschreibende Fehlercodes und Gründe für das Laden des Adapters/die Sendung hinzugefügt.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.1.0 aktualisiert.
Entwickelt und getestet mit:
- Version 19.1.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.4.2
Version 3.4.2.2
- Ein Absturz von
ConcurrentModificationException
, der auftrat, wenn bei Unity Ads ein Fehler zurückgegeben wurde, wurde behoben.
Entwickelt und getestet mit:
- Version 19.0.1 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.4.2
Version 3.4.2.1
- Die Weiterleitung von Unity-Fehlern wurde verbessert, um Initialisierung und Fehler beim Laden der Anzeige früher zu erkennen und Zeitüberschreitungen zu reduzieren.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.0.1 aktualisiert.
Entwickelt und getestet mit:
- Version 19.0.1 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.4.2
Version 3.4.2.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.4.2.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 18.3.0 aktualisiert.
Entwickelt und getestet mit:
- Version 18.3.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.4.2
Version 3.4.0.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.4.0.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 18.3.0 aktualisiert.
Entwickelt und getestet mit:
- Version 18.3.0 des Google Mobile Ads SDKs.
- Unity Ads SDK Version 3.4.0.
Version 3.3.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 3.3.0.
Entwickelt und getestet mit:
- Version 18.2.0 des Google Mobile Ads SDKs.
- Unity Ads SDK 3.3.0.
Version 3.2.0.1
- Ein Ausnahmefehler, der beim Aufrufen von
loadAd()
vor dem Aufruf vonUnityAds.initialize()
aufgetreten ist, wurde behoben. - Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 18.2.0 aktualisiert.
Version 3.2.0.0
- Banneranzeigenanfragen konnten nicht ausgeführt werden. Dieses Problem wurde behoben.
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.2.0.
- Der Adapter wurde zu AndroidX migriert.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 18.1.1 aktualisiert.
Version 3.1.0.0
- Unterstützung für flexible Banneranzeigengrößen
- Der Adapter schlägt die Anzeigenanfrage fehl, wenn die angeforderte Größe nicht mit Unity Ads-Bannergrößen kompatibel ist
- Verifizierter Kompatibilität mit Unity Ads SDK 3.1.0.
Version 3.0.1.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 3.0.1.
- Ein Programmfehler, der beim Ausliefern einer Interstitial-Anzeige 'NPE'
Version 3.0.0.2
- Aktualisierter Adapter für die neue Open-Beta-API für Anzeigen mit Prämie.
- Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf 17.2.0 aktualisiert.
Version 3.0.0.1
- Unity-Banner werden jetzt unterstützt.
Version 3.0.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 3.0.0.
Version 2.3.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 2.3.0.
Version 2.2.1.1
- Der Adapter wurde aktualisiert, um das Anzeigenereignis
onRewardedVideoComplete()
aufzurufen.
Version 2.2.1.0
- Verifizierter Kompatibilität mit Unity Ads SDK 2.2.1
Version 2.2.0.0
- Verifizierter Kompatibilität mit Unity Ads SDK 2.2.0.
Version 2.1.2.0
- Bestätigte Kompatibilität mit dem Unity Ads SDK 2.1.2.
Version 2.1.1.0
- Verifizierter Kompatibilität mit Unity Ads SDK 2.1.1
Version 2.1.0.0
- Der Adapter wurde aktualisiert, damit er mit dem Unity Ads SDK 2.1.0 kompatibel ist.
Version 2.0.8.0
- Verifizierter Kompatibilität mit Unity Ads SDK 2.0.8.
Version 2.0.7.0
- Verwendung von Klickberichten von Unity-Anzeigen. Die Klickstatistiken von AdMob und Unity werden übereinstimmen.
- OnAdApplication-Callback-Unterstützung wurde hinzugefügt.
Version 2.0.6.0
- Verifizierter Kompatibilität mit Unity Ads SDK 2.0.6
Version 2.0.5.0
- Die Adapter können jetzt als Compiler-Abhängigkeit hinzugefügt werden. Dazu fügen Sie der Datei „build.gradle“ Folgendes hinzu:
compile 'com.google.ads.mediation:unity:2.0.5.0'
- Der Adapter wurde als aar-Datei anstelle einer JAR-Datei bereitgestellt. Weitere Informationen finden Sie in der README-Datei.
Version 2.0.4.0
- Ein Programmfehler wurde behoben, durch den Videoanzeigen mit Prämie beim Laden einer Interstitial-Anzeige zuerst nicht geladen wurden.
Version 2.0.2.0
- Das Versionsbenennungssystem wurde zu [Unity Ads SDK].[adapter Patch version] geändert.
- Das erforderliche Unity Ads SDK wurde auf Version 2.0.2 aktualisiert.
- Das erforderliche Google Mobile Ads SDK wurde auf Version 9.0.0 aktualisiert.
- Zum Aufrufen von UnityAds.changeActivity(this) sind keine Apps mehr erforderlich.
Version 1.0.0
- Erste Version Unterstützt Videoanzeigen mit Prämie und Interstitial-Anzeigen.