i-mobile in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen auf i-Mobile mithilfe von Vermittlung und abfolgebasierten Integrationen zu laden und einzublenden. Darin erfahren Sie, wie Sie i-mobile zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und wie Sie das i-mobile SDK und den Adapter in eine Android App einbinden.

In der Dashboard-Oberfläche von i-mobile wird für Labels, Schaltflächen und Beschreibungen japanischer Text verwendet. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieses Leitfadens werden Labels und Schaltflächen jedoch mit ihren englischsprachigen Entsprechungen in Klammern übersetzt.

Unterstützte Integrationen und Anzeigenformate

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

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

Voraussetzungen

  • Android API-Level 21 oder höher

  • Neuestes Google Mobile Ads SDK

  • Schließen Sie die Vermittlung ab. Startleitfaden

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

Registriere dich oder melde dich in deinem i-mobile-Konto an.

Fügen Sie Ihre App dem i-mobile-Dashboard hinzu. Klicken Sie dazu auf den Tab verwaltetes/アプテ管理 (Website-/Anwendungsverwaltung) und auf die Schaltfläche für die Plattform Ihrer App.

Füllen Sie das Formular aus und klicken Sie auf die Schaltfläche 規용 (Registrieren).

Wenn Sie einen neuen Werbespot erstellen möchten, wählen Sie Ihre App auf dem Tab イト/アプす管理 (Website-/Anwendungsverwaltung) aus.

Rufen Sie den Tab 広告인ポット管理 (Verwaltung von Werbespots) auf und klicken Sie auf die Schaltfläche 金規広告인ポット (Neuer Werbespot).

create_ad_spot

Füllen Sie als Nächstes das Formular aus, indem Sie 広告인ポット名 (Name des Werbespots), 広告인ポットイズ (Größe des Werbespots) und andere Details angeben. Klicken Sie dann auf die Schaltfläche 規Preismodellregel (Registrieren).

new_ad_spot_form

Ihr neuer Werbespot ist fertig. Wenn Sie die Integrationsdetails aufrufen möchten, klicken Sie auf die Schaltfläche アプすち取得 (App-Einstellungen abrufen).

ad_spot_list

Notieren Sie sich die Angaben パテットャーID (Publisher ID), ディアID (Media-ID) und 인ポットID (Spot ID). Sie benötigen diese Parameter später, wenn Sie i-mobile für die Vermittlung auf der Ad Manager -UI konfigurieren.

Schritt 2: Nachfrage für i-Mobile Ad Manager in 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üri-mobilehaben, können Sie ihn auswählen. Wählen Sie andernfalls Neuen Ertragspartner erstellen aus.

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

Aktivieren Sie Automatische Datenerhebung und geben Sie denLogin name and API Password

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 ermitteltenPublisher ID, Media ID and Spot 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: i-mobile 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.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.2.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 Datei android-ad-sdk.aar im Ordner sdk und füge sie deinem Projekt hinzu.

  2. Rufen Sie die Artefakte für den i-mobile-Adapter im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die Datei .aar 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 Ad Manager. i-mobile bietet zu Testzwecken die Spot-ID, die Media-ID und die Publisher-ID. Diese findest du hier.

Testanzeigen überprüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen voni-mobileerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der i-mobile (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.

Optionale Schritte

Native Anzeigen verwenden

Anzeigen-Rendering

Über den i-Mobile-Adapter werden die folgenden Felder für eine NativeAd ausgefüllt.

Field Assets, die immer im i-Mobile-Adapter enthalten sind
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 füllt der i-Mobile-Adapter das App-Symbol mit einem transparenten Bild.

Fehlercodes

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

Format Klassenname
Banner com.google.ads.mediation.imobile.IMobileAdapter
Interstitial com.google.ads.mediation.imobile.IMobileAdapter
Ich bin Muttersprachler com.google.ads.mediation.imobile.IMobileMediationAdapter

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

Fehlercode Grund
0-99 i-mobile-SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code.
101 Für i-mobile ist zum Laden von Anzeigen ein Activity-Kontext erforderlich.
102 Die in der Ad Manager UI konfigurierten Parameter des i-mobile-Servers fehlen oder sind ungültig.
103 Die angeforderte Anzeigengröße stimmt nicht mit einer von i-Mobile unterstützten Bannergröße überein.
104 Der Callback beim erfolgreichen Laden der nativen Anzeigen von i-mobile hat eine leere Liste mit nativen Anzeigen zurückgegeben.
0-10 i-mobile-SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code.
101 Die in der Ad Manager UI konfigurierten Parameter des i-mobile-Servers fehlen oder sind ungültig.
102 Die angeforderte Anzeigengröße stimmt nicht mit einer von i-Mobile unterstützten Bannergröße überein.
103 i-mobile konnte keine Anzeige präsentieren.
104 „i-mobile“ hat ein leeres Array für native Anzeigen zurückgegeben.
105 i-mobile konnte die Assets für native Anzeigen nicht herunterladen.
106 i-mobile unterstützt die Anforderung mehrerer Interstitial-Anzeigen mit derselben Spot-ID nicht.

Änderungsprotokoll zum i-mobile-Android-Vermittlungsadapter

Version 2.3.2.0

  • Die Kompatibilität mit i-mobile SDK Version 2.3.2 wurde 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 23.0.0 aktualisiert.
  • Die Kompatibilität mit i-mobile SDK Version 2.3.1 wurde 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 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.
  • IMobile SDK Version 2.3.1.

Version 2.3.1.0

  • Die Kompatibilität mit i-mobile SDK Version 2.3.1 wurde bestätigt.
  • Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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

  • Die Kompatibilität mit i-mobile SDK Version 2.3.0 wurde bestätigt.
  • Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 21.3.0 aktualisiert.

Entwickelt und getestet mit:

  • Google Mobile Ads SDK, Version 21.3.0.
  • Version 2.3.0 des IMobile SDK

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

Version 2.0.23.0

  • Die Kompatibilität mit i-mobile SDK Version 2.0.23 wurde bestätigt.
  • Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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 Fehlercodes und Fehlermeldungen für Adapter hinzugefügt.
  • Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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 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
  • IMobile SDK Version 2.0.22.

Version 2.0.22.0

  • Die Kompatibilität mit i-mobile SDK Version 2.0.22 wurde bestätigt.
  • Der Adapter wurde aktualisiert, um Inline-Anfragen für adaptive 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

  • Die Kompatibilität mit i-mobile SDK Version 2.0.21 wurde bestätigt.
  • Die mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 19.1.0 aktualisiert.
  • Die Skalierung von adaptiven Banneranzeigen wird jetzt unterstützt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK, Version 19.1.0.
  • IMobile SDK Version 2.0.21.

Version 2.0.20.2

  • Flexible Banneranzeigengrößen werden jetzt unterstützt.
  • 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.
  • IMobile SDK Version 2.0.20.

Version 2.0.20.1

  • Der Adapter gibt jetzt ein mediaContent-Seitenverhältnis ungleich null zurück.

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!
  • Banner-, Interstitial- und native Anzeigen werden jetzt unterstützt.