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).
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.
Schritt 3: i-mobile SDK und Adapter importieren
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
Laden Sie die neueste Version des i-mobile SDK herunter, entpacken Sie
android-ad-sdk.aar
im Ordnersdk
und fügen Sie es Ihrem Projekt hinzu.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.
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 |
1 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
undtargetSdkVersion
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.