Überblick
Der Universal Data Mapper ist ein konfigurierbares Mapping-Tool innerhalb Ihrer Integrationen. Er erlaubt es Ihnen, Lead-Daten (Standard- und Custom-Felder) auf die Felder eines externen Systems abzubilden – inklusive Bedingungen, festen Werten, Platzhaltern und automatischer Typumwandlung.
Schritt-für-Schritt-Anleitung
- Navigieren Sie zu Einstellungen → Integrationen und öffnen Sie die gewünschte Integration.
- Scrollen Sie zum Abschnitt „Custom Data Mapping".
- Klicken Sie auf „Add new Lead Data Mapping", um eine neue Zuordnung zu erstellen.
- Wählen Sie im Dropdown „Parameter" das Lead-Feld aus, das Sie zuordnen möchten (z.B. Vorname, E-Mail oder ein Custom-Feld).
- Fügen Sie eine oder mehrere Bedingungen (Conditions) hinzu, um festzulegen, wie der Wert übertragen werden soll.
- Speichern Sie die Integration – das Mapping wird automatisch mitgespeichert.
Welche Operatoren / Bedingungen stehen zur Verfügung?
Jede Mapping-Zeile kann eine oder mehrere Bedingungen enthalten. Folgende Operatoren stehen zur Auswahl:
| Operator | Beschreibung | Beispiel |
|---|---|---|
| Just Map (map) | Direkte 1:1-Zuordnung des Lead-Feldes auf das Zielfeld. Der Wert wird unverändert übernommen. | Lead-Feld email → Zielfeld contact_email |
| Is Equal (equal) | Der Wert wird nur übertragen, wenn das Lead-Feld exakt dem angegebenen Vergleichswert entspricht. Unterstützt auch is_empty für leere Felder. |
Wenn gender = male → Zielfeld anrede = Herr |
| It Contains (contains) | Der Wert wird übertragen, wenn das Lead-Feld den angegebenen Text enthält. Mehrere Suchbegriffe können kommagetrennt angegeben werden. | Wenn city enthält Berlin,Hamburg → Zielfeld region = Nord |
| Fix Param (fix_param) | Überträgt einen festen, statischen Wert – unabhängig vom Lead-Inhalt. Ideal für API-Keys, Kampagnen-IDs oder konstante Werte. | Zielfeld source = leadnodes (immer) |
Wie funktionieren die Eingabefelder einer Bedingung?
Jede Bedingung besteht aus bis zu vier Feldern:
-
Operator – Wählen Sie die Bedingungsart (siehe Tabelle oben).
-
Lead-Wert (links oben) – Bestimmt, welcher Wert verglichen wird:
- Lead Value – Der tatsächliche Wert des Lead-Feldes
- Is Empty – Prüft, ob das Feld leer ist
- Fix Param – Ein fester Vergleichswert
- Custom Value – Eigene Texteingabe als Vergleichswert
-
Ziel-Parameter (links unten) – Der Feldname im externen System. Wählen Sie aus Preset-Feldern oder geben Sie einen eigenen Feldnamen ein (Custom Value).
-
Ziel-Wert (rechts unten) – Der Wert, der übertragen wird:
- Lead Value – Der originale Lead-Wert
- Custom Value – Ein eigener, fester Wert
- Preset Values – Vordefinierte Werte der Integration
Wie kann ich den Datentyp eines Parameters ändern (Type Casting)?
Standardmäßig werden alle Werte als Text (String) übertragen. Viele externe Systeme erwarten jedoch bestimmte Datentypen wie Ganzzahlen oder Wahrheitswerte. Der Data Mapper bietet hierfür das Präfix-System:
Setzen Sie im Ziel-Parameter (Custom Value) einen Typ-Präfix vor den Feldnamen, getrennt durch einen Punkt:
| Präfix | Datentyp | Eingabe im Ziel-Parameter | Ergebnis |
|---|---|---|---|
int. |
Ganzzahl (Integer) | int.anzahl_personen |
"anzahl_personen": 3 |
integer. |
Ganzzahl (Integer) | integer.menge |
"menge": 5 |
arrayint. |
Ganzzahl (Integer) | arrayint.category_id |
"category_id": 42 |
bool. |
Wahrheitswert (Boolean) | bool.is_active |
"is_active": true |
boolean. |
Wahrheitswert (Boolean) | boolean.opt_in |
"opt_in": false |
float. |
Dezimalzahl (Float) | float.preis |
"preis": 19.99 |
double. |
Dezimalzahl (Float) | double.betrag |
"betrag": 100.50 |
string. |
Text (String) | string.plz |
"plz": "01234" |
array. |
Array | array.tags |
"tags": [...] |
unix_timestamp_int. |
Unix-Zeitstempel (Zahl) | unix_timestamp_int.created |
"created": 1710240000 |
unix_timestamp_string. |
Unix-Zeitstempel (Text) | unix_timestamp_string.datum |
"datum": "1710240000" |
Wichtig: Der Präfix wird beim Export automatisch entfernt – im externen System erscheint nur der Feldname nach dem Punkt.
Automatische Boolean-Erkennung
Wenn Sie als Ziel-Wert exakt true oder false (kleingeschrieben) eingeben, wird der Wert automatisch als Wahrheitswert übertragen – ohne dass ein Präfix nötig ist.
Welche Platzhalter kann ich verwenden?
In Ziel-Werten (Custom Value) können Sie Platzhalter verwenden, die beim Export automatisch durch die echten Lead-Daten ersetzt werden:
Lead-Platzhalter
| Platzhalter | Beschreibung |
|---|---|
[lead.id] |
Lead-ID |
[lead.salutation] |
Anrede |
[lead.first_name] |
Vorname |
[lead.last_name] |
Nachname |
[lead.street_no] |
Straße und Hausnummer |
[lead.zip_code] |
Postleitzahl |
[lead.city] |
Stadt |
[lead.phone] |
Telefonnummer |
[lead.email] |
E-Mail-Adresse |
[lead.birth_date] |
Geburtsdatum |
Lead-Typ-Platzhalter
| Platzhalter | Beschreibung |
|---|---|
[lead.type.short_code] |
Kurzcode des Lead-Typs |
[lead.type.name] |
Name des Lead-Typs |
Lieferanten-Platzhalter (Supplier)
| Platzhalter | Beschreibung |
|---|---|
[supplier.company] |
Firmenname |
[supplier.salutation] |
Anrede |
[supplier.first_name] |
Vorname |
[supplier.last_name] |
Nachname |
[supplier.phone] |
Telefonnummer |
[supplier.email] |
E-Mail-Adresse |
Käufer-Platzhalter (Buyer)
| Platzhalter | Beschreibung |
|---|---|
[buyer.company] |
Firmenname |
[buyer.salutation] |
Anrede |
[buyer.first_name] |
Vorname |
[buyer.last_name] |
Nachname |
[buyer.phone] |
Telefonnummer |
[buyer.email] |
E-Mail-Adresse |
Custom-Data-Platzhalter
Für benutzerdefinierte Felder verwenden Sie das Format: [lead.data.feldname]
Beispiel: Wenn Ihr Lead ein Custom-Feld stromverbrauch hat, verwenden Sie [lead.data.stromverbrauch].
Unterstützt auch Umlaute und Sonderzeichen im Feldnamen (z.B. [lead.data.wärmepumpe]).
Kann ich Platzhalter in Texten kombinieren?
Ja! Sie können Platzhalter in beliebigen Texten einbetten. Beispiel:
Sehr geehrte/r [lead.first_name] [lead.last_name] aus [lead.city]
Dies wird beim Export automatisch zu z.B. Sehr geehrte/r Max Mustermann aus Berlin aufgelöst.
Weitere häufig gestellte Fragen
Kann ich mehrere Bedingungen pro Parameter anlegen?
Ja. Klicken Sie auf das Plus-Symbol (+) neben einer bestehenden Bedingung, um weitere Bedingungen hinzuzufügen. So können Sie z.B. mehrere „Is Equal"-Regeln für verschiedene Werte desselben Feldes definieren (z.B. unterschiedliche Anreden je nach Geschlecht).
Was passiert, wenn keine Bedingung zutrifft?
Wenn keine der konfigurierten Bedingungen für einen Parameter erfüllt ist, wird kein Wert für dieses Feld an das externe System übertragen. Es wird also nichts Falsches gesendet – das Feld wird einfach übersprungen.
Was bedeutet die Anzeige „Auto-mapped" unter dem Mapping?
Einige Integrationen haben vordefinierte Standard-Zuordnungen, die automatisch übertragen werden (z.B. Vorname → first_name). Diese werden unterhalb des Mappings unter „Auto-mapped" angezeigt. Sie müssen diese Felder nicht manuell im Data Mapper konfigurieren.
Warum wird mein Wert als Text statt als Zahl übertragen?
Standardmäßig werden alle Werte als Text gesendet. Um einen Wert als Zahl zu senden, verwenden Sie das Präfix-System: Geben Sie im Ziel-Parameter z.B. int.feldname ein (siehe Abschnitt „Type Casting" oben). Der Präfix int. wird beim Export entfernt und der Wert automatisch in eine Ganzzahl umgewandelt.
Kann ich Felder aus verschiedenen Lead-Typen zuordnen?
Ja. Im Parameter-Dropdown werden Ihnen sowohl die Standard-Lead-Felder (Vorname, E-Mail, etc.) als auch alle Custom-Felder Ihrer Lead-Typen angezeigt. Custom-Felder sind mit dem jeweiligen Lead-Typ-Kurzcode gekennzeichnet (z.B. PV > stromverbrauch).
]]>