Mintegral in Bidding einbinden (Beta)

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Mintegral mithilfe von Vermittlung laden und präsentieren. Dabei werden sowohl Vermittlungs- 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 Mediationsadapter für Mintegral bietet folgende Funktionen:

Integration
Gebote  1
Wasserfall  2
Formate
App öffnen
Banner
Interstitial
Verfügbar
Interstitial mit Prämie
Nativ
1 Die Gebotsintegration befindet sich in der geschlossenen Betaphase (außer für das native Anzeigenformat in der offenen Betaphase).

2 Die Vermittlungsabfolge-Integration befindet sich in der geschlossenen 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 auf die Schaltfläche Placement hinzufügen (siehe Abbildung unten), um das Anzeigen-Placement zu erstellen.

Geben Sie einen Placement-Namen und ein Anzeigenformat ein.

Wählen Sie als Gebotstyp Header Bidding 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 Ad Manager-Anzeigenblock-ID einzurichten. Gehen Sie zu Konto > API-Tools. Notieren Sie sich Ihren Skey und Ihr Secret.

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

Melden Sie sich in Ihrem Ad Manager-Konto an.

Mintegral zu „Unternehmen“ hinzufügen

Gebote

Dieser Schritt ist für Geboteinbindungen nicht erforderlich.

Wasserfall

Klicken Sie auf Verwaltung > Unternehmen und dann auf dem Tab Alle Unternehmen auf die Schaltfläche Neues Unternehmen. Wählen Sie Werbenetzwerk aus.

Wähle Mintegral als Werbenetzwerk aus, gib einen eindeutigen Namen ein und aktiviere Vermittlung.

Sie müssen keinen Nutzernamen oder ein Passwort eingeben. Klicken Sie abschließend auf Speichern.

Freigabe sicherer Signale aktivieren

Gebote

Klicken Sie auf Verwaltung > Globale Einstellungen. Rufen Sie den Tab Ad Exchange-Kontoeinstellungen auf und aktivieren Sie die Option Freigabe sicherer Signale. Klicken Sie auf Speichern.

Wasserfall

Dieser Schritt ist für abfolgebasierte Integrationen nicht erforderlich.

Mintegral-Gebote konfigurieren

Gebote

Klicken Sie auf Auslieferung > Bieter und dann 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 Zulassen, dass Signale für diesen Bieter freigegeben werden. 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

Gehen Sie zu Auslieferung > Bieter und wählen Sie auf dem Tab SDK-Gebote das Unternehmen für Mintegral aus.

Klicken Sie auf den Tab Anzeigenblockzuordnung und dann auf Neue Anzeigenblockzuordnung.

Wählen Sie Bestimmter Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format sowie Mobile App als Inventartyp und Ihre mobile App aus. Geben Sie dann den App-Schlüssel, die App-ID, die Placement-ID und die Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie abschließend auf Speichern.

Wasserfall

Klicken Sie auf Auslieferung > Ertragsgruppen und dann 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, das Sie im vorherigen Abschnitt für Mintegral erstellt haben. Wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte, als Plattform iOS und als Status Aktiv aus.

Geben Sie den App-Schlüssel, die App-ID, die Placement-ID und die Anzeigenblock-ID ein, die Sie im vorherigen Abschnitt abgerufen haben, sowie den Wert für den Standard-CPM. Klicken Sie auf Speichern.

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 die Bestimmungen von US-Bundesstaaten in der Ad Manager-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 an diese Netzwerke weitergeben.

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

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 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 der einzelnen 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 die SKAdNetwork-IDs der Datei Info.plist Ihres Projekts hinzuzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager.

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 Ad Manager-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

Im Folgenden finden Sie 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