Mintegral in die Vermittlung einbinden

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)

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

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

  1. Wenn Sie das Mintegral SDK einbinden möchten, gehen Sie zu Mintegral SDK for Android.

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

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.