Mintegral in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Mintegral mithilfe von AdMob Mediation laden und ausliefern. Dabei werden sowohl Abfolge- als auch Gebotsintegrationen behandelt. Darin wird beschrieben, wie Sie Mintegral der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Mintegral SDK und den Adapter in eine iOS-App einbinden.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für Mintegral bietet folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
App öffnen  1
Banner
Interstitial
Verfügbar
Interstitial mit Prämie
Nativ  2
1 Bidding- und Vermittlungsabfolgeintegrationen für das Anzeigenformat „App-Start“ befinden sich in der geschlossenen Betaphase.

2 Bidding- und abfolgebasierte Integrationen für native Anzeigenformate befinden sich in der offenen Betaphase.

Voraussetzungen

  • iOS-Bereitstellungsziel 11.0 oder höher

  • [Gebote]: Wenn Sie alle unterstützten Anzeigenformate in Gebote einbinden möchten, verwenden Sie den Mintegral-Adapter 7.5.3.0 oder höher (die neueste Version wird empfohlen).

  • Neueste Version des Google Mobile Ads SDK

  • Mediation abschließen Startleitfaden

Schritt 1: Konfigurationen in der Mintegral-Benutzeroberfläche einrichten

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

App-Schlüssel suchen

Rufen Sie den Tab APP-Einstellungen auf und notieren Sie sich den APP-Schlüssel.

Neue Anwendung hinzufügen

Klicken Sie auf dem Tab App-Einstellungen 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 Anwendung.

Anzeigen-Placement erstellen

Nachdem Sie die Anwendung erstellt haben, rufen Sie den Tab Placements und Blöcke auf und klicken Sie wie unten gezeigt auf die Schaltfläche Placement hinzufügen, um das Anzeigen-Placement zu erstellen.

Geben Sie einen Placement-Namen und ein Anzeigenformat ein.

Gebote

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

Wasserfall

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

Notieren Sie sich die Placement-ID, sobald das Placement erstellt wurde.

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

Mintegral Reporting API-Schlüssel ermitteln

Gebote

Dieser Schritt ist für Geboteinbindungen nicht erforderlich.

Wasserfall

Sie benötigen Ihren Mintegral Reporting API-Schlüssel, um Ihre AdMob-Anzeigenblock-ID einzurichten. Gehen Sie zu Konto > API-Tools. Notieren Sie sich Ihren Skey und Ihr Secret.

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. Rufen Sie als Nächstes den Tab Vermittlung auf. Wenn Sie eine bestehende Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten. Fahren Sie dann mit Mintegral als Anzeigenquelle hinzufügen fort.

Wenn Sie eine neue Vermittlungsgruppe erstellen möchten, wählen Sie Vermittlungsgruppe erstellen aus.

Geben Sie das Anzeigenformat und die Plattform ein und klicken Sie auf Weiter.

Geben Sie Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Standorte aus, auf die Sie Ihre Anzeigen ausrichten möchten. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Weisen Sie diese Vermittlungsgruppe mindestens einem Ihrer vorhandenen AdMob-Anzeigenblöcke zu. Klicken Sie dann auf Fertig.

Die Karte „Anzeigenblöcke“ sollte jetzt die von Ihnen ausgewählten Anzeigenblöcke enthalten:

Mintegral als Anzeigenquelle hinzufügen

Gebote


Wählen Sie unter Bidding im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann Mintegral aus.
Klicken Sie auf Partnervereinbarung unterzeichnen und richten Sie eine Bidding-Partnerschaft mit Mintegral ein.
Klicken Sie auf Bestätigen und zustimmen und dann auf Weiter.
Wenn Sie bereits eine Zuordnung für Mintegral haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.
Geben Sie als Nächstes den App-Schlüssel, die App-ID, die Placement-ID und die Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

Wasserfall


Wählen Sie unter der Karte Abfolge im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann Mintegral aus.

Wählen Sie Mintegral aus. Geben Sie dann einen eCPM-Wert für Mintegral ein und klicken Sie auf Weiter.



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

Geben Sie als Nächstes den App-Schlüssel, die App-ID, die Placement-ID und die Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.


Mobvista/Mintegral der Liste der Werbepartner für die DSGVO und Verordnungen von US-Bundesstaaten hinzufügen

Folgen Sie der Anleitung unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten, um Mobvista/Mintegral der Liste der Anzeigenpartner für die DSGVO und Bestimmungen von US-Bundesstaaten in der AdMob-Benutzeroberfläche hinzuzufügen.

Schritt 3: Mintegral SDK und Adapter importieren

  • Fügen Sie der Podfile Ihres Projekts die folgende Zeile hinzu:

    pod 'GoogleMobileAdsMediationMintegral'

  • Führen Sie in der Befehlszeile folgenden Befehl aus:

    pod install --repo-update

Manuelle Integration

  • Laden Sie die neueste Version des Mintegral SDK for iOS herunter und verknüpfen Sie alle .framework-Dateien und ‑Bundles in Ihrem Projekt.
  • Laden Sie die neueste Version des Mintegral-Adapters über den Downloadlink im Changelog herunter und verknüpfen Sie MintegralAdapter.xcframework in Ihrem Projekt.

Schritt 4: Datenschutzeinstellungen im Mintegral SDK implementieren

Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Geräte-IDs und personenbezogenen Daten offenlegen und ihre Einwilligung einholen. 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 verwenden kann. Außerdem müssen Sie Informationen zur Nutzung jedes Netzwerks bereitstellen. Google kann die Einwilligung des Nutzers derzeit nicht automatisch auf solche Netzwerke übertragen.

Das Mintegral SDK enthält die Methode setConsentStatus, um Einwilligungsinformationen an das Mintegral SDK weiterzuleiten.

Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen an das Mintegral SDK übergeben. Diese Optionen müssen festgelegt werden, bevor Sie das Google Mobile Ads SDK initialisieren, damit sie korrekt an das Mintegral SDK weitergeleitet werden.

Swift 

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C 

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

Weitere Informationen finden Sie in der Datenschutzerklärung von Mintegral.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten verpflichten Sie, Nutzern das Recht einzuräumen, 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 sollen 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 von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Anzeigennetzwerk 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 Anleitungen dieser Netzwerke befolgen, um die Einhaltung der Anforderungen sicherzustellen.

Das Mintegral SDK enthält die Methode setDoNotTrackStatus, um Einwilligungsinformationen an das Mintegral SDK weiterzuleiten.

Im folgenden Codebeispiel wird gezeigt, wie Sie Einwilligungsinformationen an das Mintegral SDK übergeben. Wenn Sie diese Methode aufrufen müssen, rufen Sie sie vor der Initialisierung des Google Mobile Ads SDK auf, damit sie richtig an das Mintegral SDK weitergeleitet werden.

Swift 

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C 

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

Weitere Informationen finden Sie in der Datenschutzerklärung von Mintegral.

Schritt 5: Erforderlichen Code hinzufügen

SKAdNetwork-Integration

Folgen Sie der Dokumentation von Mintegral, um der Datei Info.plist Ihres Projekts die SKAdNetwork-IDs hinzuzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

Wenn Sie Mintegral-Testanzeigen für Banner, Interstitials, Anzeigen mit Prämie und native Anzeigenformate erhalten möchten, empfiehlt Mintegral die Verwendung der App-Schlüssel, App-IDs, Placement-IDs und Anzeigenblock-IDs, die auf der Test-ID-Seite von Mintegral angegeben sind.

Testanzeigen bestätigen

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 Anzeigenquellen Mintegral (Gebotseinstellung) und Mintegral (Vermittlungsabfolge).

Optionale Schritte

Mintegral zur 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 GADNativeAd-Objekte zurück. Es füllt die folgenden Felder für ein GADNativeAd aus.

Feld Vom Mintegral-Adapter immer eingeschlossene Assets
Anzeigentitel
Bild 1
Text
Symbol
Call-to-Action
Bewertung
Shop
Preis
Advertiser

1 Der Mintegral-Adapter bietet keinen direkten Zugriff auf das Hauptbild-Asset für native Anzeigen. Stattdessen fügt der Adapter GADMediaView ein Video oder ein Bild ein.

Fehlercodes

Wenn der Adapter keine Anzeige von Mintegral empfängt, können Sie den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen prüfen:

GADMediationAdapterMintegral

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.mediation.mintegral Ungültige Serverparameter (z. B. fehlende App-ID oder Placement-ID)
102 com.google.mediation.mintegral Das Mintegral SDK hat den Fehler „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 entspricht nicht einer von Mintegral unterstützten Bannergröße.

Änderungsprotokoll für den Mintegral iOS Mediation Adapter

Version 7.7.3.0

  • Kompatibilität mit der Mintegral SDK-Version 7.7.3 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.10.0
  • Mintegral SDK-Version 7.7.3

Version 7.7.2.1

  • Der Adapter prüft nicht mehr, ob Interstitial- und Anzeigen mit Prämie bereit sind, bevor sie ausgeliefert werden.
  • CFBundleShortVersionString wurde auf drei statt vier Komponenten aktualisiert.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.10.0
  • Mintegral SDK-Version 7.7.2

Version 7.7.2.0

  • Kompatibilität mit der Mintegral SDK-Version 7.7.2 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.9.0
  • Mintegral SDK-Version 7.7.2

Version 7.7.1.0

  • Kompatibilität mit der Mintegral SDK-Version 7.7.1 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.8.0
  • Mintegral SDK-Version 7.7.1

Version 7.7.0.0

  • Kompatibilität mit der Mintegral SDK-Version 7.7.0 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.8.0
  • Mintegral SDK-Version 7.7.0

Version 7.6.9.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.9 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.7.0
  • Mintegral SDK-Version 7.6.9

Version 7.6.8.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.8 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.7.0
  • Mintegral SDK-Version 7.6.8

Version 7.6.7.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.7 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.6.0
  • Mintegral SDK-Version 7.6.7

Version 7.6.6.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.6 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.5.0
  • Mintegral SDK-Version 7.6.6

Version 7.6.4.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.4 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.4.0
  • Mintegral SDK-Version 7.6.4

Version 7.6.3.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.3 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.3.0
  • Mintegral SDK-Version 7.6.3

Version 7.6.2.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.2 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.3.0
  • Mintegral SDK-Version 7.6.2

Version 7.6.1.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.1 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.3.0
  • Mintegral SDK-Version 7.6.1

Version 7.6.0.0

  • Kompatibilität mit der Mintegral SDK-Version 7.6.0 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 11.2.0
  • Mintegral SDK-Version 7.6.0

Version 7.5.9.0

  • Kompatibilität mit der Mintegral SDK-Version 7.5.9 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 11.2.0
  • Mintegral SDK-Version 7.5.9

Version 7.5.8.0

  • Kompatibilität mit der Mintegral SDK-Version 7.5.8 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 11.1.0
  • Mintegral SDK-Version 7.5.8

Version 7.5.7.0

  • Kompatibilität mit der Mintegral SDK-Version 7.5.7 bestätigt.
  • Jetzt ist mindestens iOS 12.0 erforderlich.
  • Jetzt ist das Google Mobile Ads SDK Version 11.0 oder höher erforderlich.
  • Info.plist in die Frameworks in MintegralAdapter.xcframework aufgenommen.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 11.0.1
  • Mintegral SDK-Version 7.5.7

Version 7.5.6.0

  • Kompatibilität mit der Mintegral SDK-Version 7.5.6 bestätigt.
  • GADMediationAdapterMintegral.h ist jetzt ein öffentlicher Header.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.0.0
  • Mintegral SDK-Version 7.5.6

Version 7.5.3.0

  • Kompatibilität mit der Mintegral SDK-Version 7.5.3 bestätigt.
  • Unterstützung für Gebote für das Anzeigenformat „App-Anzeigen öffnen“ hinzugefügt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.14.0
  • Mintegral SDK-Version 7.5.3

Version 7.4.8.0

  • Kompatibilität mit der Mintegral SDK-Version 7.4.8 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.13.0
  • Mintegral SDK-Version 7.4.8

Version 7.4.7.0

  • Die Podspec-Datei wurde so aktualisiert, dass sie auf MintegralAdSDK/All statt auf MintegralAdSDK verweist.
  • Kompatibilität mit der Mintegral SDK-Version 7.4.7 bestätigt.
  • Unterstützung für die Vermittlungsabfolge für das Anzeigenformat „App-Start“ hinzugefügt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.12.0
  • Mintegral SDK-Version 7.4.7

Version 7.4.4.0

  • Unterstützung für Wasserzeichen bei Bidding-Anzeigen hinzugefügt
  • Kompatibilität mit der Mintegral SDK-Version 7.4.4 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.10.0
  • Mintegral SDK-Version 7.4.4

Version 7.4.3.0

  • Kompatibilität mit der Mintegral SDK-Version 7.4.3 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.9.0
  • Mintegral SDK-Version 7.4.3

Version 7.4.1.0

  • Kompatibilität mit der Mintegral SDK-Version 7.4.1 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.7.0
  • Mintegral SDK-Version 7.4.1

Version 7.3.9.0

  • Kompatibilität mit der Mintegral SDK-Version 7.3.9 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.7.0
  • Mintegral SDK-Version 7.3.9

Version 7.3.8.0

  • Kompatibilität mit der Mintegral SDK-Version 7.3.8 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.6.0
  • Mintegral SDK-Version 7.3.8

Version 7.3.7.0

  • Kompatibilität mit der Mintegral SDK-Version 7.3.7 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.5.0
  • Mintegral SDK-Version 7.3.7

Version 7.3.6.0

  • Kompatibilität mit der Mintegral SDK-Version 7.3.6 bestätigt.
  • Die Unterstützung der armv7-Architektur wurde entfernt.
  • Jetzt ist mindestens iOS 11.0 erforderlich.
  • Jetzt ist das Google Mobile Ads SDK Version 10.4.0 oder höher erforderlich.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.5.0
  • Mintegral SDK-Version 7.3.6

Version 7.3.4.0

  • Kompatibilität mit der Mintegral SDK-Version 7.3.4 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.2.0
  • Mintegral SDK-Version 7.3.4

Version 7.3.3.0

  • Kompatibilität mit der Mintegral SDK-Version 7.3.3 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.2.0
  • Mintegral SDK-Version 7.3.3

Version 7.3.0.0

  • Kompatibilität mit der Mintegral SDK-Version 7.3.0 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.1.0
  • Mintegral SDK-Version 7.3.0

Version 7.2.9.1

  • Unterstützung für die Vermittlungsabfolge für Banner (einschließlich MREC), Interstitial-, Anzeigen mit Prämie und native Anzeigen hinzugefügt.
  • Erfordert das Google Mobile Ads SDK Version 10.0.0 oder höher.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.0.0
  • Mintegral SDK-Version 7.2.9

Version 7.2.9.0

  • Kompatibilität mit der Mintegral SDK-Version 7.2.9 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 9.14.0
  • Mintegral SDK-Version 7.2.9

Version 7.2.8.0

  • Kompatibilität mit der Mintegral SDK-Version 7.2.8 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 9.14.0
  • Mintegral SDK-Version 7.2.8

Version 7.2.6.0

  • Erstes Release!
  • Unterstützung für Gebote für Banner (einschließlich MREC), Interstitials, Anzeigen mit Prämie und native Anzeigen hinzugefügt.
  • Kompatibilität mit der Mintegral SDK-Version 7.2.6 bestätigt.
  • Erfordert das Google Mobile Ads SDK Version 9.8.0 oder höher.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 9.13.0
  • Mintegral SDK-Version 7.2.6