Unity Ads in die Vermittlung einbinden

Plattform auswählen: Android iOS Unity Flutter Android (alt)

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads Flutter Plugin Anzeigen von Unity Ads mithilfe der Vermittlung laden und präsentieren. Dabei werden sowohl Bidding- als auch abfolgebasierte Integrationen behandelt. Darin wird beschrieben, wie Sie Unity Ads der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Unity Ads Anzeigen-SDK und den Adapter in eine Flutter-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Ad Manager-Vermittlungsadapter für Unity Ads bietet die folgenden Funktionen:

Integration
Gebote
Wasserfall  1
Formate
Banner
Interstitial
Verfügbar

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

  • Die aktuelle Version von Google Mobile Ads Flutter Plugin.
  • Flutter-Framework-Version 3.7.0 oder höher.
  • [Für Gebote]: Wenn Sie alle unterstützten Anzeigenformate in Gebote einbinden möchten, verwenden Sie das Google Mobile Ads-Mediations-Plug-in für Unity Ads 1.1.0 oder höher (neueste Version empfohlen).
  • Für die Bereitstellung auf Android-Geräten
    • Android API-Level 24 oder höher
  • Für die Bereitstellung auf iOS-Geräten:
    • iOS-Bereitstellungsziel von 13.0 oder höher.
  • Ein funktionierendes Flutter-Projekt, das mit Google Mobile Ads Flutter Plugin konfiguriert ist. Weitere Informationen finden Sie unter Google Mobile Ads Flutter Plugin einrichten.
  • Richten Sie die Vermittlung ein.

    • Schritt 1: Konfigurationen in der Unity Ads-Benutzeroberfläche einrichten

    Registrieren Sie sich oder melden Sie sich bei Unity Ads an.

    Projekt erstellen

    Rufen Sie im Unity Ads-Dashboard die Option Projects (Projekte) auf und klicken Sie auf New (Neu).

    Füllen Sie das Formular aus und klicken Sie auf Erstellen, um Ihr Projekt hinzuzufügen.

    Rufen Sie Unity Ads Monetization auf und klicken Sie auf Jetzt starten.

    Wählen Sie im Modal New Project (Neues Projekt) die Optionen I will use Mediation (Ich verwende die Vermittlung) und Google AdMob für Mediation Partner (Vermittlungspartner) aus und klicken Sie auf Next (Weiter).

    Wählen Sie die Option für Anzeigeneinstellungen aus und klicken Sie auf Weiter.

    Wählen Sie die Einrichtung des Placements aus und klicken Sie auf Weiter.

    Gebote

    Wasserfall

    Füllen Sie das Formular aus und klicken Sie dann auf Projekt hinzufügen.

    Notieren Sie sich die Spiel-ID.

    Anzeigenblöcke und Placements erstellen

    Rufen Sie Unity Ads Monetization > Placements auf, wählen Sie Ihr Projekt aus und klicken Sie auf Anzeigenblock hinzufügen.

    Geben Sie einen Namen für den Anzeigenblock ein und wählen Sie dann die Plattform und das Anzeigenformat aus.

    Android

    iOS

    Gehen Sie zu Monetarisierung > Placements und klicken Sie auf Anzeigenblock hinzufügen.

    Geben Sie einen Anzeigenblocknamen ein und wählen Sie dann Ihre Plattform und das Anzeigenformat aus.

    Android

    iOS

    Wählen Sie Wasserfall für die Einrichtung aus. Geben Sie unter Placement den Placement-Namen, das GEO-Tagging und das Ziel ein.

    Notieren Sie sich die Placement-ID.

    Klicken Sie abschließend auf Anzeigenblock hinzufügen, um den Anzeigenblock und die Platzierung zu speichern.

    Unity Ads Reporting API-Schlüssel finden

    Gebote

    Dieser Schritt ist für Gebotsintegrationen nicht erforderlich.

    Wasserfall

    Rufen Sie Unity Ads Monetization > API management auf und notieren Sie sich den API-Schlüssel unter Monetization Stats API Access.

    Rufen Sie dann Unity Ads Monetization > Organization Settings auf und notieren Sie sich die Organization core ID.

    app-ads.txt-Datei aktualisieren

    Authorized Sellers for Apps (app-ads.txt) ist eine Initiative des IAB Tech Lab, die dafür sorgt, dass Ihr App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren. Falls noch nicht geschehen, erstellen Sie eine app-ads.txt-Datei für Ad Manager.

    Informationen zum Implementieren von app-ads.txt für Unity Ads finden Sie unter app-ads.txt zum ersten Mal einrichten.

    Testmodus aktivieren

    Der Testmodus kann im Unity Ads-Dashboard aktiviert werden. Rufen Sie Unity Ads Monetization > Testing auf.

    Sie können den Testmodus für Ihre App erzwingen, indem Sie für jede Plattform auf die Schaltfläche „Bearbeiten“ klicken, Testmodus des Clients überschreiben aktivieren und Testmodus für alle Geräte erzwingen (d.h. Testanzeigen verwenden) auswählen.

    Android

    iOS

    Alternativ können Sie den Testmodus für bestimmte Geräte aktivieren, indem Sie auf Testgerät hinzufügen klicken.

    Geben Sie die Details Ihres Testgeräts ein und klicken Sie auf Speichern.

    Schritt 2: Unity Ads-Anzeigennachfrage in der Ad Manager-Benutzeroberfläche einrichten

    Vermittlungseinstellungen für den Anzeigenblock konfigurieren

    Android

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

    iOS

    Eine Anleitung finden Sie in Schritt 2 des Leitfadens für iOS.

    Unity Ads zur Liste der Werbepartner für die DSGVO und die Bestimmungen von US-Bundesstaaten hinzufügen

    Folgen Sie der Anleitung unter Einstellungen für EU-Verordnungen und Einstellungen für Verordnungen von US-Bundesstaaten, um Unity Ads in der Ad Manager-Benutzeroberfläche der Liste der Werbepartner für EU-Verordnungen und Verordnungen von US-Bundesstaaten hinzuzufügen.

    Schritt 3: Unity Ads SDK und Adapter importieren

    Integration über pub.dev

    Fügen Sie der Datei pubspec.yaml Ihres Pakets die folgende Abhängigkeit mit den neuesten Versionen des Unity Ads SDK und des Adapters hinzu:

    dependencies:
  gma_mediation_unity: ^1.11.1

    Manuelle Integration

    Laden Sie die aktuelle Version des Google Mobile Ads Mediation-Plug-ins für Unity Ads herunter, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und seinen Inhalt) Ihrem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml auf das Plug-in, indem Sie die folgende Abhängigkeit hinzufügen:

    dependencies:
  gma_mediation_unity:
    path: path/to/local/package

    Schritt 4: Datenschutzeinstellungen im Unity Ads SDK implementieren

    Damit Sie die Google-Richtlinie zur Einwilligung der Nutzer in der EU einhalten, müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zur Verwendung von Cookies oder anderen lokalen Speicherverfahren einholen, sofern dies gesetzlich vorgeschrieben ist, sowie zur Erhebung, Weitergabe und Verwendung personenbezogener Daten zur Personalisierung von Anzeigen. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Sie sind dafür verantwortlich, dass die Einwilligung an jede Anzeigenquelle in Ihrer Vermittlungskette weitergegeben wird.

    Ab der Version 1.10.0 des Unity Ads Flutter-Adapters können DSGVO-Einwilligungssignale von Plattformen zur Einwilligungsverwaltung, die in das Transparency and Consent Framework (TCF) des IAB eingebunden sind, an das Unity Ads SDK übergeben werden. Weitere Informationen finden Sie unter TCF- oder Nicht-TCF-Einwilligungskonfiguration einrichten.

    Datenschutzgesetze von US-Bundesstaaten

    Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten dürfen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten wird beschrieben, wie Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Richtlinien der einzelnen Netzwerke befolgen, um die Einhaltung der Bestimmungen zu gewährleisten.

    Das Google Mobile Ads-Vermittlungs-Plug-in für Unity Ads enthält die Methode GmaMediationUnity.setCCPAConsent(). Im folgenden Beispielcode wird gezeigt, wie Einwilligungsinformationen an das Unity Anzeigen-SDK übergeben werden. Wenn Sie diese Methode aufrufen, sollten Sie dies tun, bevor Sie Anzeigen über Google Mobile Ads Flutter Plugin anfordern.

    import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

    Alterskennzeichnung festlegen

    Ab Version 1.6.5 des Unity Ads-Vermittlungs-Plug-ins werden die Einstellung für Inhalte, die speziell für Kinder erstellt wurden, und die Einstellung für Nutzer, die das gültige Mindestalter noch nicht erreicht haben, an Unity Ads weitergeleitet.

    Damit diese Signale pro Nutzer verarbeitet werden können, müssen Sie in Unity Ads im Unity Monetization-Dashboard die Kennzeichnung Mixed Audience (Gemischte Zielgruppe) aktivieren. Weitere Informationen zum Aktivieren der Kennzeichnung „Gemischte Zielgruppe“ für Ihr Projekt finden Sie unter Altersfreigaben auf Spielebene festlegen.

    Schritt 5: Erforderlichen Code hinzufügen

    Android

    Für Unity Ads-Android-Integrationen ist kein zusätzlicher Code erforderlich.

    iOS

    SKAdNetwork-Integration

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

    Schritt 6: Implementierung testen

    Testanzeigen aktivieren

    Registrieren Sie Ihr Testgerät für Ad Manager und aktivieren Sie den Testmodus in der Unity Ads-Benutzeroberfläche.

    Testanzeigen überprüfen

    Wenn Sie prüfen möchten, ob Sie Testanzeigen von Unity Ads erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen Unity Ads (Bidding) und Unity Ads (Vermittlungsabfolge).

    Fehlercodes

    Wenn der Adapter keine Anzeige von Unity Ads 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.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

    iOS

    GADMAdapterUnity
GADMediationAdapterUnity

    Hier sind die Codes und die zugehörigen Meldungen, die vom UnityAds-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

    Android

    Fehlercode Grund
    0-10 Das UnityAds SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie im 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 mit einem Null-Kontext auszuliefern.
    105 Der Kontext, der zum Initialisieren, Laden und/oder Einblenden von Anzeigen aus Unity Ads verwendet wird, ist keine Aktivitätsinstanz.
    106 UnityAds hat versucht, eine Anzeige auszuliefern, die noch nicht bereit ist.
    107 UnityAds wird auf dem Gerät nicht unterstützt.
    108 UnityAds kann jeweils nur eine Anzeige pro Placement laden.
    109 UnityAds wurde mit einem FEHLERSTATUS beendet.
    110 Die angeforderte Anzeigengröße entspricht keiner von UnityAds unterstützten Bannergröße.
    111 UnityAds hat einen Initialisierungsfehler zurückgegeben.
    112 Unity Ads hat ein Null- oder leeres Bidding-Token zurückgegeben.
    200-204 UnityAds-Banner – ein spezifischer Fehler. Weitere Informationen finden Sie im Code.

    iOS

    0-9 Das UnityAds SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von Unity.
    101 Die in der Ad Manager-Benutzeroberfläche konfigurierten UnityAds-Serverparameter fehlen oder sind ungültig.
    102 Das Gerät wird von UnityAds nicht unterstützt.
    103 Die Präsentation von UnityAds wurde mit dem Fehlerstatus kUnityAdsFinishStateError abgeschlossen.
    104 Das Unity-Anzeigenobjekt ist nach dem Aufruf des Initialisierers „nil“.
    105 Unity Ads konnten nicht ausgeliefert werden, da die Anzeige noch nicht bereit war.
    107 UnityAds hat einen Callback für eine Placement-Änderung 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.
    109 Die von UnityAds zurückgegebene Banneranzeige entspricht nicht der angeforderten Größe.
    110 UnityAds hat einen Initialisierungsfehler zurückgegeben.
    111 Nicht unterstütztes Anzeigenformat.
    112 UnityAds hat ein Null- oder leeres Gebots-Token zurückgegeben.

    Änderungsprotokoll für den Flutter-Vermittlungsadapter für Unity Ads

    Version 1.11.1

    Version 1.11.0

    Version 1.10.0

    Version 1.9.0

    Version 1.8.1

    Version 1.8.0

    Version 1.7.0

    Version 1.6.5

    • Entwickelt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 6.0.0.

    Version 1.6.4

    Version 1.6.3

    • Entwickelt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 6.0.0.

    Version 1.6.2

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 6.0.0.

    Version 1.6.1

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 6.0.0.

    Version 1.6.0

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 6.0.0.

    Version 1.5.1

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 6.0.0.

    Version 1.5.0

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 6.0.0.

    Version 1.4.1

    • Entwickelt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 6.0.0.

    Version 1.4.0

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 6.0.0.

    Version 1.3.0

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 5.3.1.

    Version 1.2.0

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 5.3.1.

    Version 1.1.0

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in, Version 5.2.0.

    Version 1.0.0

    • Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.0.0.