Meta-Zielgruppen-Netzwerk in Bidding einbinden

Hinweis :Facebook Audience Network heißt jetzt „Meta Audience Network“. Weitere Informationen finden Sie in der Ankündigung von Meta.

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 Flutter App einbinden.

Unterstützte Integrationen und Anzeigenformate

Der Vermittlungsadapter Ad Manager für das Meta Audience Network bietet folgende Funktionen:

Integration
Gebote
Wasserfall  ^1
Formate
Banner
Interstitial
Verfügbar
Interstitial mit Prämie

¹ Meta Audience Network wurde 2021 auf nur Gebote umgestellt.

Voraussetzungen

• Neuestes Google Mobile Ads SDK
• Flutter 3.7.0 oder höher
• 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 Flutter 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

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.

Hinweis :Das Banner-Format von Meta Audience Network unterstützt das Displayformat „Medium Rectangle“ und Banner mit flexibler Breite mit einer Höhe von 50, 90 oder 250.

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 in Ad Manager 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 Ad Manager Benutzeroberfläche aufzunehmen.

Schritt 3: Meta Audience Network SDK und Adapter importieren

Hinweis :Wenn die kompatiblen Versionen des Meta Audience Network und des Google Mobile Ads SDK nicht eingebunden werden, kann es zu Build-Problemen kommen.

Integration über pub.dev

Fügen Sie die folgende Abhängigkeit mit den neuesten Versionen desMeta Audience Network SDK und des Adapters in die Datei pubspec.yaml des Pakets ein:

dependencies:
  gma_mediation_meta: ^1.0.0

Manuelle Integration

Laden Sie die neueste Version des Google Mobile Ads-Vermittlungs-Plug-ins für Meta Audience Network herunter, extrahieren Sie die heruntergeladene Datei und fügen Sie den extrahierten Plug-in-Ordner (und seinen Inhalt) dem Flutter-Projekt hinzu. Verweisen Sie dann in der Datei pubspec.yaml auf das Plug-in. Fügen Sie dazu die folgende Abhängigkeit hinzu:

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

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 Ad Manager und aktivieren Sie den Testmodus in der Meta Audience Network Benutzeroberfläche.

Wichtiger Hinweis :Achte beim Testen darauf, dass die Facebook-App auf dem Testgerät installiert ist und du mit einem gültigen Facebook-Log-in angemeldet bist. Weitere Informationen finden Sie in der Meta-Dokumentation.

Wichtig: Deaktiviere den Testmodus für Ad Manager undMeta Audience Network vor der Veröffentlichung deiner App.

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 zum Adapter für Meta Audience Network Flutter Mediation

1.0.1

• Es wurde eine Dart-Klasse hinzugefügt, um eine korrekte Kompatibilitätsanalyse mit Hostplattformen zu ermöglichen.
• Die Kompatibilität mit Meta-Android-Adapterversion 6.17.0.0 wurde bestätigt
• Die Kompatibilität mit Meta-iOS-Adapterversion 6.15.0.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 Meta-Android-Adapterversion 6.17.0.0 wurde bestätigt
• Die Kompatibilität mit Meta-iOS-Adapterversion 6.15.0.0 wurde bestätigt
• Erstellt und getestet mit dem Google Mobile Ads Flutter-Plug-in Version 5.0.0.