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 auszuliefern. 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
Neuestes Google Mobile Ads SDK
Mediation abschließen Startleitfaden
Schritt 1: Konfigurationen in der i-mobile-Benutzeroberfläche einrichten
Melde dich in deinem i-mobile-Konto an oder mache eine Registrierung.
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 Werbeblock erstellen möchten, wählen Sie auf dem Tab サイト/アプリ管理 (Website-/App-Verwaltung) Ihre App aus.
Rufen Sie den Tab 広告スポット管理 (Anzeigenflächenverwaltung) auf und klicken Sie auf die Schaltfläche 新規広告スポット (Neuer Anzeigenblock).
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).
Ihr neuer Anzeigen-Spot ist fertig. Klicken Sie auf die Schaltfläche アプリ設定取得 (App-Einstellungen abrufen), um die Integrationsdetails aufzurufen.
Notieren Sie sich 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 Ad Manager -Benutzeroberfläche einrichten
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 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
Lade die neueste Version des i-mobile SDK herunter, entpacke die Datei
android-ad-sdk.aar
im Ordnersdk
und füge sie deinem Projekt hinzu.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
.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
Felder
für eine
NativeAd
aus.
Feld | Assets, die vom i-mobile-Adapter immer eingeschlossen werden |
---|---|
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 | 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 Ad Manager -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 Callback beim erfolgreichen Laden der nativen Anzeigen von i-mobile hat eine leere Liste mit nativen Anzeigen zurückgegeben. |
Änderungsprotokoll zum 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 mindestens erforderliche Version des Google Mobile Ads SDK wurde auf Version 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
- Die Kompatibilität mit i-mobile SDK Version 2.3.0 wurde bestätigt.
- 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
undtargetSdkVersion
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 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 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
- 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.
- 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 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 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