i-mobile in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen von i-mobile über die AdMob-Vermittlung laden und präsentieren können. Dabei wird die Wasserfallintegration behandelt. Darin wird beschrieben, wie Sie i-mobile der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und wie Sie 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 werden Labels und Schaltflächen jedoch mit ihren englischen Entsprechungen in Klammern übersetzt.

Unterstützte Einbindungen und Anzeigenformate

Der Vermittlungsadapter für i-mobile bietet die folgenden Funktionen:

Voraussetzungen

• Android-API-Level 23 oder höher

• Neuestes Google Mobile Ads SDK

• Startleitfaden für die Vermittlung

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

Registrieren Sie sich für Ihr i-mobile-Konto oder melden Sie sich an.

Fügen Sie Ihre App dem i-mobile-Dashboard hinzu, indem Sie auf den Tab サイト／アプリ管理 (Site/Application Management) und 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 Werbeplatz erstellen möchten, wählen Sie Ihre App auf dem Tab サイト／アプリ管理 (Site-/App-Verwaltung) aus.

Rufen Sie den Tab 広告スポット管理 (Ad Spot Management) auf und klicken Sie auf die Schaltfläche 新規広告スポット (New Ad Spot).

Füllen Sie dann das Formular aus und geben Sie den 広告スポット名 (Namen des Werbeplatzes), die 広告スポットサイズ (Größe des Werbeplatzes) und andere Details an. Klicken Sie dann auf die Schaltfläche 新規登録 (Registrieren).

Dein neuer Werbespot ist fertig. Klicken Sie auf die Schaltfläche アプリ設定取得 (Get App settings), um die Integrationsdetails aufzurufen.

Notieren Sie sich die パブリッシャー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 in der AdMob-Benutzeroberfläche konfigurieren.

app-ads.txt-Datei aktualisieren

Authorized Sellers for Apps (app-ads.txt) ist eine IAB Tech Lab-Initiative, die dafür sorgt, dass Ihr App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren. Richten Sie eine app-ads.txt-Datei für Ihre App ein, falls noch nicht geschehen.

Informationen zur Implementierung von app-ads.txt für i-mobile finden Sie in den häufig gestellten Fragen.

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 Mediation auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie 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 einen Namen für die Vermittlungsgruppe ein und wählen Sie die Standorte aus, auf die Sie ausrichten möchten. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Ordnen Sie diese Vermittlungsgruppe einem oder mehreren Ihrer vorhandenen AdMob-Anzeigenblöcke zu. Klicken Sie dann auf Fertig.

Die Karte „Anzeigenblöcke“ sollte nun mit den ausgewählten Anzeigenblöcken gefüllt sein:

i-mobile als Anzeigenquelle hinzufügen

Schritt 3: i-mobile SDK und Adapter importieren

Android Studio-Integration (empfohlen)

Fügen Sie in der Datei settings.gradle.kts auf Projektebene die folgenden Repositorys 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:24.4.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

Manuelle Integration

1. Laden Sie die aktuelle Version des i-mobile SDK herunter, extrahieren Sie die android-ad-sdk.aar im Ordner sdk und fügen Sie sie Ihrem Projekt hinzu.

2. Rufen Sie das i-mobile-Adapterartefakt im Maven-Repository von Google auf. Wählen Sie die aktuelle 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

Anzeige mit Aktivitätskontext laden

Übergeben Sie den Activity-Kontext beim Laden von Banner-, Interstitial-, Anzeigenformaten mit Prämie und nativen Anzeigen.Ohne Aktivitätskontext schlägt das Laden von Anzeigen fehl.

Schritt 5: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für AdMob. i-mobile stellt Test-Spot-ID, Media-ID und Publisher-ID für Tests zur Verfügung. Sie finden sie hier.

Testanzeigen bestätigen

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

Optionale Schritte

Native Anzeigen verwenden

Anzeigen-Rendering

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

¹ 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 aus der Anzeigenantwort mit ResponseInfo.getAdapterResponses() in den folgenden Klassen prüfen:

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

i-mobile Android-Mediationsadapter – Änderungsprotokoll

Version 2.3.2.1

• Das erforderliche Mindest-API-Level für Android wurde auf 23 aktualisiert.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 24.0.0 aktualisiert.

Entwickelt und getestet mit:

• Google Mobile Ads SDK Version 24.0.0
• iMobile SDK-Version 2.3.2.

Version 2.3.2.0

• Kompatibilität mit i-mobile SDK v2.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 erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 23.0.0 aktualisiert.
• Kompatibilität mit i-mobile SDK v2.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 aktualisiert, um die neue Klasse VersionInfo zu verwenden.
• Die erforderliche 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 wurde bestätigt.
• Die erforderliche 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

• Die Kompatibilität mit dem i-mobile SDK v2.3.0 wurde bestätigt.
• Die erforderliche 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 erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.0.0 aktualisiert.
• Das erforderliche Mindest-API-Level für Android 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 dem i-mobile SDK v2.0.23 wurde bestätigt.
• Die erforderliche 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

• Standardisierte Adapterfehlercodes und ‑meldungen hinzugefügt.
• Die erforderliche 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 erforderliche 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

• Die Kompatibilität mit dem i-mobile SDK v2.0.22 wurde 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

• Die Kompatibilität mit dem i-mobile SDK v2.0.21 wurde bestätigt.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 19.1.0 aktualisiert.
• Unterstützung für das Skalieren adaptiver Banneranzeigen wurde 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 erforderliche 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 Seitenverhältnis ungleich null für mediaContent 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!
• Unterstützung für Banner-, Interstitial- und native Anzeigen hinzugefügt.