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 abfolgebasierte Integrationen berücksichtigt. Sie erfahren, 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 AdMob -Vermittlungsadapter für AppLovin hat folgende Funktionen:

Integration
Gebote
Wasserfall
Formate
Banner  1
Interstitial
Verfügbar

Banneranzeigen (ohne MREC-Banner) werden nur bei der Vermittlung unterstützt. Bidding unterstützt keine Banneranzeigen.

Voraussetzungen

  • Das aktuelle Google Mobile Ads SDK
  • Unity 5.6 oder höher
  • [Für Gebote]: Vermittlungs-Plug-in für Google Mobile Ads für AppLovin 4.2.0 oder höher (aktuelle Version empfohlen)
  • Für die Bereitstellung unter Android
    • Android API-Level 21 oder höher
  • Für die Bereitstellung unter iOS
    • iOS-Bereitstellungsziel 12.0 oder höher
  • Ein funktionierendes Unity Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Erste Schritte.
  • Arbeiten Sie den Startleitfaden zur Vermittlung ab.

Schritt 1: Konfigurationen in der AppLovin-Benutzeroberfläche 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

Gebote

Dieser Schritt ist für die Verknüpfung von Geboten nicht erforderlich.

Wasserfall

Wählen Sie auf der AppLovin-Benutzeroberfläche im Abschnitt Monetarisierung die Option Anwendungen aus, um zu Ihren registrierten Apps zu gelangen. Wählen Sie in der Liste der verfügbaren Apps die App aus, die Sie mit der Vermittlung verwenden möchten.

Zone erstellen

Gebote

Dieser Schritt ist für die Verknüpfung von Geboten nicht erforderlich.

Wasserfall

Wählen Sie auf der AppLovin-Benutzeroberfläche im Abschnitt Monetarisierung die Option Zonen aus, um Ihre registrierten Zonen-IDs aufzurufen. Wenn Sie die erforderlichen Zonen für Ihre Anwendung 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 als Plattform Android aus und wählen Sie dann den Anzeigentyp aus.

Konfigurieren Sie die Preise für die Zone, indem Sie entweder Pauschaler CPM oder Von AppLovin optimiert auswählen. CPMs können für die Option Pauschalpreis pro Land konfiguriert werden. Klicken Sie anschließend auf Speichern.

Android

iOS

Nachdem die Zone erstellt wurde, wird die Zonen-ID in der Spalte Zonen-ID angezeigt.

Android

iOS

Testmodus aktivieren

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

Schritt 2: AppLovin-Nachfrage auf 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.

AppLovin Corp. der Liste der Werbepartner gemäß DSGVO und 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

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

Wählen Sie im Unity-Projekteditor Assets > Paket importieren > Benutzerdefiniertes Paket aus und suchen Sie nach der heruntergeladenen Datei GoogleMobileAdsAppLovinMediation.unitypackage. Prüfen Sie, ob alle Dateien ausgewählt sind, und klicken Sie auf Importieren.

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

Schritt 4: Datenschutzeinstellungen im AppLovin SDK implementieren

Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie dafür sorgen, dass Nutzern im Europäischen Wirtschaftsraum (EWR) bestimmte Informationen zur Verwendung von Gerätekennungen und personenbezogenen Daten offengelegt und deren Einwilligung von diesen eingeholt wird. Die 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 jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das personenbezogene Daten erheben, empfangen oder nutzen kann, und Informationen zur Nutzung der einzelnen Werbenetzwerke angeben. Google ist derzeit nicht in der Lage, die Einwilligungsentscheidung des Nutzers automatisch an diese Netzwerke weiterzugeben.

Seit Version 7.0.0 des Vermittlungs-Plug-ins für mobile Anzeigen kann AppLovin den Einwilligungsstring aus den gemeinsamen Einstellungen lesen und den Einwilligungsstatus entsprechend festlegen.

Wenn Sie kein Google Mobile Ads Vermittlungs-Plug-in für Applovin Version 7.0.0 oder höher verwenden oder keine CMP verwenden, die den Einwilligungsstring in die gemeinsamen Präferenzen schreibt, können Sie die Methoden AppLovin.SetHasUserConsent(), AppLovin.SetIsAgeRestrictedUser() verwenden. Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das AppLovin SDK übergeben werden. Diese Optionen müssen vor dem Initialisieren des Google Mobile Ads SDK festgelegt werden, damit sie ordnungsgemäß an das AppLovin SDK weitergeleitet werden.

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

AppLovin.SetHasUserConsent(true);

Wenn der Nutzer bekanntermaßen einer Kategorie mit Altersbeschränkung angehört, kannst du außerdem das Flag unten auf true setzen.

AppLovin.SetIsAgeRestrictedUser(true);

Weitere Informationen finden Sie in den Datenschutzeinstellungen von AppLovin.

Datenschutzgesetze von US-Bundesstaaten

Datenschutzgesetze von US-Bundesstaaten schreiben Nutzern das Recht, dem „Verkauf“ ihrer „personenbezogenen Daten“ zu widersprechen (laut gesetzlicher Definition dieser Begriffe). Dazu muss auf der Startseite des „Verkäufers“ ein deutlich 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 können Sie die eingeschränkte Datenverarbeitung für die Anzeigenbereitstellung durch Google aktivieren. Google kann diese Einstellung jedoch nicht auf jedes Werbenetzwerk in der Vermittlungskette anwenden. Daher müssen Sie jedes Werbenetzwerk in Ihrer Vermittlungskette angeben, das möglicherweise am Verkauf personenbezogener Daten beteiligt ist, und die Anleitungen der einzelnen Werbenetzwerke befolgen, um die Compliance sicherzustellen.

Das Google Mobile Ads Mediation-Plug-in für AppLovin Version 6.3.1 enthält die AppLovin.SetDoNotSell() method-2-6"> Der folgende Beispielcode zeigt, wie Einwilligungsinformationen an das AppLovin SDK übergeben werden. Diese Optionen müssen vor dem Initialisieren des Google Mobile Ads SDK festgelegt werden, damit sie korrekt 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 zu AppLovin, um die SKAdNetwork-IDs in die Info.plist-Datei Ihres Projekts einzufü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

Optimierungen

Wenn Sie einen Aufruf zu AppLovin.Initialize() zu Ihrer Einführungsaktivität hinzufügen, kann AppLovin Ereignisse direkt beim Start der App erfassen.

Fehlercodes

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

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Im Folgenden sind die Codes und Begleitmeldungen aufgeführt, 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 in der Dokumentation zu AppLovin.
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 jeweils nur eine Anzeige pro Zone laden.
106 Die Anzeige ist nicht zur Auslieferung bereit.
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. Weitere Informationen finden Sie in der Dokumentation zu AppLovin.
101 Die angeforderte Anzeigengröße stimmt nicht mit einer von AppLovin unterstützten Bannergröße überein.
102 Die in der AdMob Benutzeroberfläche konfigurierten AppLovin-Serverparameter fehlen oder sind ungültig.
103 Die AppLovin-Anzeige konnte nicht eingeblendet werden.
104 Mehrere Anzeigen für dieselbe Zone angefordert. AppLovin kann jeweils nur eine Anzeige pro Zone 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 Callback für einen erfolgreichen Ladevorgang gesendet, aber keine Anzeigen geladen.

Änderungsprotokoll des AppLovin Unity Mediation-Plug-ins

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 AppLovin Android-Adapterversion 9.4.2.0.
  • Unterstützt AppLovin iOS-Adapterversion 6.6.1.0.

Version 4.1.0

  • Das Plug-in wurde aktualisiert, um die neue offene Beta Reward API zu unterstützen.
  • Unterstützt AppLovin Android-Adapterversion 9.2.1.1.
  • Unterstützt AppLovin iOS-Adapterversion 6.3.0.0.

Version 4.0.0

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

Version 3.1.2

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

Version 3.1.1

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

Version 3.1.0

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

Version 3.0.3

  • Unterstützt AppLovin Android-Adapterversion 8.0.2.1.
  • Unterstützt AppLovin iOS-Adapterversion 5.0.2.0.

Version 3.0.2

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

Version 3.0.1

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

Version 3.0.0

  • Unterstützt AppLovin Android SDK Version 8.0.0.
  • Unterstützt AppLovin iOS SDK Version 5.0.1.
  • Die Methode AppLovin.SetHasUserConsent() zum Weiterleiten des Flags zur Nutzereinwilligung an das AppLovin SDK wurde hinzugefügt.

Version 2.0.0

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

Version 1.2.1

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

Version 1.2.0

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

Version 1.1.0

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

Version 1.0.0

  • Erste Version!
  • Unterstützt AppLovin Android SDK Version 7.4.1.
  • Unterstützt Version 4.4.1 des AppLovin iOS SDK.