Mapping: Zuordnung von Journey Daten zu Entitäten
Inhaltsverzeichnis
Übersicht
Im folgenden Artikel geht es um die flexible Zuordnung von Daten aus Journeys zu Entitäten. Damit können Daten aus Journey-Blöcken in die gewünschten Felder von Entitäten gespeichert werden, die wiederum mittels des Entitäten Builders flexibel angelegt werden können. Mit dieser Funktion kannst du sicherstellen, dass alle Blockdaten aus einer Journey an den richtigen Stellen in den verschiedenen Entitäten landen.
In dieser Dokumentation konzentrieren wir uns nicht auf die „erweiterten Zuordnungen“ über JSON-Syntax, sondern auf die Benutzeroberfläche, die die Datenquellen auf eine No-Code Weise darstellt.
Die Dokumentation zu den erweiterten Zuordnungen findest du hier.
Zentrale Begriffe
Begriff | Beschreibung |
Aktion |
Ein einzelner Schritt innerhalb der Ausführung eines automatisierten Workflows. Es gibt verschiedene Aktionstypen, wobei im Rahmen dieser Dokumentation hauptsächlich der Aktionstyp „Entity Mapping“ behandelt wird. |
Zielentität |
Die Entität, in der die zugeordneten Daten gespeichert werden sollen (z. B. Kontakt, Opportunity). |
Zuordbares Element |
Der Ursprung der Daten – etwa ein Block einer Journey oder ein zuvor zugeordnetes Attribut. Je nach gewähltem Modus („Zuordnungen“ oder „Beziehungen“) ändern sich die verfügbaren Elemente.
|
Attribut-Zuordnung |
Legt fest, welches Quellfeld auf welches Attribut der Entität abgebildet wird. Unsere APIs identifizieren dabei den Wert über den definierten Pfad und kopieren ihn in das Zielattribut. |
Verknüpfung-Zuordnung |
Definiert, welche Quell-Entität oder welches Quellattribut mit dem „Relation“-Tab einer Zielentität oder einem bestimmten Attribut in Beziehung steht. Mehr dazu im Abschnitt „Mappings vs. Relations“. |
Eindeutiges Merkmal |
Bestimmt, unter welcher Bedingung eine neue Entität erstellt oder eine bestehende aktualisiert wird. |
Automatische Zuordnungen |
Wenn die Benutzeroberfläche aus dem Journey Builder heraus geöffnet wird, werden bestimmte Änderungen automatisch mit der Automatisierung synchronisiert. Zum Beispiel wird beim Hinzufügen eines Blocks für persönliche Informationen automatisch eine entsprechende Kontakt-Aktion erstellt. |

Funktionsweise
Die in einer Journey erfassten Daten werden beim Abschicken der Journey durch die Journey-NutzerInnen, mittels der Journey-Automatisierung verarbeitet und in den erstellten Entitäten gespeichert. Einige Journey-Blöcke sind dabei mit einer standardisierten und systemrelevanten Daten-Zuordnung versehen, da diese entweder für die Erstellung der Entitäten erforderlich sind oder ihre Daten strukturiert auf erstellten Entitäten gespeichert werden.
-
Benutzeroberfläche aufrufen:
Öffne die Benutzeroberfläche direkt aus dem Journey Builder über den Button „Automatisierung“. Jede Journey verfügt über eine Standardautomatisierung, die ausgelöst wird, sobald eine Journey eingereicht wurde. -
Aktion auswählen:
Wähle eine bestehende Aktion aus oder erstelle eine neue Aktion vom Typ „Entität erstellen/editieren“. Anschließend legst du fest, welche Zielentität erstellt oder – abhängig vom gewählten eindeutigen Merkmal – aktualisiert werden soll. -
Daten zuordnen:
Wähle eine Datenquelle aus dem Bereich Zuordbare Elemente auf der rechten Seite. In der Mitte wird eine leere Zuordnung angezeigt. Weise nun jedes Feld deines Elements dem entsprechenden Attribut der Zielentität zu.
Optional: Lege ein eindeutiges Merkmal fest, um zu bestimmen, unter welchen Bedingungen eine vorhandene Entität aktualisiert wird.

Hinweis
Um aus einer Journey mehrere Kontakte oder Firmen zu erstellen, sind mehrere "Persönliche Informationen"-Blöcke erforderlich, die jeweils eine eigene Zuordnung besitzen. Benutzereingaben, die bisher keiner Entität zugeordnet wurden, werden unter "Metadaten" oder in der Entität "Submission" gespeichert.
Beispiel für die Zuordnung eines individuell erstellten Attributes
Familienstand soll in der Journey abgefragt und im Kontakt gespeichert werden:
- Konfiguration im Entitäten Builder
- Entität Kontakt auswählen
- Gruppe persönliche Informationen öffnen
- Attribut Familienstand hinzufügen
- Konfiguration in der Journey
- Schritt Persönliche Angaben auswählen
- Block mit Mehrfachauswahl (ledig, verheiratet und keine Angabe) öffnen
- Zuordnung der Journey Daten zum Kontakt
- Entität Kontakt anklicken
- Zu verknüpfender Block auswählen
- Attribut Familienstand aus Schritt 2 zuordnen
- Eingaben speichern
Beim Abschicken der Journey wird die Information zum Familienstand aus der Journey im Attribut Familienstand des Kontakts gespeichert.
Label für weitere Kontakte im Journey Builder vergeben
Im Persönliche Informationen-Block hast du im Abschnitt "Verarbeitung" die Möglichkeit, ein oder mehrere Label(s) für einen weiteren Kontakt zu vergeben, die nicht der jeweilige Kunde/Auftraggeber sind (z. B. ein Architekt oder Installateur). Hierfür muss die entsprechende Option deaktiviert sein.

Dies hilft dir bei der Unterscheidung zwischen den verschiedenen Kontakten und ist vor allem dann sinnvoll, wenn z. B. eine Opportunity mit mehreren Kontakten verknüpft ist und du Variablen für das Erstellen von Dokument- oder E-Mail-Vorlagen verwendest.
Verknüpfung von Entitäten
Diese unterscheiden sich von klassischen Zuordbaren Elementen darin, dass Zuordbare Elemente direkt von dem Automatisierungs-Trigger abhängen – bei einer Journey also von den enthaltenen Journey-Blöcken.
Verknüpfbare Elemente hingegen basieren auf zuvor zugeordneten Daten oder Entitäten, die in vorherigen Aktionen derselben Automatisierung erstellt wurden – einschließlich hochgeladener Dateien. Das bedeutet:
- Du kannst eine in Aktion 1 erstellte Entität in einer späteren Aktion (z. B. Aktion 2) referenzieren oder verknüpfen – aber nicht umgekehrt.
- Du kannst zuvor zugeordnete Attribute in “Relations-Attribute” nachfolgender Aktionen übernehmen.
Beispiel: Eine Adresse, die in einer früheren Aktion einem Kontakt zugeordnet wurde, kann in einer späteren Aktion einer Opportunity als Adress-Relation hinzugefügt werden. Gleiches gilt für Zahlungsmethoden. - Du kannst Dateien, die auf der Submission-Entität erstellt wurden, mit anderen Zielentitäten verknüpfen.
Mit Verknüpfungen stellst du sicher, dass Entitäten logisch miteinander verbunden bleiben – auch wenn sie in unterschiedlichen Schritten der Automatisierung entstehen.
Veranschaulichung:
Die folgende Darstellung zeigt, dass:
- der in Aktion 1 erstellte Kontakt (3)
- mit seiner Adresse aus dem Attribut „Adresse“ (3)
- und der Zahlungsmethode aus dem Attribut „Zahlungsmethode“ (3)
in Aktion 3 mit der erstellten Opportunity (1) verknüpft wird – und zwar wie folgt:
- Die Adresse des Kontakts wird als Rechnungsadresse und Lieferadresse in der Opportunity hinterlegt (2).
- Die Zahlungsmethode des Kontakts wird als Zahlungsmethode der Opportunity übernommen (2).
So wird sichergestellt, dass alle relevanten Beziehungen automatisch zwischen den Entitäten hergestellt werden.

Frage und Antwort (FAQ)
Frage | Antwort |
Bleiben meine Zuordnungen erhalten, wenn ich Blöcke in der Journey umbenenne oder neu anordne? | Ja, die Zuordnungen bleiben bestehen. Wenn sich ein Journey-Block ändert, wird der Quellpfad automatisch angepasst, sodass die Verbindung weiterhin korrekt ist. |
Warum wird eine bestimmte Relation als „primär“ angezeigt? | Die erste Relation, die einer Entität hinzugefügt wird, erscheint standardmäßig als primäre Relation. Es wird jedoch empfohlen, Relationen sinnvoll zu benennen, anstatt sich auf diese Reihenfolge zu verlassen. |