In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK Anzeigen aus ironSource Anzeigen mithilfe von mediation mit Vermittlungsabfolge Integrationen. Hier erfahren Sie, wie Sie ironSource-Anzeigen Vermittlungskonfiguration und Integration des ironSource Ads SDK und des Adapters in einer Flutter App.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter AdMob für ironSource Ads enthält die folgenden Funktionen:
Integration | |
---|---|
Gebote | 1 |
Wasserfall | |
Formate | |
Banner | 2 |
Interstitial | |
Verfügbar | |
Interstitial mit Prämie | 2 |
1 Bidding-Integration ist in geschlossener Betaversion zu erhalten, wenden Sie sich an Ihren Account Manager, um Zugriff anzufordern.
2 Dieses Format ist nur abfolgebasierte Integration unterstützt.
Voraussetzungen
- Neuestes Google Mobile Ads SDK
- Flutter 3.7.0 oder höher
- Auf Android-Geräten bereitstellen
<ph type="x-smartling-placeholder">
- </ph>
- Android API-Level 21 oder höher
- Auf iOS-Geräten bereitstellen
<ph type="x-smartling-placeholder">
- </ph>
- iOS-Bereitstellungsziel von 12.0 oder höher
- Ein funktionierendes Flutter Projekt, das mit Google konfiguriert wurde Mobile Ads SDK. Weitere Informationen finden Sie unter Weitere Informationen
- Vermittlung abschließen Startleitfaden
Schritt 1: Konfigurationen in der Anzeigen-UI von ironSource einrichten
Registrieren Sie sich und melden Sie sich in Ihrem ironSource-Anzeigenkonto an.
Klicken Sie auf die Schaltfläche Neue App, um Ihre Anwendung dem Dashboard für ironSource-Anzeigen hinzuzufügen.
App-Details eingeben
Wählen Sie Live-App aus, geben Sie die URL Ihrer App ein und klicken Sie auf App-Info importieren.
Wenn Ihre App nicht verfügbar ist, wählen Sie App Not Live im App Store aus und geben Sie einen Temporären Namen für Ihre App an. Wählen Sie Ihre Plattform aus.
Füllen Sie den Rest des Formulars aus und klicken Sie auf App hinzufügen.
Notieren Sie sich den neuen App-Schlüssel, der nach dem Hinzufügen der App angezeigt wird. Sie benötigen diesen Wert, um Ihre Anzeigenblock-IDAdMob einzurichten. Wählen Sie die Anzeigenformate aus, die Ihre App unterstützt. Anschließend klicken Sie auf Weiter.
Android
iOS
Instanz erstellen
Als Nächstes konfigurieren Sie eine Netzwerkinstanz für die hinzugefügte Anwendung.
Gebote
Rufen Sie LevelPlay > Einrichtung > SDK-Netzwerke auf und wählen Sie dann Ihre App aus. Klicken Sie unter Gebote auf das Bearbeitungssymbol, um die Bidding-Instanz-ID aufzurufen.
Android
iOS
Notieren Sie sich die Instanz-ID.
Android
iOS
Wasserfall
Gehen Sie zu Anzeigen > Einrichtung > Instanzen. Wählen Sie die Anwendung aus und klicken Sie auf Instanz erstellen.
Geben Sie die erforderlichen Informationen ein und klicken Sie auf Speichern und schließen.
Sobald die Instanz erstellt wurde, wird die Instanz-ID im Feld Instanz-ID aufgeführt.
Schlüssel für die Reporting API finden
Gebote
Dieser Schritt ist für die Verknüpfung von Geboten nicht erforderlich.
Wasserfall
Neben dem App-Schlüssel und der Instanz-ID benötigen Sie zum Einrichten der Anzeigenblock-IDAdMob auch den Secret-Schlüssel von ironSource Ads und das Aktualisierungstoken.
Rufen Sie in Ihrem Publisher-Dashboard von ironSource-Anzeigen die Seite Mein Konto auf und klicken Sie auf den Tab API. Notieren Sie sich Ihren Geheimschlüssel und das Token aktualisieren.
Testmodus aktivieren
Folgen Sie der Anleitung im Integrationstest von ironSource Ads, um ironSource-Anzeigen zu aktivieren.
Schritt 2: Nachfrage für ironSource-Anzeigen in der AdMob Benutzeroberfläche einrichten
Vermittlungseinstellungen für Anzeigenblöcke konfigurieren
Android
Eine Anleitung finden Sie in Schritt 2 der Anleitung für Android.
iOS
Eine Anleitung dazu finden Sie in Schritt 2 der Anleitung für iOS.
Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen ironSource Mobile
Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um ironSource Mobile in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.
Schritt 3: ironSource Ads SDK und Adapter importieren
Integration über pub.dev
(Nur Android) Fügen Sie der darin enthaltenen Datei build.gradle
die folgenden Repositories hinzu
im android
-Verzeichnis Ihres Projekts:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
Fügen Sie die folgende Abhängigkeit mit den neuesten Versionen des
IronSource
SDK und Adapter im
pubspec.yaml
-Datei:
dependencies:
gma_mediation_ironsource: ^1.0.0
Manuelle Integration
Laden Sie die aktuelle Version des Google Mobile Ads Mediation-Plug-ins für
IronSource
,
entpacken Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner hinzu.
in Ihr Flutter-Projekt hochladen. Verweisen Sie dann auf das Plug-in in der
pubspec.yaml
-Datei durch Hinzufügen der folgenden Abhängigkeit:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
Schritt 4: Datenschutzeinstellungen im ironSource Ads SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Google-Einwilligung der Nutzer in der EU den Richtlinien entsprechen, müssen Sie sicherstellen, dass bestimmte Personen Einwilligungen von Nutzern im Europäischen Wirtschaftsraum (EWR) bezüglich die Verwendung von Gerätekennungen und personenbezogenen Daten. Diese Richtlinie entspricht den der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung Verordnung (DSGVO) aufgeführt. Beim Einholen der Einwilligung müssen Sie jedes Werbenetzwerk angeben in Ihrer Vermittlungskette, die personenbezogene Daten erheben, erhalten oder nutzen, Informationen zur Nutzung der einzelnen Werbenetzwerke enthalten. Google kann derzeit nicht wird die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke übergeben.
Das Google Mobile Ads-Vermittlungs-Plug-in für ironSource Ads
enthält die
GmaMediationIronsource().SetConsent()
.
. Der folgende Beispielcode zeigt, wie Sie
Einwilligungsinformationen an das ironSource Ads SDK senden. Wenn Sie diese Option wählen,
sollten Sie dies nachholen, bevor Sie Anzeigen über das
Google Mobile Ads SDK.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
In der Dokumentation von ironSource Ads finden Sie Erweiterte Einstellungen für Regulierungen .
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie den Nutzern das Angebot des Angebots ihrer "personenbezogenen Daten" (wie das Gesetz definiert dieser Nutzungsbedingungen), wobei die Widerspruchsmöglichkeit über einen gut sichtbaren "Do Not Sell My Personal"-Artikel Informationen“ auf den Link „Verkauf“ die Startseite der Party. Die USA Datenschutz für Staaten Leitfaden zur Einhaltung gesetzlicher Vorschriften die Möglichkeit, eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google, aber Google kann diese Einstellung nicht auf jede Anzeige anwenden Netzwerk in Ihrer Vermittlungskette. Daher müssen Sie jedes Werbenetzwerk, Vermittlungskette, die am Verkauf von persönlichen und folgen den Leitlinien der einzelnen Netzwerke, um sicherzustellen, Compliance.
Das Google Mobile Ads-Vermittlungs-Plug-in für ironSource Ads
enthält die
GmaMediationIronsource().setDoNotSell
.
. Der folgende Beispielcode zeigt, wie Sie
Einwilligungsinformationen an das ironSource Ads SDK senden. Diese Optionen müssen festgelegt werden,
initialisieren Sie die
SDK
damit sie korrekt an das ironSource Ads SDK weitergeleitet werden.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
Weitere Informationen finden Sie in der ironSource Ads-Dokumentation zu den erweiterten Regulierungseinstellungen für beides. Android-Gerät und iOS finden Sie weitere Details und die Werte, die in der Methode angegeben werden können.
Schritt 5: Erforderlichen Code hinzufügen
Android
Proguard-Regeln
Wenn Sie Ihre App verkleinern, verschleiern und optimieren, Für IronSource Ads sind zusätzliche ProGuard-Regeln für Ihr Projekt erforderlich.
Beratung
Integrationsleitfaden für das Android SDK von IronSource Ads
welche ProGuard-Regeln
für Ihr Projekt erforderlich sind,
und fügen Sie diese Regeln der Datei proguard-user.txt
hinzu.
Anwendungslebenszyklus
Überschreiben Sie die Methoden onPause()
und onResume()
in jeder der
Ihre Aktivitäten, um die entsprechenden ironSource-Anzeigenmethoden wie folgt aufzurufen:
Java
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
Kotlin
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation zu ironSource Ads, um die SKAdNetwork-Kennungen Ihrem
Info.plist
-Datei des Projekts.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der IronSource Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen von IronSource erhalten, aktivieren Sie im Anzeigenprüftool mithilfe der ironSource Ads (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Fehlercodes
Wenn der Adapter keine Anzeige von ironSource Ads empfängt, können Publisher
den zugrunde liegenden Fehler aus der Anzeigenantwort
ResponseInfo
unter
folgenden Klassen:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
Dies sind die Codes und zugehörigen Nachrichten, die von den ironSource-Anzeigen ausgegeben werden. Adapter, wenn eine Anzeige nicht geladen werden kann:
Android
Fehlercode | Grund |
---|---|
101 | Die in der Benutzeroberfläche AdMob konfigurierten Parameter des ironSource Ads-Servers fehlen bzw. sind ungültig. |
102 | Zur Initialisierung des SDKs von ironSource Ads ist ein Aktivitätskontext erforderlich. |
103 | Für ironSource-Anzeigen kann nur eine Anzeige pro ironSource-Instanz-ID geladen werden. |
105 | Die angeforderte Größe der Banneranzeige wird von ironSource Ads nicht unterstützt. |
106 | Das ironSource Ads SDK wurde nicht initialisiert. |
501-1056 | ironSource Ads SDK-Fehler. Dokumentation ansehen . |
iOS
Fehlercode | Grund |
---|---|
101 | Die in der Benutzeroberfläche AdMob konfigurierten Parameter des ironSource Ads-Servers fehlen bzw. sind ungültig. |
102 | Der ironSource Ads Adapter unterstützt das angeforderte Anzeigenformat nicht. |
103 | Für diese Netzwerkkonfiguration wurde bereits eine ironSource-Anzeige geladen. |
104 | Die angeforderte Größe der Banneranzeige wird von ironSource Ads nicht unterstützt. |
508-1037 | ironSource Ads SDK-Fehler. Dokumentation ansehen . |
Änderungsprotokoll zum ironSource Flutter-Vermittlungsadapter
1.0.0
- Erste Version
- Die Kompatibilität mit dem ironSource Android-Adapter Version 8.0.0.0 wurde bestätigt.
- Die Kompatibilität mit dem ironSource iOS-Adapter Version 8.0.0.0.0 wurde bestätigt.
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.1.0.