Parameter für Kund*innen-Informationen

Die Parameter für Kund*innen-Informationen sind eine Reihe von Nutzer*innen-IDs, die du zusammen mit deinen Event-Informationen freigibst. Weitere Informationen zu erforderlichen und empfohlenen Parametern findest du unter Best Practices – Conversions API: Erforderliche und empfohlene Parameter senden.

In Version 13.0 der Graph API gab es neue Anforderungen in Bezug auf die Kombinationen von Parametern für Kund*innen-Informationen, die als gültig angesehen werden. Sieh dir die Best Practices an, um sicherzustellen, dass deine Integrationen der Conversions API nicht unterbrochen werden.

Im Leitfaden zu Datenschutz und Datennutzung von Meta findest du weitere Informationen dazu, welche Daten bei Verwendung der Conversions API gesendet werden.

Unsere Systeme sind so konzipiert, dass sie keine Kund*innen-Informationen akzeptieren, die nicht gehashte Kontaktinformationen sind, sofern dies nicht nachfolgend angegeben ist. Kontaktinformationen sind Informationen, mit denen Einzelpersonen identifiziert werden können, wie Namen, E-Mail-Adressen und Telefonnummern. Diese verwenden wir nur für Abgleichzwecke. Wenn du das Meta Business-SDK verwendest, erfolgt das Hashen automatisch.

Pixel-Vergleich

Über das Meta-Pixel kannst du viele der Parameter für Kund*innen-Informationen senden. Aufgrund der Funktionsweise des Internets werden einige davon (z. B. client_user_agent) jedoch automatisch gesendet. Verwende den folgenden Code, um beispielsweise external_id über das Pixel zu senden:

fbq('init', 'PIXEL_ID', {'external_id': 12345});

In der Dokumentation zum erweiterten Abgleich erfährst du mehr über die anderen Parameter, die du mit Pixel übergeben kannst.

Stelle umgekehrt sicher, dass du auf der Serverseite denselben Satz von Parametern für Kund*innen-Informationen bereitstellst, den dein System aktuell auf der Browserseite freigibt.

Die `user_data`-Parameter formatieren

Du musst in deiner Anfrage mindestens einen der folgenden user_data-Parameter mit der korrekten Formatierung bereitstellen.

In dieser CSV-Datei

findest du Beispiele für korrekt normalisierte und gehashte Daten für die untenstehenden Parameter.

Download (Rechtsklick > Link speichern als)

Parameter	Beschreibung
`em` E-Mail String oder Liste<string>	Hashing erforderlich. Entferne alle Leerzeichen am Anfang und am Ende. Wandle alle Buchstaben in Kleinbuchstaben um. Beispiel: Eingabe: John_Smith@gmail.com Normalisiertes Format: john_smith@gmail.com Erwartete SHA256-Ausgabe: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f
`ph` Telefonnummer String oder Liste<string>	Hashing erforderlich. Entferne Symbole, Buchstaben und alle führenden Nullen. Telefonnummern müssen eine Ländervorwahl enthalten, die zum Abgleich verwendet werden kann (z. B. einer Telefonnummer in den USA muss die Nummer 1 vorangestellt sein). Füge immer die Ländervorwahl als Teil der Telefonnummern deiner Kundinnen ein, auch wenn deine Daten alle aus demselben Land stammen. Beispiel:* Eingabe: Telefonnummer in den USA (650)555-1212 Normalisiertes Format: 16505551212 Erwartete SHA256-Ausgabe: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176
`fn` Vorname String oder Liste<string>	Hashing erforderlich. Die Verwendung von Buchstaben des lateinischen Alphabets (a–z) wird empfohlen. Nur Kleinbuchstaben, keine Interpunktion. Bei der Verwendung von Sonderzeichen muss der Text im UTF-8-Format codiert sein. Beispiel: Input: Mary Normalisiertes Format: mary Erwartete SHA256-Ausgabe: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec Eingabe: 정 Normalisiertes Format: UTF-8-Zeichen „정“ Erwartete SHA256-Ausgabe: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14 Eingabe: Valéry Normalisiertes Format: valéry Erwartete SHA256-Ausgabe: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c
`ln` Nachname String oder Liste<string>	Hashing erforderlich. Die Verwendung von Buchstaben des lateinischen Alphabets (a–z) wird empfohlen. Nur Kleinbuchstaben, keine Interpunktion. Bei Verwendung von Sonderzeichen muss der Text im UTF-8-Format codiert sein. Beispiele findest du unter „Vorname“ (`fn`).
`db` Geburtsdatum String oder Liste<string>	Hashing erforderlich. Wir erwarten das Format „JJJJMMTT“ für verschiedene Kombinationen aus Monat, Tag und Jahr mit oder ohne Zeichensetzung. Jahr: Verwende das Format „JJJJ“ von 1900 bis zum aktuellen Jahr. Monat: Verwende das Format „MM“: 01 bis 12. Tag: Verwende das Format „TT“: 01 bis 31. Beispiel: Eingabe: 2/16/1997 Normalisiertes Format: 19970216 Erwartete SHA256-Ausgabe: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c
`ge` Geschlecht String oder Liste<string>	Hashing erforderlich. Für das Geschlecht akzeptieren wir den ersten Buchstaben in Kleinbuchstaben. Beispiel: f für weiblich m für männlich
`ct` Ort String oder Liste<string>	Hashing erforderlich. Die Verwendung von Buchstaben des lateinischen Alphabets (a–z) wird empfohlen. Nur Kleinbuchstaben, keine Interpunktion, keine Sonderzeichen und keine Leerzeichen. Bei Verwendung von Sonderzeichen muss der Text im UTF-8-Format codiert sein. Beispiel: paris london newyork
`st` Bundesstaat String oder Liste<string>	Hashing erforderlich. Verwende den aus zwei Zeichen bestehenden ANSI-Abkürzungscode in Kleinbuchstaben. Normalisiere Staaten außerhalb der USA in Kleinbuchstaben, ohne Interpunktion, Sonderzeichen oder Leerzeichen. Beispiel: az ca
`zp` Postleitzahl String oder Liste<string>	Hashing erforderlich. Verwende Kleinbuchstaben, ohne Leerzeichen und Bindestriche. Verwende für Postleitzahlen in den USA nur die ersten fünf Ziffern. Verwende für das Vereinigte Königreich das Format Gebiet, Distrikt und Bezirk. Beispiel: Postleitzahl in den USA: 94035 Postleitzahl in Australien: 1987 Postleitzahl in Frankreich: 75018 Postleitzahl im Vereinigten Königreich: m11ae
`country` Land String oder Liste<string>	Hashing erforderlich. Verwende die Ländercodes mit zwei Buchstaben in Kleinbuchstaben im Format ISO 3166-1 Alpha-2. Wichtiger Hinweis: Gib immer den Ländercode deiner Kunden an, auch wenn alle deine Ländercodes dasselbe Land bezeichnen. Wir gleichen Daten weltweit ab, und dieser einfache Schritt hilft uns dabei, so viele Konten der Kontenübersicht wie möglich aus deiner Liste zu finden. Beispiel: Eingabe: Vereinigte Staaten Normalisiertes Format: us Erwartete SHA256-Ausgabe: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621
`external_id` Externe ID String oder Liste<string>	Hashing erforderlich. Eine beliebige eindeutige ID des Werbetreibenden, wie zum Beispiel IDs für Loyalitäts-Mitgliedschaften, Nutzer*innen-IDs und externe Cookie-IDs. Du kannst eine oder mehrere externe ID(s) für ein bestimmtes Event senden. Wenn eine externe ID über andere Kanäle gesendet wird, sollte sie dasselbe Format aufweisen wie beim Senden über die Conversions API.
`client_ip_address` IP-Adresse des Clients String	Nicht hashen. Die IP-Adresse des dem Event entsprechenden Browsers muss eine gültige IPv4- oder IPv6-Adresse sein. IPv6 ist IPv4 für IPv6-fähige Nutzerinnen vorzuziehen. Der Nutzungsdatenparameter `client_ip_address` darf nie gehasht werden. Es dürfen keine Leerzeichen enthalten sein. Gib immer die echte IP-Adresse an, um eine genaue Event-Berichterstellung zu gewährleisten. Hinweis:* Diese Information wird automatisch zu Events hinzugefügt, die über den Browser gesendet werden. Für Events, die über den Server gesendet werden, muss sie hingegen manuell konfiguriert werden. Beispiel: IPv4: 168.212.226.204 IPv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
`client_user_agent` User-Agent des Clients String	Nicht hashen. Der User-Agent für Browser, der dem Event entspricht. Der `client_user_agent` ist erforderlich für Website-Events, die über die Conversions API freigegeben werden. Das Senden der beiden Parameter `client_ip_address` und `client_user_agent` für alle Events, die du über die Conversions API sendest, kann zur Verbesserung des Event-Abgleichs beitragen und möglicherweise auch die Anzeigenauslieferung verbessern, die die Events optimiert, welche du über die Conversions API sendest. Hinweis: Diese Information wird automatisch zu Events hinzugefügt, die über den Browser gesendet werden. Für Events, die über den Server gesendet werden, muss sie jedoch manuell konfiguriert werden. Beispiel: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, wie Gecko) Chrome/87.0.4280.141 Safari/537.36
`fbc` Klick-ID String	Nicht hashen. Der Wert der Klick-ID von Facebook wird im `_fbc`-Browser-Cookie unter deine Domain gespeichert. Weitere Informationen zum Abrufen oder Erstellen dieses Werts aus einem `fbclid`-Abfrageparameter findest du unter Verwalten von `fbc` und `fbp`-Parametern. Das Format ist `fb.${subdomain_index}.${creation_time}.${fbclid}`. Beispiel: fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890
`fbp` Browser-ID String	Nicht hashen. Der Wert der Browser-ID von Facebook wird im `_fbp`-Browser-Cookie unter deiner Domain gespeichert. Weitere Informationen zum Abrufen dieses Werts findest du unter Verwalten von `fbc` und `fbp`-Parametern. Das Format ist `fb.${subdomain_index}.${creation_time}.${random_number}`. Beispiel: fb.1.1596403881668.1116446470
`subscription_id` Abonnement-ID String	Nicht hashen. Die Abonnement-ID für dendie Nutzerin in dieser Transaktion. Sie ist ähnlich der Bestellnummer für ein jeweiliges Produkt.
`fb_login_id` Facebook Login-ID Integer	Nicht hashen. Die von Meta ausgestellte ID bei der ersten Anmeldung eineseiner Nutzerin bei einer Instanz einer App. Sie wird auch als App-spezifische ID bezeichnet.
`lead_id` Lead-ID Integer	Nicht hashen. Die mit einem von Metas Lead Ads erstellten Lead verknüpfte ID.
`anon_id` String	Nicht hashen. Deine Installations-ID. Dieses Feld stellt individuelle Anwendungs-Installationsinstanzen dar. Hinweis: Dieser Parameter gilt nur für App-Events.
`madid` String	Deine Mobile Advertiser ID, die Android-Werbe-ID oder die Werbe-ID (IDFA) von einem Apple-Gerät.
`page_id` String	Nicht hashen. Deine Seiten-ID. Gibt die mit dem Event verknüpfte Seiten-ID an. Verwende die Facebook-Seiten-ID der Seite, die mit dem Bot verknüpft ist.
`page_scoped_user_id` String	Nicht hashen. Gibt die seitenspezifische Nutzungs-ID an, die dem Messenger-Bot zugeordnet ist, der das Ereignis protokolliert. Verwende die seitenspezifische Nutzungs-ID, die deinem Webhook zur Verfügung gestellt wurde.
`ctwa_clid` String	Nicht hashen. Von Meta generierte Klick-ID für Click-to-WhatsApp (Ad).
`ig_account_id` String	Nicht hashen. Instagram-Konto-ID, die mit dem Unternehmen verbunden ist.
`ig_sid` String	Nicht hashen. Nutzer*innen, die mit Instagram interagieren, werden durch Instagram-spezifische Nutzungs-IDs (IGSID, Instagram-Scoped User IDs) identifiziert. Die IGSID kann von diesem Webhook abgerufen werden.

Parameter für Kund*innen-Informationen

Pixel-Vergleich

Die user_data-Parameter formatieren

Siehe auch

Die `user_data`-Parameter formatieren