Server-Event-Parameter

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.

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.

Optional.
Die Browser-URL, wo das Event stattgefunden hat. Die URL muss mit der verifizierten Domain übereinstimmen.

Hinweis: Die event_source_url ist für Website-Events erforderlich, die unter Verwendung der Conversions API geteilt werden.

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.

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.

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.

Optional.
Alle Metadatenfelder, mit denen Werbetreibende angeben können, wie ein „verzögertes“ Event mit einem früheren Erwerbsevent verknüpft werden soll.

Wir empfehlen dringend, bei einer Verzögerung zwischen dem Senden eines Events und einem früheren Erwerbsevent, mit dem es verknüpft werden soll, original_event_data zu verwenden. Weitere Informationen findest du unter Ursprüngliche Event-Datenparameter.