Mintegral in Bidding einbinden (Beta)

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Mintegral mithilfe von Vermittlung laden und ausliefern. Dabei werden sowohl Vermittlungsabfolgen als auch Gebotsintegrationen behandelt. Darin erfahren Sie, wie Sie Mintegral der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Mintegral SDK und den Adapter in eine Android-App einbinden.

Unterstützte Einbindungen und Anzeigenformate

Der Mediationsadapter für Mintegral bietet folgende Funktionen:

² Die abfolgebasierte Integration befindet sich in der offenen Betaphase.

Voraussetzungen

• Android API-Level 21 oder höher

• [Gebote]: Wenn Sie alle unterstützten Anzeigenformate in Gebote einbinden möchten, verwenden Sie den Mintegral-Adapter 16.5.91.1 oder höher (die neueste Version wird empfohlen).

• Neueste Version des Google Mobile Ads SDK

• Mediation abschließen Startleitfaden

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

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

App-Schlüssel suchen

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 die 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.

Wählen Sie als Gebotstyp Header Bidding aus. Füllen Sie den Rest des Formulars aus und klicken Sie auf Speichern.

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

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

Mintegral Reporting API-Schlüssel ermitteln

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

Melden Sie sich in Ihrem Ad Manager-Konto an.

Mintegral zu „Unternehmen“ hinzufügen

Freigabe sicherer Signale aktivieren

Sicheres Signal in Gebotsanfragen freigeben

Freigabe sicherer Signale für SDK-Gebote zulassen

Mintegral-Gebote konfigurieren

Anzeigenblockzuordnung konfigurieren

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

Folgen Sie der Anleitung unter Einstellungen für EU-Verordnungen und Einstellungen für Verordnungen von US-Bundesstaaten, um Mobvista/Mintegral in der Ad Manager-Benutzeroberfläche der Liste der Anzeigenpartner für EU-Verordnungen und Verordnungen von US-Bundesstaaten hinzuzufügen.

Schritt 3: Mintegral SDK und Adapter importieren

Android Studio-Integration (empfohlen)

Fügen Sie in 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.6.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-Adapter-Artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei 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 Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Geräte-IDs und personenbezogenen Daten offenlegen und ihre Einwilligung einholen. 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 jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das personenbezogene Daten erheben, empfangen oder verwenden kann. Außerdem müssen Sie Informationen zur Nutzung jedes Netzwerks bereitstellen. Google kann die Einwilligung des Nutzers derzeit nicht automatisch auf solche Netzwerke übertragen.

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

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 richtig 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

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 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 weiterzugeben.

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 der Anforderung 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 Ad Manager.

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

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von Mintegral erhalten, aktivieren Sie im Anzeigenprüftool die Tests einzelner Anzeigenquellen und verwenden Sie die Anzeigenquellen Mintegral (Gebotseinstellung) und Mintegral (Vermittlungsabfolge).

Optionale Schritte

Mintegral zur Liste der CCPA-Werbepartner hinzufügen

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

Native Anzeigen

Anzeigen-Rendering

Der Mintegral-Adapter gibt seine nativen Anzeigen als NativeAd-Objekte zurück. Es füllt die folgenden Felder für ein NativeAd aus.

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

Fehlercodes

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

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

Im Folgenden finden Sie die Codes und die zugehörigen Meldungen, die vom Mintegral-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Mintegral Android Mediation Adapter – Änderungsprotokoll

Nächste Version

• Das Mintegral SDK wird jetzt in einem Hintergrund-Thread initialisiert, um ANRs zu beheben.
• Es wird jetzt der Aktivitätskontext verwendet, der zum Zeitpunkt der Auslieferung übergeben wird, um Anzeigen für App-Starts zu schalten. So werden unerwartete Auslieferungsfehler vermieden.

Version 16.8.61.0

• Kompatibilität mit dem Mintegral SDK 16.8.61 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

• Kompatibilität mit dem Mintegral SDK 16.7.91 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

• Kompatibilität mit dem Mintegral SDK 16.7.51 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

• Kompatibilität mit dem Mintegral SDK 16.7.11 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

• Kompatibilität mit dem Mintegral SDK 16.6.71 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

• Kompatibilität mit dem Mintegral SDK 16.6.41 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-Anzeigen öffnen“ 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

• Kompatibilität mit dem Mintegral SDK 16.5.31 bestätigt.
• Der Adapter ist jetzt wieder von der Version 22.3.0 des Google Mobile Ads SDK abhängig.
• 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

• Kompatibilität mit dem Mintegral SDK 16.5.21 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
• Kompatibilität mit dem Mintegral SDK 16.5.11 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 dem 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.
• Kompatibilität mit dem Mintegral SDK 16.4.21 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

• Kompatibilität mit dem Mintegral SDK 16.3.91 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

• Kompatibilität mit dem Mintegral SDK 16.3.41 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

• Kompatibilität mit dem Mintegral SDK 16.3.11 bestätigt.
• Der Adapter wurde aktualisiert, damit onUserEarnedReward() vor 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!
• Unterstützung für Gebote für Banner (einschließlich MREC), Interstitial-, Anzeigen mit Prämie und native Anzeigenformate hinzugefügt.

Entwickelt und getestet mit:

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