AppLovin in die Vermittlung einbinden

In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus AppLovin mithilfe der Vermittlung zu laden und einzublenden. Dabei werden sowohl Bidding als auch die Vermittlungsabfolge berücksichtigt. Hier erfahren Sie, wie Sie AppLovin zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und wie Sie das AppLovin SDK und den Adapter in eine Flutter App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter AdMob für AppLovin hat die folgenden Funktionen:

¹ Banneranzeigen (ausgenommen MREC-Banner) werden nur in der Vermittlung unterstützt. Bidding unterstützt keine Banneranzeigentypen.

Voraussetzungen

• Neuestes Google Mobile Ads SDK
• Flutter 3.7.0 oder höher
• So stellen Sie sie unter Android bereit:
  • Android API-Level 21 oder höher
• So stellen Sie sie unter iOS bereit:
  • iOS-Bereitstellungsziel von 12.0 oder höher
• Ein funktionierendes Flutter Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Erste Schritte.
• Schließen Sie die Vermittlung ab. Startleitfaden

Schritt 1: Konfigurationen in der AppLovin-UI einrichten

Registrieren Sie sich oder melden Sie sich in Ihrem AppLovin-Konto an.

Zum Einrichten eines Anzeigenblocks AdMob benötigen Sie den AppLovin SDK-Schlüssel und den Berichtsschlüssel. Sie finden sie unter AppLovin-UI > Account > Keys (Schlüssel).

Wenn Sie nur Bidding einbinden möchten, können Sie mit der Konfiguration der Vermittlungseinstellungen fortfahren.

App für die Vermittlung auswählen

Zone erstellen

Folgen Sie der Anleitung im MAX-Testmodus von AppLovin, um AppLovin-Testanzeigen zu aktivieren.

Schritt 2: AppLovin-Nachfrage in AdMob Benutzeroberfläche einrichten

Vermittlungseinstellungen für Anzeigenblöcke konfigurieren

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 desAppLovin SDK und des Adapters in die Datei pubspec.yaml des Pakets ein:

dependencies:
  gma_mediation_applovin: ^1.0.0

Manuelle Integration

Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für AppLovin herunter, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und seinen Inhalt) dem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml auf das Plug-in. Fügen Sie dazu die folgende Abhängigkeit hinzu:

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-Richtlinie zur Einwilligung der Nutzer in der EU müssen Sie dafür sorgen, dass Nutzer im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten erhalten und deren Einwilligungen eingeholt werden. Diese Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Wenn Sie die Einwilligung einholen, müssen Sie alle Werbenetzwerke in Ihrer Vermittlungskette angeben, die personenbezogene Daten erheben, empfangen oder verwenden können, und Informationen zur Nutzung der einzelnen Werbenetzwerke zur Verfügung stellen. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an solche Netzwerke zu übergeben.

Wenn Sie keine CMP verwenden, die den Einwilligungsstring in die gemeinsamen Einstellungen schreibt, können Sie die Methoden GmaMediationApplovin.setHasUserConsent() und GmaMediationApplovin.setIsAgeRestrictedUser() verwenden. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das AppLovin SDK übergeben werden. Diese Optionen müssen vor der Initialisierung des Google Mobile Ads SDK festgelegt werden, damit sie korrekt an das AppLovin SDK weitergeleitet werden.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

Weitere Informationen finden Sie in den Datenschutzeinstellungen von AppLovin.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten müssen Nutzern das Recht einräumen, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Bedingungen). Dazu muss auf der Startseite des „Verkäufers“ ein gut sichtbarer Link mit dem Text „Meine personenbezogenen Daten sollen nicht verkauft werden“ eingeblendet werden. Der Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten bietet die Möglichkeit, die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google zu aktivieren. Google kann diese Einstellung jedoch nicht auf die einzelnen Werbenetzwerke in Ihrer Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette identifizieren, das am Verkauf personenbezogener Daten beteiligt sein könnte, und die Richtlinien der einzelnen Werbenetzwerke befolgen, um die Compliance sicherzustellen.

Das Google Mobile Ads-Vermittlungs-Plug-in für AppLovin enthält die Methode GmaMediationApplovin.setDoNotSell() . Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das AppLovin SDK übergeben werden. 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.setDoNotSell(true);

Weitere Informationen finden Sie in der AppLovin-Datenschutzdokumentation.

Schritt 5: Erforderlichen Code hinzufü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. Im folgenden Beispielcode sehen Sie, wie Audio in Videoanzeigen mithilfe des Parameters isMuted deaktiviert wird:

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

Optimierungen

Wenn du deiner Startaktivität einen Aufruf an GmaMediationApplovin.initializeSdk('sdkKey') hinzufügst, kann AppLovin Ereignisse erfassen, sobald die App gestartet wird.

Fehlercodes

Wenn der Adapter keine Anzeige von AppLovin empfängt, können Publisher den zugrunde liegenden Fehler der Anzeigenantwort mit ResponseInfo in den folgenden Klassen prüfen:

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Änderungslog zum AppLovin Flutter Mediation Adapter

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.