i-mobile in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von i-mobile mithilfe von AdMob Mediation laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Darin wird beschrieben, wie Sie i-mobile der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das i-mobile SDK und den Adapter in eine Android-App einbinden.

Die Dashboard-Oberfläche für i-mobile 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 sind Labels und Schaltflächen jedoch übersetzt und die englischen Entsprechungen stehen in Klammern.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für i-mobile bietet folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Nativ

Voraussetzungen

  • Android API-Level 21 oder höher

  • Neueste Version des Google Mobile Ads SDK

  • Mediation abschließen Startleitfaden

Schritt 1: Konfigurationen in der i-mobile-Benutzeroberfläche einrichten

Melde dich an oder mache dich in deinem i-mobile-Konto sitzungsaktiv.

Fügen Sie Ihre App dem i-mobile-Dashboard hinzu, indem Sie auf den Tab サイト／アプリ管理 (Website-/App-Verwaltung) und dann auf die Schaltfläche für die Plattform Ihrer App klicken.

Füllen Sie das Formular aus und klicken Sie auf die Schaltfläche 新規登録 (Registrieren).

Wenn Sie einen neuen Werbestandort erstellen möchten, wählen Sie Ihre App auf dem Tab サイト／アプリ管理 (Website-/App-Verwaltung) aus.

Rufen Sie den Tab 広告スポット管理 (Anzeigenflächenverwaltung) auf und klicken Sie auf die Schaltfläche 新規広告スポット (Neuer Anzeigenblock).

create_ad_spot

Geben Sie als Nächstes den 広告スポット名 (Name des Anzeigen-Speichers), den 広告スポットサイズ (Größe des Anzeigen-Speichers) und weitere Details ein. Klicken Sie dann auf die Schaltfläche 新規登録 (Registrieren).

new_ad_spot_form

Ihr neuer Anzeigen-Spot ist fertig. Klicken Sie auf die Schaltfläche アプリ設定取得 (App-Einstellungen abrufen), um die Integrationsdetails aufzurufen.

ad_spot_list

Notiere dir die パブリッシャーID (Publisher-ID), die メディアID (Media-ID) und die スポットID (Spot-ID). Sie benötigen diese Parameter später, wenn Sie i-mobile für die Vermittlung in der AdMob-Benutzeroberfläche konfigurieren.

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

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Sie müssen i-mobile der Vermittlungskonfiguration für Ihren Anzeigenblock hinzufügen.

Melden Sie sich zuerst in Ihrem AdMob-Konto an. Rufen Sie als Nächstes den Tab Vermittlung auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten. Fahren Sie dann mit i-mobile 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 und klicken Sie auf Weiter.

Geben Sie Ihrer Vermittlungsgruppe einen Namen und wählen Sie die Standorte aus, auf die Sie Ihre Anzeigen ausrichten möchten. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Weisen Sie diese Vermittlungsgruppe mindestens einem Ihrer vorhandenen AdMob-Anzeigenblöcke zu. Klicken Sie dann auf Fertig.

Die Karte „Anzeigenblöcke“ sollte jetzt die von Ihnen ausgewählten Anzeigenblöcke enthalten:

i-mobile als Anzeigenquelle hinzufügen


Wählen Sie unter der Karte Abfolge im Bereich Anzeigenquellen die Option Anzeigenquelle hinzufügen aus. Wählen Sie dann i-mobile aus.

Wählen Sie i-mobile aus und aktivieren Sie den Schalter Optimieren. Geben Sie den Anmeldenamen und das API-Passwort ein, die Sie im vorherigen Abschnitt erhalten haben, um die Anzeigenquellenoptimierung für i-mobile einzurichten. Geben Sie dann einen eCPM-Wert für i-mobile ein und klicken Sie auf Weiter.



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

Geben Sie als Nächstes die Publisher-ID, die Media-ID und die Spot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

Schritt 3: i-mobile 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.github.io/adnw-sdk-android")
    }
  }
}

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 i-mobile SDK und des Adapters:

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

Manuelle Integration

  1. Lade die neueste Version des i-mobile SDK herunter, entpacke die android-ad-sdk.aar in den Ordner sdk und füge sie deinem Projekt hinzu.

  2. Rufen Sie die i-mobile-Adapter-Artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die .aar-Datei des i-Mobile-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.

Schritt 4: Erforderlichen Code hinzufügen

Für die i-mobile-Integration ist kein zusätzlicher Code erforderlich.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob. i-mobile stellt Test-Spot-IDs, Media-IDs und Publisher-IDs für Tests bereit. Sie finden sie in diesem Artikel.

Testanzeigen bestätigen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von i-mobile erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen i-mobile (Abfolge).

Optionale Schritte

Native Anzeigen verwenden

Anzeigen-Rendering

Der i-mobile-Adapter füllt die folgenden Feldbeschreibungen für erweiterte native Anzeigen für eine NativeAd aus.

Feld Vom i-mobile-Adapter immer eingeschlossene Assets
Anzeigentitel
Bild
Text
App-Symbol 1
Call-to-Action
Bewertung
Shop
Preis

1 Für native Anzeigen stellt das i-mobile SDK kein App-Symbol-Asset bereit. Stattdessen wird das App-Symbol vom i-mobile-Adapter mit einem transparenten Bild gefüllt.

Fehlercodes

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

Format Klassenname
Banner com.google.ads.mediation.imobile.IMobileAdapter
Interstitial com.google.ads.mediation.imobile.IMobileAdapter
Nativ com.google.ads.mediation.imobile.IMobileMediationAdapter

Hier sind die Codes und die zugehörigen Meldungen, die vom i-mobile-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Fehlercode Grund
0-99 Das i-mobile SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie im Code.
101 i-mobile benötigt einen Activity-Kontext, um Anzeigen zu laden.
102 Die in der AdMob-Benutzeroberfläche konfigurierten i-mobile-Serverparameter fehlen oder sind ungültig.
103 Die angeforderte Anzeigengröße entspricht nicht einer von i-mobile unterstützten Bannergröße.
104 Der Rückruf nach dem erfolgreichen Laden der nativen Anzeige von i-mobile hat eine leere Liste mit nativen Anzeigen zurückgegeben.

Änderungsprotokoll für den i-mobile Android-Vermittlungsadapter

Version 2.3.2.0

  • Kompatibilität mit i-mobile SDK v2.3.2 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 23.1.0
  • IMobile SDK-Version 2.3.2

Version 2.3.1.2

  • Die Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.
  • Kompatibilität mit i-mobile SDK v2.3.1 bestätigt.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 23.0.0
  • IMobile SDK-Version 2.3.1

Version 2.3.1.1

  • 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
  • IMobile SDK-Version 2.3.1

Version 2.3.1.0

  • Kompatibilität mit i-mobile SDK v2.3.1 bestätigt.
  • Die Mindestversion des Google Mobile Ads SDK wurde auf 21.5.0 aktualisiert.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK Version 21.5.0
  • IMobile SDK-Version 2.3.1

Version 2.3.0.0

  • Kompatible Version: i-mobile SDK v2.3.0
  • Die Mindestversion des Google Mobile Ads SDK wurde auf 21.3.0 aktualisiert.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK-Version 21.3.0
  • IMobile SDK-Version 2.3.0

Version 2.0.23.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
  • IMobile SDK-Version 2.0.23

Version 2.0.23.0

  • Kompatibilität mit i-mobile SDK Version 2.0.23 bestätigt.
  • Die Mindestversion des Google Mobile Ads SDK wurde auf 20.5.0 aktualisiert.

Entwickelt und getestet mit

  • Google Mobile Ads SDK-Version 20.5.0
  • IMobile SDK-Version 2.0.23

Version 2.0.22.2

  • Es wurden standardisierte Adapterfehlercodes und ‑meldungen hinzugefügt.
  • Die Mindestversion des Google Mobile Ads SDK wurde auf 20.1.0 aktualisiert.

Entwickelt und getestet mit

  • Google Mobile Ads SDK-Version 20.1.0
  • IMobile SDK-Version 2.0.22

Version 2.0.22.1

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

Entwickelt und getestet mit

  • Google Mobile Ads SDK-Version 20.0.0
  • IMobile SDK-Version 2.0.22

Version 2.0.22.0

  • Kompatibilität mit i-mobile SDK v2.0.22 bestätigt.
  • Der Adapter wurde aktualisiert, um Anfragen für adaptive Inline-Banner zu unterstützen.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 19.1.0
  • IMobile SDK-Version 2.0.22

Version 2.0.21.0

  • Kompatibilität mit i-mobile SDK Version 2.0.21 bestätigt.
  • Die Mindestversion des Google Mobile Ads SDK wurde auf 19.1.0 aktualisiert.
  • Unterstützung für die Skalierung adaptiver Banneranzeigen hinzugefügt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 19.1.0
  • IMobile SDK-Version 2.0.21

Version 2.0.20.2

  • Unterstützung für flexible Banneranzeigengrößen hinzugefügt.
  • 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
  • IMobile SDK-Version 2.0.20.

Version 2.0.20.1

  • Der Adapter gibt jetzt ein mediaContent-Seitenverhältnis zurück, das nicht null ist.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 18.2.0
  • IMobile SDK-Version 2.0.20.

Version 2.0.20.0

  • Erstes Release!
  • Unterstützung für Banner-, Interstitial- und native Anzeigen hinzugefügt