Mai in die Vermittlung einbinden

Plattform auswählen: Android iOS Unity Flutter Android (Legacy)

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads SDK Anzeigen von maio mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Darin wird beschrieben, wie Sie maio der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das maio SDK und den Adapter in eine iOS-App einbinden.

Die Dashboard-Benutzeroberfläche für maio verwendet japanischen Text für Labels, Buttons und Beschreibungen. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen in diesem Leitfaden werden Labels und Buttons jedoch mit ihren deutschen Entsprechungen bezeichnet. „URL スキーム“ ist beispielsweise „URL-Schema“.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter für maio bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

  • iOS-Bereitstellungsziel von 15.0 oder höher.

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

Melden Sie sich zuerst in Ihrem maio-Konto an oder registrieren Sie sich. Klicken Sie in der linken Seitenleiste auf den Button App-Verwaltung und dann auf Neue App.

Wählen Sie den Tab aus, der dem gewünschten Anzeigentyp entspricht.

Interstitial

Geben Sie den Namen Ihrer App ein, wählen Sie die Plattform aus und geben Sie die App-URL an. Wählen Sie als Anzeigentyp Video-Interstitial aus und klicken Sie dann auf Aktualisieren.

Mit Prämie

Geben Sie den Namen Ihrer App ein, wählen Sie die Plattform aus und geben Sie die App-URL an. Wählen Sie als Anzeigentyp Video mit Prämie aus und klicken Sie dann auf Aktualisieren.

Notieren Sie sich auf der Seite Anwendungsverwaltung die Medien-ID. Im nächsten Abschnitt müssen Sie Ihren Ad Manager-Anzeigenblock einrichten.

Notieren Sie sich auf der Seite Zonenverwaltung die Zonen-ID. Im nächsten Abschnitt müssen Sie Ihren Ad Manager-Anzeigenblock einrichten.

(Nur Abfolge) Zusätzlich zu Media-ID und Zonen-ID benötigen Sie die API-ID und den API-SCHLÜSSEL, um die Anzeigenblock-ID für die Vermittlung einzurichten. Notieren Sie sich auf der Seite Reporting API die API-ID und den API-Schlüssel.

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

Vermittlungseinstellungen für den Anzeigenblock konfigurieren

Melden Sie sich in Ihrem Ad Manager-Verwaltungskonto an.

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf den Button Neue Ertragsgruppe.

Geben Sie einen eindeutigen Namen für die Ertragsgruppe ein, legen Sie den Status auf Aktiv fest, wählen Sie das Anzeigenformat aus und legen Sie den Inventartyp auf Mobile App fest. Wählen Sie im Bereich Targeting > Inventar unter Inventar und Mobile App den Anzeigenblock aus, dem Sie die Vermittlung hinzufügen möchten.

Klicken Sie dann auf den Button Ertragspartner hinzufügen.

Wenn Sie bereits einen Ertragspartner für maio haben, können Sie ihn auswählen. Andernfalls wählen Sie Neuen Ertragspartner erstellen aus.

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

Aktivieren Sie Automatische Datenerhebung und geben Sie die API-ID und den API-Schlüssel ein, die Sie im vorherigen Abschnitt erhalten haben.

Wählen Sie als Integrationstyp SDK-Vermittlung für Mobilgeräte, als Plattform iOS und als Status Aktiv aus. Geben Sie die Media-ID und die Zonen-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Geben Sie dann einen Wert für den Standard-CPM ein.

Klicken Sie abschließend unten auf der Seite auf Speichern.

Schritt 3: maio SDK und Adapter importieren

Swift Package Manager verwenden

Bevor Sie fortfahren, müssen Sie die unterstützte Mindestversion des Adapters (2.2.0.0) haben.

So fügen Sie Ihrem Projekt eine Paketabhängigkeit hinzu:

  1. Gehen Sie in Xcode zu File > Add Package Dependencies….

  2. Suchen Sie im angezeigten Prompt nach der folgenden Paket-URL:

    https://github.com/googleads/googleads-mobile-ios-mediation-maio.git

  3. Wählen Sie unter Abhängigkeitsregel die Option Zweig aus.

  4. Geben Sie im Textfeld main ein.

Mit CocoaPods

  • Fügen Sie in der Podfile-Datei Ihres Projekts folgende Zeile ein:

    pod 'GoogleMobileAdsMediationMaio'

  • Führen Sie über die Befehlszeile folgenden Befehl aus:

    pod install --repo-update

Manuelle Integration

  • Laden Sie die aktuelle Version des maio SDK herunter.
  • Laden Sie die aktuelle Version des maio-Adapters über den Downloadlink im Changelog herunter und verknüpfen Sie maioAdapter.framework in Ihrem Projekt.

Schritt 4: Erforderlichen Code hinzufügen

SKAdNetwork implementieren

Folgen Sie der Dokumentation von maio, um die SKAdNetwork-Kennungen in die Info.plist-Datei Ihres Projekts einzufügen.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

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

Publisher, die Version 7.26.0 oder höher von Google Mobile Ads SDK verwenden, erhalten bei Anfragen automatisch Testanzeigen von maio auf Smartphones und Tablets, die als Testgeräte registriert sind.

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von maio erhalten, aktivieren Sie im Anzeigenprüftool die Tests einzelner Anzeigenquellen und verwenden Sie die Anzeigenquellen maio (Vermittlungsabfolge).

Fehlercodes

Wenn der Adapter keine Anzeige von maio empfängt, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen prüfen:

Format Klassenname
Interstitial GADMMaioInterstitialAdapter
Verfügbar GADMMaioRewardedAdapter

Hier sind die Codes und die zugehörigen Meldungen, die vom maio-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Fehlercode Grund
0-10 maio hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie im Code von maio.
101 Für maio ist noch keine Anzeige verfügbar.
102 Ungültige Serverparameter (z.B. fehlende Placement-ID).
103 Der maio-Adapter unterstützt das angeforderte Anzeigenformat nicht.
104 Für diese Netzwerkkonfiguration wurde bereits eine Anzeige geladen.
105 Anfragen mit Altersbeschränkung für das maio SDK filtern, da es keine Signale mit Altersbeschränkung empfangen kann.

Änderungsprotokoll für den maio iOS-Vermittlungsadapter

Version 2.2.3.0

  • Kompatibilität mit der maio SDK-Version 2.2.3 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.9.0
  • Maio SDK-Version 2.2.3

Version 2.2.2.0

  • Kompatibilität mit der maio SDK-Version 2.2.2 bestätigt.
  • Jetzt ist mindestens die iOS-Version 15.0 erforderlich.
  • Die Mindestversion von iOS wurde aktualisiert, um die Abhängigkeit vom Google Mobile Ads SDK zu verringern und Nebenversionen zuzulassen.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.7.0
  • Maio SDK-Version 2.2.2

Version 2.2.1.2

  • Anfragen mit Altersbeschränkung für das maio SDK werden gefiltert, wenn der neue ageRestrictedTreatment auf GADAgeRestrictedTreatmentChild gesetzt ist.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 13.3.0
  • Maio SDK-Version 2.2.1

Version 2.2.1.1

  • Anfragen mit Altersbeschränkung für das maio SDK filtern, da es keine Signale mit Altersbeschränkung empfangen kann.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.2.0
  • Maio SDK-Version 2.2.1

Version 2.2.1.0

  • Kompatibilität mit der maio SDK-Version 2.2.1 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 13.1.0
  • Maio SDK-Version 2.2.1

Version 2.2.0.3

  • Unterstützung für abfolgebasierte Banneranzeigen hinzugefügt.
  • Die Google Mobile Ads SDK-Abhängigkeit wurde auf Version 13.0.0 aktualisiert.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 13.0.0
  • Maio SDK-Version 2.2.0

Version 2.2.0.2

  • Die mindestens erforderliche iOS-Version für CocoaPods wurde auf 13.0 aktualisiert.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.0.0
  • Maio SDK-Version 2.2.0

Version 2.2.0.1

  • Die Gebotsimplementierung wurde entfernt, da Maio keine Gebote mehr unterstützt.
  • Aktualisieren Sie den Adapter, um das GADMediationAdapter-Protokoll zu verwenden.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 12.11.0
  • Maio SDK-Version 2.2.0

Version 2.2.0.0

  • Kompatibilität mit der maio SDK-Version 2.2.0 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 12.11.0
  • Maio SDK-Version 2.2.0

Version 2.1.6.1

  • Jetzt ist das Google Mobile Ads SDK ab Version 12.0.0 erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 12.0.0
  • Maio SDK-Version 2.1.6

Version 2.1.6.0

  • Kompatibilität mit der maio SDK-Version 2.1.6 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.13.0
  • Maio SDK-Version 2.1.6

Version 2.1.5.1

  • CFBundleShortVersionString wurde aktualisiert und hat jetzt drei statt vier Komponenten.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.10.0
  • Maio SDK-Version 2.1.5

Version 2.1.5.0

  • Kompatibilität mit der maio SDK-Version 2.1.5 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 11.6.0
  • Maio SDK-Version 2.1.5

Version 2.1.4.0

  • Kompatibilität mit der maio SDK-Version 2.1.4 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 11.2.0
  • Maio SDK-Version 2.1.4

Version 2.1.3.0

  • Kompatibilität mit der maio SDK-Version 2.1.3 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 11.1.0
  • Maio SDK-Version 2.1.3.

Version 2.1.2.1

  • Erfordert jetzt das Google Mobile Ads SDK Version 11.0 oder höher.
  • Info.plist in die Frameworks in MaioAdapter.xcframework aufgenommen.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 11.0.1
  • Maio SDK-Version 2.1.2

Version 2.1.2.0

  • Kompatibilität mit der maio SDK-Version 2.1.2 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 10.14.0
  • Maio SDK-Version 2.1.2

Version 2.1.1.0

  • Kompatibilität mit der maio SDK-Version 2.1.1 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 10.12.0
  • Maio SDK-Version 2.1.1

Version 2.0.0.0

  • Kompatibilität mit der maio SDK-Version 2.0.0 bestätigt.
  • Die Abhängigkeit von MaioOB SDK wurde entfernt.
  • Die Unterstützung der armv7-Architektur wurde entfernt.
  • Es ist jetzt mindestens iOS-Version 12.0 erforderlich.
  • Jetzt ist das Google Mobile Ads SDK in Version 10.4.0 oder höher erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 10.10.0
  • Maio SDK-Version 2.0.0

Version 1.6.3.1

  • Jetzt ist das Google Mobile Ads SDK ab Version 10.0.0 erforderlich.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 10.0.0
  • Maio SDK-Version 1.6.3.
  • MaioOB SDK-Version 2.0.0-alpha

Version 1.6.3.0

  • Der Adapter wurde aktualisiert, um die didRewardUser API zu verwenden.
  • Jetzt ist das Google Mobile Ads SDK in Version 9.8.0 oder höher erforderlich.
  • Kompatibilität mit der maio SDK-Version 1.6.3 und der maioOB SDK-Version 2.0.0-alpha bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 9.12.0
  • Maio SDK-Version 1.6.3.
  • MaioOB SDK-Version 2.0.0-alpha

Version 1.6.2.0

  • Kompatibilität mit der maio SDK-Version 1.6.2 und der maioOB SDK-Version 2.0.0-alpha bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 9.5.0
  • Maio SDK-Version 1.6.2.
  • MaioOB SDK-Version 2.0.0-alpha

Version 1.6.1.0

  • Kompatibilität mit der maio SDK-Version 1.6.1 und der maioOB SDK-Version 2.0.0-alpha bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 9.2.0
  • Maio SDK-Version 1.6.1.
  • MaioOB SDK-Version 2.0.0-alpha

Version 1.6.0.1

  • Kompatibilität mit Google Mobile Ads SDK-Version 9.0.0 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK ab Version 9.0.0 erforderlich.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 9.0.0
  • Maio SDK Version 1.6.0
  • MaioOB SDK-Version 2.0.0-alpha

Version 1.6.0.0

  • Kompatibilität mit der maio SDK-Version 1.6.0 und der maioOB SDK-Version 2.0.0-alpha bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 8.13.0
  • Erfordert jetzt mindestens iOS 10.0.
  • Maio SDK Version 1.6.0
  • MaioOB SDK-Version 2.0.0-alpha

Version 1.5.8.0

  • Kompatibilität mit der maio SDK-Version 1.5.8 und der maioOB SDK-Version 2.0.0-alpha bestätigt.
  • Dem Adapter wurde die Gebotsfunktion für Interstitial-Anzeigenformate und Anzeigenformate mit Prämie hinzugefügt.
  • Die Abhängigkeit vom Google Mobile Ads SDK wurde auf Version 8.0.0 oder höher gelockert.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 8.7.0
  • Maio SDK-Version 1.5.8
  • MaioOB SDK-Version 2.0.0-alpha

Version 1.5.6.1

  • Standardisierte Adapter-Fehlercodes und -meldungen hinzugefügt.
  • Der Adapter wurde aktualisiert, um das Format .xcframework zu verwenden.
  • Ein Fehler wurde behoben, bei dem Ereignisse für Anzeigen mit Prämie manchmal nicht weitergeleitet wurden.
  • Jetzt ist die Version 8.3.0 oder höher des Google Mobile Ads SDK erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 8.3.0
  • Maio SDK-Version 1.5.6

Version 1.5.6.0

  • Kompatibilität mit der maio SDK-Version 1.5.6 bestätigt.
  • Erfordert jetzt das Google Mobile Ads SDK Version 7.68.0 oder höher.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 7.68.0
  • Maio SDK-Version 1.5.6

Version 1.5.5.0

  • Kompatibilität mit der maio SDK-Version 1.5.5 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK in Version 7.64.0 oder höher erforderlich.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 7.64.0
  • Maio SDK-Version 1.5.5

Version 1.5.4.0

  • Kompatibilität mit der maio SDK-Version 1.5.4 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK ab Version 7.60.0 erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 7.60.0
  • Maio SDK-Version 1.5.4

Version 1.5.3.1

  • Um Zeitüberschreitungen zu vermeiden, werden Anzeigenanfragen jetzt sofort fehlschlagen, wenn in maio keine Anzeige zur Auslieferung bereitsteht.
  • Die Unterstützung für die i386-Architektur wurde entfernt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 7.58.0
  • Maio SDK-Version 1.5.3

Version 1.5.3.0

  • Kompatibilität mit der maio SDK-Version 1.5.3 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 7.55.1
  • Maio SDK-Version 1.5.3.

Version 1.5.2.1

  • Ein Problem wurde behoben, bei dem der Adapter den -rewardedAdDidPresent:-Callback nicht aufgerufen hat.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 7.53.1
  • Maio SDK-Version 1.5.2.

Version 1.5.2.0

  • Kompatibilität mit der maio SDK-Version 1.5.2 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 7.53.1
  • Maio SDK-Version 1.5.2.

Version 1.5.1.0

  • Kompatibilität mit der maio SDK-Version 1.5.1 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 7.52.0
  • Maio SDK-Version 1.5.1

Version 1.5.0.0

  • Kompatibilität mit der maio SDK-Version 1.5.0 bestätigt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.51.0
  • Maio Anzeigen-SDK, Version 1.5.0

Version 1.4.8.0

  • Kompatibilität mit der maio SDK-Version 1.4.8 bestätigt.

Version 1.4.6.0

  • Kompatibilität mit der maio SDK-Version 1.4.6 bestätigt.
  • Der Adapter wurde aktualisiert, um die neue API für Anzeigen mit Prämie zu verwenden.
  • Erfordert jetzt das Google Mobile Ads SDK Version 7.42.2 oder höher.

Version 1.4.2.0

  • Kompatibilität mit der maio SDK-Version 1.4.2 bestätigt.

Version 1.4.1.0

  • Kompatibilität mit der maio SDK-Version 1.4.1 bestätigt.
  • Es wurde ein Problem behoben, bei dem der maio-Adapter fehlschlagen konnte, wenn mehrere MediaIds von AdMob bereitgestellt wurden.

Version 1.4.0.0

  • Kompatibilität mit der maio SDK-Version 1.4.0 bestätigt.

Version 1.3.2.0

  • Kompatibilität mit der maio SDK-Version 1.3.2 bestätigt.

Version 1.3.1.1

  • Dem Adapter wurde der adapterDidCompletePlayingRewardBasedVideoAd:-Callback hinzugefügt.

Version 1.3.1.0

  • Kompatibilität mit der maio SDK-Version 1.3.1 bestätigt.

Version 1.3.0.0

  • Kompatibilität mit der maio SDK-Version 1.3.0 bestätigt.

Version 1.2.19.0

  • Kompatibilität mit der maio SDK-Version 1.2.19 bestätigt.

Version 1.2.18.0

  • Erster Release!
  • Unterstützung für Interstitials und Videoanzeigen mit Prämie hinzugefügt.