Maiio in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von maio mithilfe der AdMob Mediation, also der Es werden auch Abfolgeintegrationen behandelt. Darin erfahren Sie, wie Sie Maio der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Maio SDK und den Adapter in eineAndroid App einbinden.

Die Dashboard-Benutzeroberfläche für maio verwendet japanischen Text für Labels, Schaltflächen und Beschreibungen. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieses Leitfadens werden Labels und Schaltflächen jedoch in ihrer jeweiligen englischen Sprache angegeben. „URL スキーム“ steht beispielsweise für „URL-Schema“.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für Maio hat folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Nativ

Voraussetzungen

• Android API-Level 21 oder höher

• maio SDK 1.0.7 oder höher

• Neueste Version des Google Mobile Ads SDK

• Schließen Sie die Vermittlung ab. Startleitfaden

Schritt 1: Konfigurationen in der Maio-UI einrichten

Melden Sie sich zuerst in Ihrem Maio-Konto an oder registrieren Sie sich. Klicken Sie in der linken Seitenleiste auf die Schaltfläche Anwendungsverwaltung 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.

Hinweis:Interstitial-Anzeigen von Maio sind standardmäßig überspringbar.

Verfügbar

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

Hinweis:Videoanzeigen mit Prämie von maio sind standardmäßig NICHT überspringbar.

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. Außerdem ist es erforderlich, den AdMob-Anzeigenblock im nächsten Abschnitt einzurichten.

Zusätzlich zur 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.

Hinweis: Wenn Sie Ihr Maio-Konto zum ersten Mal einrichten, müssen Sie sich möglicherweise an das Supportteam von Maio wenden, damit Ihnen eine API-ID und ein API-KEY ausgestellt werden.

Schritt 2: Maio-Nachfrage in der AdMob -Benutzeroberfläche einrichten

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

Sie müssen der Vermittlungskonfiguration für Ihren Anzeigenblock maio hinzufügen.

Melden Sie sich in Ihrem AdMob-Konto an. Rufen Sie als Nächstes den Tab Vermittlung auf. Wenn Sie eine bestehende Vermittlungsgruppe ändern möchten, klicken Sie zum Bearbeiten auf ihren Namen 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. Klicken Sie dann auf Weiter.

Geben Sie einen Namen für die Vermittlungsgruppe ein und wählen Sie Standorte für die Ausrichtung 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 vorhandenenAdMob Anzeigenblöcke. Klicken Sie dann auf Fertig.

Die Karte „Anzeigenblöcke“ sollte jetzt mit den ausgewählten Anzeigenblöcken gefüllt 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 dann maio aus.

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

Hinweis :Die Optimierung der Anzeigenquelle muss pro Netzwerk nur einmal eingerichtet werden.

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

Geben Sie als Nächstes den Media ID and Zone IDein, den Sie im vorherigen Abschnitt erhalten haben. Klicken Sie dann auf Fertig.

Wichtig : Media ID muss wie in der Benutzeroberflächemaio mit der Ziel-App verknüpft sein.

Hinweis :Es dauert einige Tage, bis genügend Daten für die Optimierung der Anzeigenquelle erfasst wurden, um den eCPM für ein Vermittlungsnetzwerk präzise zu berechnen. In der Zwischenzeit lautet der Optimierungsstatus der Anzeigenquelle PENDING, sodass Sie manuell einen eCPM-Wert für das Netzwerk festlegen müssen. Sobald der eCPM berechnet werden kann, wird der eCPM von der Anzeigenquelle automatisch für Sie aktualisiert.

Schritt 3: maio SDK und Adapter importieren

Hinweis: Wenn Sie die kompatiblen Versionen von maio und Google Mobile Ads SDK nicht integrieren, kann das zu Build-Problemen führen.

Android Studio-Integration (empfohlen)

Fügen Sie in der Datei settings.gradle.kts auf Projektebene die folgenden Repositories hinzu:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

Fügen Sie dann in der Datei build.gradle.kts auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu. Verwenden Sie die neuesten Versionen des maiO SDK und des Adapters:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

Manuelle Integration

• Lade die neueste Version des maio Android SDK herunter und füge sie deinem Projekt hinzu.
• Rufen Sie die Maio-Adapterartefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei des Maio-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Erforderlichen Code hinzufügen

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

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob.

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

Wichtig: Deaktivieren Sie den Testmodus für AdMob und maiO, bevor Sie Ihre App veröffentlichen.

Testanzeigen bestätigen

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 (Abfolge).

Fehlercodes

Wenn der Adapter keine Anzeige von maio empfängt, können Publisher den zugrunde liegenden Fehler in der Anzeigenantwort mithilfe von ResponseInfo.getAdapterResponses() unter den folgenden Klassen prüfen:

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

Im Folgenden finden Sie 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 und in der Dokumentation von maio.
101	Für Maio ist keine Anzeige verfügbar.
102	Ungültige Serverparameter (z. B. fehlende Placement-ID)
103	Der zum Laden einer Anzeige verwendete Kontext war keine „Activity“-Instanz.

Änderungsprotokoll für den Android-Vermittlungsadapter von maio

Version 1.1.16.3

• Die Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.
• Kompatibilität mit der Maio SDK-Version 1.1.16 bestätigt.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 23.0.0
• Maio SDK-Version 1.1.16

Version 1.1.16.2

• Der Adapter wurde aktualisiert, um die neue VersionInfo-Klasse zu verwenden.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 22.0.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 22.0.0
• Maio SDK-Version 1.1.16

Version 1.1.16.1

• compileSdkVersion und targetSdkVersion auf API 31 aktualisiert
• Die Mindestversion des Google Mobile Ads SDK wurde auf 21.0.0 aktualisiert.
• Das für Android erforderliche Mindest-API-Level wurde auf 19 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 21.0.0
• Maio SDK-Version 1.1.16

Version 1.1.16.0

• Fehlercodes wurden aktualisiert, um zusätzliche Maio-Fehler zu erfassen.
• Kompatibilität mit der Maio SDK-Version 1.1.16 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 20.4.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 20.4.0.
• Maio SDK Version 1.1.16.

Version 1.1.15.0

• Kompatibilität mit der Maio SDK-Version 1.1.15 bestätigt.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 20.0.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK-Version 20.0.0
• Maio SDK-Version 1.1.15

Version 1.1.14.0

• Es wurden standardisierte Fehlercodes und Fehlermeldungen für Adapter hinzugefügt.
• Kompatibilität mit der Maio SDK-Version 1.1.14 bestätigt.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.8.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.8.0
• Maio SDK Version 1.1.14.

Version 1.1.13.0

• Geprüfte Kompatibilität mit der Maio SDK-Version 1.1.13.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 19.5.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.5.0
• Maio SDK-Version 1.1.13

Version 1.1.12.0

• Die Mindestversion des Google Mobile Ads SDK wurde auf 19.4.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK, Version 19.4.0.
• Maio SDK Version 1.1.12.

Version 1.1.11.1

• Um Zeitüberschreitungen zu vermeiden, werden Anzeigenanfragen jetzt sofort fehlgeschlagen, wenn in Maio keine Anzeige zur Auslieferung bereitsteht.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 19.1.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 19.1.0
• Maio SDK-Version 1.1.11

Version 1.1.11.0

• Die Kompatibilität mit maio SDK-Version 1.1.11 wurde bestätigt.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 18.3.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 18.3.0
• Maio SDK-Version 1.1.11

Version 1.1.10.0

• Kompatibilität mit der Maio SDK-Version 1.1.10 bestätigt.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 18.2.0 aktualisiert.

Version 1.1.8.0

• Kompatibilität mit der Maio SDK-Version 1.1.8 bestätigt.
• Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 18.1.0 aktualisiert.

Version 1.1.7.0

• Fehlerkorrekturen.
• Kompatibilität mit der Maio SDK-Version 1.1.7 bestätigt.

Version 1.1.6.1

• Der Adapter wurde aktualisiert, um die neue Reward API zu unterstützen.
• Die Mindestversion des Google Mobile Ads SDK wurde auf 17.2.0 aktualisiert.

Version 1.1.6.0

• Kompatibilität mit der Maio SDK-Version 1.1.6 bestätigt.

Version 1.1.5.0

• Geprüfte Kompatibilität mit der Maio SDK-Version 1.1.5.

Version 1.1.4.0

• Kompatibilität mit der Maio SDK-Version 1.1.4 bestätigt.

Version 1.1.3.1

• Der Adapter wurde aktualisiert, sodass er mit der Instanzklasse anstelle von Singleton funktioniert.

Version 1.1.3.0

• Geprüfte Kompatibilität mit der maio SDK-Version 1.1.3.

Version 1.1.2.1

• Der Adapter wurde mit aktualisierten Initialisierungsfunktionen aktualisiert.

Version 1.1.2.0

• Kompatibilität mit der Maio SDK-Version 1.1.2 bestätigt.

Version 1.1.1.1

• Der Adapter wurde aktualisiert, um das onRewardedVideoComplete()-Anzeigenereignis aufzurufen.

Version 1.1.1.0

• Kompatibilität mit der Maio SDK-Version 1.1.1 bestätigt.

Version 1.1.0.0

• Die Kompatibilität mit dem maio SDK Version 1.1.0 wurde bestätigt.

Version 1.0.8.0

• Kompatibilität mit der Maio SDK-Version 1.0.8 bestätigt.

Version 1.0.7.1

• Ein Problem wurde behoben, das dazu führen konnte, dass NullPointerExceptions auftreten, wenn Anzeigen nicht geladen werden konnten.

Version 1.0.7.0

• Es ist jetzt möglich, den Testmodus zu aktivieren, indem der Testgeräte-ID AdRequest hinzugefügt wird.
• Geprüfte Kompatibilität mit der Maio SDK-Version 1.0.7.

Version 1.0.6.0

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