In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von Mintegral über die AdMob-Vermittlung laden und ausliefern. Dabei werden sowohl Vermittlungsabfolge- als auch Gebotsintegrationen behandelt. Hier 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 Integrationen und Anzeigenformate
Der Vermittlungsadapter für Mintegral bietet die folgenden Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Vermittlungsabfolge | |
| Formate | |
| App öffnen | |
| Banner | |
| Interstitial | |
| Verfügbar | |
| Interstitial mit Prämie | |
| Nativ | |
Voraussetzungen
- Android API‑Level 24 oder höher
- [Für Gebote] Wenn Sie alle unterstützten Anzeigenformate in Geboten einbinden möchten, verwenden Sie den Mintegral-Adapter 16.5.91.1 oder höher (die neueste Version wird empfohlen)
Neuestes GMA Next-Gen SDK.
Anleitung „Erste Schritte mit der Vermittlung“ vollständig durcharbeiten.
Schritt 1: Konfigurationen in der Mintegral-Benutzeroberfläche einrichten
Registrieren Sie sich oder melden Sie sich an für ein Mintegral-Konto.
App-Schlüssel suchen
Gehen Sie zum Tab APP Setting (App-Einstellung) und notieren Sie sich den APP Key (App-Schlüssel).

Neue App hinzufügen
Klicken Sie auf dem Tab APP Setting (App-Einstellung) auf die Schaltfläche Add APP (App hinzufügen).

Wählen Sie die Platform (Plattform) aus und füllen Sie den Rest des Formulars aus. Klicken Sie anschließend auf Save (Speichern).
Notieren Sie sich die APP ID (App-ID) Ihrer App.
Anzeigen-Placement erstellen
Nachdem Sie Ihre App erstellt haben, gehen Sie zum Tab Placements &Units (Placements und Anzeigenblöcke) und klicken Sie auf die Schaltfläche Add Placement (Placement hinzufügen), wie unten gezeigt, um Ihr Anzeigen-Placement zu erstellen.
Geben Sie einen Placement Name (Placement-Name) und ein AD Format (Anzeigenformat) ein.
Gebote
Wählen Sie Header Bidding (Header Bidding) als Bidding Type (Gebotstyp) aus. Füllen Sie den Rest des Formulars aus und klicken Sie auf Save (Speichern).

Vermittlungsabfolge
Wählen Sie Waterfall (Vermittlungsabfolge) als Bidding Type (Gebotstyp) aus. Füllen Sie den Rest des Formulars aus und klicken Sie auf Save (Speichern).

Notieren Sie sich nach dem Erstellen des Anzeigen-Placements die Placement ID (Placement-ID).
Klicken Sie auf das Drop-down-Menü 1 AD Units (1 Anzeigenblock) und notieren Sie sich die AD Unit ID (Anzeigenblock-ID).
Mintegral Reporting API Key suchen
Gebote
Dieser Schritt ist für Gebotsintegrationen nicht erforderlich.
Vermittlungsabfolge
Sie benötigen Ihren Mintegral Reporting API Key, um Ihre AdMob-Anzeigenblock-ID einzurichten. Gehen Sie zu Account (Konto) > API Tools (API-Tools). Notieren Sie sich Ihren Skey (S-Schlüssel) und Ihr Secret (Secret).

app-ads.txt-Datei aktualisieren
Authorized Sellers for Apps (app-ads.txt) ist eine IAB Tech Lab-Initiative, die dafür sorgt, dass Ihr
App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren.
Wenn Sie das noch nicht getan haben,
richten Sie eine app-ads.txt-Datei für Ihre App ein.
Informationen zum Implementieren von app-ads.txt für Mintegral finden Sie unter
Wie app-ads.txt bei der Bekämpfung von Anzeigenbetrug helfen kann.
Schritt 2: Mintegral-Nachfrage in der AdMob-Benutzeroberfläche einrichten
Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren
Sie müssen Mintegral der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.
Melden Sie sich zuerst in Ihrem AdMob-Konto an. Gehen Sie dann zum Tab Mediation (Vermittlung). Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie mit Mintegral als Anzeigenquelle hinzufügen fort.
Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Create Mediation Group (Vermittlungsgruppe erstellen) aus.

Geben Sie Ihr Anzeigenformat und Ihre Plattform ein und klicken Sie auf Continue (Weiter).

Geben Sie Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Zielstandorte aus. Setzen Sie den Status der Vermittlungsgruppe auf Enabled und klicken Sie dann auf Add Ad Units.

Verknüpfen Sie diese Vermittlungsgruppe mit mindestens einem Ihrer vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Done (Fertig).

Auf der Karte „Anzeigenblöcke“ sollten jetzt die von Ihnen ausgewählten Anzeigenblöcke angezeigt werden:

Mintegral als Anzeigenquelle hinzufügen
Gebote
Wählen Sie auf der Karte Bidding (Gebote) im Bereich Ad Sources (Anzeigenquellen) die Option Add ad source (Anzeigenquelle hinzufügen) aus. Wählen Sie dann Mintegral aus.
Klicken Sie auf How to sign a partnership agreement und richten Sie eine Gebotspartnerschaft ein mit Mintegral.
Klicken Sie auf Acknowledge & agree (Bestätigen und zustimmen) und dann auf Continue (Weiter).
Wenn Sie bereits eine Zuordnung für Mintegral haben, können Sie sie auswählen. Klicken Sie andernfalls auf Add mapping (Zuordnung hinzufügen).
Geben Sie dann den App Key (App-Schlüssel), die App ID (App-ID), die Placement ID (Placement-ID) und die Ad Unit ID (Anzeigenblock-ID) ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie anschließend auf Done (Fertig).

Vermittlungsabfolge
Wählen Sie auf der Karte Waterfall (Vermittlungsabfolge) im Bereich Ad Sources (Anzeigenquellen) die Option Add Ad Source (Anzeigenquelle hinzufügen) aus.
Wählen Sie Mintegral aus. Geben Sie dann einen eCPM value (eCPM-Wert) für Mintegral ein und klicken Sie auf Continue (Weiter).

Wenn Sie bereits eine Zuordnung für Mintegral haben, können Sie sie auswählen. Klicken Sie andernfalls auf Add mapping (Zuordnung hinzufügen).

Geben Sie dann den App Key (App-Schlüssel), die App ID (App-ID), die Placement ID (Placement-ID) und die AD Unit ID (Anzeigenblock-ID) ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie anschließend auf Done (Fertig).

Mobvista/Mintegral der Liste der Werbepartner für die DSGVO und die 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 der Liste der Werbepartner für EU-Verordnungen und 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 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 in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:mintegral:17.0.91.0") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' implementation 'com.google.ads.mediation:mintegral:17.0.91.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Manuelle Integration
Wenn Sie das Mintegral SDK einbinden möchten, gehen Sie zu Mintegral SDK for Android.
Gehen Sie zum Maven-Repository von Google, um die Mintegral-Adapterartefakte aufzurufen. 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 für das Mintegral SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zu folgenden Aktivitäten einholen: Einsatz von Cookies oder anderen Formen der lokalen Speicherung, falls die Einholung der Einwilligung dafür gesetzlich vorgeschrieben ist, sowie Erhebung, Weiterleitung und Nutzung personenbezogener Daten für personalisierte Werbung. 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. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.
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 initialisieren GMA Next-Gen SDK , damit sie ordnungsgemäß 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)
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 dürfen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten können Sie die eingeschränkte Datenverarbeitung für die Google-Anzeigenauslieferung aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbe netzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein kann, und die Anleitung der einzelnen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.
Das Mintegral SDK enthält die Methode setDoNotTrackStatus, um Einwilligungsinformationen an das Mintegral SDK zu übergeben.
Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen an das Mintegral SDK übergeben. Wenn Sie diese Methode aufrufen müssen, tun Sie das nach der Initialisierung GMA Next-Gen SDK aber bevor Sie Anzeigen über GMA Next-Gen SDKanfordern.
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)
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
Stellen Sie sicher, dass Sie Ihr Testgerät für AdMob registrieren.
Wenn Sie Mintegral-Testanzeigen für Banner-, Interstitial-, Prämien- und native Anzeigen formate erhalten möchten, empfiehlt Mintegral, die App-Schlüssel, App-IDs, Placement-IDs und Anzeigen block-IDs zu verwenden, die auf der Mintegral-Test-ID-Seite angegeben sind.
Testanzeigen prüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen von Mintegral erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Mintegral (Bidding) und Mintegral (Waterfall) Anzeigenquelle(n).
Optionale Schritte
Mintegral der Liste der CCPA-Werbepartner hinzufügen
Folgen Sie der Anleitung unter CCPA-Einstellungen , um Mintegral der Liste der CCPA-Werbepartner in der AdMob-Benutzeroberfläche hinzuzufügen.
Native Anzeigen
Anzeigen-Rendering
Der Mintegral-Adapter gibt seine nativen Anzeigen als
NativeAd
Objekte zurück. Er füllt die folgenden
Felder
für ein
NativeAd aus.
| Feld | Assets, die immer vom Mintegral-Adapter eingeschlossen werden |
|---|---|
| Anzeigentitel | |
| Bild | 1 |
| Text | |
| Symbol | |
| Call-to-Action | |
| Bewertung | |
| Shop | |
| Preis | |
| Advertiser |
1 Der Mintegral-Adapter bietet keinen direkten Zugriff auf das Haupt-Bild-Asset für seine nativen Anzeigen. Stattdessen wird der
Adapter mit einem Video oder einem Bild gefüllt.MediaView
Fehlercodes
Wenn der Adapter keine Anzeige von Mintegral empfängt, können Sie den
zugrunde liegenden Fehler in der Anzeigenantwort mit
ResponseInfo.getAdSourceResponses()
unter den folgenden Klassen 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:
| 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 entspricht keiner von Mintegral unterstützten Bannergröße. |
| 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. |