Vermittlung mit der Vermittlung

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus Mai mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch Vermittlungsabfolgen berücksichtigt. 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.

In der Dashboard-Oberfläche von maio wird für Beschriftungen, Schaltflächen und Beschreibungen japanischer Text verwendet. Die Screenshots in dieser Anleitung wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieses Leitfadens werden Labels und Schaltflächen jedoch in ihrer jeweiligen englischen Sprache angegeben. z. B. "URL 名ーム", also "URL-Schema" usw.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter Ad Manager für Maio hat die folgenden Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Ich bin Muttersprachler

Voraussetzungen

• Android API-Level 21 oder höher

• maio SDK 1.0.7 oder höher

• Neuestes Google Mobile Ads SDK

• Schließen Sie die Vermittlung ab. 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.

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

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.

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

Notieren Sie sich auf der Seite Anwendungsverwaltung die Medien-ID. Sie müssen ihn im nächsten Abschnitt einrichten, um den Anzeigenblock Ad Manager 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 Ad Manager Anzeigenblocks konfigurieren.

Neben der Media-ID und der Zonen-ID benötigen Sie die API-ID und den API-SCHLÜSSEL, um Ihre 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 Ihre API-ID und Ihr API-SCHLÜSSEL ausgestellt werden.

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

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

Melden Sie sich in Ihrem Ad Manager-Konto an.

Rufen Sie Auslieferung > Ertragsgruppen auf und klicken Sie auf die Schaltfläche Neue Ertragsgruppe.

Geben Sie einen eindeutigen Namen für die Ertragsgruppe ein, setzen Sie den Status auf Aktiv, wählen Sie das Anzeigenformat und dann den Inventartyp auf Mobile App aus. Wählen Sie unter Targeting > Inventar unter Inventar und Mobile App den Anzeigenblock aus, dem Sie die Vermittlung hinzufügen möchten.

Klicken Sie dann auf die Schaltfläche Ertragspartner hinzufügen.

Wenn Sie bereits einen Ertragspartner fürmaiohaben, können Sie ihn auswählen. Wählen Sie andernfalls Neuen Ertragspartner erstellen aus.

Wählen Sie maio als Werbenetzwerk aus, geben Sie einen eindeutigen Namen ein und aktivieren Sie die Vermittlung.

Aktivieren Sie Automatische Datenerhebung und geben Sie denAPI ID and API KEY ein, den Sie im vorherigen Abschnitt erhalten haben.

Wählen Sie nach der Auswahl des Ertragspartners als Integrationstyp die Option SDK-Vermittlung für Mobilgeräte, als Plattform Android und als Status Aktiv aus. Geben Sie den im vorherigen Abschnitt ermitteltenMedia ID and Zone ID ein. Geben Sie dann einen Wert für den Standard-CPM ein.

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

Klicken Sie abschließend unten auf der Seite auf Speichern.

Hinweis :Bei der automatischen Datenerfassung dauert es einige Tage, bis Daten erfasst sind und dann ein Wert für den dynamischen CPM für ein Vermittlungsnetzwerk präzise berechnet werden kann. Sobald der eCPM berechnet werden kann, wird er automatisch für Sie aktualisiert.

Schritt 3: maio SDK und Adapter importieren

Hinweis :Wenn die kompatiblen Versionen des Mais und des Google Mobile Ads SDK nicht integriert werden, kann es zu Build-Problemen kommen.

Android Studio-Integration (empfohlen)

Fügen Sie 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.1.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

Manuelle Integration

• Laden Sie die neueste Version des maio Android SDK herunter und fügen Sie sie Ihrem Projekt hinzu.
• Gehen Sie zu den Maio-Adapterartefakten im Maven-Repository von Google. 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 Maio-Android-Integration ist kein zusätzlicher Code erforderlich.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager.

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: Deaktiviere den Testmodus für Ad Manager undmaio vor der Veröffentlichung deiner App.

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, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo.getAdapterResponses() in 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

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. Weitere Informationen finden Sie in der Code-Dokumentation und in der Dokumentation zu 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.
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.

Ä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 und targetSdkVersion 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:

• Version 20.0.0 des Google Mobile Ads SDK
• 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 dazu führen konnte, dass NullPointerExceptions auftraten, wenn Anzeigen nicht geladen wurden.

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.