In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen aus Unity Ads mithilfe der Vermittlung mit Vermittlungsabfolgen. Hier erfahren Sie, wie Sie Unity-Anzeigen Vermittlungskonfiguration und das Integrieren des Unity Ads SDK und des Adapters in eine Flutter App.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter AdMob für Unity Ads hat die folgende Funktionen:
Integration | |
---|---|
Gebote | 1 |
Wasserfall | |
Formate | |
Banner | |
Interstitial | |
Verfügbar |
Voraussetzungen
- Neuestes Google Mobile Ads SDK
- Flutter 3.7.0 oder höher
- Auf Android-Geräten bereitstellen
<ph type="x-smartling-placeholder">
- </ph>
- Android API-Level 21 oder höher
- Auf iOS-Geräten bereitstellen
<ph type="x-smartling-placeholder">
- </ph>
- iOS-Bereitstellungsziel von 12.0 oder höher
- Ein funktionierendes Flutter Projekt, das mit Google konfiguriert wurde Mobile Ads SDK. Weitere Informationen finden Sie unter Weitere Informationen
- Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der Unity Ads-Benutzeroberfläche einrichten
Registrieren Sie sich bei Unity Ads oder melden Sie sich an.
Projekt erstellen
Gehen Sie im Unity Ads-Dashboard zu Projekte und klicken Sie auf Projekt erstellen.
Füllen Sie das Formular aus und klicken Sie auf Projekt erstellen, um Ihr Projekt hinzuzufügen.
Gehe zu Monetarisierung > Jetzt starten und dann auf Jetzt starten klicken.
Wählen Sie im modalen Fenster Projekteinrichtung die Optionen I plan to use Mediation (Ich möchte die Vermittlung verwenden) und Google AdMob für Vermittlungspartner und klicken Sie auf Weiter.
Wählen Sie die Einstellungen für Werbung aus und klicken Sie auf Weiter.
Füllen Sie das Formular aus und klicken Sie auf Projekt hinzufügen.
Notieren Sie sich die Spiel-ID.
Anzeigenblock erstellen
Gehe zu Monetarisierung > Anzeigenblöcke und klicken Sie dann auf Anzeigenblock hinzufügen.
Geben Sie einen Namen für den Anzeigenblock ein und wählen Sie dann Ihre Plattform und Ihr Anzeigenformat aus.
Android
iOS
Klicken Sie abschließend auf Erstellen, um den Anzeigenblock zu speichern.
Placement hinzufügen
Gebote
Wenden Sie sich an Ihren Google Account Manager, um Bidding-Placements zu erstellen.
Wasserfall
Nachdem das Projekt erstellt wurde, gehe zu Monetarisierung > Placements: Bis Erstellen Sie ein neues Placement, klicken Sie für Ihren Anzeigenblock auf Placement hinzufügen.
Geben Sie die erforderlichen Informationen ein und klicken Sie auf Placement hinzufügen.
Notieren Sie sich die Placement-ID.
Android
iOS
Unity Ads Reporting API-Schlüssel suchen
Gebote
Dieser Schritt ist für Bidding-Integrationen nicht erforderlich.
Wasserfall
Neben der Game ID (ID des Spiels) und der Placement ID (Platzierungs-ID) benötigen Sie API-Schlüssel und Organisationskern-ID von Unity Ads zur Einrichtung der AdMob Anzeigenblock-ID.
Gehe zu Monetarisierung > Einrichtung > API-Verwaltung und beachten Sie des Monetization Stats API-Zugriffsschlüssels.
Rufe dann Monetarisierung > Organisationseinstellungen und notieren Sie sich diese Informationen. der Organisationskern-ID.
Testmodus aktivieren
Der Testmodus kann über die Unity Ads-Dashboard: Im Feld den Tab Test aus.
Sie können den Testmodus für Ihre App erzwingen, indem Sie jeweils auf die Schaltfläche „Bearbeiten“ klicken. aktivieren Sie die Option Client-Testmodus überschreiben und wählen Sie Aktivieren des Testmodus für alle Geräte erzwingen (d. h. Testanzeigen verwenden)
Android
iOS
Alternativ können Sie den Testmodus für bestimmte Geräte aktivieren, indem Sie auf das Schaltfläche Add Test Device (Testgerät hinzufügen).
Füllen Sie das Formular aus und klicken Sie auf Speichern.
Schritt 2: Unity Ads-Nachfrage in 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.
Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Unity Ads
Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Unity Ads in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.
Schritt 3: Unity Ads SDK und Adapter importieren
Integration über pub.dev
Fügen Sie die folgende Abhängigkeit mit den neuesten Versionen des
Unity Ads SDK und Adapter im
pubspec.yaml
-Datei:
dependencies:
gma_mediation_unity: ^1.0.0
Manuelle Integration
Laden Sie die aktuelle Version des Google Mobile Ads Mediation-Plug-ins für
Unity Ads,
entpacken Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner hinzu.
in Ihr Flutter-Projekt hochladen. Verweisen Sie dann auf das Plug-in in der
pubspec.yaml
-Datei durch Hinzufügen der folgenden Abhängigkeit:
dependencies:
gma_mediation_unity:
path: path/to/local/package
Schritt 4: Datenschutzeinstellungen im Unity Ads SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Google-Einwilligung der Nutzer in der EU den Richtlinien entsprechen, müssen Sie sicherstellen, dass bestimmte Personen Einwilligungen von Nutzern im Europäischen Wirtschaftsraum (EWR) bezüglich die Verwendung von Gerätekennungen und personenbezogenen Daten. Diese Richtlinie entspricht den der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung Verordnung (DSGVO) aufgeführt. Beim Einholen der Einwilligung müssen Sie jedes Werbenetzwerk angeben in Ihrer Vermittlungskette, die personenbezogene Daten erheben, erhalten oder nutzen, Informationen zur Nutzung der einzelnen Werbenetzwerke enthalten. Google kann derzeit nicht wird die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke übergeben.
Das Google Mobile Ads-Vermittlungs-Plug-in für Unity Ads
enthält die
GmaMediationUnity.setGDPRConsent()
.
. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an die
Unity Ads SDK. Wenn Sie diese Methode aufrufen,
bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
Siehe Unity-Anzeigen Privacy Consent und Data APIs und Einhaltung der DSGVO finden Sie weitere Details und die Werte, die in den einzelnen Methoden angegeben werden können.
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie den Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert dieser Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über einen gut sichtbaren "Do Not Sell My Personal"-Artikel Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Staaten Leitfaden zur Einhaltung gesetzlicher Vorschriften die Möglichkeit, eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google, aber Google kann diese Einstellung nicht auf jede Anzeige anwenden Netzwerk in Ihrer Vermittlungskette. Daher müssen Sie jedes Werbenetzwerk, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.
Das Google Mobile Ads-Vermittlungs-Plug-in für Unity Ads
enthält die
GmaMediationUnity.setCCPAConsent()
.
. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an die
Unity Ads SDK. Wenn Sie diese Methode aufrufen,
bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
Schritt 5: Erforderlichen Code hinzufügen
Android
Für Integrationen von Unity Ads-Android-Geräten ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Unity Ads folgen Dokumentation
um die SKAdNetwork-IDs zur Info.plist
-Datei Ihres Projekts hinzuzufügen.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der Unity Ads Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonUnity Adserhalten, aktivieren Sie im Anzeigenprüftool mithilfe der Unity Ads (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Fehlercodes
Wenn der Adapter keine Anzeige von Unity Ads empfängt, können Publisher
zugrunde liegender Fehler aus der Anzeigenantwort
ResponseInfo
unter
folgenden Klassen:
Android
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
Dies sind die Codes und zugehörigen Nachrichten, die vom UnityAds-Adapter ausgegeben werden, wenn wenn eine Anzeige nicht geladen wird:
Android
Fehlercode | Grund |
---|---|
0-10 | Das UnityAds SDK hat einen Fehler zurückgegeben. Siehe Code . |
101 | Die in der AdMob-Benutzeroberfläche konfigurierten UnityAds-Serverparameter 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 DEAKTIVIERT zurückgegeben. |
104 | UnityAds hat versucht, eine Anzeige ohne Kontext auszuliefern. |
105 | Der Kontext, der zum Initialisieren, Laden und/oder Einblenden von Anzeigen von Unity Ads verwendet wird, ist keine Activity-Instanz. |
106 | UnityAds hat versucht, eine Anzeige einzublenden, die noch nicht zur Auslieferung bereit ist. |
107 | UnityAds wird auf diesem Gerät nicht unterstützt. |
108 | UnityAds kann jeweils nur eine Anzeige pro Placement laden. |
109 | UnityAds wurde mit dem Status ERROR beendet. |
200-204 | UnityAds-Banner weist auf einen bestimmten Fehler hin. Siehe Code . |
iOS
0-9 | Das UnityAds SDK hat einen Fehler zurückgegeben. Dokumentation von Unity ansehen . |
101 | Die in der AdMob-Benutzeroberfläche konfigurierten UnityAds-Serverparameter fehlen oder sind ungültig. |
102 | Gerät wird von UnityAds nicht unterstützt. |
103 | Die Präsentation von UnityAds ist mit dem Fehlerstatus „kUnityAdsFinishStateError“ abgeschlossen. |
104 | Das Unity-Anzeigenobjekt ist nach dem Aufrufen seines Initialisierers null. |
105 | Unity-Anzeigen konnten nicht ausgeliefert werden, weil die Anzeige nicht bereit ist. |
106 | UnityAds hat einen Placement-geänderten Callback mit dem Placement-Status „kUnityAdsPlacementStateNoFill“ aufgerufen. |
107 | UnityAds hat einen Placement-geänderten Callback mit dem Placement-Status „kUnityAdsPlacementStateDisabled“ aufgerufen. |
108 | Für dieses Placement wurde bereits eine Anzeige geladen. Das UnityAds SDK unterstützt nicht das Laden mehrerer Anzeigen für dasselbe Placement. |
Änderungslog zum Unity Ads Flutter Mediation-Adapter
Version 1.0.0
- Erste Version
- Die Kompatibilität mit dem Unity Android-Adapter Version 4.10.0.0 wurde bestätigt
- Die Kompatibilität mit dem Unity iOS-Adapter Version 4.10.0.0 wurde bestätigt