Vermittlung mit der Vermittlung

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen von Mai mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch abfolgebasierte Integrationen berücksichtigt. Sie erfahren, wie Sie Mai zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Mai-SDK und den Adapter in eineAndroid -App einbinden.

Die Dashboard-Oberfläche für Mai verwendet für die Beschriftungen, Schaltflächen und Beschreibungen japanischer Text. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieses Leitfadens wird jedoch auf die Beschriftungen und Schaltflächen in der entsprechenden englischen Sprache verwiesen. Zum Beispiel ist "URL 名キーム" „URL Scheme“ und so weiter.

Unterstützte Integrationen und Anzeigenformate

Der Ad Manager -Vermittlungsadapter für maio hat folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Nativ

Voraussetzungen

  • Android API-Level 19 oder höher
  • maio SDK 1.0.7 oder höher

  • Das aktuelle Google Mobile Ads SDK

  • Arbeiten Sie den Startleitfaden zur Vermittlung ab.

Schritt 1: Konfigurationen in der Mai-Benutzeroberfläche 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 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.

Schritt 2: Mai-Nachfrage in Ad Manager der 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.

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

Schritt 3: Mai-SDK und Adapter importieren

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 Anwendungsebene die folgenden Implementierungsabhängigkeiten und Konfigurationen hinzu. Verwenden Sie die neuesten Versionen des Mai-SDK und des Adapters:

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

Manuelle Integration

  • Laden Sie die neueste Version des maio Android SDK herunter und fügen Sie sie Ihrem 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 Mai-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.

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

Erhält der Adapter keine Anzeige von maio, 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 sehen Sie die Codes und Begleitmeldungen, die vom Maiio-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 von maio.
101 Maio hat 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 Mai hat noch keine Anzeige.
102 Ungültige Serverparameter (z. B. fehlende Placement-ID)
103 Das angeforderte Anzeigenformat wird vom Mai-Adapter nicht unterstützt.
104 Für diese Netzwerkkonfiguration wurde bereits eine Anzeige geladen.

maio Android Mediation Adapter-Änderungsprotokoll

Nächste Version

  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 22.4.0 aktualisiert.

Version 1.1.16.2

  • Der Adapter wurde zur Verwendung der neuen VersionInfo-Klasse aktualisiert.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 22.0.0 aktualisiert.

Erstellt und getestet mit:

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

Version 1.1.16.1

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

Erstellt und getestet mit:

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

Version 1.1.16.0

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

Erstellt und getestet mit:

  • Google Mobile Ads SDK: Version 20.4.0
  • Maio SDK-Version 1.1.16.

Version 1.1.15.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.15.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 20.0.0 aktualisiert.

Erstellt und getestet mit:

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

Version 1.1.14.0

  • Standardisierte Adapterfehlercodes und -meldungen hinzugefügt.
  • Bestätigte Kompatibilität mit Mai-SDK-Version 1.1.14.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 19.8.0 aktualisiert.

Erstellt und getestet mit:

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

Version 1.1.13.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.13.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 19.5.0 aktualisiert.

Erstellt und getestet mit:

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

Version 1.1.12.0

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

Erstellt und getestet mit:

  • Version 19.4.0 des Google Mobile Ads SDK
  • Maio SDK-Version 1.1.12.

Version 1.1.11.1

  • Um Zeitüberschreitungen zu begrenzen, schlagen Anzeigenanfragen jetzt sofort fehl, wenn maio keine Anzeige zur Auslieferung bereit hat.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 19.1.0 aktualisiert.

Erstellt und getestet mit:

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

Version 1.1.11.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.11.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 18.3.0 aktualisiert.

Erstellt und getestet mit:

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

Version 1.1.10.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.10.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 18.2.0 aktualisiert.

Version 1.1.8.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.8.
  • Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 18.1.0 aktualisiert.

Version 1.1.7.0

  • Fehlerkorrekturen
  • Bestätigte Kompatibilität mit maio SDK Version 1.1.7.

Version 1.1.6.1

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

Version 1.1.6.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.6.

Version 1.1.5.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.5.

Version 1.1.4.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.4.

Version 1.1.3.1

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

Version 1.1.3.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.3.

Version 1.1.2.1

  • Der Adapter wurde mit aktualisierten Initialisierungsfunktionen aktualisiert.

Version 1.1.2.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.2.

Version 1.1.1.1

  • Der Adapter wurde aktualisiert, sodass das Anzeigenereignis onRewardedVideoComplete() aufgerufen wird.

Version 1.1.1.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.1.

Version 1.1.0.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.1.0.

Version 1.0.8.0

  • Bestätigte Kompatibilität mit maio SDK Version 1.0.8.

Version 1.0.7.1

  • Es wurde ein Problem behoben, das dazu führen konnte, dass NullPointerExceptions auftrat, wenn Anzeigen nicht geladen wurden.

Version 1.0.7.0

  • Der Testmodus kann jetzt aktiviert werden, indem eine Testgeräte-ID zu AdRequest hinzugefügt wird.
  • Bestätigte Kompatibilität mit maio SDK Version 1.0.7.

Version 1.0.6.0

  • Erste Version!
  • Interstitials und Videoanzeigen mit Prämie werden jetzt unterstützt.