AppLovin in die Vermittlung einbinden

Plattform auswählen: Android iOS Unity Flutter Android (Legacy)

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

Unterstützte Integrationen und Anzeigenformate

Der Ad Manager-Vermittlungsadapter für AppLovin bietet die folgenden Funktionen:

Integration
Gebote
Vermittlungsabfolge
Formate
App öffnen  1
Banner  2
Interstitial
Verfügbar

1 Die Integration der Vermittlungsabfolge befindet sich in der geschlossenen Betaphase.

 Bei der Vermittlungsabfolge werden nur die Bannergrößen 320 × 50 und 728 × 90 unterstützt. Banneranzeigen werden bei Geboten nicht unterstützt.

Vorbereitung

Prüfen Sie Folgendes, bevor Sie fortfahren:

  • Die aktuelle Version von Google Mobile Ads Unity Plugin.
  • Unity Editor-Version 5.6 oder höher.
  • [Für Bidding]: Wenn Sie alle unterstützten Anzeigenformate in Bidding einbinden möchten, verwenden Sie das Google Mobile Ads-Vermittlungs-Plug-in für AppLovin 4.2.0 oder höher (aktuelle Version empfohlen).
  • Für die Bereitstellung auf Android-Geräten
    • Android API-Level 24 oder höher
  • Für die Bereitstellung auf iOS-Geräten:
    • Das iOS-Bereitstellungsziel muss 13.0 oder höher sein.
  • Ein funktionierendes Unity-Projekt, das mit Google Mobile Ads Unity Plugin konfiguriert ist. Weitere Informationen finden Sie unter Google Mobile Ads Unity Plugin einrichten.
  • Richten Sie die Vermittlung ein.

    • Schritt 1: Konfigurationen in der AppLovin-Benutzeroberfläche einrichten

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

    Zum Einrichten des Ad Manager-Anzeigenblocks benötigen Sie den SDK-Schlüssel und den Berichtsschlüssel von AppLovin. Sie finden sie in der AppLovin-Benutzeroberfläche > Konto > Schlüssel.

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

    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 im Bereich Monetization (Monetarisierung) die Option Applications (Anwendungen) aus, um zu Ihren registrierten Apps zu gelangen. Wählen Sie die App aus, die Sie mit der Vermittlung verwenden möchten.

    Zone erstellen

    Gebote

    Dieser Schritt ist für Bidding-Integrationen nicht erforderlich.

    Wasserfall

    Wählen Sie in der AppLovin-Benutzeroberfläche im Bereich Monetization (Monetarisierung) die Option Zones (Zonen) aus, um Ihre registrierten Zonen-IDs aufzurufen. Wenn Sie die erforderlichen Zonen für Ihre App bereits erstellt haben, 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, wählen Sie Android als Plattform aus und wählen Sie den Anzeigentyp aus.

    Konfigurieren Sie Pricing (Preisgestaltung) für die Zone, indem Sie entweder Flat CPM (Fester CPM) oder Optimized by AppLovin (Von AppLovin optimiert) auswählen. CPMs können für die Option Pauschaler CPM länderspezifisch konfiguriert werden. Klicken Sie anschließend auf Speichern.

    Android

    iOS

    Nachdem die Zone erstellt wurde, finden Sie die Zonen-ID in der Spalte Zonen-ID.

    Android

    iOS

    app-ads.txt-Datei aktualisieren

    Authorized Sellers for Apps (app-ads.txt) ist eine Initiative des IAB Tech Lab, die dafür sorgt, dass Ihr App-Anzeigeninventar nur über Kanäle verkauft wird, die Sie autorisiert haben. Um einen erheblichen Rückgang des Anzeigenumsatzes zu vermeiden, müssen Sie eine app-ads.txt-Datei implementieren. Falls noch nicht geschehen, erstellen Sie eine app-ads.txt-Datei für Ad Manager.

    Wenn Sie app-ads.txt für AppLovin implementieren möchten, fügen Sie AppLovin Ihrer app-ads.txt-Datei hinzu.

    Testmodus aktivieren

    Folgen Sie der Anleitung im MAX Test Mode-Leitfaden von AppLovin, um AppLovin-Testanzeigen zu aktivieren.

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

    Vermittlungseinstellungen für den Anzeigenblock konfigurieren

    Android

    Eine Anleitung dazu finden Sie unter Schritt 2 im Android.

    iOS

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

    AppLovin Corp. der Liste der Werbepartner für die DSGVO und die Datenschutzbestimmungen der US-Bundesstaaten hinzufügen

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

    Schritt 3: AppLovin SDK und Adapter importieren

    OpenUPM-CLI

    Wenn Sie OpenUPM-CLI installiert haben, können Sie das Google Mobile Ads AppLovin-Vermittlungs-Plug-in für Unity in Ihrem Projekt installieren. Führen Sie dazu den folgenden Befehl im Stammverzeichnis Ihres Projekts aus:

    openupm add com.google.ads.mobile.mediation.applovin

    OpenUPM

    Wählen Sie im Unity-Projekt-Editor Bearbeiten > Projekteinstellungen > Paketmanager aus, um die Einstellungen für den Unity-Paketmanager zu öffnen.

    Fügen Sie auf dem Tab Scoped Registries OpenUPM als bereichsbezogene Registry mit den folgenden Details hinzu:

    • Name: OpenUPM
    • URL: https://package.openupm.com
    • Bereich(e): com.google

    OpenUPM-Details

    Gehen Sie dann zu Window > Package Manager, um den Unity Package Manager zu öffnen, und wählen Sie im Drop-down-Menü My Registries aus.

    Unity-Registries

    Wählen Sie das Paket Google Mobile Ads Applovin Mediation aus und klicken Sie auf Installieren.

    Über OpenUPM installieren

    Unity-Paket

    Laden Sie die aktuelle Version des Google Mobile Ads-Vermittlungs-Plug-ins für AppLovin über den Downloadlink im Changelog herunter und extrahieren Sie die GoogleMobileAdsApplovinMediation.unitypackage aus der ZIP-Datei.

    Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package aus und suchen Sie die heruntergeladene GoogleMobileAdsApplovinMediation.unitypackage-Datei. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

    Aus Unity importieren

    Wählen Sie dann Assets > External Dependency Manager > Android Resolver > Force Resolve aus. Die Bibliothek „External Dependency Manager“ führt die Abhängigkeitsauflösung von Grund auf durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android Ihrer Unity-Anwendung.

    Lösung erzwingen

    Schritt 4: Datenschutzeinstellungen im AppLovin SDK implementieren

    Damit Sie die Google-Richtlinie zur Einwilligung der Nutzer in der EU einhalten, 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 Speicherverfahren einholen, sofern dies gesetzlich vorgeschrieben ist, sowie zur Erhebung, Weitergabe und Verwendung personenbezogener Daten zur Personalisierung von Anzeigen. Die Richtlinie entspricht den Anforderungen der EU-Datenschutzrichtlinie für elektronische Kommunikation und der EU-Datenschutz-Grundverordnung (DSGVO). Sie sind dafür verantwortlich, dass die Einwilligung an jede Anzeigenquelle in Ihrer Vermittlungskette weitergegeben wird.

    Ab Version 7.0.0 des AppLovin Unity-Adapters wird die Weitergabe von DSGVO-Einwilligungssignalen vom UMP SDK und von Plattformen zur Einwilligungsverwaltung unterstützt, die in die Spezifikation für zusätzliche Einwilligung von Google eingebunden sind.

    Weitere Informationen finden Sie in den Datenschutzeinstellungen von AppLovin.

    Minderjährige Nutzer deklarieren

    AppLovin unterstützt die Initialisierung des AppLovin SDK in Verbindung mit einem Kind nicht. Weitere Informationen finden Sie in der AppLovin-Dokumentation zum Thema „Prohibition on Children Data or Using the Services for Children or Apps Exclusively Targeted to Children“ (Verbot von Kinderdaten oder der Nutzung der Dienste für Kinder oder Apps, die ausschließlich auf Kinder ausgerichtet sind) für Android oder iOS.

    Mit dem Google Mobile Ads Unity-Plug-in für die Vermittlung für AppLovin (Version 11.3.0 oder höher) wird die Vermittlung für AppLovin automatisch für Apps deaktiviert, in denen ein minderjähriger Nutzer mit einer der folgenden Einstellungen deklariert wird:

    Datenschutzgesetze von US-Bundesstaaten

    Gemäß den Datenschutzgesetzen von US-Bundesstaaten muss Nutzern das Recht eingeräumt werden, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition der Begriffe „sale“ und „personal information“). Dazu muss auf der Website des „Verkäufers“ (selling party) ein gut sichtbarer Link mit dem Text „Do Not Sell My Personal Information“ (Meine personenbezogenen Daten dürfen nicht verkauft werden) vorhanden sein. Im Leitfaden zur Einhaltung der Datenschutzgesetze von US-Bundesstaaten wird beschrieben, wie Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung 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 könnte, und die Richtlinien der einzelnen Netzwerke befolgen, um die Einhaltung der Bestimmungen zu gewährleisten.

    Das Google Mobile Ads-Vermittlungs-Plug-in für AppLovin Version 6.3.1 enthält die Methode AppLovin.SetDoNotSell(). Im folgenden Beispielcode wird gezeigt, wie Sie Einwilligungsinformationen an das AppLovin SDK übergeben. Diese Optionen müssen festgelegt werden, bevor Sie das Google Mobile Ads SDK initialisieren, damit sie ordnungsgemäß an das AppLovin SDK weitergeleitet werden.

    using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

    Weitere Informationen finden Sie in der Datenschutzdokumentation von AppLovin.

    Schritt 5: Erforderlichen Code hinzufügen

    Android

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

    iOS

    SKAdNetwork-Integration

    Folgen Sie der Dokumentation von AppLovin, um die SKAdNetwork-IDs der Info.plist-Datei 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 AppLovin-Benutzeroberfläche.

    Testanzeigen überprüfen

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

    Optionale Schritte

    Optimierungen

    Wenn Sie Ihrer Startaktivität einen Aufruf von AppLovin.Initialize() hinzufügen, 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 aus der Anzeigenantwort mit ResponseInfo unter den folgenden Klassen prüfen:

    Android

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

    iOS

    GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

    Android

    Fehlercode Grund
    -1009 bis -1, 204 Das AppLovin SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von AppLovin.
    101 Die angeforderte Anzeigengröße entspricht keiner von AppLovin unterstützten Bannergröße.
    103 Kontext ist null.
    104 Das AppLovin-Gebots-Token ist leer.
    105 Es wurden mehrere Anzeigen für dieselbe Zone angefordert. AppLovin kann pro Zone nur eine Anzeige gleichzeitig laden.
    106 Die Anzeige ist noch nicht bereit für die Auslieferung.
    108 Der AppLovin-Adapter unterstützt das angeforderte Anzeigenformat nicht.
    109 Der Kontext ist keine Activity-Instanz.
    110 SDK-Schlüssel fehlt.
    112 Der Nutzer ist ein Kind.
    113 Die Anzeigenblock-ID fehlt.

    iOS

    Fehlercode Grund
    -1009 bis -1, 204 Das AppLovin SDK hat einen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation von AppLovin.
    101 Die angeforderte Anzeigengröße entspricht keiner von AppLovin unterstützten Bannergröße.
    102 Die in der Ad Manager-Benutzeroberfläche konfigurierten AppLovin-Serverparameter fehlen oder sind ungültig.
    103 AppLovin-Anzeige konnte nicht ausgeliefert werden.
    104 Es wurden mehrere Anzeigen für dieselbe Zone angefordert. AppLovin kann pro Zone jeweils nur eine Anzeige laden.
    105 AppLovin SDK-Schlüssel nicht gefunden.
    107 Das Gebots-Token ist leer.
    108 Der AppLovin-Adapter unterstützt das angeforderte Anzeigenformat nicht.
    110 AppLovin hat einen erfolgreichen Load-Callback gesendet, aber keine Anzeigen geladen.
    111 Die Instanz des AppLovin SDK kann nicht abgerufen werden.
    112 Der Nutzer ist ein Kind.
    113 Die freigegebene Instanz des AppLovin SDK wurde nicht initialisiert.
    114 Das AppLovin SDK gibt kein Gebotstoken zurück.
    115 Anzeigenblock-ID fehlt. Anzeige kann nicht geladen werden.
    116 Die Anzeige ist noch nicht bereit. Die Anzeige kann nicht ausgeliefert werden.

    Änderungsprotokoll für das AppLovin Unity Mediation-Plug-in

    Version 8.7.7

    Version 8.7.6

    Version 8.7.5

    Version 8.7.4

    Version 8.7.3

    Version 8.7.2

    Version 8.7.1

    Version 8.7.0

    Version 8.6.0

    Version 8.5.2

    Version 8.5.1

    Version 8.5.0

    Version 8.4.1

    Version 8.4.0

    Version 8.3.2

    Version 8.3.1

    Version 8.3.0

    Version 8.2.1

    Version 8.2.0

    Version 8.1.1

    Version 8.1.0

    Version 8.0.4

    Version 8.0.3

    Version 8.0.2

    Version 7.4.1

    Version 7.4.0

    Version 7.3.1

    Version 7.3.0

    Version 7.2.2

    Version 7.2.1

    Version 7.2.0

    Version 7.1.0

    Version 7.0.1

    Version 7.0.0

    Version 6.9.1

    Version 6.9.0

    Version 6.8.0

    Version 6.7.0

    Version 6.6.0

    Version 6.5.1

    Version 6.5.0

    Version 6.4.3

    Version 6.4.2

    Version 6.4.1

    Version 6.4.0

    Version 6.3.1

    Version 6.3.0

    Version 6.2.1

    Version 6.2.0

    Version 6.1.0

    Version 6.0.0

    Version 5.1.3

    Version 5.1.2

    Version 5.1.1

    Version 5.1.0

    Version 5.0.0

    Version 4.8.1

    Version 4.8.0

    Version 4.7.0

    Version 4.6.2

    Version 4.6.1

    Version 4.6.0

    Version 4.5.8

    Version 4.5.7

    Version 4.5.6

    Version 4.5.5

    Version 4.5.4

    Version 4.5.3

    Version 4.5.2

    Version 4.5.1

    Version 4.5.0

    Version 4.4.1

    Version 4.4.0

    Version 4.3.0

    Version 4.2.0

    • Unterstützt die AppLovin Android-Adapterversion 9.4.2.0.
    • Unterstützt die AppLovin iOS-Adapterversion 6.6.1.0.

    Version 4.1.0

    • Das Plug-in wurde aktualisiert, um die neue offene Betaversion der API für Anzeigen mit Prämie zu unterstützen.
    • Unterstützt AppLovin-Android-Adapterversion 9.2.1.1.
    • Unterstützt die AppLovin iOS-Adapterversion 6.3.0.0

    Version 4.0.0

    • Unterstützt die AppLovin Android-Adapterversion 9.2.1.0.
    • Unterstützt die AppLovin iOS-Adapterversion 6.2.0.0.

    Version 3.1.2

    • Unterstützt die AppLovin-Android-Adapterversion 8.1.4.0.
    • Unterstützt die AppLovin iOS-Adapterversion 5.1.2.0.

    Version 3.1.1

    • Unterstützt die AppLovin Android-Adapterversion 8.1.0.0.
    • Unterstützt die AppLovin iOS-Adapterversion 5.1.1.0.

    Version 3.1.0

    • Unterstützt die AppLovin Android-Adapterversion 8.1.0.0.
    • Unterstützt die AppLovin iOS-Adapterversion 5.1.0.0.

    Version 3.0.3

    • Unterstützt die Version 8.0.2.1 des Android-Adapters von AppLovin.
    • Unterstützt die AppLovin iOS-Adapterversion 5.0.2.0.

    Version 3.0.2

    • Unterstützt die AppLovin Android SDK-Version 8.0.1.
    • Unterstützt AppLovin iOS SDK Version 5.0.1.

    Version 3.0.1

    • Unterstützt die AppLovin Android SDK-Version 8.0.0.
    • Unterstützt AppLovin iOS SDK Version 5.0.1.
    • Die Methode AppLovin.SetIsAgeRestrictedUser() wurde hinzugefügt, um anzugeben, ob der Nutzer einer Kategorie mit Altersbeschränkung angehört.

    Version 3.0.0

    • Unterstützt die AppLovin Android SDK-Version 8.0.0.
    • Unterstützt AppLovin iOS SDK-Version 5.0.1.
    • Die Methode AppLovin.SetHasUserConsent() wurde hinzugefügt, um das Flag für die Nutzereinwilligung an das AppLovin SDK weiterzuleiten.

    Version 2.0.0

    • Unterstützt die AppLovin Android SDK-Version 7.8.6.
    • Unterstützt AppLovin iOS SDK Version 5.0.1.

    Version 1.2.1

    • Unterstützt die AppLovin Android SDK-Version 7.8.6.
    • Unterstützt AppLovin iOS SDK-Version 4.8.3.

    Version 1.2.0

    • Unterstützt die AppLovin Android SDK-Version 7.8.5.
    • Unterstützt AppLovin iOS SDK-Version 4.8.3.

    Version 1.1.0

    • Unterstützt die AppLovin Android SDK-Version 7.7.0.
    • Unterstützt AppLovin iOS SDK-Version 4.7.0.

    Version 1.0.0

    • Erster Release!
    • Unterstützt AppLovin Android SDK Version 7.4.1.
    • Unterstützt AppLovin iOS SDK-Version 4.4.1.