In diesem Leitfaden erfahren Sie, wie Sie das Google Mobile Ads SDK verwenden, um Anzeigen aus dem Meta Audience Network mithilfe der Vermittlung zu laden und einzublenden. Es wird auch auf die Integration von Geboten eingegangen. Sie erfahren, wie Sie das Meta Audience Network zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Meta Audience Network und den Adapter in eine Unity App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter AdMob für das Meta Audience Network bietet folgende Funktionen:
Integration | |
---|---|
Gebote | |
Wasserfall 1 | |
Formate | |
Banner | |
Interstitial | |
Verfügbar | |
Interstitial mit Prämie |
1 Meta Audience Network wurde 2021 auf nur Gebote umgestellt.
Voraussetzungen
- Neuestes Google Mobile Ads SDK
- Unity 5.6 oder höher
- Google Mobile Ads-Vermittlungs-Plug-in für Meta Audience Network 2.11.0 (aktuelle Version empfohlen)
- So stellen Sie sie unter Android bereit:
- Android API-Level 21 oder höher
- So stellen Sie sie unter iOS bereit:
- iOS-Bereitstellungsziel von 10.0 oder höher
- Für das neueste Meta Audience Network SDK ist normalerweise die neueste Version von Xcode erforderlich.
- Ein funktionierendes Unity Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Erste Schritte.
- Schließen Sie den Startleitfaden für die Vermittlung ab.
Schritt 1: Konfigurationen in der Meta Audience Network-Benutzeroberfläche einrichten
Sign up and log in to the Business Manager Start page.
Click Get started then Create new account.
Fill out the required fields with your business details and click Next.
Create a property
After you've filled out the required information, you're prompted to create a property for your app. Enter the desired name of the property for your app and click Next.
Next, select your platform to monetize.
Add your app details and click Next.
Android
iOS
Set up your payment account by clicking Add a new payment account. You will be redirected to a new page to enter your payment information. Fill out the necessary details, then click Next.
Select Google AdMob as the Mediation platform, then click Create placement.
Select a format, fill out the form and click Create.
Take note of the Placement ID.
Click Done.
Turn on test mode
See the Testing Audience Network Implementation guide for detailed instructions on how to enable Meta Audience Network test ads.
Schritt 2: Meta Audience Network-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.
Zur Liste der Werbepartner zur DSGVO und zu Verordnungen von US-Bundesstaaten hinzufügen Facebook
Folgen Sie den Schritten unter DSGVO-Einstellungen und Einstellungen zu Bestimmungen von US-Bundesstaaten um Facebook in die Liste der Werbepartner gemäß DSGVO und US-Bundesstaaten auf der AdMob Benutzeroberfläche aufzunehmen.
Schritt 3: Meta Audience Network SDK und Adapter importieren
Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für Meta Audience Network über den Downloadlink im Änderungsprotokoll herunter und extrahieren Sie die GoogleMobileAdsFacebookMediation.unitypackage
aus der ZIP-Datei.
Wählen Sie im Unity-Projekteditor Assets > Import Package > Custom Package (Assets > Paket importieren > Benutzerdefiniertes Paket) und suchen Sie die heruntergeladene Datei GoogleMobileAdsFacebookMediation.unitypackage
. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.
Wähle Assets > Play-Dienste-Resolver > Android-Resolver > Erzwingung erzwingen.
Die Unity Play Services-Resolver-Bibliothek führt dann eine Abhängigkeitsauflösung durch und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android
Ihrer Unity-App.
Schritt 4: Datenschutzeinstellungen im Meta Audience Network 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.
In den Hinweisen von Meta finden Sie Informationen zur DSGVO und zu Meta-Werbung.
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.
Informationen für Nutzer in Kalifornien finden Sie unter Datenverarbeitungsoptionen von Meta.
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die Integration des Meta Audience Network ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation zu Meta Audience Network, um die SKAdNetwork-IDs zur Info.plist
-Datei Ihres Projekts hinzuzufügen.
Werbe-Tracking aktiviert
Wenn Sie Apps für iOS 14 oder höher entwickeln, lesen Sie in der Anleitung von Meta Audience Network nach, wie das Werbe-Tracking-Flag festgelegt wird.
Schritt 6: Implementierung testen
Testanzeigen aktivieren
Registrieren Sie Ihr Testgerät für AdMob und aktivieren Sie den Testmodus in der Meta Audience Network Benutzeroberfläche.
Testanzeigen überprüfen
Wenn Sie prüfen möchten, ob Sie Testanzeigen vonMeta Audience Networkerhalten, aktivieren Sie im Anzeigenprüftool mithilfe der Meta Audience Network (Bidding) Anzeigenquellen den Test für eine einzelne Anzeigenquelle.
Optionale Schritte
Caching unter Android 9
Android
Ab Android 9 (API-Level 28) ist die Klartextunterstützung standardmäßig deaktiviert. Dies wirkt sich auf die Funktionalität des Medien-Cachings des Meta Audience Network SDK sowie auf die Nutzerfreundlichkeit und die Werbeeinnahmen aus. Folgen Sie der Meta-Dokumentation, um die Netzwerksicherheitskonfiguration in Ihrer Anwendung zu aktualisieren.
iOS
Gilt nicht für iOS-Integrationen.
Fehlercodes
Wenn der Adapter keine Anzeige vom Zielgruppennetzwerk empfängt, können Sie mit ResponseInfo
in den folgenden Klassen den zugrunde liegenden Fehler aus der Anzeigenantwort prüfen:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Hier sind die Codes und zugehörigen Nachrichten, die vom Meta Audience Network-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann:
Android
Fehlercode | Grund |
---|---|
101 | Ungültige Serverparameter (z.B. fehlende Placement-ID). |
102 | Die angeforderte Anzeigengröße stimmt nicht mit einer vom Meta Audience Network unterstützten Bannergröße überein. |
103 | Der Publisher muss Anzeigen mit dem Kontext Activity anfordern. |
104 | Das Meta Audience Network SDK konnte nicht initialisiert werden. |
105 | Der Publisher hat keine einheitlichen nativen Anzeigen angefordert. |
106 | Die geladene native Anzeige ist ein anderes Objekt als das erwartete. |
107 | Das verwendete Context -Objekt ist ungültig. |
108 | In der geladenen Anzeige fehlen die erforderlichen Assets für native Anzeigen. |
109 | Es konnte keine native Anzeige aus der Gebotsnutzlast erstellt werden. |
110 | Das Meta Audience Network SDK konnte die Interstitial-Anzeige/Anzeige mit Prämie nicht präsentieren. |
111 | Beim Erstellen eines Meta Audience Network-AdView -Objekts wird eine Ausnahme ausgelöst. |
1000-9999 | Das Meta Audience Network hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zu Meta Audience Network. |
iOS
Fehlercode | Grund |
---|---|
101 | Ungültige Serverparameter (z.B. fehlende Placement-ID). |
102 | Die angeforderte Anzeigengröße stimmt nicht mit einer vom Meta Audience Network unterstützten Bannergröße überein. |
103 | Das Meta Audience Network-Anzeigenobjekt konnte nicht initialisiert werden. |
104 | Das Meta Audience Network SDK konnte die Interstitial-Anzeige/Anzeige mit Prämie nicht präsentieren. |
105 | Root View Controller der Banneranzeige ist nil . |
106 | Das Meta Audience Network SDK konnte nicht initialisiert werden. |
1000-9999 | Das Meta Audience Network hat einen SDK-spezifischen Fehler zurückgegeben. Weitere Informationen finden Sie in der Dokumentation zu Meta Audience Network. |
Änderungsprotokoll für Meta Audience Network Unity Mediation-Plug-in
Version 3.12.1
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.17.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.15.1.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.1.0 erstellt und getestet.
Version 3.12.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.17.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.15.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 9.0.0 erstellt und getestet.
Version 3.11.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.15.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.14.0.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 8.5.1.
Version 3.10.0
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/MetaAudienceNetwork/
verschoben. - Unterstützt die Meta Audience Network-Android-Adapterversion 6.14.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.12.0.1.
- Mit dem Google Mobile Ads Unity Plugin Version 8.1.0 erstellt und getestet.
Version 3.9.1
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.12.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.12.0.1.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.4.1.
Version 3.9.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.12.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.12.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.3.0 erstellt und getestet.
Version 3.8.0
- Der Name des Unity-Vermittlungs-Plug-ins wurde in „Meta Audience Network“ umbenannt.
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.11.0.1.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.11.1.0.
- Erstellt und getestet mit dem Google Mobile Ads Unity Plugin Version 7.0.2.
Version 3.7.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.10.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.10.0.0.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.6.1
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.8.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.9.0.1.
- Mit dem Google Mobile Ads Unity Plugin Version 7.0.0 erstellt und getestet.
Version 3.6.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.8.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.8.0.0.
Version 3.5.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.7.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.7.0.0.
Version 3.4.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.6.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.6.0.0.
Version 3.3.2
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.5.1.1.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.5.1.0.
Version 3.3.1
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.5.1.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.5.1.0.
Version 3.3.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.4.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.4.1.0.
Version 3.2.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.2.0.1.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.2.1.0.
Version 3.1.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.2.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.2.0.0.
Version 3.0.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 6.1.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 6.0.0.0.
Version 2.12.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.11.0.0.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.10.1.0.
Version 2.11.1
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.10.1.0.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.10.1.0.
Version 2.11.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.10.0.0.
- Unterstützt den Meta Audience Network-iOS-Adapter in der Version 5.10.0.0.
Version 2.10.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.9.1.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 5.9.0.1.
Version 2.9.2
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.9.0.2.
- Unterstützt die Meta Audience Network iOS-Adapterversion 5.9.0.1.
Version 2.9.1
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.9.0.1.
- Unterstützt die Meta Audience Network iOS-Adapterversion 5.9.0.1.
Version 2.9.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.9.0.0.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.9.0.0.
Version 2.8.1
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.8.0.1.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.8.0.2.
Version 2.8.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.8.0.0.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.8.0.1.
Version 2.7.1 (veraltet, verwenden Sie 2.8.0 oder höher)
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.7.1.0.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.7.1.1.
Version 2.7.0 (veraltet, verwenden Sie 2.8.0 oder höher)
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.7.0.0.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.7.0.0.
Version 2.6.1 (veraltet, verwenden Sie 2.8.0 oder höher)
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.6.1.0.
- Unterstützt den Meta Audience Network iOS-Adapter in der Version 5.6.1.0.
Version 2.6.0
- Unterstützt die Meta Audience Network-Android-Adapterversion 5.6.0.0.
- Unterstützt die Meta Audience Network iOS-Adapterversion 5.6.0.0.
Version 2.5.1
- Unterstützt Facebook Android Adapter Version 5.5.0.0.
- Unterstützt den Facebook iOS Adapter Version 5.5.1.0.
Version 2.5.0
- Unterstützt Facebook Android Adapter Version 5.5.0.0.
- Unterstützt den Facebook iOS Adapter Version 5.5.0.0.
Version 2.4.1
- Unterstützt Facebook Android Adapter Version 5.4.1.1.
- Unterstützt den Facebook iOS Adapter Version 5.4.0.0.
Version 2.4.0
- Unterstützt Facebook Android Adapter Version 5.4.0.0.
- Unterstützt den Facebook iOS Adapter Version 5.4.0.0.
Version 2.3.2
- Unterstützt Facebook Android Adapter Version 5.3.1.2.
- Unterstützt den Facebook iOS Adapter Version 5.3.2.0.
Version 2.3.1
- Unterstützt Facebook Android Adapter Version 5.3.1.0.
- Unterstützt den Facebook iOS Adapter Version 5.3.2.0.
Version 2.3.0
- Unterstützt Facebook Android Adapter Version 5.3.0.0.
- Unterstützt den Facebook iOS Adapter Version 5.3.0.0.
Version 2.2.0
- Das Plug-in wurde aktualisiert, um die neue Open-Beta Reward API zu unterstützen.
- Unterstützt Facebook Android Adapter Version 5.2.0.1.
- Unterstützt den Facebook iOS Adapter Version 5.2.0.1.
Version 2.1.1
- Unterstützt Facebook Android Adapter Version 5.1.0.1.
- Unterstützt den Facebook iOS Adapter Version 5.1.0.0.
Version 2.1.0
- Unterstützt Facebook Android Adapter Version 5.1.0.0.
- Unterstützt den Facebook iOS Adapter Version 5.1.0.0.
Version 2.0.0
- Unterstützt Facebook Android Adapter Version 5.0.1.0.
- Unterstützt den Facebook iOS Adapter Version 5.0.1.0.
Version 1.2.1
- Unterstützt Facebook Android Adapter Version 4.99.3.0.
- Unterstützt den Facebook iOS Adapter Version 4.99.3.0.
Version 1.2.0
- Unterstützt Facebook Android Adapter Version 4.99.1.1.
- Unterstützt den Facebook iOS Adapter Version 4.99.2.0.
Version 1.1.3
- Unterstützt Facebook Android Adapter Version 4.28.2.1.
- Unterstützt den Facebook iOS Adapter Version 4.28.1.2.
Version 1.1.2
- Ein möglicher Konflikt mit dem Unity Ads Unity-Vermittlungs-Plug-in wurde behoben.
Version 1.1.1
- Unterstützt Facebook Android Adapter Version 4.28.2.0.
- Unterstützt den Facebook iOS Adapter Version 4.28.1.1.
Version 1.1.0
- Unterstützt Facebook Android SDK Version 4.28.1.
- Unterstützt Facebook iOS SDK Version 4.28.1.
Version 1.0.0
- Erste Veröffentlichung!
- Unterstützt Facebook Android SDK Version 4.27.0.
- Unterstützt Facebook iOS SDK Version 4.27.1.