.
In dieser Anleitung erfahren Sie, wie Sie mit GMA Next-Gen SDK Anzeigen von Meta Audience Network mithilfe von Vermittlung laden und präsentieren. Dabei werden auch Gebotsintegrationen behandelt. Hier erfahren Sie, wie Sie Meta Audience Network der Vermittlungskonfiguration eines Anzeigenblocks hinzufügen und das Meta Audience Network SDK und den Adapter in eine Android-App einbinden.
Unterstützte Integrationen und Anzeigenformate
Der Vermittlungsadapter für Meta Audience Network bietet die folgenden Funktionen:
| Integration | |
|---|---|
| Gebote | |
| Vermittlungsabfolge 1 | |
| Formate | |
| Banner 2 | |
| Interstitial | |
| Verfügbar | |
| Interstitial mit Prämie | |
| Nativ | |
1
Meta Audience Network
unterstützt seit 2021 nur noch Gebote.
2
Meta Audience Network
unterstützt keine verankerten und adaptiven Inline-Banner.
Voraussetzungen
Neueste Version des GMA Next-Gen SDK.
Vermittlung abschließen Startleitfaden.
- Android API-Level 24 oder höher
- Meta Audience Network-Adapter 5.10.0.0 oder höher (neueste Version empfohlen)
Schritt 1: Konfigurationen in der Meta Audience Network-Benutzeroberfläche einrichten
Registrieren Sie sich und melden Sie sich auf der Business Manager Start Seite an.
Klicken Sie auf Los gehts und dann auf Neues Konto erstellen.

Füllen Sie die Pflichtfelder mit Ihren Unternehmensdetails aus 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 der Property für Ihre App ein und klicken Sie auf Weiter.

Wählen Sie als Nächstes die Plattform aus, die Sie monetarisieren möchten.

Fügen Sie Ihre App-Details hinzu und klicken Sie auf Weiter.
Richten Sie Ihr Zahlungskonto ein, indem Sie auf Neues Zahlungskonto hinzufügen klicken. Sie werden zu einer neuen Seite weitergeleitet, auf der Sie Ihre Zahlungsinformationen eingeben können. Geben Sie die erforderlichen Details ein und klicken Sie dann auf Weiter.

Wählen Sie Google Ad Manager 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.
app-ads.txt-Datei aktualisieren
Authorized Sellers for Apps oder app-ads.txt ist eine IAB Tech Lab-Initiative, 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.
Informationen zum Implementieren von app-ads.txt für Meta Audience Network finden Sie unter
Autorisierte Verkäufer mit app-ads.txt identifizieren.
Testmodus aktivieren
Eine detaillierte Anleitung zum Aktivieren von Testanzeigen für Meta Audience Network finden Sie im Leitfaden zur Implementierung von Audience Network testen.
Schritt 2: Meta Audience Network-Nachfrage in der Ad Manager-Benutzeroberfläche einrichten
Melden Sie sich in Ihrem Ad Manager-Konto an.
Freigabe sicherer Signale aktivieren
Klicken Sie auf Admin > Globale Einstellungen. Rufen Sie den Tab Ad Exchange-Kontoeinstellungen auf und aktivieren Sie die Option Freigabe sicherer Signale. Klicken Sie auf Speichern.

Sichere Signale in Gebotsanfragen freigeben
Klicken Sie auf Inventar > Sichere Signale. Suchen Sie unter Sichere Signale nach Facebook und aktivieren Sie die Option App-Integration aktivieren.

Klicken Sie auf Speichern.
Freigabe sicherer Signale für SDK-Gebote zulassen
Klicken Sie auf Auslieferung > Einstellungen für Nachfragechannel. Aktivieren Sie auf dem Tab Standardeinstellungen die Option Freigabe sicherer Signale zulassen für SDK-Gebote.

Klicken Sie auf Speichern.
Meta-Gebote konfigurieren
Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Klicken Sie auf Neuer Bieter.

Wählen Sie Meta als Bieter aus.

Klicken Sie auf Weiter , um SDK-Gebote für diesen Bieter zu aktivieren.

Klicken Sie auf Fertig.
Anzeigenblockzuordnung konfigurieren
Klicken Sie auf Auslieferung > Bieter und dann auf SDK-Gebote aufrufen.

Wählen Sie das Unternehmen für Meta Audience Network aus.

Rufen Sie den Tab Zuordnung von Anzeigenblöcken auf und klicken Sie auf Neue Anzeigenblockzuordnung.

Wählen Sie Bestimmter Anzeigenblock aus. Wählen Sie einen Anzeigenblock und ein Format, Mobile App als den Inventartyp und Ihre Mobile App aus. Geben Sie dann die Placement-ID ein, die Sie im vorherigen Abschnitt abgerufen haben.
Wenn Sie die Anzeigenblockzuordnung für eine Interstitial-Anzeige mit Prämie in der Ad Manager-Benutzeroberfläche konfigurieren, wählen Sie das Format Mit Prämie aus und verwenden Sie die Placement-ID für Interstitials mit Prämie.
Klicken Sie abschließend auf Speichern.

Meta der Liste der Werbepartner gemäß DSGVO und Verordnungen von US-Bundesstaaten hinzufügen
Folgen Sie der Anleitung unter Einstellungen für Verordnungen von US-Bundesstaaten und Einstellungen für Verordnungen von US-Bundesstaaten , um Meta der Liste der Werbepartner gemäß EU-Verordnungen und Verordnungen von US-Bundesstaaten in der Ad Manager-Benutzeroberfläche hinzuzufügen.
Schritt 3: Meta Audience Network SDK und Adapter importieren
Android Studio-Integration (empfohlen)
Fügen Sie in der Gradle-Datei auf App-Ebene die folgenden Implementierungsabhängigkeiten und ‑konfigurationen hinzu:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:facebook:6.21.0.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' implementation 'com.google.ads.mediation:facebook:6.21.0.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Manuelle Integration
Laden Sie die neueste Version des Meta Audience Network SDK für Android herunter. Extrahieren Sie
AudienceNetwork.aaraus dem OrdnerAudienceNetwork/binund fügen Sie sie Ihrem Projekt hinzu.Rufen Sie die Meta Audience Network-Adapter artefakte im Maven-Repository von Google auf. Wählen Sie die neueste Version aus, laden Sie die
.aar-Datei des Meta Audience Network-Adapters herunter und fügen Sie sie Ihrem Projekt hinzu.
Schritt 4: Datenschutzeinstellungen für das Meta Audience Network SDK implementieren
Einwilligung der Nutzer in der EU und DSGVO
Gemäß der Richtlinie zur Einwilligung der Nutzer in der EU von Google müssen Sie Ihren Nutzern im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz bestimmte Informationen offenlegen und ihre Einwilligung zu folgenden Aktivitäten einholen: Einsatz von Cookies oder anderen Formen der lokalen Speicherung, falls die Einholung der Einwilligung dafür gesetzlich vorgeschrieben ist, sowie Erhebung, Weiterleitung und Nutzung personenbezogener Daten für personalisierte Werbung. 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. Google kann die Einwilligung des Nutzers nicht automatisch an diese Netzwerke weitergeben.
Meta ist nicht in der Global Vendor List (GVL) von IAB Europe registriert. Verwenden Sie stattdessen die technische Spezifikation für die zusätzliche Einwilligung. Weitere Informationen finden Sie unter Komponenten der zusätzlichen Einwilligung. Die Spezifikation für die zusätzliche Einwilligung funktioniert in Verbindung mit Version 2 des Transparency &Consent Framework (TCF) von IAB Europe. Mit dieser Spezifikation können Sie zusammen mit Ihren Plattformen zur Einwilligungsverwaltung (CMPs) und Partnern zusätzliche Einwilligungssignale für Unternehmen erheben und übertragen, die in der Liste der Anzeigentechnologie-Anbieter von Google aufgeführt sind, aber noch nicht Teil der GVL von IAB Europe sind.
Folgen Sie der Anleitung in der Meta-Dokumentation zur DSGVO und zu Meta-Werbung.
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 können Sie die eingeschränkte Datenverarbeitung für die Google-Anzeigenbereitstellung 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 kann, und die Anleitung der jeweiligen Netzwerke befolgen, um die Einhaltung der Datenschutzgesetze zu gewährleisten.
Folgen Sie der Anleitung in der Meta-Dokumentation zu den Optionen für die Datenverarbeitung für Nutzer in Kalifornien.
Schritt 5: Erforderlichen Code hinzufügen
Für die Meta Audience Network-Integration ist kein zusätzlicher Code erforderlich.
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.
Testanzeigen prüfen
Optionale Schritte
Native Anzeigen
Einige
Assets für native Anzeigen von Meta Audience Network
lassen sich nicht direkt Google-Assets für native Anzeigen zuordnen. Solche Assets werden über die Methode getExtras() in NativeAd in einem Bundle an den Publisher zurückgegeben.
Der Adapter unterstützt die Übergabe der folgenden Assets:
| Anfrageparameter und ‑werte | |
|---|---|
FacebookMediationAdapter.KEY_ID
|
String Eindeutige ID der nativen Anzeige |
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET
|
String Sozialer Kontext der Anzeige |
Hier ein Codebeispiel, das zeigt, wie Sie diese Assets extrahieren:
Beispiel:
Kotlin
val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
// ...
}
Java
Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
// ...
}
Native Anzeigen von Meta Audience Network ohne MediaView verwenden
Für das native Anzeigenformat von Meta Audience Network muss das
MediaView
Asset gerendert werden. Wenn Sie native Anzeigen ohne dieses Asset rendern möchten, verwenden Sie
das native Banner
Anzeigenformat von Meta Audience Network.
Wenn Sie stattdessen native Banneranzeigen von Meta Audience Network verwenden möchten, müssen Sie beim Einrichten von Meta Audience Network das
Native Banner Format auswählen. Der
Adapter lädt dann automatisch das entsprechende native Anzeigenformat.
Anzeigen-Rendering
Der Audience Network-Adapter gibt seine nativen Anzeigen als
NativeAd
Objekte zurück. Er füllt die folgenden
Felder
für ein
NativeAd aus.
| Feld | Vom Meta Audience Network-Adapter ausgefüllt |
|---|---|
| Anzeigentitel | |
| Bild | 1 |
| Text | |
| App-Symbol | |
| Call-to-Action | |
| Name des Werbetreibenden | |
| Bewertung | |
| Shop | |
| Preis |
1 Der Meta Audience Network-Adapter
bietet keinen direkten Zugriff auf das Hauptbild-Asset
für native Anzeigen. Stattdessen wird das
MediaView
vom Adapter mit einem Video oder einem Bild gefüllt.
Impressionen und Klicks tracken
In der folgenden Tabelle wird erläutert, wann Impressionen und Klicks für native Anzeigen erfasst werden von GMA Next-Gen SDK.
| Impressionen erfassen | Klicks erfassen |
|---|---|
| 1 Pixel des Assets für native Anzeigen von Meta Audience Network auf dem Bildschirm + Anforderungen an das Asset-Rendering | Meta Audience Network SDK-Callback |
Meta Audience Network hat bestimmte Anforderungen an das Asset-Rendering, damit eine Impression als gültig gilt. Diese Anforderungen hängen davon ab, ob Sie beim Einrichten von Meta Audience Network das Format Nativ oder Natives Banner ausgewählt haben, wenn Sie Meta Audience Network einrichten.
| Natives Format von Meta Audience Network | Erforderliches Asset | Erforderliche Rendering-Klasse |
|---|---|---|
| Nativ | Medienansicht |
MediaView
|
| Natives Banner | App-Symbol |
ImageView
|
Caching unter Android 9
Ab Android 9 (API-Level 28) ist die Unterstützung für Klartext standardmäßig deaktiviert. Dies wirkt sich auf die Funktion des Media-Caching des Meta Audience Network SDK aus und kann die Nutzerfreundlichkeit und den Anzeigenumsatz beeinträchtigen. Folgen Sie der Anleitung von Meta , um die Netzwerksicherheitskonfiguration in Ihrer App zu aktualisieren.
Fehlercodes
Wenn der Adapter keine Anzeige von Audience Network empfängt, können Sie den
zugrunde liegenden Fehler aus der Anzeigenantwort mit
ResponseInfo.getAdSourceResponses()
in den folgenden Klassen prüfen:
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
Hier sind die Codes und die zugehörigen Meldungen, die vom Audience Network-Adapter ausgegeben werden, wenn eine Anzeige nicht geladen werden kann: