Integration von Vungle mit Mediation

Dieser Leitfaden richtet sich an Publisher, die das Google Mobile Ads SDK verwenden möchten, um Anzeigen über Vungle über die Vermittlung zu laden und einzublenden.

Sie erfahren, wie Sie die Vungle-Vermittlungskonfiguration hinzufügen, die Werbenetzwerkoptimierung (ANO), dieeinrichten und die Vungle SDK und Adapter in eineAndroid App integrieren.

Unterstützte Integrationen und Anzeigenformate

Der AdMob Vermittlungsadapter für Vungle 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

Beschränkungen

  • Vungle unterstützt nicht das Laden mehrerer Anzeigen mit derselben Placement-Referenz-ID.
    • Der Vungle-Adapter schlägt die zweite Anfrage problemlos vor, wenn eine andere Anfrage für das Placement geladen wird oder gewartet wird.
  • Vungle unterstützt jeweils nur eine Banneranzeige.
    • Der Vungle-Adapter schlägt keine nachfolgenden Banneranfragen mehr an, wenn eine Banneranzeige bereits geladen wird.

Schritt 1: Vungle einrichten

Registrieren Sie sich oder melden Sie sich in Ihrem Vungle-Konto an.

Fügen Sie die App in das Vungle-Anwendungs-Dashboard ein, indem Sie auf die Schaltfläche Anwendung hinzufügen klicken.

Füllen Sie das Formular aus und geben Sie alle erforderlichen Details ein. Klicken Sie dann unten auf der Seite auf die Schaltfläche Weiter, um Ihre App zu Vungle hinzuzufügen.

Nachdem Ihre Anwendung erstellt wurde, wählen Sie sie im Vungle Applications-Dashboard aus.

Notieren Sie sich die App-ID.

Hinzufügen neuer Placements

Wenn Sie ein neues Placement zur Verwendung mit der AdMob-Vermittlung erstellen möchten, klicken Sie auf das Dashboard Vungle Placements, klicken Sie auf die Schaltfläche Placement hinzufügen und wählen Sie die App aus der Drop-down-Liste aus.

Unten finden Sie die Details zum Hinzufügen neuer Placements:

Wähle Banner aus, gib den gewünschten Placement-Namen ein und fülle den Rest des Formulars aus. Klicken Sie unten auf der Seite auf Weiter, um das Placement zu erstellen.

Notiere dir die Referenz-ID und klicke auf Klingt gut.

Banner 300 x 250

Wähle MREC aus, gib den gewünschten Placement-Namen ein und fülle den Rest des Formulars aus. Klicken Sie unten auf der Seite auf Weiter, um das Placement zu erstellen.

Notiere dir die Referenz-ID und klicke auf Klingt gut.

Interstitial

Wählen Sie Interstitial aus, geben Sie den gewünschten Placement-Namen ein und füllen Sie das Formular aus. Klicken Sie unten auf der Seite auf Weiter, um das Placement zu erstellen.

Notiere dir die Referenz-ID und klicke auf Klingt gut.

Verfügbar

Wählen Sie Mit Prämie aus, geben Sie den gewünschten Placement-Namen ein und füllen Sie den Rest des Formulars aus. Klicken Sie unten auf der Seite auf Weiter, um das Placement zu erstellen.

Notiere dir die Referenz-ID und klicke auf Klingt gut.

Neben der App-ID und der Referenz-ID benötigen Sie auch Ihren Vungle Reporting API-Schlüssel, um IhreAdMob -Anzeigenblock-ID einzurichten. Rufen Sie das Vungle Reports-Dashboard auf und klicken Sie auf die Schaltfläche Reporting API Key (Reporting API-Schlüssel), um Ihren Reporting API Key aufzurufen.

Schritt 2: Vermittlungseinstellungen für den AdMob Anzeigenblock konfigurieren

Sie müssen der Vermittlungskonfiguration für Ihren Anzeigenblock eine Vungle 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 Option Vungle 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 dann den Status der Vermittlungsgruppe auf Aktiviert fest. Klicken Sie dann auf Anzeigenblöcke hinzufügen.

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

Die Karte „Anzeigenblöcke“ sollte jetzt mit den von dir ausgewählten Anzeigenblöcken ausgefüllt sein:

Vungle als Anzeigenquelle hinzufügen

Wählen Sie auf der Karte Anzeigenquellen die Option Werbenetzwerk hinzufügen aus. Wählen Sie Vungle aus und aktivieren Sie den Schieberegler Optimize. Geben Sie unter Reporting API-Schlüssel den Reporting API-Schlüssel ein, den Sie im vorherigen Abschnitt erhalten haben, um ANO für Vungle einzurichten. Geben Sie dann einen eCPM-Wert für Vungle ein und klicken Sie auf Weiter.

Geben Sie die App-ID und die Placement-Referenz-ID aus dem vorherigen Abschnitt ein. Wenn Sie Version 4.x oder eine ältere Version des Vungle SDK verwenden, kann die Placement-Referenz-ID ein beliebiger Wert sein.

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 Vungle-Adapter standardmäßig auf eine Prämie vom Typ vungle mit dem Wert 1 eingestellt. Das Vungle SDK bietet für Anzeigen mit Prämie keine bestimmten Prämienwerte.

Weitere Informationen zum Festlegen von Prämienwerten für AdMob-Anzeigenblöcke finden Sie unter Anzeigenblock erstellen.

Schritt 3: Vungle SDK und Adapter importieren

Füge die folgende Implementierungsabhängigkeit mit der neuesten Version des Vungle 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.google.ads.mediation:vungle:6.11.0.0'
}
...

Manuelle Integration

  1. Lade das neueste Vungle Android SDK herunter und extrahiert die .jar-Dateien im Ordner libs und füge sie deinem Projekt hinzu.

  2. Rufen Sie im Maven-Repository von Google die Vungle-Adapter-Artefakte auf. Wähle die aktuelle Version aus, lade die Vungle-Adapterdatei .aar herunter und füge sie deinem Projekt hinzu.

Schritt 4: Erforderlichen Code hinzufügen

Für die Vungle-Integration ist kein zusätzlicher Code erforderlich.

Schritt 5: Implementierung testen

Um Testanzeigen zu aktivieren, gehen Sie zu Ihrem Vungle-Dashboard und gehen zu Anwendungen.

Wählen Sie die App, für die Sie Testanzeigen aktivieren möchten, im Abschnitt Placement-Referenz-ID der App aus. Testanzeigen können aktiviert werden, indem Sie im Bereich Status die Option Testmodus auswählen.

Fertig! Sie haben jetzt eine funktionierende Vermittlungsintegration in Vungle.

Optionale Schritte

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.

Im folgenden Abschnitt erfahren Sie, wie Sie personalisierte Anzeigen für Vungle aktivieren oder deaktivieren.

In der Version 6.2.5.0 wurde der Vungle-Adapter die Klasse VungleConsent hinzugefügt, mit der Sie die Einwilligung an Vungle weitergeben können. Mit dem folgenden Beispielcode wird der Einwilligungsstatus auf OPTED_IN festgelegt. Wenn Sie diese Methode aufrufen möchten, sollten Sie das tun, bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.

import com.vungle.warren.Vungle;
import com.vungle.mediation.VungleConsent;
...

VungleConsent.updateConsentStatus(Vungle.Consent.OPTED_IN);

Sie können den aktuellen Einwilligungsstatus für Vungle auch mit dem folgenden Code prüfen:

VungleConsent.getCurrentVungleConsent();

In Version 6.3.12.0 des Vungle-Adapters wurde die Methode updateConsentStatus() aktualisiert, um eine Version der Mitteilung zur EU-Nutzereinwilligung hinzuzufügen:

import com.vungle.warren.Vungle;
import com.vungle.mediation.VungleConsent;
...

VungleConsent.updateConsentStatus(Vungle.Consent.OPTED_IN, "1.0.0");

Sie können diese Mitteilung zur EU-Nutzereinwilligung für Vungle mit dem folgenden Code abrufen:

VungleConsent.getCurrentVungleConsentMessageVersion();

Weitere Informationen findest du unter DSGVO-konforme Implementierung von Vungle.

Netzwerkspezifische Parameter

Der Vungle-Adapter unterstützt einen zusätzlichen Anfrageparameter, der mithilfe der Klasse VungleExtrasBuilder an den Adapter übergeben werden kann. Diese Klasse enthält die folgenden Methoden:

setSoundEnabled(bool)
Damit wird festgelegt, ob der Ton beim Abspielen von Videoanzeigen aktiviert werden soll.
setUserId(String)
Eine Zeichenfolge, die die Incentive-ID"Vungle"als Anreiz darstellt.

Im folgenden Codebeispiel wird gezeigt, wie Sie eine Anzeigenanfrage erstellen, mit der die folgenden Parameter festgelegt werden:

Java 

Bundle extras = new VungleExtrasBuilder(placements)
     .setSoundEnabled(false)
     .setUserId("test_user")
     .build();
AdRequest request = new AdRequest.Builder()
     .addNetworkExtrasBundle(VungleAdapter.class, extras)             // Rewarded.
     .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
     .build();

Kotlin 

val extras = VungleExtrasBuilder(placements)
     .setSoundEnabled(false)
     .setUserId("test_user")
     .build()
val request = AdRequest.Builder()
     .addNetworkExtrasBundle(VungleAdapter::class.java, extras)       // Rewarded.
     .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
     .build()

Fehlercodes

Wenn der Adapter keine Anzeige von Vungle empfängt, können Publisher den zugrunde liegenden Fehler in der Anzeigenantwort mit ResponseInfo.getAdapterResponse() in den folgenden Klassen prüfen:

Format Kursname
Banner com.vungle.mediation.VungleInterstitialAdapter
Interstitial com.vungle.mediation.VungleInterstitialAdapter
Verfügbar com.vungle.mediation.VungleAdapter

Dies sind die Codes und die zugehörigen Benachrichtigungen, die vom Vungle-Adapter ausgelöst werden, wenn eine Anzeige nicht geladen werden kann:

Fehlercode Domain Grund
0–100 com.vungle.warren Das Vungle SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in diesem Dokument.
101 com.google.ads.mediation.vungle Ungültige Serverparameter (z. B. App- oder Placement-ID)
102 com.google.ads.mediation.vungle Die angeforderte Bannergröße ist keiner gültigen Vungle-Anzeigengröße zugeordnet.
103 com.google.ads.mediation.vungle Vungle benötigt einen Activity-Kontext, um Anzeigen anzufordern.
104 com.google.ads.mediation.vungle Das Vungle SDK kann nicht mehrere Anzeigen für dieselbe Placement-ID laden.
105 com.google.ads.mediation.vungle Das Vungle SDK konnte nicht initialisiert werden.
106 com.google.ads.mediation.vungle Das Vungle SDK hat einen erfolgreichen Callback für das Laden zurückgegeben, aber Banners.getBanner() oder Vungle.getNativeAd() haben NULL zurückgegeben.
107 com.google.ads.mediation.vungle Das Vungle SDK ist für die Wiedergabe der Anzeige nicht bereit.
1-100 Vom Vungle SDK gesendet Das Vungle SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code.
101 de.google.mediation.vungle Die in der AdMob -UI konfigurierten Vungle-Serverparameter fehlen oder sind ungültig.
102 de.google.mediation.vungle Für diese Netzwerkkonfiguration wurde bereits eine Anzeige geladen. Das Vungle SDK kann keine zweite Anzeige für dieselbe Placement-ID laden.
103 de.google.mediation.vungle Die angeforderte Anzeigengröße stimmt nicht mit der Bannergröße von Vungle überein.
104 de.google.mediation.vungle Das Vungle SDK konnte die Banneranzeige nicht rendern.
105 de.google.mediation.vungle Das Vungle SDK unterstützt unabhängig von der Placement-ID nur jeweils eine Banneranzeige.
106 de.google.mediation.vungle Das Vungle SDK hat einen Callback gesendet, der besagt, dass die Anzeige nicht wiedergegeben werden kann.

Vungle-Android Mediation-Adapter-Änderungsprotokoll

Version 6.11.0.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.11.0.

Entwickelt und getestet mit:

  • Version 20.6.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.11.0.

Version 6.10.5.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.10.5.
  • 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.
  • Vungle SDK-Version 6.10.5.

Version 6.10.4.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.10.4.

Entwickelt und getestet mit:

  • Version 20.5.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.10.4.

Version 6.10.3.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.10.3.

Entwickelt und getestet mit:

  • Version 20.5.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.10.3.

Version 6.10.2.1

  • Verifizierte Kompatibilität mit Vungle SDK 6.10.2.
  • Interstitial-Anzeigen und Anzeigenformate mit Prämie werden jetzt unterstützt.
  • 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.
  • Vungle SDK-Version 6.10.2.

Version 6.10.2.0

  • Verifizierte Kompatibilität mit Vungle SDK 6.10.2.
  • Ein Problem mit dem Adapter wurde behoben: Ersetzen Sie den Parameter serverParameters durch mediationExtras, um netzwerkspezifische Vungle-Parameter zu erhalten, wenn Sie Banner- und Interstitial-Anzeigen anfordern.

Entwickelt und getestet mit:

  • Version 20.3.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.10.2.

Version 6.10.1.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.10.1.
  • Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 20.3.0 aktualisiert.
  • MREC-Anzeigen werden jetzt mit der Vungle Banner API unterstützt.
  • Aktualisierte standardisierte Fehlercodes und -meldungen.

Entwickelt und getestet mit:

  • Version 20.3.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.10.1.

Version 6.9.1.1

  • Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf 20.0.0 aktualisiert.

Entwickelt und getestet mit:

  • Version 20.0.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.9.1.

Version 6.9.1.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.9.1.
  • OMSDK wird jetzt unterstützt.
  • Diverse Fehlerkorrekturen.
  • Unterstützung von Anzeigen mit Prämie bei Vungle onAdViewed-Callback.
  • Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.7.0 aktualisiert.

Entwickelt und getestet mit:

  • Version 19.7.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.9.1.

Version 6.8.1.1

  • 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.
  • Vungle SDK-Version 6.8.1.

Version 6.8.1.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.8.1.
  • 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.
  • Vungle SDK-Version 6.8.1.

Version 6.8.0.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.8.0.
  • Der Adapter wurde so geändert, dass onAdClosed() nicht weitergeleitet wird, wenn Banneranzeigen aktualisiert oder gelöscht werden.
  • Entfernen Sie FlexFeed und FlexView (in Vungle 6.8.0 eingestellt).
  • Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.4.0 aktualisiert.

Entwickelt und getestet mit:

  • Version 19.4.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.8.0.

Version 6.7.1.0

  • Verifizierte Kompatibilität mit Vungle SDK 6.7.1.
  • Ein Fehler wurde behoben, durch den Anzeigen nicht geladen wurden, wenn eine Anzeige mit einem Anwendungskontext geladen wurde.
  • targetSdkVersion wurde auf API 29 aktualisiert.
  • 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.
  • Vungle SDK-Version 6.7.1.

Version 6.7.0.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.7.0.
  • Der Adapter wurde aktualisiert, um Anforderungen für adaptive Inline-Banner zu unterstützen.
  • Interstitial-Anzeigen und Anzeigen mit Prämie sind jetzt standardmäßig stummgeschaltet.
  • Interstitial-Anzeigen leiten jetzt den onAdLeftApplication()-Callback zurück, wenn sie angeklickt werden.
  • Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 19.2.0 aktualisiert.

Entwickelt und getestet mit:

  • Version 19.2.0 des Google Mobile Ads SDKs.
  • Vungle SDK-Version 6.7.0.

Version 6.5.3.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.5.3.
  • Unterstützung des neu eingeführten Vungle-Bannerformats
  • 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.
  • Vungle SDK-Version 6.5.3.

Version 6.4.11.1

  • Banneranzeigen konnten nicht aktualisiert werden.

Version 6.4.11.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.4.11.
  • Banneranzeigen werden jetzt unterstützt.
  • Der Adapter wurde zu AndroidX migriert.
  • Die erforderliche Mindestversion des Google Mobile Ads SDKs wurde auf Version 18.2.0 aktualisiert.

Version 6.3.24.1

  • 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 6.3.24.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.3.24.

Version 6.3.17.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.3.17.

Version 6.3.12.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.3.12.

Version 6.2.5.1

  • Der Adapter wurde aktualisiert, um das Anzeigenereignis onRewardedVideoComplete() aufzurufen.

Version 6.2.5.0

  • Bestätigte Kompatibilität mit Vungle SDK 6.2.5.

Version 5.3.2.1

  • Der Adapter wurde aktualisiert, sodass Klicks richtig an das Google Mobile Ads SDK gemeldet werden.

Version 5.3.2.0

  • Verifizierte Kompatibilität mit Vungle SDK 5.3.2.
  • Das Adpater-Projekt für Android Studio 3.0 wurde aktualisiert.
  • Die folgenden Methoden wurden der Bundle Builder-Klasse hinzugefügt.
    • setOrdinalViewCount: Dieses Feld wird dazu verwendet, die Vermittlungs Ordinal zu übergeben, wenn der Publisher die normalen Datenberichte von Vungle erhält.
    • setFlexViewCloseTimeInSec: Diese Option wird verwendet, um Anzeigen nach der angegebenen Anzahl von Sekunden automatisch zu schließen.

Version 5.3.0.0

  • Bestätigte Kompatibilität mit Vungle SDK 5.3.0.

Version 5.1.0.0

  • Der Adapter wurde aktualisiert, damit er mit dem Vungle SDK 5.1.0 kompatibel ist.
  • Das Versionsbenennungssystem wurde zu [Vungle SDK-Version)[adapter Patch version] geändert.

Frühere Versionen

  • Interstitial-Anzeigen und Videoanzeigen mit Prämie werden jetzt unterstützt.