InMobi in die Vermittlung einbinden

Plattform auswählen: Android Neu Android iOS Unity Flutter

In dieser Anleitung erfahren Sie, wie Sie mit Google Mobile Ads Flutter Plugin Anzeigen von InMobi mithilfe von Vermittlung laden und präsentieren. Dabei werden sowohl Vermittlungsabfolge- als auch Gebotsintegrationen behandelt. Hier erfahren Sie, wie Sie InMobi der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das InMobi SDK und den Adapter in eine Flutter-App einbinden.

Unterstützte Integrationen und Anzeigenformate

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 Gebote] Wenn Sie alle unterstützten Anzeigenformate in Geboten einbinden möchten, verwenden Sie das Google Mobile Ads-Vermittlungs-Plug-in für InMobi 4.5.0 oder höher (die neueste Version wird empfohlen).
  • Für die Bereitstellung unter Android
    • Android API-Level 23 oder höher
  • Für die Bereitstellung unter iOS
    • iOS-Bereitstellungsziel 10.0 oder höher
  • Ein funktionierendes Flutter-Projekt, das mit Google Mobile Ads Flutter Plugin konfiguriert wurde. Weitere Informationen finden Sie unter Einrichten von Google Mobile Ads Flutter Plugin.
  • Vermittlung einrichten.

Schritt 1: Konfigurationen in der InMobi-Benutzeroberfläche einrichten

Registrieren Sie sich für ein InMobi-Konto.

Melden Sie sich an, sobald Ihr Konto bestätigt wurde.

App hinzufügen

Wenn Sie Ihre App dem InMobi-Dashboard hinzufügen möchten, klicken Sie auf Inventory > Inventory Settings (Inventar > Inventareinstellungen).

Klicken Sie auf Add Inventory (Inventar hinzufügen) und wählen Sie im Drop-down-Menü den Kanal Mobile App (Mobile App) aus.

Geben Sie die URL Ihres veröffentlichten App-Shops in die Suchleiste ein und wählen Sie die App aus den automatisch ausgefüllten Ergebnissen aus. Klicken Sie auf Continue (Weiter).

Wenn Ihre App nicht veröffentlicht ist, klicken Sie auf Link manually (Manuell verknüpfen) und geben Sie die erforderlichen Details ein. Klicken Sie auf Continue (Weiter).

Prüfen Sie die Einstellungen unter App &Website Compliance (App- und Website-Compliance) und klicken Sie dann auf Save and Create Placements (Speichern und Placements erstellen).

Placements

Nachdem Sie Ihr Inventar eingerichtet haben, werden Sie zum Workflow für die Placement-Erstellung weitergeleitet.

Gebote

Wählen Sie den Typ des Anzeigenblocks aus. Geben Sie einen Placement Name (Placement-Name) ein, wählen Sie für Audience Bidding (Zielgruppen-Bidding) die Option On (Ein) und für Partner die Option Google Open Bidding aus und füllen Sie den Rest des Formulars aus. Klicken Sie anschließend auf Create Placement (Placement erstellen).

Vermittlungsabfolge

Wählen Sie den Typ des Anzeigenblocks aus. Geben Sie dann einen Placement Name (Placement-Name) ein, wählen Sie für Audience Bidding (Zielgruppen-Bidding) Off (Aus) aus und füllen Sie den Rest des Formulars aus. Klicken Sie anschließend auf Create Placement (Placement erstellen).

Nachdem das Placement erstellt wurde, werden die Details angezeigt. Notieren Sie sich die Placement-ID, die Sie zum Einrichten Ihres Ad Manager-Anzeigenblocks benötigen.

Konto-ID

Ihre InMobi-Konto-ID finden Sie unter Finance > Payment Settings > Payment Information (Finanzen > Zahlungseinstellungen > Zahlungsinformationen).

InMobi Reporting API-Schlüssel finden

Gebote

Dieser Schritt ist für Gebotsintegrationen nicht erforderlich.

Vermittlungsabfolge

Rufen Sie My Account > Account Settings (Mein Konto > Kontoeinstellungen) auf. Gehen Sie zum Tab API Key (API-Schlüssel) und klicken Sie auf Generate API Key (API-Schlüssel generieren).

Wählen Sie die E-Mail-Adresse des Nutzers aus, für den der Schlüssel erforderlich ist, und klicken Sie auf Generate API Key (API-Schlüssel generieren). Eine Datei mit dem API-Schlüssel und dem Nutzernamen bzw. Anmeldenamen wird generiert.

Nur der Publisher-Administrator des Kontos kann einen API-Schlüssel für alle Nutzer generieren. Wenn Sie den zuvor generierten API-Schlüssel vergessen haben, setzen Sie ihn zurück, indem Sie auf dem Tab API Key (API-Schlüssel) mit dem Mauszeiger auf Ihre E-Mail-Adresse zeigen.

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 Verlust an Werbeeinnahmen zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren. Wenn Sie das noch nicht getan haben, erstellen Sie eine app-ads.txt-Datei für Ad Manager.

Wenn Sie app-ads.txt für InMobi implementieren möchten, fügen Sie Ihr personalisiertes Code-Snippet hinzu.

Testmodus aktivieren

Aktivieren Sie den Testmodus für Ihr Placement für alle Live-Impressionen oder nur für bestimmte Testgeräte.

Schritt 2: InMobi-Nachfrage in der Ad Manager-Benutzeroberfläche einrichten

Vermittlungseinstellungen für Ihren Anzeigenblock konfigurieren

Android

Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.

iOS

Eine Anleitung finden Sie in Schritt 2 der Anleitung für iOS.

InMobi der Liste der Werbepartner für die DSGVO und die Verordnungen von US-Bundesstaaten hinzufügen

Folgen Sie der Anleitung unter Einstellungen für EU-Verordnungen und Einstellungen für Verordnungen von US-Bundesstaaten , um InMobi der Liste der Werbepartner für EU-Verordnungen und Verordnungen von US-Bundesstaaten in der Ad Manager-Benutzeroberfläche hinzuzufügen.

Schritt 3: InMobi 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 InMobi SDK und des Adapters hinzu:

dependencies:
  gma_mediation_inmobi: ^2.1.0

Manuelle Integration

Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für InMobi herunter, 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_inmobi:
    path: path/to/local/package

Schritt 4: Datenschutzeinstellungen im InMobi SDK implementieren

Gemäß der Google-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zur Verwendung von Cookies oder anderen lokalen Speichern einholen, sofern dies gesetzlich vorgeschrieben ist, sowie zur Erhebung, Weitergabe und Verwendung personenbezogener Daten für die Anzeigenpersonalisierung. Diese Richtlinie entspricht den Anforderungen der EU-Richtlinie zum Schutz der Privatsphäre in der elektronischen Kommunikation und der Datenschutz-Grundverordnung (DSGVO). Sie sind dafür verantwortlich, dass die Einwilligung an jede Anzeigenquelle in Ihrer Vermittlungskette weitergegeben wird. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.

Ab Version 1.1.0 des InMobi Flutter-Vermittlungs-Plug-ins liest InMobi automatisch die DSGVO-Einwilligung, die von Consent Management Plattformen festgelegt wurde, die die zusätzliche Einwilligungsspezifikation von Google unterstützen, einschließlich des UMP SDK. Weitere Informationen finden Sie in der InMobi-Dokumentation unter Initializing the SDK for Android and iOS (SDK für Android und iOS initialisieren).

Datenschutzgesetze der US-Bundesstaaten

Gemäß den Datenschutzgesetzen der US-Bundesstaaten müssen Nutzer die Möglichkeit haben, den „Verkauf“ ihrer „personenbezogenen Daten“ (wie in den Gesetzen definiert ) abzulehnen. Die Ablehnung muss über einen gut sichtbaren Link „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten nicht verkaufen) auf der Startseite der „verkaufenden“ Partei angeboten werden. Im Leitfaden zur Einhaltung der Datenschutzgesetze der US-Bundesstaaten können Sie die eingeschränkte Datenverarbeitung für die Anzeigenauslieferung von Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein kann, und die Anweisungen dieser Netzwerke befolgen, um die Einhaltung der Gesetze zu gewährleisten.

Das Google Mobile Ads-Vermittlungs-Plug-in für InMobi unterstützt die Weitergabe von Einwilligungsinformationen an das InMobi SDK nicht.

Schritt 5: Erforderlichen zusätzlichen Code hinzufügen

Android

Für die InMobi-Integration ist kein zusätzlicher Code erforderlich.

iOS

SKAdNetwork-Integration

Folgen Sie der InMobi-Dokumentation, um die SKAdNetwork-IDs der Datei Info.plist Ihres Projekts hinzuzufügen.

Schritt 6: Implementierung testen

Testanzeigen aktivieren

Registrieren Sie Ihr Testgerät für Ad Manager und aktivieren Sie den Testmodus in der InMobi-Benutzeroberfläche.

Testanzeigen prüfen

Wenn Sie prüfen möchten, ob Sie Testanzeigen von InMobi erhalten, aktivieren Sie im Anzeigenprüftool die Tests für einzelne Anzeigenquellen und verwenden Sie die Anzeigenquellen InMobi (Bidding) und InMobi (Vermittlungsabfolge).

Optionale Schritte

Android

Berechtigungen

Für eine optimale Leistung empfiehlt InMobi, der Datei AndroidManifest.xml Ihrer App die folgenden optionalen Berechtigungen hinzuzufügen.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

Sie können diese Berechtigungen optional der Datei Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml hinzufügen.

iOS

Für die iOS-Integration sind keine zusätzlichen Schritte erforderlich.

Fehlercodes

Wenn der Adapter keine Anzeige von InMobi empfangen kann, können Publisher den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo unter den folgenden Klassen prüfen:

Android

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

Hier sind die Codes und die zugehörigen Meldungen, die vom InMobi-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:

Android

Fehlercode Grund
0-99 InMobi SDK-Fehler. Weitere Informationen finden Sie im Code.
100 Die in der Ad Manager-Benutzeroberfläche konfigurierten InMobi-Serverparameter fehlen oder sind ungültig.
101 Das InMobi SDK konnte nicht initialisiert werden.
102 Die angeforderte Anzeigengröße entspricht keiner von InMobi unterstützten Bannergröße.
103 Die Anzeigenanfrage ist keine einheitliche native Anzeigenanfrage.
104 Es wurde versucht, eine InMobi-Anzeige anzufordern, ohne das InMobi SDK zu initialisieren. Das sollte theoretisch nie passieren, da der Adapter das InMobi SDK initialisiert, bevor er InMobi-Anzeigen anfordert.
105 Die InMobi-Anzeige ist noch nicht bereit für die Auslieferung.
106 InMobi konnte keine Anzeige ausliefern.
107 InMobi hat eine native Anzeige zurückgegeben, der ein erforderliches Asset fehlt.
108 Die Bild-Assets der nativen Anzeige von InMobi enthalten eine fehlerhafte URL.
109 Der Adapter konnte die Bild-Assets der nativen Anzeige von InMobi nicht herunterladen.

iOS

Fehlercode Grund
101 Die in der Ad Manager-Benutzeroberfläche konfigurierten InMobi-Serverparameter fehlen oder sind ungültig.
102 Der InMobi-Adapter unterstützt das angeforderte Anzeigenformat nicht.
103 Für diese Netzwerkkonfiguration ist bereits eine InMobi-Anzeige geladen.
Sonstiges Das InMobi SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter IMRequestStatus.h.

Änderungsprotokoll für den InMobi Flutter-Vermittlungsadapter

Version 2.1.0

Version 2.0.1

  • Die Mindestversion von Flutter wurde auf 3.35.1 aktualisiert.
  • Unterstützung für das Google Mobile Ads Flutter-Plug-in Version 7.0.0 wurde hinzugefügt.

Version 2.0.0

Version 1.1.6

Version 1.1.5

Version 1.1.4

Version 1.1.3

Version 1.1.2

Version 1.1.1

Version 1.1.0

Version 1.0.0