i-mobile in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus i-mobilen mithilfe der Vermittlung zu laden und einzublenden. Dabei werden auch die abfolgebasierten Integrationen behandelt. Sie erfahren, 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 japanischer Text für ihre Beschriftungen, Schaltflächen und Beschreibungen. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen dieser Anleitung werden jedoch Beschriftungen und Schaltflächen in ihre Entsprechung in der englischen Sprache in Klammern übersetzt.

Unterstützte Integrationen und Anzeigenformate

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

Integration
Gebote
Wasserfall
Formate
Banner
Interstitial
Verfügbar
Nativ

Voraussetzungen

• Android API-Level 19 oder höher

• Das aktuelle Google Mobile Ads SDK

• Arbeiten Sie den Startleitfaden zur Vermittlung ab.

Schritt 1: Konfigurationen in der i-mobile-UI 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).

Hinweis :i-mobile muss Ihre Registrierung genehmigen. Sobald Sie genehmigt wurden, können Sie einen Werbespot erstellen.

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).

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).

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

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: Mobile-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ü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.

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: i-mobile SDK und Adapter importieren

Hinweis :Wenn die kompatiblen Versionen des i-mobile 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.github.io/adnw-sdk-android")
    }
  }
}

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

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

Manuelle Integration

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

2. Rufen Sie die i-mobile Adapter-Artefakte im Maven-Repository von Google auf. Wähle die neueste Version aus, lade die Datei .aar des i-mobile-Adapters herunter und füge sie deinem 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.

Wichtig: Deaktiviere den Testmodus für Ad Manager undi-mobile vor der Veröffentlichung deiner App.

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

Der i-Mobile-Adapter füllt die folgenden Felder für eine NativeAd.

Field	Assets, die immer im i-Mobile-Adapter enthalten sind
Anzeigentitel
Bild
Text
App-Symbol	^1
Call-to-Action
Bewertung
Speichern
Preis

¹ Für native Anzeigen stellt das i-mobile SDK kein App-Symbol-Asset zur Verfügung. Stattdessen wird das App-Symbol über den 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.getAdapterResponse() in 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 Begleitmeldungen, 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 unter Code.
101	Für i-mobile ist ein Activity-Kontext erforderlich, damit Anzeigen geladen werden können.
102	Die in der Ad Manager Benutzeroberfläche konfigurierten Parameter des i-mobile-Servers fehlen oder sind ungültig.
103	Die angeforderte Anzeigengröße stimmt nicht mit einer von iOS unterstützten Bannergröße überein.
104	Der Callback für das erfolgreiche Laden von nativen Anzeigen von i-mobile hat eine leere Liste mit nativen Anzeigen zurückgegeben.
0-10	Das i-mobile SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter Code.
101	Die in der Ad Manager Benutzeroberfläche konfigurierten Parameter des i-mobile-Servers fehlen oder sind ungültig.
102	Die angeforderte Anzeigengröße stimmt nicht mit einer von iOS 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	Die Assets für native Anzeigen konnten für i-mobile nicht heruntergeladen werden.
106	i-mobile unterstützt die Anforderung mehrerer Interstitial-Anzeigen mit derselben Spot-ID nicht.

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

Nächste Version

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

Version 2.3.1.1

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

Version 2.3.1.0

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

Erstellt und getestet mit:

• Version 21.5.0 des Google Mobile Ads SDK
• IMobile SDK Version 2.3.1.

Version 2.3.0.0

• Bestätigte Kompatibilität mit i-mobile SDK v2.3.0.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 21.3.0 aktualisiert.

Erstellt und getestet mit:

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

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

Version 2.0.23.0

• Bestätigte Kompatibilität mit i-mobile SDK v2.0.23.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf 20.5.0 aktualisiert.

Erstellt 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 Version 20.1.0 aktualisiert.

Erstellt 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 Version 20.0.0 aktualisiert.

Erstellt und getestet mit

• Google Mobile Ads SDK: Version 20.0.0.
• IMobile SDK Version 2.0.22.

Version 2.0.22.0

• Bestätigte Kompatibilität mit i-mobile SDK v2.0.22.
• Der Adapter wurde aktualisiert, sodass Anfragen für adaptive Inline-Banner unterstützt werden.

Erstellt und getestet mit

• Version 19.1.0 des Google Mobile Ads SDK
• IMobile SDK Version 2.0.22.

Version 2.0.21.0

• Bestätigte Kompatibilität mit i-mobile SDK v2.0.21.
• Die erforderliche Mindestversion des Google Mobile Ads SDK wurde auf Version 19.1.0 aktualisiert.
• Die Skalierung von adaptiven Banneranzeigen wird jetzt unterstützt.

Erstellt und getestet mit

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

Version 2.0.20.2

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

Version 2.0.20.1

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

Erstellt und getestet mit

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

Version 2.0.20.0

• Erstes Release!
• Banner-, Interstitial- und native Anzeigen werden jetzt unterstützt.