In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Displayanzeigen von Mintegral mit Vermittlung Sie profitieren sowohl von der Vermittlungsabfolge als auch von Bidding. Sie behandelt wie Sie Mintegral zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen Integration des Mintegral SDK und des Adapters in eine Android App.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter für Mintegral bietet folgende Funktionen:
Integration | |
---|---|
Gebote | 1 |
Wasserfall | 2 |
Formate | |
App öffnen | |
Banner | |
Interstitial | |
Verfügbar | |
Interstitial mit Prämie | |
Nativ |
2 Die Wasserfall-Integration ist verfügbar geschlossene Betaversion
Voraussetzungen
- Android API-Level 21 oder höher
Neuestes Google Mobile Ads SDK
Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der Mintegral UI einrichten
Schritt 2: Mintegral-Nachfrage in der Ad Manager Benutzeroberfläche einrichten
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 Folgendes hinzu:
Repositories:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Füge dann der Datei build.gradle.kts
auf App-Ebene Folgendes hinzu:
Implementierungsabhängigkeiten und -konfigurationen. Verwenden Sie die neuesten Versionen des
Mintegral SDK und Adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.31.0")
}
Manuelle Integration
Informationen zum Hinzufügen des Mintegral SDK finden Sie unter Mintegral SDK for Android.
Gehen Sie zur Artefakte des Mintegral Adapters im Maven-Repository von Google. Neueste Version auswählen und Mintegral herunterladen die Datei
.aar
des Adapters 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-Einwilligung der Nutzer in der EU den Richtlinien entsprechen, müssen Sie sicherstellen, dass bestimmte Personen Einwilligungen von Nutzern im Europäischen Wirtschaftsraum (EWR) bezüglich die Verwendung von Gerätekennungen und personenbezogenen Daten. Diese Richtlinie entspricht den der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung Verordnung (DSGVO) aufgeführt. Beim Einholen der Einwilligung müssen Sie jedes Werbenetzwerk angeben in Ihrer Vermittlungskette, die personenbezogene Daten erheben, erhalten oder nutzen, Informationen zur Nutzung der einzelnen Werbenetzwerke enthalten. Google kann derzeit nicht automatisch an solche Werbenetzwerke übergeben wird.
Das Mintegral SDK enthält die Methode setConsentStatus
zum Übergeben der Einwilligung
an das Mintegral SDK senden.
Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an Mintegral übergeben werden. SDK. Diese Optionen müssen festgelegt werden, bevor Sie Google Mobile Ads SDK initialisieren damit sie korrekt an das Mintegral SDK weitergeleitet werden.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
Datenschutzdokumentation von Mintegral .
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert dieser Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über einen gut sichtbaren "Do Not Sell My Personal"-Artikel Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Bundesstaaten Leitfaden zur Einhaltung gesetzlicher Vorschriften die Möglichkeit, eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google, aber Google kann diese Einstellung nicht auf jede Anzeige anwenden Netzwerk in Ihrer Vermittlungskette. Daher müssen Sie jedes Werbenetzwerk, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.
Das Mintegral SDK enthält die Methode setDoNotTrackStatus
zum Übergeben der Einwilligung
an das Mintegral SDK senden.
Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an Mintegral übergeben werden. SDK. Wenn Sie diese Methode aufrufen müssen, nachher Google Mobile Ads SDK initialisieren . bevor Anzeigen über das Google Mobile Ads SDK angefordert werden.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
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 in CCPA-Einstellungen um Mintegral in die Liste der CCPA-Werbepartner Ad Manager Benutzeroberfläche.
Native Anzeigen
Anzeigen-Rendering
Der Mintegral-Adapter gibt seine nativen Anzeigen als
NativeAd
Objekte. Folgende Werte werden eingefügt:
Felder
für ein
NativeAd
Feld | Assets, die immer im Mintegral-Adapter enthalten sind |
---|---|
Anzeigentitel | |
Bild | 1 |
Text | |
Symbol | |
Call-to-Action | |
Bewertung | |
Shop | |
Preis | |
Advertiser |
1 Der Mintegral-Adapter enthält keine
direkten Zugriff auf das zentrale Bild-Asset für die nativen Anzeigen bieten. Stattdessen
füllt den Adapter in den
MediaView
mit einem Video oder Bild.
Fehlercodes
Wenn der Adapter keine Anzeige von Mintegral empfängt, können Sie auf der
zugrunde liegender Fehler aus der Anzeigenantwort
.
ResponseInfo.getAdapterResponses()
in den folgenden Klassen:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
Hier sind die Codes und zugehörigen Nachrichten, die vom Mintegral-Adapter ausgegeben werden Wenn eine Anzeige nicht geladen werden kann:
Fehlercode | Domain | Grund |
---|---|---|
101 | com.google.ads.mediation.mintegral | Ungültige Serverparameter (z.B. fehlende App-ID oder Placement-ID). |
102 | com.google.ads.mediation.mintegral | Die angeforderte Anzeigengröße stimmt nicht mit einer von Mintegral unterstützten Bannergröße überein. |
103 | com.google.ads.mediation.mintegral | Fehlende oder ungültige Gebotsantwort |
104 | com.google.ads.mediation.mintegral | Das Mintegral SDK hat einen Fehler vom Typ „Keine Ausführung“ zurückgegeben. |
Änderungsprotokoll zum Mintegral Android Mediation Adapter
Version 16.8.31.0
- Die Kompatibilität mit Mintegral SDK 16.8.31 wurde 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
- Die Kompatibilität mit Mintegral SDK 16.8.11 wurde 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
- 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 demonAdClosed()
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.