Maiio in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von maio über Vermittlung laden und präsentieren. Dabei wird auch die Wasserfallintegration behandelt. Darin wird beschrieben, wie Sie maio der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das maio SDK und den Adapter in eine Flutter-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 hier werden Labels und Schaltflächen jedoch mit ihren englischen Entsprechungen bezeichnet. „URL スキーム“ ist beispielsweise „URL Scheme“.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für maio bietet die folgenden Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitials
Verfügbar
Nativ

Voraussetzungen

  • Neuestes Google Mobile Ads SDK
  • Flutter 3.7.0 oder höher
  • So stellen Sie die App auf Android-Geräten bereit:
    • Android-API-Level 23 oder höher
  • So stellen Sie die App auf iOS-Geräten bereit:
    • iOS-Bereitstellungsziel von 12.0 oder höher
  • Ein funktionierendes Flutter-Projekt, das mit dem Google Mobile Ads SDK konfiguriert ist. Weitere Informationen
  • Startleitfaden für die Vermittlung

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 Video-Interstitial als Anzeigentyp aus und klicken Sie dann auf Aktualisieren.

Android

iOS

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 auf Aktualisieren.

Android

iOS

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

Android

iOS

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.

Android

iOS

(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 Reporting API-Seite 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

Android

Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.

iOS

Eine Anleitung finden Sie in Schritt 2 der Anleitung für iOS.

Schritt 3: maio SDK und Adapter importieren

Integration über pub.dev

Fügen Sie der Datei pubspec.yaml Ihres Pakets die folgende Abhängigkeit mit den neuesten Versionen des maio SDK und Adapters hinzu:

dependencies:
  gma_mediation_maio: ^

Manuelle Integration

Laden Sie die aktuelle Version des Google Mobile Ads-Mediations-Plug-ins für maio herunter, entpacken Sie die heruntergeladene Datei und fügen Sie den entpackten Plug-in-Ordner (und seinen Inhalt) in Ihr Flutter-Projekt ein. Verweisen Sie dann in Ihrer pubspec.yaml-Datei auf das Plug-in, indem Sie die folgende Abhängigkeit hinzufügen:

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

Schritt 4: Erforderlichen Code hinzufügen

Android

Für die Integration von maio ist kein zusätzlicher Code erforderlich.

iOS

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 Tests einzelner Anzeigenquellen im Anzeigenprüftool mit den Anzeigenquellen maio (Waterfall).

Fehlercodes

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

Android

Format Klassenname
Interstitial jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Verfügbar jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

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:

Android

Fehlercode Grund
0-10 maio hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie im Code und in der Dokumentation von maio.
101 Maio hat keine Anzeige verfügbar.
102 Ungültige Serverparameter (z.B. fehlende Placement-ID).
103 Der Kontext, der zum Laden einer Anzeige verwendet wurde, war keine `Activity`-Instanz.

iOS

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 Flutter Mediation Adapter – Änderungsprotokoll

Version 1.0.3 (in Arbeit)

Version 1.0.2

Version 1.0.1

Version 1.0.0