AppLovin in die Vermittlung einbinden

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

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.