In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads SDK AppLovin-Anzeigen mithilfe der Vermittlung Bidding und die Vermittlungsabfolge. Sie erfahren, wie Sie AppLovin Vermittlungskonfiguration eines Anzeigenblocks und zur Integration des AppLovin SDK und Adapter in eine Flutter App.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter AdMob für AppLovin hat die folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall | |
Formate | |
Banner | 1 |
Interstitial | |
Verfügbar |
Banneranzeigen (ohne MREC) Banner) werden nur in der Vermittlung unterstützt. Bidding unterstützt keinen Typ von Banneranzeigen.
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 AppLovin-UI einrichten
Registrieren oder anmelden mit Ihrem AppLovin-Konto verknüpfen.
Zum Einrichten eines AdMob-Anzeigenblocks benötigen Sie SDK-Schlüssel und Berichtsschlüssel von AppLovin Sie finden sie in der AppLovin-UI > Konto > Zu sehende Schlüssel beide Werte.
Wenn Sie nur Bidding einbinden möchten, können Sie mit dem Vermittlungseinstellungen konfigurieren.
App für die Vermittlung auswählen
Gebote
Dieser Schritt ist für Bidding-Integrationen nicht erforderlich.
Wasserfall
Wählen Sie in der AppLovin-Benutzeroberfläche unter dem Menüpunkt Applications (Anwendungen) Monetarisierung, um auf Ihre registrierten Apps zuzugreifen. App auswählen die Sie für die Vermittlung aus der Liste der verfügbaren Apps verwenden möchten.
Zone erstellen
Gebote
Dieser Schritt ist für Bidding-Integrationen nicht erforderlich.
Wasserfall
Wählen Sie in der AppLovin-Benutzeroberfläche unter Monetization die Option Zones (Zonen) aus. , um Ihre registrierten Zonen-IDs aufzurufen. Wenn Sie die welche Zonen für Ihre App erforderlich sind, fahren Sie mit Schritt 2 fort. Klicken Sie auf Zone erstellen, um eine neue Zonen-ID zu erstellen.
Geben Sie den Namen der Zonen-ID ein und wählen Sie Android als Platform aus. wählen Sie den Anzeigentyp aus.
Konfigurieren Sie die Preise für die Zone, indem Sie entweder Pauschalpreis oder Optimiert von AppLovin. CPMs können für einzelne Länder die Option Pauschaler CPM aus. Klicken Sie anschließend auf Speichern.
Android
iOS
Nachdem die Zone erstellt wurde, finden Sie die Zonen-ID unter der Zonen-ID. Spalte.
Android
iOS
Testmodus aktivieren
Folgen Sie der Anleitung in der AppLovin- MAX-Testmodus zum Aktivieren von AppLovin-Testanzeigen.
Schritt 2: AppLovin-Nachfrage in 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.
AppLovin Corp. zur Liste der Werbepartner zur DSGVO und zu Bestimmungen von US-Bundesstaaten hinzufügen
Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um AppLovin Corp. in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.
Schritt 3: AppLovin SDK und Adapter importieren
Integration über pub.dev
Fügen Sie die folgende Abhängigkeit mit den neuesten Versionen des
AppLovin SDK und Adapter im
pubspec.yaml
-Datei:
dependencies:
gma_mediation_applovin: ^1.0.0
Manuelle Integration
Neueste Version des Google Mobile Ads Mediation-Plug-ins für herunterladen
AppLovin,
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_applovin:
path: path/to/local/package
Schritt 4: Datenschutzeinstellungen im AppLovin 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 automatisch an solche Werbenetzwerke übergeben wird.
AppLovin unterstützt das Lesen des Einwilligungsstrings aus gemeinsamen Einstellungen und Einstellungen Einwilligungsstatus entsprechend ändern.Wenn Sie
keine CMP verwendet, die den Einwilligungsstring in die gemeinsam genutzten
können Sie
.
GmaMediationApplovin.setHasUserConsent()
und
GmaMediationApplovin.setIsAgeRestrictedUser()
. Der folgende Beispielcode zeigt,
um Einwilligungsinformationen
an das AppLovin SDK zu senden. Diese Optionen müssen festgelegt werden
bevor Sie das Google Mobile Ads SDK initialisieren.
damit sie korrekt an das AppLovin SDK weitergeleitet werden.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
Siehe Datenschutzeinstellungen von AppLovin .
Datenschutzgesetze von US-Bundesstaaten
USA Datenschutzgesetze von Bundesstaaten müssen Sie 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 Bundesstaaten 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 AppLovin
enthält die
GmaMediationApplovin.setDoNotSell()
.
. Der folgende Beispielcode zeigt, wie Sie
Einwilligungsinformationen für das AppLovin SDK verwenden. Diese Optionen müssen festgelegt werden, bevor Sie
Google Mobile Anzeigen initialisieren
SDK
damit sie korrekt an das AppLovin SDK weitergeleitet werden.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
Siehe AppLovin-Datenschutz Dokumentation .
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die AppLovin-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
AppLovin-Dokumentation um der Info.plist-Datei Ihres Projekts die SKAdNetwork-IDs hinzuzufügen.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der AppLovin Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonAppLovinerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der AppLovin (Bidding) and AppLovin (Waterfall) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Optionale Schritte
Netzwerkspezifische Parameter
Der AppLovin-Adapter unterstützt die Übergabe eines AppLovinMediationExtras
-Objekts an die
Anzeigenanfrage, um netzwerkspezifische Parameter festzulegen. Der folgende Beispielcode zeigt
So deaktivieren Sie Audio in Videoanzeigen mithilfe des Parameters isMuted
:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
Optimierungen
Anruf wird hinzugefügt für
GmaMediationApplovin.initializeSdk('sdkKey')
zu Ihrer Einführungsaktivität
AppLovin ermöglicht das Tracking von Ereignissen beim Start der App
Fehlercodes
Wenn der Adapter keine Anzeige von AppLovin empfängt,
Publisher können den zugrunde liegenden Fehler der Anzeigenantwort mit
ResponseInfo
unter
folgenden Klassen:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
Hier sind die Codes und zugehörigen Nachrichten, die vom AppLovin-Adapter ausgegeben werden Wenn eine Anzeige nicht geladen werden kann:
Android
Fehlercode | Grund |
---|---|
-1.009 bis -1.204 | Das AppLovin SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie unter AppLovin-Dokumentation . |
101 | Die angeforderte Anzeigengröße stimmt nicht mit einer von AppLovin unterstützten Bannergröße überein. |
103 | Kontext ist null. |
104 | Das AppLovin-Gebotstoken ist leer. |
105 | Mehrere Anzeigen für dieselbe Zone angefordert. AppLovin kann pro Zone nur jeweils eine Anzeige laden. |
106 | Die Anzeige ist nicht bereit zur Auslieferung. |
108 | Der AppLovin-Adapter unterstützt das angeforderte Anzeigenformat nicht. |
iOS
Fehlercode | Grund |
---|---|
-1.009 bis -1.204 | Das AppLovin SDK hat einen Fehler zurückgegeben. Siehe AppLovin-Dokumentation . |
101 | Die angeforderte Anzeigengröße stimmt nicht mit einer von AppLovin unterstützten Bannergröße überein. |
102 | Die in der AdMob UI konfigurierten AppLovin-Serverparameter fehlen oder sind ungültig. |
103 | Die AppLovin-Anzeige konnte nicht ausgeliefert werden. |
104 | Mehrere Anzeigen für dieselbe Zone angefordert. AppLovin kann pro Zone nur jeweils eine Anzeige laden. |
105 | Der AppLovin SDK-Schlüssel wurde nicht gefunden. |
107 | Das Gebotstoken ist leer. |
108 | Der AppLovin-Adapter unterstützt das angeforderte Anzeigenformat nicht. |
110 | AppLovin hat einen erfolgreichen Lade-Callback gesendet, aber keine Anzeigen geladen. |
Änderungslog zum AppLovin Flutter Mediation Adapter
1.2.0
- Die Kompatibilität mit AppLovin Android-Adapterversion 12.6.1.0 wurde bestätigt.
- Die Kompatibilität mit AppLovin iOS Adapter Version 12.6.1.0 wurde bestätigt.
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.1.0.
1.1.0
- Die API für GmaMediationApplovin ist nicht mehr statisch.
- Die Kompatibilität mit AppLovin Android-Adapterversion 12.4.3.0 wurde bestätigt.
- Die Kompatibilität mit AppLovin iOS Adapter Version 12.4.2.0 wurde bestätigt.
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.1.0.
1.0.0
- Erste Version
- Die Kompatibilität mit AppLovin Android-Adapterversion 12.3.0.0 wurde bestätigt
- Die Kompatibilität mit AppLovin iOS Adapter Version 12.2.1.0 wurde bestätigt
- Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.0.0.