In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads Unity Plugin Anzeigen aus dem BIGO Anzeigen-SDK über die AdMob Mediation laden und präsentieren. Dabei werden auch Bidding-Integrationen behandelt. Hier erfahren Sie, wie Sie das BIGO Ads Anzeigen-SDK der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das BIGO Ads Anzeigen-SDK und den Adapter in eine Unity-App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der AdMob-Vermittlungsadapter für das BIGO Ads SDK bietet folgende Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Vermittlungsabfolge | |
| Formate | |
| App öffnen | |
| Banner | |
| Interstitial | |
| Verfügbar | |
| Interstitial mit Prämie | |
| Nativ | |
Vorbereitung
Bevor Sie fortfahren, prüfen Sie Folgendes:
- Aktuelle Google Mobile Ads Unity Plugin-Version.
- Unity Editor-Version 2019.4 oder höher
- 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 Unity-Projekt, das mit Google Mobile Ads Unity Plugin konfiguriert ist. Weitere Informationen finden Sie unter Erste Schritte.
- Richten Sie AdMob Mediation ein.
Schritt 1: Konfigurationen in der BIGO Ads SDK-Benutzeroberfläche einrichten
Melden Sie sich in Ihrem BIGO Ads-Dashboard an.
App erstellen
Rufen Sie den Tab Inventar auf und wählen Sie in der Tabelle Apps und Websites die Option + Hinzufügen aus.
Füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.
Notieren Sie sich die Anwendungs-ID.
Android
iOS
Anzeigenfläche erstellen
Nachdem Ihre App überprüft wurde, rufen Sie die Tabelle Anzeigenflächen auf und wählen Sie den Button + Hinzufügen aus.
Wählen Sie als Auktionstyp die Option Servergebot aus, füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.
Notieren Sie sich die Slot-ID.
Android
iOS
app-ads.txt-Datei aktualisieren
Authorized Sellers for Apps (app-ads.txt) ist eine IAB Tech Lab-Initiative, 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, richten Sie eine app-ads.txt-Datei für Ihre App ein.
Wenn Sie app-ads.txt für das BIGO Anzeigen-SDK implementieren möchten, rufen Sie im Dashboard den Tab APP-ads.txt auf und folgen Sie der Anleitung auf dem Tab.
Schritt 2: BIGO Ads SDK-Nachfrage in der AdMob-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.
BIGO TECHNOLOGY PTE LTD zur Liste der Werbepartner für die DSGVO und die Datenschutzbestimmungen von US-Bundesstaaten hinzufügen
Folgen Sie der Anleitung unter Einstellungen für europäische Verordnungen und Einstellungen für Verordnungen von US-Bundesstaaten, um Empathy Technology Pte.Ltd. (BIGO Ads) in der AdMob-Benutzeroberfläche der Liste der Werbepartner für europäische Verordnungen und **BIGOAds** der Liste der Werbepartner für Verordnungen von US-Bundesstaaten hinzuzufügen.
Schritt 3: BIGO Anzeigen-SDK und Adapter importieren
OpenUPM-CLI
Wenn Sie OpenUPM-CLI installiert haben, können Sie das Google Mobile Ads BIGO Ads Anzeigen-SDK-Vermittlungs-Plug-in für Unity in Ihrem Projekt installieren. Führen Sie dazu den folgenden Befehl im Stammverzeichnis Ihres Projekts aus:
openupm add com.google.ads.mobile.mediation.bigoOpenUPM
Wählen Sie im Unity-Projekt-Editor Edit > Projekteinstellungen > Package Manager aus, um die Unity Package Manager Settings zu öffnen.
Fügen Sie auf dem Tab Scoped Registries OpenUPM als bereichsbezogene Registry mit den folgenden Details hinzu:
- Name:
OpenUPM - URL:
https://package.openupm.com - Bereich(e):
com.google
Gehen Sie dann zu Window > Package Manager, um den Unity Package Manager zu öffnen, und wählen Sie im Drop-down-Menü My Registries aus.
Wählen Sie das Paket Google Mobile Ads Bigo Mediation aus und klicken Sie auf Install (Installieren).
Unity-Paket
Laden Sie die aktuelle Version des Google Mobile Ads-Vermittlungs-Plug-ins für das BIGO Ads SDK über den Downloadlink im Änderungsprotokoll herunter und extrahieren Sie die GoogleMobileAdsBigoMediation.unitypackage aus der ZIP-Datei.
Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package aus und suchen Sie die heruntergeladene Datei GoogleMobileAdsBigoMediation.unitypackage. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.
Wählen Sie dann Assets > External Dependency Manager > Android Resolver > Force Resolve aus. Die Bibliothek „External Dependency Manager“ 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: Datenschutzeinstellungen im BIGO Anzeigen-SDK implementieren
In den folgenden Abschnitten erfahren Sie, wie Sie Datenschutzeinstellungen für das BIGO Anzeigen-SDK implementieren und die relevanten Datenschutzbestimmungen einhalten.
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU 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. Außerdem müssen Sie ihre Einwilligung zur Erhebung, Weitergabe und Verwendung personenbezogener Daten für personalisierte Anzeigen einholen. 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.
Die BIGO Ads SDK Unity-Adapterversion 1.0.0 und höher unterstützt die Weitergabe von DSGVO-Einwilligungssignalen von Plattformen zur Einwilligungsverwaltung, die in das Transparency and Consent Framework (TCF) des IAB integriert sind, an das BIGO Ads SDK. Weitere Informationen finden Sie in der DSGVO-Dokumentation für das BIGO Ads SDK für Android und iOS.
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 können. 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.
Im folgenden Beispielcode sehen Sie, wie das Einwilligungs-Flag an das BIGO Anzeigen-SDK übergeben wird. Rufen Sie diese Methode auf, bevor Sie Anzeigen über Google Mobile Ads Unity Plugin anfordern.
using GoogleMobileAds.Mediation.Bigo.Api;
// ...
Bigo.SetCcpaConsent(true);
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die Integration des BIGO Ads SDK ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation zum BIGO Anzeigen-SDK, 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 AdMob.
BIGO Ads stellt Anwendungs-IDs und Anzeigenflächen-IDs für Android und iOS bereit, um das Testen und die Integration zu erleichtern.
Testanzeigen prüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vom BIGO Ads SDK erhalten, aktivieren Sie im Anzeigenprüftool die Tests einzelner Anzeigenquellen und verwenden Sie die Anzeigenquellen BIGO Ads SDK (Bidding).
Fehlercodes
Wenn der Adapter keine Anzeige vom BIGO Anzeigen-SDK erhält, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo unter den folgenden Klassen prüfen:
Android
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
iOS
GADMediationAdapterBigo
Die Codes und die zugehörigen Meldungen werden vom BIGO Ads SDK-Adapter ausgegeben, wenn eine Anzeige nicht geladen werden kann:
Android
| Fehlercode | Domain | Grund |
|---|---|---|
| 101 | com.google.ads.mediation.bigo | Bigo-Slot-ID fehlt oder ist leer. |
| 102 | com.google.ads.mediation.bigo | Die App-ID zum Initialisieren des Bigo SDK ist leer oder fehlt. |
| 1000-1100 | Vom BIGO Anzeigen-SDK gesendet | Das BIGO Anzeigen-SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zum BIGO Ads SDK. |
iOS
| Fehlercode | Domain | Grund |
|---|---|---|
| 101 | com.google.mediation.bigoadapter | In der Serverkonfiguration fehlt eine erforderliche Anwendungs-ID. |
| 102 | com.google.mediation.bigoadapter | Ungültige Anzeigenkonfiguration. |
| 103 | com.google.mediation.bigoadapter | Fehler bei der Anzeigenpräsentation. |
| 104 | com.google.mediation.bigoadapter | Nicht unterstützte Bannergröße. |
| 105 | com.google.mediation.bigoadapter | Bigo hat eine Banneranzeige erfolgreich geladen, aber es fehlt eine Anzeigenaufruf. |
| 1000-1100 | Vom BIGO Anzeigen-SDK gesendet | Das BIGO Anzeigen-SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zum BIGO Ads SDK. |
Änderungsprotokoll für das Unity-Vermittlungs-Plug-in für das BIGO Anzeigen-SDK
Nächste Version
- Unterstützung für den Swift Package Manager (SPM) für den Unity-Adapter des BIGO Anzeigen-SDK hinzugefügt.
- Die mindestens erforderliche Version des Unity-Plug-ins wurde auf 11.7.0 aktualisiert.
Version 3.1.0
- Unterstützt die Android-Adapterversion 6.1.0.0 des BIGO Ads SDK
- Unterstützt BIGO Anzeigen-SDK iOS-Adapterversion 6.1.0.0
- Erstellt und getestet mit dem Google Mobile Ads Unity-Plug-in, Version 11.6.0.
Version 3.0.0
- Unterstützt die Android-Adapterversion 6.0.0.1 des BIGO Ads SDK
- Unterstützt BIGO Anzeigen-SDK iOS-Adapterversion 6.0.0.0
- Erstellt und getestet mit dem Google Mobile Ads Unity-Plug-in, Version 11.5.0.
Version 2.0.0
- Unterstützt die Android-Adapterversion 6.0.0.0 des BIGO Ads SDK
- Unterstützt die iOS-Adapterversion 5.3.0.0 des BIGO Ads SDK
- Erstellt und getestet mit dem Google Mobile Ads Unity-Plug-in, Version 11.4.0.
Version 1.1.0
- Unterstützt die Version 5.10.1.0 des BIGO Ads Anzeigen-SDK-Adapters für Android.
- Unterstützt die iOS-Adapterversion 5.3.0.0 des BIGO Ads SDK
- Erstellt und getestet mit dem Google Mobile Ads Unity-Plug-in, Version 11.3.0.
Version 1.0.0
- Erstes Release!
- Unterstützt die Version 5.8.0.0 des Android-Adapters für das BIGO Ads SDK.
- Unterstützt die iOS-Adapterversion 5.1.2.0 des BIGO Ads SDK.
- Erstellt und getestet mit dem Google Mobile Ads Unity-Plug-in, Version 11.0.0.