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. Dabei werden auch die Integration von Geboten behandelt. Sie erfahren, wie Sie Meta Audience Network zur Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und wie Sie das Meta Audience Network und den Adapter in eine Unity-App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der AdMob -Vermittlungsadapter 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 nur für Gebote verfügbar.
Voraussetzungen
- Das aktuelle Google Mobile Ads SDK
- Unity 5.6 oder höher
- Vermittlungs-Plug-in für Google Mobile Ads für Meta Audience Network 2.11.0 (aktuelle Version empfohlen)
- Für die Bereitstellung unter Android
- Android API-Level 21 oder höher
- Für die Bereitstellung unter iOS
- iOS-Bereitstellungsziel 10.0 oder höher
- Das neueste Meta Audience Network SDK erfordert normalerweise die neueste Version von Xcode.
- Ein funktionierendes Unity Projekt, das mit dem Google Mobile Ads SDK konfiguriert wurde Weitere Informationen finden Sie unter Erste Schritte.
- Startleitfaden für die Vermittlung
Schritt 1: Konfigurationen in der Meta Audience Network-UI einrichten
Registrieren Sie sich und melden Sie sich auf der Business Manager-Startseite an.
Klicken Sie auf Jetzt starten und dann auf Neues Konto erstellen.
Geben Sie Ihre Unternehmensdetails in die Pflichtfelder ein und klicken Sie auf Weiter.
Property erstellen
Nachdem Sie die erforderlichen Informationen eingegeben haben, werden Sie aufgefordert, eine Property für Ihre App zu erstellen. Geben Sie den gewünschten Namen für die Property für Ihre App ein und klicken Sie auf Weiter.
Wähle als Nächstes die Plattform für die Monetarisierung aus.
Fügen Sie die App-Details hinzu und klicken Sie auf Weiter.
Android
iOS
Klicken Sie auf Neues Zahlungskonto hinzufügen, um ein Zahlungskonto einzurichten. Sie werden auf eine neue Seite weitergeleitet, auf der Sie Ihre Zahlungsinformationen eingeben können. Geben Sie die erforderlichen Informationen ein und klicken Sie dann auf Weiter.
Wählen Sie Google AdMob als Vermittlungsplattform aus und klicken Sie dann auf Placement erstellen.
Wählen Sie ein Format aus, füllen Sie das Formular aus und klicken Sie auf Erstellen.
Notieren Sie sich die Placement-ID.
Klicken Sie auf Fertig.
Testmodus aktivieren
Eine ausführliche Anleitung zum Aktivieren von Meta Audience Network-Testanzeigen finden Sie im Leitfaden zum Testen der Audience Network-Implementierung.
Schritt 2: Meta Audience Network-Nachfrage AdMob in der 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.
Facebook zur 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 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 aus und suchen Sie die heruntergeladene Datei GoogleMobileAdsFacebookMediation.unitypackage
. Achten Sie darauf, dass alle Dateien ausgewählt sind, und klicken Sie auf Importieren.
Wählen Sie Assets > Play Services Resolver > Android Resolver > Force Resolver aus.
Die Unity Play Services Resolver-Bibliothek führt dann eine Abhängigkeitsauflösung von Grund auf und kopiert die deklarierten Abhängigkeiten in das Verzeichnis Assets/Plugins/Android
Ihrer Unity-Anwendung.
Schritt 4: Datenschutzeinstellungen im Meta Audience Network SDK implementieren
EU-Nutzereinwilligung und DSGVO
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.
Informationen zur DSGVO und Meta-Werbung finden Sie in den Hinweisen von Meta.
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.
Nutzer in Kalifornien können sich über die Datenverarbeitungsoptionen von Meta informieren.
Schritt 5: Erforderlichen Code hinzufügen
Android
Für die Meta Audience Network-Integration ist kein zusätzlicher Code erforderlich.
iOS
SKAdNetwork-Integration
Folgen Sie der Dokumentation von Meta Audience Network, um die SKAdNetwork-IDs in die Datei Info.plist
Ihres Projekts einzufügen.
Werbe-Tracking aktiviert
Wenn Sie für iOS 14 oder höher entwickeln, lesen Sie in der Anleitung von Meta Audience Network zum Festlegen des Werbe-Tracking-Flags nach.
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 beeinträchtigt die Funktionalität des Medien-Caching des Meta Audience Network SDK und kann sich negativ auf die Nutzerfreundlichkeit und die Werbeeinnahmen auswirken. Folgen Sie der Meta-Dokumentation, um die Netzwerksicherheitskonfiguration in Ihrer App zu aktualisieren.
iOS
Gilt nicht für iOS-Integrationen.
Fehlercodes
Wenn der Adapter keine Anzeige vom Audience Network empfangen kann, können Sie den zugrunde liegenden Fehler aus der Anzeigenantwort mit ResponseInfo
in den folgenden Klassen prüfen:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Dies sind die Codes und Begleitmitteilungen, 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 Bannergröße überein, die vom Meta Audience Network unterstützt wird. |
103 | Der Publisher muss Anzeigen mit einem Activity -Kontext 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 erwartet. |
107 | Das verwendete Context -Objekt ist ungültig. |
108 | Bei der geladenen Anzeige fehlen die erforderlichen nativen Anzeigen-Assets. |
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 AdView -Meta Audience Network-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 Bannergröße überein, die vom Meta Audience Network unterstützt wird. |
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-Ansicht-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 des Plug-ins „Meta Audience Network Unity Mediation“
Version 3.12.0
- Unterstützt Android-Adapterversion 6.17.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.15.0.0 von Meta Audience Network
- Das Unity-Plug-in wurde mit Version 9.0.0 des Google Mobile Ads Unity-Plug-ins erstellt und getestet.
Version 3.11.0
- Unterstützt Android-Adapterversion 6.15.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.14.0.0 von Meta Audience Network
- Das Unity-Plug-in für Google Mobile Ads wurde mit Version 8.5.1 erstellt und getestet.
Version 3.10.0
- Adapterinhalt wurde nach
GoogleMobileAds/Mediation/MetaAudienceNetwork/
verschoben. - Unterstützt Android-Adapterversion 6.14.0.0 von Meta Audience Network
- Unterstützt Meta Audience Network-iOS-Adapterversion 6.12.0.1.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 8.1.0, entwickelt und getestet.
Version 3.9.1
- Unterstützt Android-Adapterversion 6.12.0.0 von Meta Audience Network
- Unterstützt Meta Audience Network-iOS-Adapterversion 6.12.0.1.
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.4.1, entwickelt und getestet.
Version 3.9.0
- Unterstützt Android-Adapterversion 6.12.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.12.0.0 von Meta Audience Network
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.3.0, entwickelt und getestet.
Version 3.8.0
- Der Name des Unity-Vermittlungs-Plug-ins wurde in „Meta Audience Network“ umbenannt.
- Unterstützt Android-Adapterversion 6.11.0.1 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.11.1.0 von Meta Audience Network
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.2. entwickelt und getestet.
Version 3.7.0
- Unterstützt Android-Adapterversion 6.10.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.10.0.0 von Meta Audience Network
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.0, entwickelt und getestet.
Version 3.6.1
- Unterstützt Android-Adapterversion 6.8.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.9.0.1 von Meta Audience Network
- Das Unity-Plug-in wurde für Google Mobile Ads, Version 7.0.0, entwickelt und getestet.
Version 3.6.0
- Unterstützt Android-Adapterversion 6.8.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.8.0.0 von Meta Audience Network
Version 3.5.0
- Unterstützt Android-Adapterversion 6.7.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.7.0.0 von Meta Audience Network
Version 3.4.0
- Unterstützt Android-Adapterversion 6.6.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.6.0.0 von Meta Audience Network
Version 3.3.2
- Unterstützt Android-Adapterversion 6.5.1.1 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.5.1.0 von Meta Audience Network
Version 3.3.1
- Unterstützt Android-Adapterversion 6.5.1.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.5.1.0 von Meta Audience Network
Version 3.3.0
- Unterstützt Android-Adapterversion 6.4.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.4.1.0 von Meta Audience Network
Version 3.2.0
- Unterstützt Android-Adapterversion 6.2.0.1 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.2.1.0 von Meta Audience Network
Version 3.1.0
- Unterstützt Android-Adapterversion 6.2.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.2.0.0 von Meta Audience Network
Version 3.0.0
- Unterstützt Android-Adapterversion 6.1.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 6.0.0.0 von Meta Audience Network
Version 2.12.0
- Unterstützt Android-Adapterversion 5.11.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.10.1.0 von Meta Audience Network
Version 2.11.1
- Unterstützt Android-Adapterversion 5.10.1.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.10.1.0 von Meta Audience Network
Version 2.11.0
- Unterstützt Android-Adapterversion 5.10.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.10.0.0 von Meta Audience Network
Version 2.10.0
- Unterstützt Android-Adapterversion 5.9.1.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.9.0.1 von Meta Audience Network
Version 2.9.2
- Unterstützt Android-Adapterversion 5.9.0.2 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.9.0.1 von Meta Audience Network
Version 2.9.1
- Unterstützt Android-Adapterversion 5.9.0.1 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.9.0.1 von Meta Audience Network
Version 2.9.0
- Unterstützt Android-Adapterversion 5.9.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.9.0.0 von Meta Audience Network
Version 2.8.1
- Unterstützt Android-Adapterversion 5.8.0.1 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.8.0.2 von Meta Audience Network
Version 2.8.0
- Unterstützt Android-Adapterversion 5.8.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.8.0.1 von Meta Audience Network
Version 2.7.1 (eingestellt, verwenden Sie 2.8.0 oder höher)
- Unterstützt Android-Adapterversion 5.7.1.0 von Meta Audience Network
- Unterstützt Meta Audience Network-iOS-Adapterversion 5.7.1.1.
Version 2.7.0 (eingestellt, 2.8.0 oder höher verwenden)
- Unterstützt Android-Adapterversion 5.7.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.7.0.0 von Meta Audience Network
Version 2.6.1 (eingestellt, verwenden Sie 2.8.0 oder höher)
- Unterstützt Android-Adapterversion 5.6.1.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.6.1.0 von Meta Audience Network
Version 2.6.0
- Unterstützt Android-Adapterversion 5.6.0.0 von Meta Audience Network
- Unterstützt iOS-Adapterversion 5.6.0.0 von Meta Audience Network
Version 2.5.1
- Unterstützt Facebook Android-Adapterversion 5.5.0.0.
- Unterstützt Facebook-iOS-Adapterversion 5.5.1.0.
Version 2.5.0
- Unterstützt Facebook Android-Adapterversion 5.5.0.0.
- Unterstützt Facebook-iOS-Adapterversion 5.5.0.0.
Version 2.4.1
- Unterstützt Facebook Android Adapterversion 5.4.1.1.
- Unterstützt Facebook-iOS-Adapterversion 5.4.0.0.
Version 2.4.0
- Unterstützt Facebook Android Adapterversion 5.4.0.0.
- Unterstützt Facebook-iOS-Adapterversion 5.4.0.0.
Version 2.3.2
- Unterstützt Facebook Android Adapterversion 5.3.1.2.
- Unterstützt Facebook-iOS-Adapterversion 5.3.2.0.
Version 2.3.1
- Unterstützt Facebook Android-Adapterversion 5.3.1.0.
- Unterstützt Facebook-iOS-Adapterversion 5.3.2.0.
Version 2.3.0
- Unterstützt Facebook-Android-Adapterversion 5.3.0.0.
- Unterstützt Facebook-iOS-Adapterversion 5.3.0.0.
Version 2.2.0
- Das Plug-in wurde aktualisiert, um die neue offene Beta Reward API zu unterstützen.
- Unterstützt Facebook Android Adapterversion 5.2.0.1.
- Unterstützt Facebook-iOS-Adapterversion 5.2.0.1.
Version 2.1.1
- Unterstützt Facebook Android Adapterversion 5.1.0.1.
- Unterstützt Facebook-iOS-Adapterversion 5.1.0.0.
Version 2.1.0
- Unterstützt Facebook Android-Adapterversion 5.1.0.0.
- Unterstützt Facebook-iOS-Adapterversion 5.1.0.0.
Version 2.0.0
- Unterstützt Facebook Android Adapterversion 5.0.1.0.
- Unterstützt Facebook-iOS-Adapterversion 5.0.1.0.
Version 1.2.1
- Unterstützt die Adapterversion 4.99.3.0 des Facebook Android-Adapters.
- Unterstützt Facebook-iOS-Adapterversion 4.99.3.0.
Version 1.2.0
- Unterstützt die Adapterversion 4.99.1.1 des Facebook Android-Adapters.
- Unterstützt Facebook-iOS-Adapterversion 4.99.2.0.
Version 1.1.3
- Unterstützt die Adapterversion 4.28.2.1 des Facebook Android-Adapters.
- Unterstützt Facebook-iOS-Adapterversion 4.28.1.2.
Version 1.1.2
- Ein potenzieller Konflikt mit dem Vermittlungs-Plug-in von Unity Ads Unity wurde behoben.
Version 1.1.1
- Unterstützt die Adapterversion 4.28.2.0 des Facebook Android-Adapters.
- Unterstützt Facebook-iOS-Adapterversion 4.28.1.1.
Version 1.1.0
- Unterstützt das Facebook Android SDK, Version 4.28.1.
- Unterstützt das Facebook iOS SDK Version 4.28.1.
Version 1.0.0
- Erste Version!
- Unterstützt das Facebook Android SDK, Version 4.27.0.
- Unterstützt das Facebook iOS SDK Version 4.27.1.