Moloco in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von Moloco mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Gebotsintegrationen behandelt. Darin wird beschrieben, wie Sie Moloco der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Moloco SDK und den Adapter in eine Android-App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für Moloco bietet die folgenden Funktionen:

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

• Aktuelle GMA Next-Gen SDK-Version.

• Richten Sie die Vermittlung ein.

Schritt 1: Konfigurationen in der Moloco-Benutzeroberfläche einrichten

Melden Sie sich im Moloco Publisher Portal an.

Rufen Sie den Tab Übersicht > Apps auf und klicken Sie auf den Button App hinzufügen, um eine neue App zu erstellen.

Wählen Sie das Betriebssystem und die Datenschutzeinstellungen für Ihre App aus, füllen Sie den Rest des Formulars aus und klicken Sie dann auf Erstellen.

Nachdem Ihre App erstellt wurde, wählen Sie sie auf dem Tab Apps aus, um die Details aufzurufen. Notieren Sie sich den App-Schlüssel.

Rufen Sie den Tab Übersicht > Anzeigenblöcke auf, wählen Sie die App im Drop-down-Menü aus und klicken Sie dann auf Neuer Anzeigenblock.

Wählen Sie In-App-Gebote als Auktionsmethode aus und füllen Sie den Rest des Formulars aus. Klicken Sie dann auf Erstellen.

Rufen Sie den neu erstellten Anzeigenblock auf dem Tab Anzeigenblöcke auf, um die zugehörigen Details anzusehen. Notieren Sie sich die Anzeigenblock-ID.

Schritt 2: Moloco-Nachfrage in der Ad Manager-Benutzeroberfläche einrichten

Melden Sie sich in Ihrem Ad Manager-Verwaltungskonto an.

Freigabe sicherer Signale aktivieren

Klicken Sie auf Admin > Globale Einstellungen. Rufen Sie den Tab Ad Exchange-Kontoeinstellungen auf und aktivieren Sie die Option Freigabe sicherer Signale. Klicken Sie auf Speichern.

Sichere Signale in Gebotsanfragen freigeben

Rufen Sie Inventar > Sichere Signale auf. Suchen Sie unter Sichere Signale nach Moloco Anzeigen-SDK und aktivieren Sie App-Integration aktivieren.

Klicken Sie auf Speichern.

Freigabe sicherer Signale für SDK-Gebote zulassen

Klicken Sie auf Auslieferung > Einstellungen für Nachfragechannel. Aktivieren Sie auf dem Tab Standardeinstellungen die Option Freigabe sicherer Signale zulassen für SDK-Gebote.

Klicken Sie auf Speichern.

Moloco-Bidding konfigurieren

Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Klicken Sie auf Neuer Bieter.

Wählen Sie Moloco Ads als Bieter aus.

Klicken Sie auf Weiter, um SDK-Gebote für diesen Bieter zu aktivieren.

Klicken Sie auf Fertig.

Anzeigenblockzuordnung konfigurieren

Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Wählen Sie das Unternehmen für das Moloco Anzeigen-SDK aus.

Rufen Sie den Tab Anzeigenblockzuordnung auf und klicken Sie auf Neue Anzeigenblockzuordnung.

Wählen Sie Spezifischer Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format, Mobile App als Inventartyp und Ihre Mobile App aus. Geben Sie dann den App-Schlüssel und die Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben.

Klicken Sie abschließend auf Speichern.

Moloco Ads der Liste der Werbepartner für EU- und US-Bundesstaatsverordnungen hinzufügen

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

Schritt 3: Moloco SDK und Adapter importieren

Android Studio-Integration (empfohlen)

Fügen Sie in der Datei build.gradle.kts auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu. Verwenden Sie die aktuellen Versionen des Moloco SDK und des Adapters:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:moloco:4.13.0.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

Schritt 4: Datenschutzeinstellungen im Moloco SDK implementieren

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.

Der Moloco Ads SDK-Android-Adapter in Version 3.5.0.0 und höher unterstützt die Übergabe von Signalen zur Einwilligung gemäß DSGVO von Consent Management-Plattformen, die in das Transparency and Consent Framework (TCF) des IAB eingebunden sind, an das Moloco Ads SDK. Weitere Informationen finden Sie in der Dokumentation zu MolocoPrivacy.

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 Moloco SDK enthält das Flag isDoNotSell, um Einwilligungsinformationen an das Moloco SDK zu übergeben.

Im folgenden Beispielcode wird gezeigt, wie Einwilligungsinformationen an das Moloco SDK übergeben werden. Wenn Sie diese Flags festlegen möchten, sollten Sie das tun, bevor Sie Anzeigen über GMA Next-Gen SDK anfordern.

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
MolocoMediationSnippets.kt

PrivacySettings privacySettings =
    new PrivacySettings(
        /* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);
MolocoMediationSnippets.java

Weitere Informationen

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager.

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen vom Moloco Anzeigen-SDK erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquelle (n) Moloco(Gebote).

Fehlercodes

Wenn der Adapter keine Anzeige von Moloco erhält, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo.getAdSourceResponses() unter den folgenden Klassen prüfen:

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

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

Moloco Android-Mediationsadapter – Versionshinweise

Version 4.13.0.0

• Kompatibilität mit Moloco SDK 4.13.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.5.0
• Google Mobile Ads Next-Gen SDK Version 1.5.0
• Moloco SDK-Version 4.13.0

Version 4.12.0.1

• Legen Sie die Kotlin-Abhängigkeit des Adapters auf 1.9.0 fest (die vom GMA NextGen SDK unterstützte Mindestversion von Kotlin).

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.4.0
• Moloco SDK-Version 4.12.0

Version 4.12.0.0

• Kompatibilität mit Moloco SDK 4.12.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.4.0
• Moloco SDK-Version 4.12.0

Version 4.11.1.0

• Aktualisiert, um eine Anzeigenimpression zu melden, wenn eine native Anzeige ausgeliefert wird.
• Banneranzeigen wurden korrigiert, sodass beim Klicken der Callback onAdOpened aufgerufen wird, anstatt dass sie angezeigt werden.
• Kompatibilität mit Moloco SDK 4.11.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.3.1
• Moloco SDK-Version 4.11.1

Version 4.11.0.0

• Unterstützung für adaptive Banner zum Moloco-Vermittlungsadapter hinzugefügt.
• Kompatibilität mit Moloco SDK 4.11.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.3.1
• Moloco SDK-Version 4.11.0

Version 4.10.1.0

• Kompatibilität mit Moloco SDK 4.10.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.2.1
• Moloco SDK-Version 4.10.1

Version 4.10.0.0

• Wird den Einstellungen für Altersbeschränkungen von Moloco (AgeRestrictedTreatment) zugeordnet.
• Kompatibilität mit Moloco SDK 4.10.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.4.0
• Google Mobile Ads Next-Gen SDK Version 1.2.1
• Moloco SDK-Version 4.10.0

Version 4.9.0.0

• Kompatibilität mit Moloco SDK 4.9.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.3.0
• Google Mobile Ads Next-Gen SDK Version 1.1.1
• Moloco SDK-Version 4.9.0

Version 4.9.0.0 (in Arbeit)

Version 4.8.1.0

• Kompatibilität mit Moloco SDK 4.8.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.2.0
• Google Mobile Ads Next-Gen SDK Version 1.0.1
• Moloco SDK-Version 4.8.1.

Version 4.8.0.0

• Aktualisiert, um den Anwendungskontext an „Moloco.initialize()“ anstelle des Aktivitätskontexts zu übergeben, um Speicherlecks zu vermeiden.
• Kompatibilität mit Moloco SDK 4.8.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 25.2.0
• Google Mobile Ads Next-Gen SDK, Version 0.25.0-beta01
• Moloco SDK-Version 4.8.0

Version 4.7.0.0

• Es wurde eine Eigenschaft hinzugefügt, mit der der Adapter mit der GMA Next-Gen SDK-Abhängigkeit erstellt werden kann.
• Kompatibilität mit Moloco SDK 4.7.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 25.1.0
• Google Mobile Ads Next-Gen SDK, Version 0.25.0-beta01
• Moloco SDK-Version 4.7.0

Version 4.6.0.0

• Kompatibilität mit Moloco SDK 4.6.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• Moloco SDK Version 4.6.0

Version 4.5.0.0

• Kompatibilität mit Moloco SDK 4.5.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• Moloco SDK-Version 4.5.0

Version 4.4.0.0

• Kompatibilität mit Moloco SDK 4.4.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.9.0
• Moloco SDK-Version 4.4.0

Version 4.3.1.0

• Kompatibilität mit Moloco SDK 4.3.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.8.0
• Moloco SDK-Version 4.3.1

Version 4.2.1.0

• Kompatibilität mit Moloco SDK 4.2.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.7.0
• Moloco SDK-Version 4.2.1

Version 4.2.0.0

• Kompatibilität mit Moloco SDK 4.2.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.7.0
• Moloco SDK-Version 4.2.0

Version 4.1.1.0

• Kompatibilität mit Moloco SDK 4.1.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.7.0
• Moloco SDK-Version 4.1.1.

Version 4.1.0.0

• Kompatibilität mit Moloco SDK 4.1.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.6.0
• Moloco SDK-Version 4.1.0

Version 4.0.0.0

• Kompatibilität mit Moloco SDK 4.0.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.5.0
• Moloco SDK-Version 4.0.0

Version 3.12.1.0

• Kompatibilität mit Moloco SDK 3.12.1 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.5.0
• Moloco SDK-Version 3.12.1

Version 3.12.0.0

• Kompatibilität mit Moloco SDK 3.12.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.4.0
• Moloco SDK Version 3.12.0

Version 3.11.0.0

• Kompatibilität mit Moloco SDK 3.11.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.4.0
• Moloco SDK Version 3.11.0

Version 3.10.0.0

• Kompatibilität mit Moloco SDK 3.10.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.3.0
• Moloco SDK-Version 3.10.0

Version 3.9.0.0

• Kompatibilität mit Moloco SDK 3.9.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 24.2.0
• Moloco SDK Version 3.9.0

Version 3.8.0.1

• Unterstützung für die Banneranzeigengröße „Medium Rectangle“ hinzugefügt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.1.0
• Moloco SDK Version 3.8.0

Version 3.8.0.0

• Unterstützung für Gebote für das native Anzeigenformat hinzugefügt.
• Kompatibilität mit Moloco SDK 3.8.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.1.0
• Moloco SDK-Version 3.8.0

Version 3.7.2.0

• Kompatibilität mit Moloco SDK 3.7.2 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.0.0
• Moloco SDK-Version 3.7.2

Version 3.7.1.0

• Das erforderliche Android-API-Mindestlevel wurde auf 23 aktualisiert.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 24.0.0 aktualisiert.
• Kompatibilität mit Moloco SDK 3.7.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.0.0
• Moloco SDK-Version 3.7.1

Version 3.7.0.0

• Kompatibilität mit Moloco SDK 3.7.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.6.0
• Moloco SDK-Version 3.7.0

Version 3.6.1.0

• Kompatibilität mit Moloco SDK 3.6.1 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.6.0
• Moloco SDK-Version 3.6.1

Version 3.6.0.0

• Kompatibilität mit Moloco SDK 3.6.0 bestätigt.

Erstellt und getestet mit:

• Google Mobile Ads SDK Version 23.6.0
• Moloco SDK Version 3.6.0

Version 3.5.0.0

• Erste Version
• Unterstützung für Gebote für Banner-, Interstitial- und Anzeigenformate mit Prämie wurde hinzugefügt.
• Kompatibilität mit Moloco SDK 3.5.0 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.6.0
• Moloco SDK-Version 3.5.0