BIGO Ads SDK mit Vermittlung einbinden

Plattform auswählen: Android Android iOS Unity

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads SDK Anzeigen aus dem BIGO Ads SDK über die AdMob-Vermittlung laden und ausliefern. Dabei werden Gebotsintegrationen behandelt. Hier erfahren Sie, wie Sie das BIGO Ads SDK der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das BIGO Ads SDK und den Adapter in eine Android-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für das BIGO Ads SDK bietet die folgenden Funktionen:

Integration
Gebote	^1
Wasserfall
Formate
App-Start
Banner
Interstitial
Verfügbar
Interstitial mit Prämie
Nativ

¹ Die Gebotsintegration befindet sich in der geschlossenen Betaphase. Wenden Sie sich an Ihren Account Manager, um Zugriff anzufordern.

Voraussetzungen

• Android API-Level 23 oder höher

• Aktuelles Google Mobile Ads SDK

• Vermittlung abschließen Startleitfaden

Schritt 1: Konfigurationen in der Benutzeroberfläche des BIGO Ads SDK einrichten

Melden Sie sich an im BIGO Ads-Dashboard.

App erstellen

Gehen Sie zum Tab Inventar und wählen Sie in der Tabelle Apps und Websites die Schaltfläche + Hinzufügen aus.

Füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.

Notieren Sie sich die Anwendungs-ID.

Wichtig: Nachdem Sie Ihre neue Anwendung erstellt haben, wird sie zur Überprüfung eingereicht. Die Anwendung muss überprüft werden, bevor Sie mit den nächsten Schritten fortfahren können.

Anzeigenfläche erstellen

Sobald Ihre Anwendung überprüft wurde, gehen Sie zur Tabelle Anzeigen-Slots und wählen Sie die Schaltfläche + Hinzufügen aus.

Wählen Sie für den Auktionstyp die Option Server Bidding aus, füllen Sie den Rest des Formulars aus und klicken Sie auf Senden.

Notieren Sie sich die Slot-ID.

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. Wenn Sie das noch nicht getan haben, richten Sie eine app-ads.txt-Datei für Ihre App ein.

Wenn Sie app-ads.txt für das BIGO Ads SDK implementieren möchten, gehen Sie im Dashboard zum APP-ads.txt Tab und folgen Sie der Anleitung auf dem Tab.

Schritt 2: BIGO Ads SDK-Nachfrage in der AdMob-Benutzeroberfläche einrichten

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Sie müssen das BIGO Ads SDK der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.

Melden Sie sich zuerst in Ihrem AdMob-Konto an. Gehen Sie dann zum Tab Vermittlung. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie mit dem Abschnitt BIGO Ads SDK als Anzeigenquelle hinzufügen fort.

Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Vermittlungsgruppe erstellen aus.

Geben Sie das Anzeigenformat und die Plattform ein und klicken Sie auf Weiter.

Geben Sie Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Zielstandorte aus. Setzen Sie dann den Status der Vermittlungsgruppe auf Aktiviert und klicken Sie auf Anzeigenblöcke hinzufügen.

Verknüpfen Sie diese Vermittlungsgruppe mit einem oder mehreren Ihrer vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Fertig.

Auf der Karte „Anzeigenblöcke“ sollten jetzt die von Ihnen ausgewählten Anzeigenblöcke angezeigt werden:

BIGO Ads SDK als Anzeigenquelle hinzufügen

Wählen Sie im Bereich Anzeigenquellen auf der Karte Gebote die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann BIGO Ads SDK aus.

Klicken Sie auf Partnervereinbarung unterzeichnen und richten Sie eine Gebotspartnerschaft ein mit dem BIGO Ads SDK.



Klicken Sie auf Bestätigen und zustimmen und dann auf Weiter.



Wenn Sie bereits eine Zuordnung für das BIGO Ads SDK haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.



Geben Sie als Nächstes die Slot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

Wichtig: Die Anwendungs-ID muss mit der Ziel-App verknüpft sein, wie in der Benutzeroberfläche des BIGO Ads SDK.

BIGO TECHNOLOGY PTE LTD der Liste der Werbepartner für die DSGVO und die Verordnungen von US-Bundesstaaten hinzufügen

Wichtig:Sie benötigen die Berechtigung Kontoverwaltung, um die Konfiguration für die Einwilligung der Nutzer in der EU und die DSGVO, die Verordnungen von US-Bundesstaaten und die User Messaging Platform abzuschließen. Weitere Informationen finden Sie unter Nutzerzugriff auf Ihr Konto verwalten.

Folgen Sie der Anleitung unter Einstellungen für Verordnungen in der EU und Einstellungen für Verordnungen von US-Bundesstaaten , um BIGO TECHNOLOGY PTE LTD in der AdMob-Benutzeroberfläche der Liste der Werbepartner für die Verordnungen in der EU und den US-Bundesstaaten hinzuzufügen.

Schritt 3: BIGO Ads SDK und Adapter importieren

Hinweis: Wenn Sie die kompatiblen Versionen des BIGO Ads SDK und des Google Mobile Ads SDK nicht integrieren, kann es zu Build-Problemen kommen.

Android Studio-Integration (empfohlen)

Fügen Sie in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten hinzu:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.3.0")
    implementation("com.google.ads.mediation:bigo:5.9.0.0")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:bigo:5.9.0.0'
}

Schritt 4: Datenschutzeinstellungen für das BIGO Ads SDK implementieren

Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zu folgenden Aktivitäten einholen: Einsatz von Cookies oder anderen Formen der lokalen Speicherung, falls die Einholung der Einwilligung dafür gesetzlich vorgeschrieben ist, sowie Erhebung, Weiterleitung und Nutzung personenbezogener Daten für personalisierte Werbung. 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. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.

Das BIGO Ads SDK liest automatisch die DSGVO-Einwilligung, die von Consent Management Plattformen wie dem UMP SDK festgelegt wurde. Weitere Informationen finden Sie im Integrationsleitfaden des BIGO Ads SDK zur DSGVO.

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. Der Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten bietet die Möglichkeit, die eingeschränkte Datenverarbeitung für die Google-Anzeigenauslieferung zu 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 kann, und die Anleitung der einzelnen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.

Der folgende Beispielcode zeigt, wie Sie das Einwilligungs-Flag an das BIGO Ads SDK übergeben. Rufen Sie diese Methode auf, bevor Sie Anzeigen über Google Mobile Ads SDK anfordern.

Java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

Kotlin

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

Weitere Informationen finden Sie im Integrationsleitfaden des BIGO Ads SDK zu CCPA.

Schritt 5: Erforderlichen Code hinzufügen

Für die Integration des BIGO Ads SDK ist kein zusätzlicher Code erforderlich.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Stellen Sie sicher, dass Sie Ihr Testgerät für AdMob registrieren.

BIGO Ads bietet Test Anwendungs-IDs und Anzeigen-Slot-IDs für Android zur Unterstützung bei Tests und Integration.

Wichtig:Deaktivieren Sie den Testmodus für AdMob und das BIGO Ads SDK, bevor Sie Ihre App veröffentlichen.

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von BIGO Ads SDK erhalten, aktivieren Sie im Anzeigenprüftool die Tests einzelner Anzeigenquellen und verwenden Sie die Anzeigenquelle (n) BIGO Ads SDK(Bidding).

Optionale Schritte

Native Anzeigen

Anzeigen-Rendering

Der BIGO Ads SDK-Adapter gibt seine nativen Anzeigen als NativeAd Objekte zurück. Er füllt die folgenden Felder für ein NativeAd aus.

Feld	Assets, die immer vom BIGO Ads SDK-Adapter eingefügt werden
Anzeigentitel
Bild
Text
Symbol
Call-to-Action
Bewertung
Speicher
Preis
Advertiser

Fehlercodes

Wenn der Adapter keine Anzeige vom BIGO Ads SDK empfängt, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo.getAdapterResponses() unter den folgenden Klassen prüfen:

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

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

Fehlercode	Domain	Grund
101	com.google.mediation.bigoadapter	Fehlende oder leere Bigo-Slot-ID
1000-1100	Gesendet vom BIGO Ads SDK	Das BIGO Ads SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation des BIGO Ads SDK.

Änderungsprotokoll für den Bigo Android-Vermittlungsadapter

Nächste Version

• Zuordnung von AgeRestrictedTreatment zur COPPA API von Bigo

Version 5.9.0.0

• Kompatibilität mit Bigo Ads SDK 5.9.0 bestätigt

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.2.0
• Google Mobile Ads Next-Gen SDK Version 1.0.1
• Bigo Ads SDK Version 5.9.0

Version 5.8.0.0

• Eigenschaft hinzugefügt, um den Adapter mit der GMA Next-Gen SDK-Abhängigkeit zu erstellen
• Kompatibilität mit Bigo Ads SDK 5.8.0 bestätigt

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.1.0
• Bigo Ads SDK Version 5.8.0

Version 5.7.1.0

• Kompatibilität mit Bigo Ads SDK 5.7.1 bestätigt

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.0.0
• Bigo Ads SDK Version 5.7.1

Version 5.7.0.0

• Unterstützung für die Weiterleitung des Google Mobile Ads SDK-Parameters tagForUnderAgeOfConsent an das Bigo Ads SDK hinzugefügt
• Kompatibilität mit Bigo Ads SDK 5.7.0 bestätigt

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• Bigo Ads SDK Version 5.7.0

Version 5.5.2.0

• Unterstützung für Banner-, Interstitial-, Anzeigen mit Prämie- und native Anzeigenformate hinzugefügt
• Kompatibilität mit Bigo Ads SDK 5.5.2 bestätigt

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• Bigo Ads SDK Version 5.5.2