In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von Mai mit AdMob Mediation mit Vermittlungsabfolgen. Hier erfahren Sie, wie Sie Vermittlungskonfiguration und die Integration des maio-SDK und des Adapters in eine Android App.
Die Dashboard-Oberfläche von maio verwendet für Beschriftungen, Schaltflächen, und Beschreibungen und die Screenshots in dieser Anleitung wurden nicht übersetzt. In den Beschreibungen und Anweisungen dieses Handbuchs werden Labels und Schaltflächen jedoch mit ihren englischsprachigen Entsprechungen referenziert wird. „URL 備名ーム“, zum Beispiel ist "URL-Schema".
Unterstützte Integrationen 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
Neuestes Google Mobile Ads SDK
Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der Maio-UI einrichten
Registrieren Sie sich oder melden Sie sich in Ihrem maio-Konto an. 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 der 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 Videoprämien aus und klicken Sie dann auf Aktualisieren.
Notieren Sie sich auf der Seite Anwendungsverwaltung die Medien-ID. Sie müssen ihn im nächsten Abschnitt einrichten, um den Anzeigenblock AdMob einzurichten.
Notieren Sie sich auf der Seite Zone Management (Zonenverwaltung) die Zone ID (Zonen-ID). Außerdem müssen Sie ihn im nächsten Abschnitt für die Einrichtung des AdMob Anzeigenblocks konfigurieren.
Schritt 2: Lokale 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.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.
Schritt 3: maio SDK und Adapter importieren
Android Studio-Integration (empfohlen)
Fügen Sie der Datei settings.gradle.kts
auf Projektebene Folgendes hinzu:
Repositories:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
Fügen Sie dann der Datei build.gradle.kts
auf App-Ebene Folgendes hinzu:
Implementierungsabhängigkeiten und -konfigurationen. Verwenden Sie die neuesten Versionen des
maio SDK und Adapter:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Manuelle Integration
- Laden Sie die neueste Version von maio Android SDK und fügen Sie in Ihr Projekt ein.
- Rufen Sie die Maio-Adapterartefakte im Maven-Repository von Google auf. Neueste Version auswählen und.aar-Datei des Maio-Adapters herunterladen und fügen Sie sie Ihrem Projekt hinzu.
Schritt 4: Erforderlichen Code hinzufügen
Für die Maio-Android-Integration 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 überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonmaioerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der maio (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Fehlercodes
Wenn der Adapter keine Anzeige von maio empfängt,
Publisher können den zugrunde liegenden Fehler der Anzeigenantwort mit
.
ResponseInfo.getAdapterResponses()
in den folgenden Klassen:
Format | Klassenname |
---|---|
Interstitial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
Verfügbar | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
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. Siehe Code und in der Dokumentation von maio . |
101 | Maio hat derzeit keine Anzeige. |
102 | Ungültige Serverparameter (z.B. fehlende Placement-ID). |
103 | Der zum Laden einer Anzeige verwendete Kontext war keine „Activity“-Instanz. |
Änderungsprotokoll zum maio-Vermittlungsadapter für Android
Version 1.1.16.3
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 23.0.0 aktualisiert.
- Die Kompatibilität mit dem maio SDK Version 1.1.16 wurde 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 zur Verwendung der neuen
VersionInfo
-Klasse aktualisiert. - Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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
undtargetSdkVersion
wurden auf API 31 aktualisiert.- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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.
- Die Kompatibilität mit dem maio SDK Version 1.1.16 wurde bestätigt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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
- Die Kompatibilität mit dem maio SDK Version 1.1.15 wurde 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.
- Die Kompatibilität mit dem maio SDK Version 1.1.14 wurde 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
- 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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 begrenzen, schlagen Anzeigenanfragen jetzt sofort fehl, wenn in Ihrer Mai keine Anzeige zur Auslieferung bereit ist.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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
- Die Kompatibilität mit dem maio SDK Version 1.1.10 wurde bestätigt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 18.2.0 aktualisiert.
Version 1.1.8.0
- Die Kompatibilität mit dem maio SDK Version 1.1.8 wurde bestätigt.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 18.1.0 aktualisiert.
Version 1.1.7.0
- Fehlerkorrekturen.
- Die Kompatibilität mit dem maio SDK Version 1.1.7 wurde bestätigt.
Version 1.1.6.1
- Der Adapter wurde aktualisiert, um die neue Reward API zu unterstützen.
- Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 17.2.0 aktualisiert.
Version 1.1.6.0
- Die Kompatibilität mit dem maio SDK Version 1.1.6 wurde 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 aktualisiert, sodass er mit der Instanzklasse anstelle von 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
- Die Kompatibilität mit dem maio SDK Version 1.1.2 wurde bestätigt.
Version 1.1.1.1
- Der Adapter wurde aktualisiert, um das Anzeigenereignis
onRewardedVideoComplete()
aufzurufen.
Version 1.1.1.0
- Die Kompatibilität mit dem maio SDK Version 1.1.1 wurde 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
- Die Kompatibilität mit dem maio SDK Version 1.0.8 wurde bestätigt.
Version 1.0.7.1
- Es wurde ein Problem behoben, das NullPointerExceptions verursachen konnte, wenn Anzeigen fehlschlagen. geladen werden.
Version 1.0.7.0
- Es besteht jetzt die Möglichkeit, den Testmodus durch Hinzufügen einer Testgeräte-ID zu
AdRequest
zu aktivieren. - Die Kompatibilität mit dem maio SDK Version 1.0.7 wurde bestätigt.
Version 1.0.6.0
- Erste Veröffentlichung!
- Interstitials und Videoanzeigen mit Prämie werden jetzt unterstützt.