Punkt-Referenz

Jeder Punkt enthält ein point_data-Objekt mit genau einem verschachtelten Schlüssel, der dem point_type des Punktes entspricht (siehe die Zuordnung von point-type → Schlüssel). Diese Seite dokumentiert die Struktur unter jedem Schlüssel.

Hinweis

Eintritts-, Timing-, Aufteilungs-, Aktions- und Konversionspunkte werden unten vollständig dokumentiert.

Für Messaging-Punkte (send_*, inapp) behandelt diese Seite nur die strukturellen Felder: auf welches Preset oder welchen Inhalt verwiesen werden soll und welche Kanaleinstellungen zu übergeben sind. Der Nachrichteninhalt selbst wird im Preset definiert und in der Presets API sowie in der Dokumentation der einzelnen Kanäle dokumentiert. Einige Felder verweisen auf verschachtelte Objekte, die die Steuerelemente im Customer Journey Builder widerspiegeln.

Eintrittspunkte

Eine Journey benötigt mindestens einen Eintrittspunkt. Alle Eintrittspunkte haben einen einzigen default-Ausgang.

start_by_segment

Fügt Benutzer hinzu, die einem Segment entsprechen. POINT_TYPE_START_BY_SEGMENT.

Feld	Typ	Beschreibung
application_code	string	Anwendungscode.
filter_code	string	Segment-/Filtercode, der die Zielgruppe definiert.
repeat	SegmentRepeat	Optionaler Zeitplan für wiederkehrende Eintritte (siehe SegmentRepeat).
start_at	timestamp	Nicht vor dieser Zeit verarbeiten (ISO 8601).
is_deactivated	bool	Gibt an, ob dieser Eintrittspunkt deaktiviert ist.

message_bus (Ereigniseintritt)

Fügt Benutzer hinzu, wenn sie ein Ereignis auslösen. POINT_TYPE_EVENT.

Feld	Typ	Beschreibung
event_name	string	Ereignisname, auf den gelauscht werden soll.
application_code	string	Anwendungscode.
event_conditions	PointEventCondition[]	Bedingungen, die mit den Attributen des Ereignisses abgeglichen werden.
active_period	Period	Zeitfenster, in dem der Auslöser aktiv ist.
multi_entry	MultiEntry	Wie ein Benutzer mehr als einmal eintreten kann (siehe MultiEntry).
attribute_entry	AttributeEntry	Registriert die Benutzer-IDs, die in einem Ereignisattribut enthalten sind, anstelle des Benutzers, der das Ereignis ausgelöst hat (siehe AttributeEntry).
allow_reenter	bool	Gibt an, ob Benutzer die Journey erneut betreten dürfen.

AttributeEntry

Registriert die Benutzer-IDs, die in einem Ereignisattribut enthalten sind, anstelle des Benutzers, der das Ereignis ausgelöst hat. Spiegelt Benutzer aus einem Ereignisattribut im Customer Journey Builder wider.

Feld	Typ	Beschreibung
enabled	bool	Gibt an, ob Benutzer registriert werden sollen, die in einem Ereignisattribut benannt sind, anstatt des Benutzers, der das Ereignis ausgelöst hat.
attribute_name	string	Name des Ereignisattributs, das die zu registrierende(n) Benutzer-ID(s) enthält.

start_by_api

Eintrittspunkt, der durch den Start by API-Aufruf gespeist wird. POINT_TYPE_START_BY_API.

Feld	Typ	Beschreibung
application_code	string	Anwendungscode.
attributes	string[]	Namen der benutzerdefinierten Attribute, die in den attribute_values einer Start by API-Anfrage übergeben werden können.
is_deactivated	bool	Gibt an, ob dieser Eintrittspunkt deaktiviert ist.

Timing-Punkte

delay (warten)

Pausiert jeden Benutzer für ein festes oder berechnetes Intervall. POINT_TYPE_WAIT. Das point_data.delay-Objekt setzt genau einen der folgenden Intervallschlüssel:

Intervallschlüssel	Typ	Beschreibung
sec	uint64	Eine feste Anzahl von Sekunden warten.
exact_time	ExactTime	Warten bis zu einer bestimmten Tageszeit (Stunde, Minute).
exact_date_time	ExactDateTime	Warten bis zu einem absoluten Datum und einer absoluten Uhrzeit.
exact_week_days_time	ExactWeekDaysTime	Warten bis zu bestimmten Zeiten an bestimmten Wochentagen (Zuordnung von Tag 0=Montag … 6=Sonntag → ExactTime).
dynamic_time	DynamicTime	Warten relativ zu einem Wert aus einem Tag oder Ereignis.

Ein dynamic_time mit split_branches: true fügt einen output1-Zweig hinzu (siehe Ausgabeschlüssel).

DynamicTime

Feld	Typ	Beschreibung
from	enum DynamicTimeFrom	Gibt an, ob die Basiszeit von einem Tag oder einem Ereignis stammt.
direction	enum DynamicTimeDirection	Versatz vor oder nach der Basiszeit.
duration	uint64	Größe des Versatzes.
unit	enum DynamicTimeUnit	Einheit von duration (Minuten, Stunden, Tage, …).
split_branches	bool	Benutzer in separate Zweige aufteilen, wenn sich ihre berechneten Zeiten unterscheiden.
tag_name	string	Tag, der die Basiszeit enthält (wenn from ein Tag ist).
event_name / event_attribute / point_id	string	Ereignisquelle der Basiszeit (wenn from ein Ereignis ist).

wait_event

Wartet, bis Benutzer ein Ereignis auslösen (oder ein Timeout eintritt). POINT_TYPE_WAIT_EVENT. Der default-Ausgang ist der nicht ausgelöste Pfad. Der ausgelöste Pfad ist output1 oder, mit einem Skript, ein Zweig pro Bedingung.

Feld	Typ	Beschreibung
events	PointWaitEventInfo[]	Ereignisse, auf die gewartet werden soll.
conditions_script	string	Optionales Skript für komplexe Logik mit mehreren Ereignissen. Die Namen der geparsten Bedingungen werden zu den Ausgabeschlüsseln.
multi_entry	MultiEntry	Verhalten bei Wiedereintritt.

Aufteilungs- und Filterpunkte

boolean_splitter

Leitet Benutzer basierend auf einer Bedingung in verschiedene Zweige weiter. POINT_TYPE_BOOLEAN_SPLITTER.

Feld	Typ	Beschreibung
split_strategy	enum	SPLIT_FILTER (nach Segment), SPLIT_TAGS (nach Tag-Bedingungen) oder SPLIT_EVENTS (nach Ereignisbedingungen).
load_policy	enum	ALL (jedes Gerät des Benutzers kann übereinstimmen) oder FILTER (nur das aktuelle Gerät).
filter_code	string	Segmentcode, wenn split_strategy SPLIT_FILTER ist.
filter_expressions	FilterExpression[]	Tag-Bedingungen, wenn split_strategy SPLIT_TAGS ist: ein zusätzlicher output-Zweig pro Ausdruck.
event	BooleanSplitterEventInfo	Ereignisbedingungen, wenn split_strategy SPLIT_EVENTS ist: ein zusätzlicher output-Zweig pro Bedingung.

ab_splitter

Teilt Benutzer zufällig in gewichtete Varianten auf. POINT_TYPE_AB_SPLITTER. Ausgabeschlüssel sind output0, output1, … (einer pro Eintrag in split, indiziert ab 0. Es gibt kein default).

Feld	Typ	Beschreibung
split	uint32[]	Prozentsatz für jeden Zweig. Muss in der Summe 100 ergeben. Index i wird dem Ausgabeschlüssel output{i} zugeordnet.
auto_select_winner	bool	Gibt an, ob automatisch ein gewinnender Zweig ausgewählt werden soll.
winner_strategy	enum	ANY_GOAL oder SPECIFIC_GOAL.
goal_uuid	string	Ziel, das zur Bestimmung des Gewinners verwendet wird (bei SPECIFIC_GOAL).
winner_split	uint32	Nummer des gewinnenden Zweigs (1-basiert, 0 = noch kein Gewinner).

filter

Lässt nur übereinstimmende Benutzer fortfahren (default) und leitet den Rest zu output1. POINT_TYPE_FILTER.

Feld	Typ	Beschreibung
filter	enum Filter	Eine vordefinierte Prüfung: EMAIL_EXISTS, PUSH_TOKEN_EXISTS, SMS_TOKEN_EXISTS, WHATSAPP_TOKEN_EXISTS, LINE_TOKEN_EXISTS oder CUSTOM.
filter_raw	string	Benutzerdefinierter Filterausdruck, wenn filter CUSTOM ist.

Aktionspunkte

set_tags

Aktualisiert Tags für den Benutzer. POINT_TYPE_SET_TAGS.

Feld	Typ	Beschreibung
application_code	string	Anwendungscode.
tags	Tag[]	Zu schreibende Tags.

Tag

Feld	Typ	Beschreibung
name	string	Tag-Name.
type	enum TagType	Datentyp und Operation: TYPE_STRING, TYPE_INTEGER, TYPE_DATE, TYPE_BOOLEAN, TYPE_LIST, TYPE_LIST_APPEND, TYPE_LIST_REMOVE, TYPE_DYNAMIC, …
value	oneof	Genau ein Werteschlüssel, der mit type übereinstimmt: str, int, bool, date, price, version, timezone, list oder dynamic.

web_hook

Sendet eine ausgehende HTTP-Anfrage. POINT_TYPE_WEBHOOK. Einzelner default-Ausgang.

Feld	Typ	Beschreibung
method	string	HTTP-Methode (GET, POST, PUT, …).
url	string	Ziel-URL.
request_template	string	Vorlage für den Anfragekörper. Unterstützt Liquid-Templating.
headers	map<string, string>	HTTP-Header.
disabled	bool	Schreibgeschützt. true, wenn Pushwoosh den Webhook nach wiederholten Fehlern automatisch deaktiviert hat.
reactivate	bool	Nur schreibbar. Setzen Sie true, um einen deaktivierten Webhook wieder zu aktivieren.

audience_sync

Fügt den Benutzer einer Meta Custom Audience hinzu oder entfernt ihn daraus. POINT_TYPE_AUDIENCE_SYNC.

Feld	Typ	Beschreibung
ad_account_id	string	Meta-Werbekonto-ID.
ad_account_name	string	Anzeigename für ad_account_id, nur für die Benutzeroberfläche.
audience_id	string	Meta Custom Audience ID.
audience_name	string	Anzeigename für audience_id, nur für die Benutzeroberfläche.
action	enum AudienceSyncAction	AUDIENCE_SYNC_ACTION_ADD oder AUDIENCE_SYNC_ACTION_REMOVE.

Vorsicht

Dies wird nicht überprüft, wenn Sie den Punkt erstellen oder aktualisieren – nur, wenn die Journey validiert oder gestartet wird. Eine ungültige ad_account_id (nicht mehr verbunden) oder audience_id (nicht von Meta zurückgegeben) wird ohne Fehler gespeichert und erst zu diesem Zeitpunkt angezeigt, nicht stillschweigend bei der Synchronisierung jedes Benutzers.

Konversionspunkte

goal_event

Verfolgt ein Konversionsziel. POINT_TYPE_GOAL_EVENT. Hat keine Ausgänge.

Feld	Typ	Beschreibung
event_name	string	Name des Zielereignisses.
application_code	string	Anwendungscode.
event_conditions	PointEventCondition[]	Bedingungen, die mit den Attributen des Zielereignisses abgeglichen werden.
is_throw_out	bool	Gibt an, ob der Benutzer aus der Journey entfernt werden soll, sobald das Ziel erreicht ist.
is_cancel_event	bool	Gibt an, ob dies ein negatives (Stornierungs-) Ziel ist.

Austrittspunkte

terminator

Beendet die Journey für den Benutzer. POINT_TYPE_EXIT. Leeres Objekt ({}) und keine Ausgänge.

{ "point_type": "POINT_TYPE_EXIT", "point_data": { "terminator": {} }, "outputs": [] }

Ein Terminator-Punkt ist optional. Wenn info.next_point_uuid eines Ausgangs nicht gesetzt wird, endet die Journey für den Benutzer auf die gleiche Weise wie bei einem expliziten Terminator – beide Fälle werden gleich gezählt, als Austritte, nicht als Fehler.

Messaging-Punkte

Alle Messaging-Punkte senden über einen Kanal und teilen sich einen gemeinsamen Umschlag. Jeder hat einen einzigen default-Ausgang, es sei denn, ein Splitter ist aktiviert (siehe Ausgabeschlüssel).

Gemeinsame Felder:

Feld	Typ	Beschreibung
application_code	string	Anwendungscode.
preset_code	string	Preset (Vorlage) zum Senden. inapp verwendet stattdessen richmedia_code.
content / title	string	Inline-Nachrichteninhalt, wenn kein Preset verwendet wird (kanalabhängig).
campaign_code	string	Kampagnencode für das Tracking. Wird automatisch erstellt, wenn er weggelassen wird.
split_params	BehaviorSplitter	Optional: auf eine Interaktion warten und darauf basierend verzweigen.
message_type	enum	Marketing vs. transaktional Nachrichtentyp (steuert die Behandlung von Kontrollgruppen). Wird nicht von send_email verwendet, das sein eigenes email_type/email_category-Paar unten hat.

Punkttypen und ihre bemerkenswerten zusätzlichen Felder:

Punkttyp	point_data-Schlüssel	Hinweise
POINT_TYPE_SEND_PUSH	send_push	split_params (Verhalten) plus ein Zustellungs-Splitter können bis zu drei Ausgänge erzeugen. send_by_user_id, wait_optimal_time.
POINT_TYPE_SEND_EMAIL	send_email	liquid_template_params, personalise, email_type, email_category (siehe unten). Siehe die Email API.
POINT_TYPE_SEND_SMS	send_sms	Siehe SMS.
POINT_TYPE_SEND_WHATSAPP	send_whatsapp	personalise (siehe unten). Ein Schnellantwort-Preset fügt einen Ausgang pro Antwort hinzu (Schlüssel = Antwortwert). Siehe WhatsApp.
POINT_TYPE_SEND_TELEGRAM	send_telegram	Telegram-Kanal.
POINT_TYPE_SEND_KAKAO	send_kakao	Siehe Kakao.
POINT_TYPE_SEND_LINE	send_line	Siehe LINE API.
POINT_TYPE_SEND_DATA	send_data	Stille Datennachricht (keine Benutzeroberfläche).
POINT_TYPE_INAPP	inapp	Verwendet richmedia_code, expire_in_days, capping.

Vorsicht

Bei send_email muss email_type weggelassen oder auf genau marketing oder transactional gesetzt werden – in Kleinbuchstaben, jeder andere Wert wird abgelehnt. email_category ist erforderlich, wenn email_type marketing ist, und muss der Code einer bestehenden Kategorie sein, nicht ihr Anzeigename.

Bei send_whatsapp muss ein personalise.placeholders[]-Eintrag mit type: "MPM" (Multi-Product-Message) actions.actions[].type auf genau action gesetzt haben – der einzige Aktionstyp, den Meta in einer MPM-Vorlagenschaltfläche akzeptiert. Jeder andere Wert wird abgelehnt.

Nichts davon wird überprüft, wenn Sie den Punkt erstellen oder aktualisieren – nur, wenn die Journey validiert oder gestartet wird. Ein ungültiger Wert wird ohne Fehler gespeichert und erst zu diesem Zeitpunkt angezeigt.

Gemeinsame Typen

SegmentRepeat

Feld	Typ	Beschreibung
enabled	bool	Gibt an, ob der wiederkehrende Eintritt aktiviert ist.
frequency	string	daily, weekly, monthly oder dates.
every	uint32	Alle N Perioden wiederholen.
dates	string[]	Spezifische Daten, wenn frequency dates ist.
time	SegmentRepeatTime	Tageszeit-Konfiguration.

Zeitobjekte

• ExactTime: { "hour": 0–23, "minute": 0–59 }.
• ExactDateTime: { "year", "month": 1–12, "day": 1–31, "hour": 0–23, "minute": 0–59 }.

BehaviorSplitter

Feld	Typ	Beschreibung
enabled	bool	Gibt an, ob auf eine Interaktion gewartet und darauf basierend verzweigt werden soll.
interval	uint64	Sekunden, die auf die Interaktion gewartet werden soll.

MultiEntry

Steuert, wie viele aktive Sitzungen ein Benutzer gleichzeitig in der Journey haben kann. Spiegelt Steuern, wie viele Sitzungen ein Benutzer gleichzeitig haben kann im Customer Journey Builder wider. Wird vom Ereigniseintrittspunkt und wait_event verwendet.

Feld	Typ	Beschreibung
enabled	bool	Gibt an, ob ein Benutzer mehrere aktive Sitzungen gleichzeitig haben kann. false: eine aktive Sitzung pro Benutzer. true: mehrere aktive Sitzungen pro Benutzer.
attribute_name	string	Optional. Ereignisattribut, das den Geltungsbereich jeder Sitzung festlegt. Wenn gesetzt, kann ein Benutzer eine aktive Sitzung pro eindeutigem Wert dieses Attributs haben (z. B. eine pro order_id). Ereignisse mit demselben Wert teilen sich eine Sitzung. Leer lassen, um alle Einträge des Benutzers zusammenzufassen.

Verwandte Themen

Journey-Objekt

Erstellen und aktualisieren

Presets API