Mintegral in Bidding einbinden (Beta)

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Mintegral mithilfe der Vermittlung laden und präsentieren. Dabei werden sowohl Abfolge- als auch Gebotsintegrationen abgedeckt. Sie erfahren, wie Sie Mintegral der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Mintegral SDK und den Adapter in eineAndroid -App einbinden.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für Mintegral bietet folgende Funktionen:

² Die Wasserfall-Integration befindet sich in einer geschlossenen Betaphase.

Voraussetzungen

• Android API-Level 21 oder höher

• Neuestes Google Mobile Ads SDK

• Schließen Sie die Vermittlung ab. Startleitfaden

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

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

App-Schlüssel finden

Rufen Sie den Tab APP-Einstellungen auf und notieren Sie sich den APP-Schlüssel.

Neue Anwendung hinzufügen

Klicken Sie auf dem Tab App-Einstellungen auf die Schaltfläche App hinzufügen.

Wählen Sie die Plattform aus und füllen Sie den Rest des Formulars aus. Klicken Sie dann auf Speichern.

Notieren Sie sich die APP-ID Ihrer Anwendung.

Anzeigen-Placement erstellen

Nachdem Sie Ihre Anwendung erstellt haben, rufen Sie den Tab Placements und Blöcke auf und klicken Sie wie unten gezeigt auf die Schaltfläche Placement hinzufügen, um das Anzeigen-Placement zu erstellen.

Geben Sie einen Placement-Namen und ein Anzeigenformat ein.

Notieren Sie sich die Placement-ID, sobald das Placement erstellt wurde.

Klicken Sie auf das Drop-down-Menü 1 Anzeigenblock und notieren Sie sich die Anzeigenblock-ID.

Mintegral Reporting API-Schlüssel ermitteln

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

Mintegral zur Liste der Werbepartner für die DSGVO und Verordnungen von US-Bundesstaaten hinzufügen

Folgen Sie den Schritten in den DSGVO-Einstellungen und den Einstellungen für Verordnungen von US-Bundesstaaten, um Mobvista/Mintegral der Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.

Schritt 3: Mintegral SDK und Adapter importieren

Android Studio-Integration (empfohlen)

Fügen Sie der Datei settings.gradle.kts auf Projektebene die folgenden Repositories hinzu:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}

Manuelle Integration

1. Informationen zum Einbinden des Mintegral SDK finden Sie unter Mintegral SDK for Android.

2. Rufen Sie die Mintegral-Adapterartefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die Datei .aar des Mintegral-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Datenschutzeinstellungen im Mintegral SDK implementieren

Einwilligung der Nutzer in der EU und DSGVO

Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie dafür sorgen, dass Nutzer im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten erhalten und deren Einwilligungen eingeholt werden. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Wenn Sie die Einwilligung einholen, müssen Sie alle Werbenetzwerke in Ihrer Vermittlungskette angeben, die personenbezogene Daten erheben, empfangen oder verwenden können, und Informationen zur Nutzung der einzelnen Werbenetzwerke zur Verfügung stellen. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an solche Netzwerke zu übergeben.

Das Mintegral SDK enthält die Methode setConsentStatus, um Einwilligungsinformationen an das Mintegral SDK zu übergeben.

Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen an das Mintegral SDK übergeben. Diese Optionen müssen festgelegt werden, bevor Sie das Google Mobile Ads SDK initialisieren, damit sie korrekt an das Mintegral SDK weitergeleitet werden.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

Weitere Informationen finden Sie in der Datenschutzerklärung von Mintegral.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten verpflichten Sie, Nutzern das Recht einzuräumen, 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 sollen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten können Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Anzeigennetzwerk 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 Anleitungen dieser Netzwerke befolgen, um die Einhaltung der Anforderungen sicherzustellen.

Das Mintegral SDK enthält die Methode setDoNotTrackStatus, um Einwilligungsinformationen an das Mintegral SDK weiterzuleiten.

Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen an das Mintegral SDK übergeben. Wenn Sie diese Methode aufrufen müssen, rufen Sie sie nach der Initialisierung des Google Mobile Ads SDK aber vor dem Anfordern von Anzeigen über das Google Mobile Ads SDK auf.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

Weitere Informationen finden Sie in der Datenschutzerklärung von Mintegral.

Schritt 5: Erforderlichen Code hinzufügen

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

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

Wenn Sie Mintegral-Testanzeigen für Banner, Interstitials sowie native Anzeigenformate und Anzeigenformate mit Prämie erhalten möchten, empfiehlt Mintegral die Verwendung der App-Schlüssel, App-IDs, Placement-IDs und Anzeigenblock-IDs auf der Seite mit den Mintegral-Test-IDs.

Testanzeigen bestätigen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von Mintegral erhalten, aktivieren Sie im Anzeigenprüftool Tests für einzelne Anzeigenquellen mit den Anzeigenquellen Mintegral (Bidding) und Mintegral (Wasserfall).

Optionale Schritte

Mintegral in die Liste der CCPA-Werbepartner aufnehmen

Folgen Sie der Anleitung unter CCPA-Einstellungen , um Mintegral der Liste der CCPA-Werbepartner in derAd Manager -Benutzeroberfläche hinzuzufügen.

Native Anzeigen

Anzeigen-Rendering

Der Mintegral-Adapter gibt seine nativen Anzeigen als-, NativeAd-,-Objekte zurück. Er wird für die folgenden Felder für eine NativeAd ausgefüllt.

¹ Der Mintegral-Adapter bietet keinen direkten Zugriff auf das Hauptbild-Asset für seine nativen Anzeigen. Stattdessen füllt der Adapter MediaView mit einem Video oder einem Bild.

Fehlercodes

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

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

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

Änderungsprotokoll für den Mintegral Android Mediation Adapter

Nächste Version

• Initialisiere das Mintegral SDK in einem Hintergrundthread, um ANR-Fehler zu beheben.

Version 16.8.61.0

• Die Kompatibilität mit Mintegral SDK 16.8.61 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.3.0
• Mintegral SDK Version 16.8.61.

Version 16.8.51.0

• Kompatibilität mit dem Mintegral SDK 16.8.51 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.3.0
• Mintegral SDK-Version 16.8.51

Version 16.8.41.0

• Kompatibilität mit dem Mintegral SDK 16.8.41 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.3.0
• Mintegral SDK Version 16.8.41.

Version 16.8.31.0

• Kompatibilität mit dem Mintegral SDK 16.8.31 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 23.2.0.
• Mintegral SDK-Version 16.8.31

Version 16.8.11.0

• Kompatibilität mit dem Mintegral SDK 16.8.11 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.2.0
• Mintegral SDK Version 16.8.11.

Version 16.7.91.0

• Die Kompatibilität mit Mintegral SDK 16.7.91 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.2.0
• Mintegral SDK-Version 16.7.91.

Version 16.7.81.0

• Kompatibilität mit dem Mintegral SDK 16.7.81 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 23.2.0.
• Mintegral SDK-Version 16.7.81.

Version 16.7.71.0

• Kompatibilität mit dem Mintegral SDK 16.7.71 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.1.0
• Mintegral SDK-Version 16.7.71.

Version 16.7.61.0

• Kompatibilität mit Mintegral SDK 16.7.61 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.1.0
• Mintegral SDK-Version 16.7.61

Version 16.7.51.0

• Die Kompatibilität mit Mintegral SDK 16.7.51 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 23.1.0.
• Mintegral SDK-Version 16.7.51.

Version 16.7.41.0

• Kompatibilität mit dem Mintegral SDK 16.7.41 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.1.0
• Mintegral SDK Version 16.7.41.

Version 16.7.31.0

• Kompatibilität mit dem Mintegral SDK 16.7.31 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 23.1.0.
• Mintegral SDK-Version 16.7.31.

Version 16.7.21.0

• Kompatibilität mit dem Mintegral SDK 16.7.21 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.0.0.
• Mintegral SDK Version 16.7.21.

Version 16.7.11.0

• Die Kompatibilität mit Mintegral SDK 16.7.11 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.0.0.
• Mintegral SDK-Version 16.7.11.

Version 16.6.71.0

• Die Kompatibilität mit Mintegral SDK 16.6.71 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.0.0.
• Mintegral SDK-Version 16.6.71

Version 16.6.61.0

• Die Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.
• Kompatibilität mit dem Mintegral SDK 16.6.61 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.0.0
• Mintegral SDK Version 16.6.61.

Version 16.6.51.0

• Kompatibilität mit dem Mintegral SDK 16.6.51 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.6.0
• Mintegral SDK-Version 16.6.51

Version 16.6.41.0

• Die Kompatibilität mit Mintegral SDK 16.6.41 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.6.0
• Mintegral SDK-Version 16.6.41

Version 16.6.34.0

• Kompatibilität mit dem Mintegral SDK 16.6.34 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 22.6.0.
• Mintegral SDK-Version 16.6.34

Version 16.6.21.0

• Kompatibilität mit dem Mintegral SDK 16.6.21 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.6.0
• Mintegral SDK-Version 16.6.21

Version 16.5.91.1

• Unterstützung für Gebote für das Anzeigenformat „App-Öffnung“ hinzugefügt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.6.0
• Mintegral SDK-Version 16.5.91.

Version 16.5.91.0

• Kompatibilität mit dem Mintegral SDK 16.5.91 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 22.6.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.6.0
• Mintegral SDK-Version 16.5.91.

Version 16.5.51.0

• Kompatibilität mit dem Mintegral SDK 16.5.51 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.3.0
• Mintegral SDK-Version 16.5.51.

Version 16.5.41.0

• Kompatibilität mit dem Mintegral SDK 16.5.41 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.3.0
• Mintegral SDK-Version 16.5.41.

Version 16.5.31.0

• Die Kompatibilität mit Mintegral SDK 16.5.31 wurde bestätigt.
• Der Adapter wurde so zurückgesetzt, dass er von Version 22.3.0 des Google Mobile Ads SDK abhängig ist.
• Unterstützung für die Vermittlungsabfolge für das Anzeigenformat „App-Start“ hinzugefügt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.3.0
• Mintegral SDK-Version 16.5.31

Version 16.5.21.0

• Die Kompatibilität mit Mintegral SDK 16.5.21 wurde bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 22.4.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.4.0
• Mintegral SDK-Version 16.5.21.

Version 16.5.11.0

• Unterstützung für Wasserzeichen bei Bidding-Anzeigen hinzugefügt
• Die Kompatibilität mit Mintegral SDK 16.5.11 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.2.0
• Mintegral SDK-Version 16.5.11.

Version 16.4.91.0

• Kompatibilität mit Mintegral SDK 16.4.91 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 22.2.0.
• Mintegral SDK-Version 16.4.91.

Version 16.4.81.0

• Kompatibilität mit dem Mintegral SDK 16.4.81 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.2.0
• Mintegral SDK Version 16.4.81.

Version 16.4.71.0

• Kompatibilität mit dem Mintegral SDK 16.4.71 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.2.0
• Mintegral SDK-Version 16.4.71.

Version 16.4.61.0

• Kompatibilität mit Mintegral SDK 16.4.61 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.1.0
• Mintegral SDK-Version 16.4.61

Version 16.4.51.0

• Kompatibilität mit dem Mintegral SDK 16.4.51 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.1.0
• Mintegral SDK-Version 16.4.51.

Version 16.4.41.0

• Ein Problem wurde behoben, durch das Banneranzeigen in der falschen Größe gerendert wurden.
• Kompatibilität mit dem Mintegral SDK 16.4.41 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.0.0
• Mintegral SDK-Version 16.4.41.

Version 16.4.31.0

• Kompatibilität mit dem Mintegral SDK 16.4.31 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.0.0
• Mintegral SDK Version 16.4.31.

Version 16.4.21.0

• Der Adapter wurde aktualisiert, um die neue VersionInfo-Klasse zu verwenden.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 22.0.0 aktualisiert.
• Die Kompatibilität mit Mintegral SDK 16.4.21 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 22.0.0.
• Mintegral SDK-Version 16.4.21.

Version 16.3.91.0

• Die Kompatibilität mit Mintegral SDK 16.3.91 wurde bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.5.0
• Mintegral SDK-Version 16.3.91.

Version 16.3.81.0

• Kompatibilität mit dem Mintegral SDK 16.3.81 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.5.0
• Mintegral SDK-Version 16.3.81

Version 16.3.71.0

• Kompatibilität mit dem Mintegral SDK 16.3.71 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.5.0
• Mintegral SDK Version 16.3.71.

Version 16.3.61.0

• Kompatibilität mit dem Mintegral SDK 16.3.61 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.5.0
• Mintegral SDK Version 16.3.61.

Version 16.3.51.1

• Unterstützung für die Vermittlungsabfolge für Banner (einschließlich MREC), Interstitial-, Anzeigen mit Prämie und native Anzeigen hinzugefügt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 21.5.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.5.0
• Mintegral SDK Version 16.3.51.

Version 16.3.51.0

• Kompatibilität mit dem Mintegral SDK 16.3.51 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 21.4.0.
• Mintegral SDK-Version 16.3.51

Version 16.3.41.0

• Die Kompatibilität mit Mintegral SDK 16.3.41 wurde bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 21.4.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 21.4.0
• Mintegral SDK-Version 16.3.41.

Version 16.3.11.0

• Die Kompatibilität mit Mintegral SDK 16.3.11 wurde bestätigt.
• Der Adapter wurde aktualisiert, sodass onUserEarnedReward() vor dem onAdClosed() weitergeleitet wird, wenn Anzeigen mit Prämie ausgeliefert werden.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 21.3.0
• Mintegral SDK-Version 16.3.11

Version 16.2.61.0

• Erstes Release!
• Bidding wird jetzt für Banner- (einschließlich MREC), Interstitial-Anzeigen, Anzeigen mit Prämie und native Anzeigen unterstützt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 21.3.0
• Mintegral SDK Version 16.2.61.