Server-Event-Parameter

ParameterBeschreibung
event_name
String

Erforderlich.
Ein Name eines Standard-Events oder selbstdefinierten Events. Mit diesem Feld können Events dedupliziert werden, die per Web (via Meta-Pixel) oder App (via SDK oder App Events API) und über die Conversions API gesendet werden. Der Parameter event_id wird ebenfalls bei der Deduplizierung verwendet.


Für die gleiche Kundenhandlung gleicht event aus dem Browser- oder App-Event mit event_name aus dem Server-Event ab. Wenn eine Übereinstimmung von Events, die innerhalb von 48 Stunden gesendet wurden, festgestellt wird, wird nur das erste Event berücksichtigt. Wenn ein Server- und Browser/App-Event etwa gleichzeitig (d. h. in einem Zeitfenster von fünf Minuten) eintreffen, wird das Browser-Event beibehalten. Erfahre mehr über die Deduplizierung von Pixel- und Server-Events.

event_time
Ganzzahl

Erforderlich.
Ein UNIX-Zeitstempel in Sekunden, der angibt, wann das tatsächliche Event stattgefunden hat. Die angegebene Uhrzeit kann vor der Zeit liegen, zu der du das Event an Facebook gesendet hast. Das ermöglicht die Batch-Verarbeitung und eine Optimierung der Serverleistung. Dieses Datum muss als Datum der GMT-Zeitzone gesendet werden.


Die event_time kann bis zu 7 Tage vor dem Zeitpunkt liegen, zu dem du ein Event an Facebook gesendet hast. Liegt eine event_time in data weiter als 7 Tage zurück, geben wir einen Fehler für die gesamte Anfrage zurück und verarbeiten keine Events.

user_data
Objekt

Erforderlich.
Eine Map mit Informationen zu dem*der Kund*in. Informationen zu Optionen findest du unter Parameter für Kundeninformationen. Unter Erweiterter Abgleich findest du Informationen zu vergleichbaren Optionen für über das Meta-Pixel gesendete Daten.

custom_data
Objekt

Optional.
Eine Map mit zusätzlichen Geschäftsdaten über ein Event. Siehe Benutzerdefinierte Datenparameter für weitere Informationen.

event_source_url
String

Optional.
Die Browser-URL, wo das Event stattgefunden hat. Die URL muss mit http:// oder https:// beginnen und mit der verifizierten Domain übereinstimmen.


Hinweis: Die event_source_url ist für geteilte Website-Events unter Verwendung der Conversions API erforderlich.

opt_out
Boolescher Wert

Optional.
Ein Flag, das angibt, dass dieses Event nicht zur Optimierung der Anzeigenauslieferung verwendet werden soll. Wenn auf true festgelegt, wird das Event nur zur Attribution verwendet.

event_id
String

Optional.
Diese ID kann ein beliebiger individueller String sein, der vom Werbetreibenden ausgewählt wird. Mit den Parametern event_id und event_name werden Events dedupliziert, die per Web (via Meta-Pixel) oder App (via SDK oder App Events API) und über die Conversions API gesendet werden. Die event_id ist zwar als optional gekennzeichnet, wird jedoch für die Deduplizierung von Events empfohlen.


Für die Deduplizierung muss die eventID von einem Browser/App-Event mit der event_id in dem entsprechenden Server-Event übereinstimmen. Erfahre mehr über die Verarbeitung doppelter Pixel- und Conversions API-Events.


Für die event_id können zwei potenzielle IDs verwendet werden: eine Bestellnummer oder Transaktions-ID. Wenn ein*e Kund*in beispielsweise auf deiner Website zwei Käufe mit den Bestellnummern 123 und 456 tätigt, müssen die jeweiligen Aufrufe der Conversions API die entsprechenden Bestellnummern für die event_id enthalten. Somit können wir diese zwei Kauf-Events eindeutig als separate Bestellungen unterscheiden. Die zwei entsprechenden Pixel-Kauf-Events im Browser müssen außerdem dieselben Bestellnummern im Parameter eventID senden, damit wir erkennen können, dass nur zwei anstatt vier Kauf-Events stattgefunden haben.


Für sonstige Events ohne eigene ID kann eine Zufallszahl (solange dieselbe Zufallszahl zwischen den Browser- und Server-Events gesendet wird) verwendet werden.

action_source
String

Optional.
In diesem Feld kannst du angeben, wo deine Conversions erfolgt sind. Die Information, wo deine Events stattgefunden haben, trägt dazu bei, dass deine Anzeigen an die richtigen Personen gerichtet werden. Indem du die Conversions API verwendest, versicherst du, dass der Parameter action_source nach bestem Wissen und Gewissen richtig ist.


Du kannst folgende Werte über das Feld action_source senden:


  • email – Die Conversion erfolgte per E-Mail.
  • website – Die Conversion erfolgte auf deiner Website.
  • app – Die Conversion erfolgte auf deiner mobilen App.
  • phone_call – Die Conversion erfolgte per Telefon.
  • chat – Die Conversion erfolgte über eine Messaging-App, per SMS oder einen anderen Online-Messaging-Dienst.
  • physical_store – Die Conversion erfolgte persönlich in einem Ladengeschäft.
  • system_generated – Die Conversion erfolgte automatisch, zum Beispiel durch die Verlängerung eines Abonnements, für welches automatische Zahlungen pro Monat eingerichtet sind.
  • business_messaging – Die Conversion erfolgte über Click-to-Messenger-, Click-to-Instagram oder Click-to-WhatsApp-Anzeigen.
  • other – Die Conversion erfolgte auf eine andere Art, die nicht aufgeführt wurde.
Hinweis: Alle Handlungs-Quellenwerte ermöglichen die Anzeigenmessung und Funktionen für die Custom Audience-Erstellung. Alle Handlungs-Quellen außer physical_store ermöglichen Funktionen für die Anzeigenoptimierung.
data_processing_options
Array

Optional.
Verarbeitungsoptionen, die du für ein bestimmtes Event aktivieren möchtest. Aktuell wird der Wert LDU für die eingeschränkte Datennutzung akzeptiert. Es kann ein leeres Array gesendet werden, um ausdrücklich anzugeben, dass dieses Event nicht mit den Beschränkungen der eingeschränkten Datennutzung verarbeitet werden soll. Erfahre mehr über Datenverarbeitungsoptionen. Siehe Beispiele für die Implementierung der Conversions API.

data_processing_options_country
Ganzzahl

Erforderlich, wenn du LDU unter data_processing_options sendest.
Ein Land, das dieser Datenverarbeitungsoption zugewiesen werden soll. Aktuell werden die Werte 1 für die Vereinigten Staaten von Amerika oder 0 für die Anforderung der Geolocation dieses Events akzeptiert. Erfahre mehr über Datenverarbeitungsoptionen. Siehe Beispiele für die Implementierung der Conversions API.

data_processing_options_state
Ganzzahl

In einigen Fällen erforderlich. (Weitere Details im nachfolgenden Hinweis)
Ein Bundesstaat, der dieser Datenverarbeitungsoption zugewiesen werden soll. Aktuell werden die Werte 1000 für Kalifornien oder 0 für die Anforderung der Geolocation dieses Events akzeptiert.


Hinweis:

  • Wenn du ein Land angibst, musst du auch einen Bundesstaat angeben. Andernfalls wenden wir unsere Geolocation-Logik auf das gesamte Event an.
  • Dieses Feld ist erforderlich, wenn du LDU unter data_processing_options sendest und keine IP-Adresse angibst.

Erfahre mehr über Datenverarbeitungsoptionen. Siehe Beispiele für die Implementierung der Conversions API.

app_data

Objekt

Erforderlich für App-Events

Parameter zum Teilen von App-Daten und Geräteinformationen mit der Conversions API.

extinfo ist ein Subparameter von app_data.

extinfo

Objekt

Erforderlich für App-Events

Erweiterte Geräteinformationen, z. B. Breite und Höhe des Bildschirms. Dieser Parameter ist ein Array und Werte werden durch Kommas voneinander getrennt. Bei Verwendung von „extinfo“ sind alle Werte erforderlich und müssen in der untenstehenden Reihenfolge angegeben werden. Falls ein Wert fehlt, füge einen leeren String als Platzhalter ein.


Hinweis:


  • version muss für Android a2 sein.

  • version muss für iOS i2 sein.

0

String

Erforderlich

extinfo-Version


Beispiel: i2

1

String

App-Paketname


Beispiel: com.facebook.sdk.samples.hellofacebook

2

String

Kurze Version (Integer oder String)


Beispiel: 1.0

3

String

Lange Version


Beispiel: 1.0 long

4

String

Erforderlich

OS-Version


Beispiel: 13.4.1

5

String

Gerätemodellname


Beispiel: iPhone5,1

6

String

Ländereinstellung


Beispiel: En_US

7

String

Zeitzonenkürzel


Beispiel: PDT

8

String

Anbieter


Beispiel: AT&T

9

int64

Bildschirmbreite


Beispiel: 320

10

int64

Bildschirmhöhe


Beispiel: 568

11

String

Bildschirmdichte


Beispiel: 2

12

int64

CPU-Kerne


Beispiel: 2

13

int64

Externer Speicherplatz in GB


Beispiel: 13

14

int64

Freier externer Speicherplatz in GB


Beispiel: 8

15

String

Zeitzone des Geräts


Beispiel: USA/New York

referrer_url
String

Optional.
Die interne Website, die direkt vor der Seite des Werbetreibenden besucht wurde, auf der das Meta-Pixel ausgelöst wurde. Es handelt sich um ein HTTP-Referrer aus der Perspektive von JavaScript. Die referral_url ist entweder die Seite, auf der der*die Benutzer*in vor seinem*ihrem Besuch der aktuellen Seite war, oder das iFrame.