Einbindung von Mintegral in Bidding (Beta)

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus Mintegral mithilfe der Vermittlung zu laden und einzublenden. Dabei werden sowohl die Vermittlungsabfolge als auch die Gebotsintegration berücksichtigt. Sie erfahren, 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 Ad Manager -Vermittlungsadapter für Mintegral hat folgende Funktionen:

Integration
Gebote  1
Wasserfall  2
Formate
App öffnen  1  2
Banner
Interstitial
Verfügbar
Interstitial mit Prämie
Nativ  1  3
1 Die Gebotsintegration befindet sich in der geschlossenen Betaphase.

2 Die Wasserfall-Integration befindet sich in der geschlossenen Betaversion.

Voraussetzungen

  • Android API-Level 21 oder höher

  • Das aktuelle Google Mobile Ads SDK

  • Arbeiten Sie den Startleitfaden zur Vermittlung ab.

Schritt 1: Konfigurationen in der Mintegral-Benutzeroberfläche 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

Gebote

Dieser Schritt ist für die Verknüpfung von Geboten nicht erforderlich.

Wasserfall

Sie benötigen Ihren Mintegral Reporting API-Schlüssel, um IhreAd Manager -Anzeigenblock-ID einzurichten. Gehen Sie zu Account > API Tools (Konto > API-Tools). Notieren Sie sich Ihren Skey und Ihren Secret.

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

Melden Sie sich in Ihrem Ad Manager-Konto an.

Mintegral in „Unternehmen“ hinzufügen

Gebote

Dieser Schritt ist für die Verknüpfung von Geboten nicht erforderlich.

Wasserfall

Rufen Sie Admin > Unternehmen auf und klicken Sie dann auf dem Tab Alle Unternehmen auf die Schaltfläche Neues Unternehmen. Wählen Sie Werbenetzwerk aus.

Wählen Sie Mintegral als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie die Vermittlung.

Sie müssen keinen Nutzernamen und kein Passwort eingeben. Klicken Sie abschließend auf Speichern.

Freigabe sicherer Signale aktivieren

Gebote

Gehen Sie zu Admin > Globale Einstellungen. Wechseln Sie zum Tab Ad Exchange-Kontoeinstellungen und aktivieren Sie Freigabe sicherer Signale. Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Gebotseinstellung Mintegral konfigurieren

Gebote

Rufen Sie Auslieferung > Bieter auf und klicken Sie auf dem Tab SDK-Gebote auf Neuer Bieter.

Wählen Sie Mintegral als Bieter aus.

Aktivieren Sie die Optionen Signalbibliothek dieses Bieters der Liste der zulässigen Signale hinzufügen und Freigabe von Signalen für diesen Bieter zulassen. Klicken Sie dann auf Weiter.

Klicken Sie auf Weiter.

Klicken Sie auf Fertig.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Anzeigenblockzuordnung konfigurieren

Gebote

Rufen Sie Auslieferung > Bieter auf und wählen Sie auf dem Tab SDK-Gebote das Unternehmen fürMintegral aus.

Wechseln Sie zum Tab Anzeigenblockzuordnung und klicken Sie auf Neue Anzeigenblockzuordnung.

Wählen Sie Bestimmter Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format, Mobile App als Inventartyp und Ihre Mobile App aus. Geben Sie dannApp Key, App ID, Placement ID, and Ad Unit ID erhalten (im vorherigen Abschnitt) ein. Klicken Sie abschließend auf Speichern.

Wasserfall

Rufen Sie Auslieferung > Ertragsgruppen auf und klicken Sie auf die Schaltfläche Neue Ertragsgruppe. Wählen Sie Ihre Mobile App aus.

Scrollen Sie nach unten und klicken Sie auf Ertragspartner hinzufügen.

Wählen Sie das Unternehmen aus, für das Sie Mintegralim vorherigen Abschnitt erstellt haben. Wählen Sie als Integrationstyp die Option SDK-Vermittlung für Mobilgeräte, als Plattform Android und als Status Aktiv aus.

Geben Sie den Wert App Key, App ID, Placement ID, and Ad Unit IDaus dem vorherigen Abschnitt und den Wert für Standard-CPM ein. Klicken Sie auf Speichern.

Mintegral zur Liste der Werbepartner gemäß DSGVO und Bestimmungen von US-Bundesstaaten hinzufügen

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

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

Manuelle Integration

  1. Informationen zum Einbinden 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

Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie dafür sorgen, dass Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten offengelegt und deren Einwilligung von diesen eingeholt wird. 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 nutzen kann, und Informationen zur Nutzung der einzelnen Werbenetzwerke angeben. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke weiterzugeben.

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 vor dem Initialisieren des Google Mobile Ads SDK festgelegt werden, 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 Datenschutzdokumentation von Mintegral.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten schreiben Nutzern das Recht, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Begriffe). Dazu muss auf der Startseite des „Verkäufers“ ein deutlich 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 Anzeigenbereitstellung durch Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in der Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das möglicherweise am Verkauf personenbezogener Daten beteiligt ist, und die Anleitungen 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 sie nach Initialisierung des Google Mobile Ads SDK auf, bevor Sie jedoch Anzeigen über das Google Mobile Ads SDK anfordern.

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 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 zur Liste der CCPA-Werbepartner hinzufügen

Folgen Sie der Anleitung unter CCPA-Einstellungen um Mintegral auf der Ad Manager Benutzeroberfläche in die Liste der CCPA-Werbepartner aufzunehmen.

Native Anzeigen

Anzeigen-Rendering

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

Field Assets, die immer im Mintegral-Adapter enthalten sind
Anzeigentitel
Bild 1
Text
Icon
Call-to-Action
Bewertung
Speichern
Preis
Advertiser

1 Der Mintegral-Adapter bietet keinen direkten Zugriff auf das Haupt-Bild-Asset für seine nativen Anzeigen. Stattdessen füllt der Adapter MediaView mit einem Video oder einem Bild aus.

Fehlercodes

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

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

Im Folgenden finden Sie die Codes und Begleitmeldungen, 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- 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.
101 com.google.mediation.mintegral Ungültige Serverparameter (z. B. fehlende App- oder Placement-ID)
102 com.google.mediation.mintegral Das Mintegral SDK hat einen Fehler vom Typ „Keine Ausführung“ zurückgegeben.
103 com.google.mediation.mintegral Das Mintegral SDK konnte keine Anzeige ausliefern.
104 com.google.mediation.mintegral Die angeforderte Anzeigengröße stimmt nicht mit einer von Mintegral unterstützten Bannergröße überein.

Änderungsprotokoll für den Android-Mediationsadapter von Mintegral

Version 16.6.51.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.6.51.

Erstellt und getestet mit:

  • Version 22.6.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.6.51.

Version 16.6.41.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.6.41.

Erstellt und getestet mit:

  • Version 22.6.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.6.41.

Version 16.6.34.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.6.34.

Erstellt und getestet mit:

  • Version 22.6.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.6.34.

Version 16.6.21.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.6.21.

Erstellt und getestet mit:

  • Version 22.6.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.6.21.

Version 16.5.91.1

  • Bidding-Unterstützung für App-Start-Anzeigen wurde hinzugefügt.

Erstellt und getestet mit:

  • Version 22.6.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.5.91.

Version 16.5.91.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.5.91.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 22.6.0 aktualisiert.

Erstellt und getestet mit:

  • Version 22.6.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.5.91.

Version 16.5.51.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.5.51.

Erstellt und getestet mit:

  • Version 22.3.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.5.51.

Version 16.5.41.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.5.41.

Erstellt und getestet mit:

  • Version 22.3.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.5.41.

Version 16.5.31.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.5.31.
  • Der Adapter wurde zurückgesetzt, sodass er von Version 22.3.0 des Google Mobile Ads SDK abhängig ist.
  • Für App-Start-Anzeigen wird jetzt die Vermittlungsabfolge unterstützt.

Erstellt und getestet mit:

  • Version 22.3.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.5.31.

Version 16.5.21.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.5.21.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 22.4.0 aktualisiert.

Erstellt und getestet mit:

  • Version 22.4.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.5.21.

Version 16.5.11.0

  • Bidding-Anzeigen werden jetzt für Wasserzeichen unterstützt.
  • Bestätigte Kompatibilität mit Mintegral SDK 16.5.11.

Erstellt und getestet mit:

  • Version 22.2.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.5.11.

Version 16.4.91.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.91.

Erstellt und getestet mit:

  • Version 22.2.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.91.

Version 16.4.81.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.81.

Erstellt und getestet mit:

  • Version 22.2.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.81.

Version 16.4.71.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.71.

Erstellt und getestet mit:

  • Version 22.2.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.71.

Version 16.4.61.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.61.

Erstellt und getestet mit:

  • Version 22.1.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.61.

Version 16.4.51.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.51.

Erstellt und getestet mit:

  • Version 22.1.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.51.

Version 16.4.41.0

  • Ein Problem wurde behoben, bei dem Banneranzeigen mit falschen Größen gerendert wurden.
  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.41.

Erstellt und getestet mit:

  • Version 22.0.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.41.

Version 16.4.31.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.31.

Erstellt und getestet mit:

  • Version 22.0.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.31.

Version 16.4.21.0

  • Der Adapter wurde zur Verwendung der neuen VersionInfo-Klasse aktualisiert.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 22.0.0 aktualisiert.
  • Bestätigte Kompatibilität mit Mintegral SDK 16.4.21.

Erstellt und getestet mit:

  • Version 22.0.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.4.21.

Version 16.3.91.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.3.91.

Erstellt und getestet mit:

  • Version 21.5.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.91.

Version 16.3.81.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.3.81.

Erstellt und getestet mit:

  • Version 21.5.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.81.

Version 16.3.71.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.3.71.

Erstellt und getestet mit:

  • Version 21.5.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.71.

Version 16.3.61.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.3.61.

Erstellt und getestet mit:

  • Version 21.5.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.61.

Version 16.3.51.1

  • Abfolge wird jetzt für Banner (einschließlich MREC), Interstitial-Anzeigen, Anzeigen mit Prämie und native Anzeigenformate unterstützt.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.5.0 aktualisiert.

Erstellt und getestet mit:

  • Version 21.5.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.51.

Version 16.3.51.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.3.51.

Erstellt und getestet mit:

  • Version 21.4.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.51.

Version 16.3.41.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.3.41.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.4.0 aktualisiert.

Erstellt und getestet mit:

  • Version 21.4.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.41.

Version 16.3.11.0

  • Bestätigte Kompatibilität mit Mintegral SDK 16.3.11.
  • Der Adapter wurde so aktualisiert, dass bei Anzeigen mit Prämie onUserEarnedReward() vor dem onAdClosed() weitergeleitet werden.

Erstellt und getestet mit:

  • Version 21.3.0 des Google Mobile Ads SDK
  • Mintegral SDK-Version 16.3.11.

Version 16.2.61.0

  • Erstes Release!
  • Zusätzliche Gebotsunterstützung für Banner (einschließlich MREC), Interstitial-Anzeigen, Anzeigen mit Prämie und native Anzeigenformate.

Erstellt und getestet mit:

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