Mai in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von maio über Mediation laden und präsentieren. Dabei wird auch die Waterfall-Integration 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-Oberfläche für maio verwendet japanischen Text für Labels, Schaltflächen und Beschreibungen. Die Screenshots in dieser Anleitung wurden nicht übersetzt. In den Beschreibungen und Anleitungen in diesem Leitfaden werden Labels und Schaltflächen jedoch mit ihren englischen Entsprechungen referenziert. „URL スキーム“ ist beispielsweise „URL Scheme“.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für maio bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

Voraussetzungen

  • iOS-Bereitstellungsziel von 12.0 oder höher

  • Neuestes Google Mobile Ads SDK

  • Vermittlung abschließen Startleitfaden

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

Registrieren Sie sich zuerst für ein maio-Konto oder melden Sie sich in Ihrem Konto an. Klicken Sie in der linken Seitenleiste auf die Schaltfläche 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.

Verfügbar

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

Notieren Sie sich auf der Seite Anwendungsverwaltung die Media-ID. Sie benötigen sie, um Ihren Ad Manager-Anzeigenblock im nächsten Abschnitt einzurichten.

Notieren Sie sich auf der Seite Zonenverwaltung die Zonen-ID. Sie benötigen sie auch, um Ihren Ad Manager-Anzeigenblock im nächsten Abschnitt einzurichten.

(Nur Wasserfall) 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 Ihren Anzeigenblock konfigurieren

Melden Sie sich in Ihrem Ad Manager-Konto an.

Klicken Sie auf Auslieferung > Ertragsgruppen und dann auf die Schaltfläche 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 den Anzeigenblock unter Inventar und Mobile App aus, dem Sie die Vermittlung hinzufügen möchten.

Klicken Sie dann auf die Schaltfläche 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 Vermittlung.

Aktivieren Sie Automatische Datenerfassung und geben Sie die API‑ID und den API‑SCHLÜSSEL ein, die Sie im vorherigen Abschnitt abgerufen haben.

Sobald Sie den Ertragspartner ausgewählt 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

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

    pod 'GoogleMobileAdsMediationMaio'

  • Führen Sie in der 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-Integration

Folgen Sie der Dokumentation von maio, um die SKAdNetwork-IDs zur Datei Info.plist Ihres Projekts hinzuzufü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 des Google Mobile Ads SDK verwenden, erhalten automatisch Testanzeigen von maio auf Smartphones und Tablets, die als Testgeräte registriert sind, wenn sie Anfragen stellen.

Testanzeigen bestätigen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von maio erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne 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 in den folgenden Klassen prüfen:

Format Klassenname
Interstitial GADMMaioInterstitialAdapter
Verfügbar GADMMaioRewardedAdapter

Hier sind die Codes und 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 maio hat 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.

maio iOS Mediation Adapter – Änderungsprotokoll

Nächste Version

  • Aktivieren Sie „-fobjc-arc“ und „-fstack-protector-all“.

Version 2.1.6.1

  • Erfordert jetzt das Google Mobile Ads SDK Version 12.0.0 oder höher.

Entwickelt 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 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 besteht nun aus 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 maio SDK-Version 2.1.5 bestätigt.

Entwickelt 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 maio SDK-Version 2.1.4 bestätigt.

Entwickelt 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 maio SDK-Version 2.1.3 bestätigt.

Entwickelt 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 maio SDK-Version 2.1.2 bestätigt.

Entwickelt 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 maio SDK-Version 2.1.1 bestätigt.

Entwickelt 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 maio SDK-Version 2.0.0 bestätigt.
  • Die Abhängigkeit von MaioOB SDK wurde entfernt.
  • Die armv7-Architektur wird nicht mehr unterstützt.
  • Erfordert jetzt mindestens iOS 12.0.
  • Erfordert jetzt das Google Mobile Ads SDK Version 10.4.0 oder höher.

Entwickelt und getestet mit:

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

Version 1.6.3.1

  • Erfordert jetzt das Google Mobile Ads SDK Version 10.0.0 oder höher.

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, sodass er die didRewardUser API verwendet.
  • Erfordert jetzt das Google Mobile Ads SDK Version 9.8.0 oder höher.
  • Kompatibilität mit maio SDK-Version 1.6.3 und maioOB SDK-Version 2.0.0-alpha bestätigt.

Entwickelt 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 maio SDK-Version 1.6.2 und maioOB SDK-Version 2.0.0-alpha bestätigt.

Entwickelt 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 maio SDK-Version 1.6.1 und 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.
  • Erfordert jetzt das Google Mobile Ads SDK Version 9.0.0 oder höher.

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 maio SDK-Version 1.6.0 und maioOB SDK-Version 2.0.0-alpha bestätigt.

Entwickelt 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 maio SDK-Version 1.5.8 und maioOB SDK-Version 2.0.0-alpha bestätigt.
  • Dem Adapter wurde die Gebotsfunktion für Interstitial- und Anzeigenformate mit Prämie hinzugefügt.
  • Die Abhängigkeit vom Google Mobile Ads SDK 8.0.0 oder höher wurde gelockert.

Entwickelt 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 Adapterfehlercodes und ‑meldungen hinzugefügt.
  • Der Adapter wurde aktualisiert, um das .xcframework-Format zu verwenden.
  • Ein Fehler wurde behoben, bei dem Ereignisse für Anzeigen mit Prämie manchmal nicht weitergeleitet wurden.
  • Jetzt ist das Google Mobile Ads SDK Version 8.3.0 oder höher erforderlich.

Entwickelt 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 maio SDK-Version 1.5.6 bestätigt.
  • Erfordert jetzt das Google Mobile Ads SDK Version 7.68.0 oder höher.

Entwickelt 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 maio SDK-Version 1.5.5 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK 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 maio SDK-Version 1.5.4 bestätigt.
  • Erfordert jetzt das Google Mobile Ads SDK Version 7.60.0 oder höher.

Entwickelt 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 begrenzen, schlagen Anzeigenanfragen jetzt sofort fehl, wenn maio keine Anzeige zur Auslieferung bereit hat.
  • 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 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

  • Es wurde ein Problem 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 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 maio SDK-Version 1.5.1 bestätigt.

Entwickelt 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 maio SDK-Version 1.5.0 bestätigt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK-Version 7.51.0
  • Maio Ads SDK-Version 1.5.0.

Version 1.4.8.0

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

Version 1.4.6.0

  • Kompatibilität mit maio SDK-Version 1.4.6 bestätigt.
  • Der Adapter wurde aktualisiert, sodass die neue API für Prämienanzeigen verwendet wird.
  • Erfordert jetzt das Google Mobile Ads SDK Version 7.42.2 oder höher.

Version 1.4.2.0

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

Version 1.4.1.0

  • Kompatibilität mit maio SDK-Version 1.4.1 bestätigt.
  • Ein Problem wurde behoben, durch das der MAIO-Adapter möglicherweise fehlschlägt, wenn mehrere MediaIDs von AdMob bereitgestellt werden.

Version 1.4.0.0

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

Version 1.3.2.0

  • Kompatibilität mit 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 maio SDK-Version 1.3.1 bestätigt.

Version 1.3.0.0

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

Version 1.2.19.0

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

Version 1.2.18.0

  • Erste Veröffentlichung!
  • Unterstützung für Interstitials und Videoanzeigen mit Prämie hinzugefügt.