In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads Flutter Plugin Anzeigen von i-mobile mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Außerdem wird beschrieben, wie Sie i-mobile der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das i-mobile SDK und den Adapter in eine Flutter-App einbinden.
Die Dashboard-Benutzeroberfläche für i-mobile verwendet japanischen Text für Labels, Buttons und Beschreibungen. Die Screenshots in diesem Leitfaden wurden nicht übersetzt. In den Beschreibungen und Anleitungen in diesem Leitfaden werden Labels und Buttons jedoch mit ihren deutschen Entsprechungen in Klammern übersetzt.
Unterstützte Integrationen und Anzeigenformate
Der AdMob-Vermittlungsadapter für i-mobile bietet die folgenden Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Vermittlungsabfolge | |
| Formate | |
| Banner | |
| Interstitial | |
| Mit Prämie | |
| Nativ | |
Voraussetzungen
- Aktuellstes Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 oder höher
- Für die Bereitstellung auf Android-Geräten:
- Android API-Level 23 oder höher
- Für die Bereitstellung auf iOS-Geräten:
- iOS-Bereitstellungsziel 13.0 oder höher
- Ein funktionierendes Flutter-Projekt, das mit Google Mobile Ads Flutter Plugin konfiguriert wurde Weitere Informationen finden Sie unter Einrichten Google Mobile Ads Flutter Plugin.
- AdMob Mediation einrichten.
Schritt 1: Konfigurationen in der i-mobile-Benutzeroberfläche einrichten
Registrieren Sie sich oder melden Sie sich in Ihrem i-mobile-Konto an.
Fügen Sie Ihre App dem i-mobile-Dashboard hinzu, indem Sie auf den Tab サイト/アプリ管理 (Website-/App-Verwaltung) und auf den Button für die Plattform Ihrer App klicken.
Android

iOS

Füllen Sie das Formular aus und klicken Sie auf den Button 新規登録 (Registrieren).
Android

iOS

Wenn Sie einen neuen Werbeplatz erstellen möchten, wählen Sie Ihre App auf dem Tab サイト/アプリ管理 (Website-/App-Verwaltung) aus.
Android

iOS

Rufen Sie den Tab 広告スポット管理 (Werbespot-Verwaltung) auf und klicken Sie auf den Button 新規広告スポット (Neuer Werbespot).
Füllen Sie dann das Formular aus und geben Sie 広告スポット名 (Name des Werbespots), 広告スポットサイズ (Größe des Werbespots) und andere Details an. Klicken Sie dann auf den Button 新規登録 (Registrieren).
Dein neuer Werbespot ist fertig. Klicken Sie auf den Button アプリ設定取得 (App-Einstellungen abrufen), 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.
Android

iOS

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.
Wenn Sie das noch nicht getan haben,
richten Sie eine app-ads.txt-Datei für Ihre App ein.
Informationen zum Implementieren von app-ads.txt für i-mobile finden Sie in den
FAQs.
Schritt 2: i-mobile-Nachfrage in der AdMob-Benutzeroberfläche einrichten
Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren
Android
Eine Anleitung finden Sie unter Schritt 2 im Leitfaden für Android.
iOS
Eine Anleitung finden Sie unter Schritt 2 im Leitfaden für iOS.
Schritt 3: i-mobile SDK und Adapter importieren
Integration über pub.dev
Fügen Sie der Datei pubspec.yaml Ihres Pakets die folgende Abhängigkeit mit den neuesten Versionen des i-mobile SDK und des Adapters hinzu:
dependencies:
gma_mediation_imobile: ^1.0.2
Manuelle Integration
Laden Sie die aktuelle Version des Google Mobile Ads-Vermittlungs-Plug-ins für
i-mobile,
extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner
(und dessen Inhalt) Ihrem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml auf das Plug-in, indem Sie die folgende Abhängigkeit hinzufügen:
dependencies:
gma_mediation_imobile:
path: path/to/local/package
Schritt 4: Zusätzlicher Code erforderlich
Android
Für die i-mobile-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation von i-mobile
, um die SKAdNetwork-IDs der Datei Info.plist Ihres Projekts hinzuzufügen.
Schritt 5: Implementierung testen
Testanzeigen aktivieren
Stellen Sie sicher, dass Sie Ihr Testgerät für AdMob registrieren. i-mobile stellt Test-Spot-ID, Media-ID, und Publisher-ID zur Verfügung. Sie finden sie hier.
Testanzeigen prüfen
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 i-mobile (Vermittlungsabfolge) Anzeigenquelle(n).
Fehlercodes
Wenn der Adapter keine Anzeige von i-mobile erhält, können Publisher den
zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo
unter den folgenden Klassen prüfen:
Android
| Format | Klassenname |
|---|---|
| Banner | com.google.ads.mediation.imobile.IMobileAdapter |
| Interstitial | com.google.ads.mediation.imobile.IMobileAdapter |
| Nativ | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| Format | Klassenname |
|---|---|
| Banner | IMobileAdapter |
| Interstitial | IMobileAdapter |
| Nativ | GADMediationAdapterIMobile |
Hier sind die Codes und die zugehörigen Meldungen, die vom i-mobile-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
| Fehlercode | Grund |
|---|---|
| 0-99 | Das i-mobile SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie im Code. |
| 101 | Für i-mobile ist ein Activity-Kontext erforderlich, um Anzeigen zu laden. |
| 102 | Die in der AdMob-Benutzeroberfläche konfigurierten i-mobile-Serverparameter fehlen oder sind ungültig. |
| 103 | Die angeforderte Anzeigengröße entspricht keiner von i-mobile unterstützten Bannergröße. |
| 104 | Der Callback für den erfolgreichen Ladevorgang für native Anzeigen von i-mobile hat eine leere Liste mit nativen Anzeigen zurückgegeben. |
iOS
| Fehlercode | Grund |
|---|---|
| 0-10 | Das i-mobile SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie im Code. |
| 101 | Die in der AdMob-Benutzeroberfläche konfigurierten i-mobile-Serverparameter fehlen oder sind ungültig. |
| 102 | Die angeforderte Anzeigengröße entspricht keiner von i-mobile unterstützten Bannergröße. |
| 103 | i-mobile konnte keine Anzeige präsentieren. |
| 104 | i-mobile hat ein leeres Array mit nativen Anzeigen zurückgegeben. |
| 105 | i-mobile konnte keine Assets für native Anzeigen herunterladen. |
| 106 | i-mobile unterstützt keine Anfragen für mehrere Interstitial-Anzeigen mit derselben Spot-ID. |
Änderungsprotokoll für den i-mobile Flutter-Vermittlungsadapter
Version 1.0.4 (in Arbeit)
Version 1.0.3 (in Arbeit)
- Mindestversion von Flutter auf 3.35.1 aktualisiert
- Unterstützung für Google Mobile Ads Flutter-Plug-in Version 7.0.0 hinzugefügt
Version 1.0.2
- Unterstützt den i-mobile Android-Adapter Version 2.3.2.1.
- Unterstützt den i-mobile iOS-Adapter Version 2.3.4.3.
- Mit dem Google Mobile Ads Flutter-Plug-in Version 6.0.0 erstellt und getestet
Version 1.0.1
- Unterstützt den i-mobile Android-Adapter Version 2.3.2.1.
- Unterstützt den i-mobile iOS-Adapter Version 2.3.4.2.
- Mit dem Google Mobile Ads Flutter-Plug-in Version 6.0.0 erstellt und getestet
Version 1.0.0
- Erste Version
- Unterstützt den i-mobile Android-Adapter Version 2.3.2.0.
- Unterstützt den i-mobile iOS-Adapter Version 2.3.4.1.
- Mit dem Google Mobile Ads Flutter-Plug-in Version 5.3.1 erstellt und getestet