i-mobile in die Vermittlung einbinden

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads SDK Anzeigen von i-mobile über die AdMob Mediation laden und präsentieren. Dabei werden auch Abfolgeintegrationen behandelt. Darin wird beschrieben, wie Sie i-mobile der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das i-mobile SDK und den Adapter in eine iOS-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 Vermittlungsadapter für i-mobile bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
Banner
Interstitial
Mit Prämie
Nativ

Vorbereitung

Bevor Sie fortfahren, prüfen Sie Folgendes:

  • iOS-Bereitstellungsziel von 13.0 oder höher

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.

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

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

Rufen Sie den Tab 広告スポット管理 (Werbespot-Verwaltung) auf und klicken Sie auf den Button 新規広告スポット (Neuer Werbespot).

create_ad_spot

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

new_ad_spot_form

Dein neuer Werbespot ist fertig. Klicken Sie auf den Button アプリ設定取得 (App-Einstellungen abrufen), um die Integrationsdetails aufzurufen.

ad_spot_list

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 Initiative des IAB Tech Lab, 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. Falls noch nicht geschehen, richten Sie eine app-ads.txt-Datei für Ihre App ein.

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 den 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 Vermittlung auf. Wenn Sie eine vorhandene Vermittlungsgruppe ändern möchten, klicken Sie auf den Namen der Vermittlungsgruppe, um sie zu bearbeiten, und fahren Sie mit dem Abschnitt 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 Zielregionen aus. Legen Sie als Nächstes den Status der Vermittlungsgruppe auf Aktiviert fest und klicken Sie dann auf Anzeigenblöcke hinzufügen.

Verknüpfen Sie diese Vermittlungsgruppe mit einem oder mehreren Ihrer vorhandenen AdMob-Anzeigenblöcke. Klicken Sie dann auf Fertig.

Auf der Karte „Anzeigenblöcke“ sollten jetzt die ausgewählten Anzeigenblöcke zu sehen sein:

i-mobile als Anzeigenquelle hinzufügen


Wählen Sie im Bereich Anzeigenquellen auf der Karte Abfolge die Option Anzeigenquelle hinzufügen aus.

Wählen Sie i-mobile aus und aktivieren Sie den Schalter Optimieren. Geben Sie den Anmeldenamen und das API-Passwort ein, die Sie im vorherigen Abschnitt erhalten haben, um die Optimierung der Anzeigenquelle für i-mobile einzurichten. Geben Sie dann einen eCPM-Wert für i-mobile ein und klicken Sie auf Weiter.




Wenn Sie bereits eine Zuordnung für i-mobile haben, können Sie sie auswählen. Klicken Sie andernfalls auf Zuordnung hinzufügen.



Geben Sie als Nächstes die Publisher-ID, die Media-ID und die Spot-ID ein, die Sie im vorherigen Abschnitt abgerufen haben. Klicken Sie dann auf Fertig.

Schritt 3: i-mobile SDK und Adapter importieren

Empfohlen: Swift Package Manager verwenden

Bevor Sie fortfahren, müssen Sie die unterstützte Mindestversion des Adapters (2.3.4.2) haben.

So fügen Sie Ihrem Projekt eine Paketabhängigkeit hinzu:

  1. Gehen Sie in Xcode zu File > Add Package Dependencies….

  2. Suchen Sie im angezeigten Prompt nach der folgenden Paket-URL:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. Wählen Sie unter Abhängigkeitsregel die Option Zweig aus.

  4. Geben Sie im Textfeld main ein.

Manuelle Integration

  • Laden Sie die aktuelle Version des i-mobile SDK herunter und verknüpfen Sie ImobileSdkAds.framework in Ihrem Projekt.
  • Laden Sie die aktuelle Version des i-mobile-Adapters über den Downloadlink im Änderungsprotokoll herunter und verknüpfen Sie IMobileAdapter.framework in Ihrem Projekt.

Mit CocoaPods

  • Fügen Sie in der Podfile-Datei Ihres Projekts folgende Zeile ein:

    pod 'GoogleMobileAdsMediationIMobile'

  • Führen Sie über die Befehlszeile folgenden Befehl aus:

    pod install --repo-update

Schritt 4: Erforderlichen Code hinzufügen

SKAdNetwork implementieren

Folgen Sie der Dokumentation von i-mobile, um die SKAdNetwork-IDs in die Info.plist-Datei Ihres Projekts einzufügen.

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 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 Anzeigenquelle(n) i-mobile (Vermittlungsabfolge).

Optionale Schritte

Native Anzeigen verwenden

Anzeigen-Rendering

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

Feld Assets, die immer im i-mobile-Adapter enthalten sind
Anzeigentitel
Bild
Text
App-Symbol 1
Call-to-Action
Bewertung
Shop
Preis

1 Das i-mobile SDK stellt kein App-Symbol-Asset für native Anzeigen 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 erhält, können Publisher den zugrunde liegenden Fehler in der Anzeigenantwort mit GADResponseInfo.adNetworkInfoArray unter den folgenden Klassen prüfen:

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:

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 für native Anzeigen zurückgegeben.
105 i-mobile konnte keine nativen Anzeigen-Assets herunterladen.
106 i-mobile unterstützt nicht das Anfordern mehrerer Interstitial-Anzeigen mit derselben Spot-ID.
107 Anfragen mit Altersbeschränkung für das i-mobile SDK filtern, da es keine Signale mit Altersbeschränkung empfangen kann.

Änderungsprotokoll für den i-mobile iOS-Vermittlungsadapter

Version 2.3.4.8

  • Die Mindestversion von iOS wurde aktualisiert, um die Abhängigkeit vom Google Mobile Ads SDK zu lockern und Nebenversionen zuzulassen.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.7.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.7

  • Anfragen mit Altersbeschränkung für das i-mobile SDK filtern, wenn der neue ageRestrictedTreatment auf GADAgeRestrictedTreatmentChild festgelegt ist.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.4.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.6

  • Anfragen mit Altersbeschränkung für das i-mobile SDK filtern, da es keine Signale mit Altersbeschränkung empfangen kann.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.2.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.5

  • Die Google Mobile Ads SDK-Abhängigkeit wurde auf Version 13.0.0 aktualisiert.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.0.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.4

  • Die mindestens erforderliche iOS-Version für CocoaPods wurde auf 13.0 aktualisiert.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 13.0.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.3

  • Die Namen des Frameworks und des Umbrella-Headers in der IMobileAdapter-Modulzuordnung wurden korrigiert.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 12.12.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.2

  • Jetzt ist das Google Mobile Ads SDK ab Version 12.0.0 erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 12.0.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.1

  • CFBundleShortVersionString wurde aktualisiert und hat jetzt drei statt vier Komponenten.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 11.10.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.4.0

  • Kompatibilität mit i-mobile SDK 2.3.4 bestätigt.
  • Unterstützung für die Rückgabe der i-mobile SDK-Version in adSDKVersion hinzugefügt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 11.2.0
  • i-mobile SDK-Version 2.3.4

Version 2.3.3.0

  • Kompatibilität mit i-mobile SDK 2.3.3 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 11.1.0
  • i-mobile SDK-Version 2.3.3

Version 2.3.2.1

  • Die verworfene Delegatmethode willBackgroundApplication wurde aus den Implementierungen von Bannern, Interstitials und nativen Anzeigen entfernt.
  • Es ist jetzt mindestens iOS-Version 12.0 erforderlich.
  • Jetzt ist das Google Mobile Ads SDK ab Version 11.0 erforderlich.
  • Info.plist wurde in die Frameworks in IMobileAdapter.xcframework aufgenommen.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 11.0.1
  • i-mobile SDK-Version 2.3.2

Version 2.3.2.0

  • Kompatibilität mit i-mobile SDK 2.3.2 bestätigt.
  • Die Unterstützung der armv7-Architektur wurde entfernt.
  • Mindestens iOS-Version 11.0 erforderlich.
  • Jetzt ist das Google Mobile Ads SDK in Version 10.4.0 oder höher erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 10.4.0
  • i-mobile SDK-Version 2.3.2

Version 2.3.1.0

  • Kompatibilität mit i-mobile SDK 2.3.1 bestätigt.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 10.3.0
  • i-mobile SDK-Version 2.3.1

Version 2.3.0.1

  • Jetzt ist das Google Mobile Ads SDK ab Version 10.0.0 erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 10.0.0
  • i-mobile SDK Version 2.3.0

Version 2.3.0.0

  • Kompatibilität mit i-mobile SDK 2.3.0 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK ab Version 9.8.0 erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 9.13.0
  • i-mobile SDK Version 2.3.0

Version 2.2.0.1

  • Jetzt ist das Google Mobile Ads SDK ab Version 9.0.0 erforderlich.

Erstellt und getestet mit:

  • Google Mobile Ads SDK Version 9.0.0
  • i-mobile SDK-Version 2.2.0

Version 2.2.0.0

  • Kompatibilität mit i-mobile SDK-Version 2.2.0 bestätigt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 8.13.0
  • i-mobile SDK-Version 2.2.0

Version 2.1.0.1

  • Die Abhängigkeit vom Google Mobile Ads SDK wurde auf Version 8.0.0 oder höher gelockert.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 8.4.0
  • i-mobile SDK-Version 2.1.0

Version 2.1.0.0

  • Kompatibilität mit i-mobile SDK-Version 2.1.0 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK ab Version 8.1.0 erforderlich.
  • Der Adapter wurde aktualisiert, um das Format .xcframework zu verwenden.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 8.1.0
  • i-mobile SDK-Version 2.1.0

Version 2.0.33.1

  • Standardisierte Adapter-Fehlercodes und -meldungen hinzugefügt.
  • Der Adapter beschränkt jetzt die Anforderung mehrerer Interstitial-Anzeigen mit derselben i-mobile-Spot-ID.
  • Der Adapter leitet jetzt den -nativeAdWillLeaveApplication:-Callback weiter, wenn auf native Anzeigen getippt wird.
  • Jetzt ist das Google Mobile Ads SDK ab Version 7.68.0 erforderlich.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.68.0
  • i-mobile SDK-Version 2.0.33

Version 2.0.33.0

  • Kompatibilität mit i-mobile SDK-Version 2.0.33 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK in Version 7.65.0 oder höher erforderlich.
  • Es ist jetzt mindestens iOS 9.0 erforderlich.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.65.0
  • i-mobile SDK-Version 2.0.33

Version 2.0.32.0

  • Kompatibilität mit i-mobile SDK-Version 2.0.32 bestätigt.
  • Jetzt ist das Google Mobile Ads SDK ab Version 7.60.0 erforderlich.
  • Anzeigen im Format 320 × 50 und 320 × 100 können jetzt skaliert werden, um besser zu den Größen von Anfragen für adaptive Banner zu passen.
  • Die Unterstützung für die i386-Architektur wurde entfernt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.60.0
  • i-mobile SDK-Version 2.0.32

Version 2.0.31.0

  • Kompatibilität mit i-mobile SDK-Version 2.0.31 bestätigt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.53.1
  • i-mobile SDK-Version 2.0.31

Version 2.0.29.0

  • Erstes Release!
  • Unterstützung für Banner, Interstitials und native Anzeigen hinzugefügt.

Entwickelt und getestet mit

  • Google Mobile Ads SDK Version 7.52.0
  • i-mobile SDK-Version 2.0.29