Maiio in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads SDK Anzeigen von maio über die AdMob-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 für den gewünschten Anzeigentyp aus.

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 AdMob-Anzeigenblock einrichten.

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

(Nur Abfolge) Zusätzlich zur Media ID und Zone 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 AdMob-Benutzeroberfläche einrichten

Vermittlungseinstellungen für den Anzeigenblock konfigurieren

Sie müssen maio 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 vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie mit maio 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 einen Namen für die Vermittlungsgruppe ein und wählen Sie die Zielregionen aus. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Verknüpfen Sie diese Vermittlungsgruppe mit einem oder mehreren Ihrer vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Fertig.

Auf der Karte „Anzeigenblöcke“ sollten jetzt die von Ihnen ausgewählten Anzeigenblöcke zu sehen sein:

maio als Anzeigenquelle hinzufügen


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

Wählen Sie maio aus und aktivieren Sie den Schalter Optimieren. Geben Sie die API-ID und den API-Schlüssel ein, die Sie im vorherigen Abschnitt erhalten haben, um die Optimierung der Anzeigenquelle für maio einzurichten. Geben Sie dann einen eCPM-Wert für maio ein und klicken Sie auf Weiter.




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



Geben Sie als Nächstes die Media-ID und die Zonen-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.


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 Änderungsprotokoll 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-IDs in die Info.plist-Datei Ihres Projekts einzufügen.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

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 erhält, können Publisher den zugrunde liegenden Fehler in 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 Filtern Sie Anfragen mit Altersbeschränkung für das maio SDK, 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 lockern 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.

Erstellt und getestet mit:

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

Version 2.2.1.1

  • Filtern Sie Anfragen mit Altersbeschränkung für das maio SDK, 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.

Erstellt 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.

Erstellt 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.

Erstellt 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.

Erstellt 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

  • Jetzt ist das Google Mobile Ads SDK ab Version 11.0 erforderlich.
  • Info.plist in die Frameworks in MaioAdapter.xcframework aufgenommen.

Erstellt 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.
  • Erfordert jetzt mindestens iOS-Version 12.0.
  • Jetzt ist das Google Mobile Ads SDK ab Version 10.4.0 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.

Erstellt 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 ab Version 9.8.0 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.

Erstellt 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 dem Google Mobile Ads SDK, Version 9.0.0, bestätigt.
  • Jetzt ist das Google Mobile Ads SDK ab Version 9.0.0 erforderlich.

Erstellt 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
  • Mindestens iOS-Version 10.0 erforderlich.
  • 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 Bidding-Funktion für Interstitial-Anzeigen und Anzeigen 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.
  • Jetzt ist die Google Mobile Ads SDK-Version 7.68.0 oder höher erforderlich.

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.

Erstellt 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.

Erstellt 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.

Erstellt 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.

Erstellt 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.

Erstellt 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.
  • Jetzt ist das Google Mobile Ads SDK ab Version 7.42.2 erforderlich.

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.
  • Ein Problem wurde 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

  • Der Callback adapterDidCompletePlayingRewardBasedVideoAd: wurde dem Adapter 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.