Mai in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von maio mithilfe der Vermittlung, carregarn und anzeigen lassen. Es werden auch Abfolgeintegrationen behandelt. Darin erfahren Sie, wie Sie der Vermittlungskonfiguration eines Anzeigenblocks Maio hinzufügen und wie Sie 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 in diesem Leitfaden werden Labels und Schaltflächen jedoch mit ihren englischen Entsprechungen bezeichnet. „URL スキーム“ steht beispielsweise für „URL-Schema“.

Unterstützte Integrationen und Anzeigenformate

Der Mediationsadapter für maio bietet 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
  • Neuestes Google Mobile Ads SDK

  • Mediation abschließen Startleitfaden

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

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

Verfügbar

Geben Sie den Namen der App ein, wählen Sie die Plattform aus und geben Sie die App-URL an. Wählen Sie als Anzeigentyp Video Rewards 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. 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.

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

Schritt 3: Maio SDK und Adapter importieren

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-Adapter-Artefakte 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.

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 Kontext, der zum Laden einer Anzeige verwendet wurde, war keine „Aktivität“-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 mindestens erforderliche Android-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 Mindestversion des Google Mobile Ads SDK wurde auf 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

  • Die Kompatibilität mit dem maio SDK Version 1.1.13 wurde bestätigt.
  • Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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 Mindestversion des Google Mobile Ads SDK wurde auf 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

  • Die Kompatibilität mit dem maio SDK Version 1.1.8 wurde bestätigt.
  • Die Mindestversion des Google Mobile Ads SDK wurde auf 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 Rewarded 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

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

Version 1.1.4.0

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

Version 1.1.3.1

  • Der Adapter wurde so aktualisiert, dass er mit einer Instanzklasse statt einem Singleton funktioniert.

Version 1.1.3.0

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

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

  • Kompatibilität mit der Maio SDK-Version 1.1.0 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 besteht jetzt die Möglichkeit, den Testmodus durch Hinzufügen einer Testgeräte-ID zu AdRequest zu aktivieren.
  • Geprüfte Kompatibilität mit der Maio SDK-Version 1.0.7.

Version 1.0.6.0

  • Erster Release!
  • Interstitials und Videoanzeigen mit Prämie werden jetzt unterstützt.