Server-Event-Parameter

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.

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

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

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.

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.

app_data

Erforderlich für App-Events

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

extinfo

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.

Hinweise:

• version muss für Android a2 sein.

• version muss für iOS i2 sein.

Optional.
Der von der Seite, die das Conversions API- oder Meta-Pixel-Event auslöst, beobachtete HTTP-Referrer-Header. In der Regel ist dies die vorherige Seite im Browser.

Optional.
Damit können Werbetreibende das Nutzer*innen-Segment angeben, zu dem die Person, die das Event ausführt, gehört. Dieser Wert kann dazu genutzt werden, mehr Kontext zur Beziehung zwischen den Nutzer*innen und dem Unternehmen anzugeben.

Dieses Feld akzeptiert einen der folgenden vordefinierten Enum-Werte:

• new_customer_to_business: Der*Die Nutzer*in ist ein*e neue*r Kund*in des Unternehmens.
• new_customer_to_business_line: Der*Die Nutzer*in ist ein*e neue*r Kund*in in einem bestimmten Geschäftsbereich (beispielsweise Produkt oder Dienstleistung).
• new_customer_to_product_area: Der*Die Nutzer*in ist ein*e neue*r Kund*in in einem bestimmten Produktbereich (beispielsweise E-Commerce, Finanzen).
• new_customer_to_medium: Der*Die Nutzer*in ist ein*e neue*r Kund*in in einem bestimmten Marketingmedium (beispielsweise Social Media, E-Mail).
• existing_customer_to_business: Der*Die Nutzer*in ist ein*e Bestandskund*in des Unternehmens.
• existing_customer_to_business_line: Der*Die Nutzer*in ist ein*e Bestandskund*in in einem bestimmten Geschäftsbereich (beispielsweise Produkt oder Dienstleistung).
• existing_customer_to_product_area: Der*Die Nutzer*in ist ein*e Bestandskund*in in einem bestimmten Produktbereich (beispielsweise E-Commerce, Finanzen).
• existing_customer_to_medium: Der*Die Nutzer*in ist ein*e Bestandskund*in in einem bestimmten Marketingmedium (beispielsweise Social Media, E-Mail).
• customer_in_loyalty_program: Der*Die Nutzer*in ist Mitglied bei einem Treueprogramm.

Beispiel für JSON-Payload:

{
 "event_name": "Purchase",
 "event_time": 1643723400,
 "user_data": {
   "em": "user@example.com"
 },
 "custom_data": {
   "currency": "USD",
   "value": 100.00,
   "customer_segmentation": "new_customer_to_business"
 }
}