Einbindung von Mintegral in Bidding (Beta)

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus Mintegral mithilfe von Vermittlung zu laden und einzublenden. Dabei werden sowohl Wasserfall- als auch Bidding-Integrationen 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 Integrationen 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 UI einrichten

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

App-Schlüssel finden

Gehen Sie zum Tab APP Setting (APP-Einstellungen) und notieren Sie sich den APP Key (APP-Schlüssel).

Neue Anwendung hinzufügen

Klicken Sie auf dem Tab APP-Einstellung 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 App.

Anzeigen-Placement erstellen

Rufen Sie nach dem Erstellen Ihrer Anwendung den Tab Placements und Einheiten auf und klicken Sie wie unten gezeigt auf die Schaltfläche Placement hinzufügen, um Ihr Anzeigen-Placement zu erstellen.

Geben Sie einen Placement-Namen und ein Anzeigenformat ein.

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

Notieren Sie nach dem Erstellen des Anzeigen-Placements die Placement-ID.

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

Mintegral Reporting API-Schlüssel finden

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

Melden Sie sich in Ihrem Ad Manager-Konto an.

Mintegral in „Unternehmen“ hinzufügen

Freigabe sicherer Signale aktivieren

Gebotseinstellung Mintegral konfigurieren

Anzeigenblockzuordnung konfigurieren

Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Mintegral

Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Mintegral in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der Ad Manager Benutzeroberfläche aufzunehmen.

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.2.0")
    implementation("com.google.ads.mediation:mintegral:16.7.81.0")
}

Manuelle Integration

1. Informationen zum Hinzufügen 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. Diese 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.

Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das Mintegral SDK übergeben werden. 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 Datenschutzdokumentation von Mintegral.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten müssen Nutzern das Recht einräumen, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Bedingungen). Dazu muss auf der Startseite des „Verkäufers“ ein gut sichtbarer Link mit dem Text „Meine personenbezogenen Daten sollen nicht verkauft werden“ eingeblendet werden. Der Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten bietet die Möglichkeit, die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google zu aktivieren. Google kann diese Einstellung jedoch nicht auf die einzelnen Werbenetzwerke 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 Werbenetzwerke befolgen, um die Compliance sicherzustellen.

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

Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das Mintegral SDK übergeben werden. Wenn Sie diese Methode aufrufen müssen, rufen Sie sienach das Google Mobile Ads SDK initialisieren , aber bevor Sie Anzeigen über das Google Mobile Ads SDK anfordern.

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

Um Mintegral-Testanzeigen für Banner, Interstitials sowie native Anzeigenformate und Anzeigen mit Prämie zu erhalten, empfiehlt Mintegral die Verwendung der App-Schlüssel, App-IDs, Placement-IDs und Anzeigenblock-IDs, die auf der Seite mit der Mintegral-Test-ID bereitgestellt werden.

Testanzeigen überprüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen vonMintegralerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der Mintegral (Bidding) and Mintegral (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.

Optionale Schritte

Mintegral in die Liste der CCPA-Werbepartner aufnehmen

Folgen Sie der Anleitung unter CCPA-Einstellungen , um Mintegral zur Liste der CCPA-Werbepartner auf 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 zugehörigen Meldungen, die vom Mintegral-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Änderungsprotokoll zum Mintegral Android Mediation Adapter

Version 16.7.81.0

• Die Kompatibilität mit Mintegral SDK 16.7.81 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.7.71 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.7.61 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.7.41 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.7.31 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.7.21 wurde 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 23.0.0 aktualisiert.
• Die Kompatibilität mit Mintegral SDK 16.6.61 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.6.51 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.6.34 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.6.21 wurde 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

• Bidding-Unterstützung für das App-Start-Anzeigenformat wurde 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

• Die Kompatibilität mit Mintegral SDK 16.5.91 wurde bestätigt.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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

• Die Kompatibilität mit Mintegral SDK 16.5.51 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.5.41 wurde 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.
• Abfolgebasierte Unterstützung für App-Start-Anzeigen wurde 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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

• Wasserzeichenunterstützung für Bidding-Anzeigen wurde 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

• Die Kompatibilität mit Mintegral SDK 16.4.91 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.4.81 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.4.71 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.4.61 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.4.51 wurde 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

• Banneranzeigen wurden mit falschen Größen gerendert. Das Problem wurde behoben.
• Die Kompatibilität mit Mintegral SDK 16.4.41 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.4.31 wurde 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 zur Verwendung der neuen VersionInfo-Klasse aktualisiert.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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

• Die Kompatibilität mit Mintegral SDK 16.3.81 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.3.71 wurde 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

• Die Kompatibilität mit Mintegral SDK 16.3.61 wurde 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

• Abfolgebasierte Unterstützung für Banner- (einschließlich MREC), Interstitial-Anzeigen, Anzeigen mit Prämie und native Anzeigen wurde hinzugefügt.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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

• Die Kompatibilität mit Mintegral SDK 16.3.51 wurde 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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.