You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/engage/journeys/event-triggered-journeys-steps.md
+10-11Lines changed: 10 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -7,27 +7,24 @@ plan: engage-foundations
7
7
8
8
Steps are the building blocks of a journey. This page explains the the **Hold Until** and **Send to Destination** steps, which enable precise control over journey progression and data delivery.
9
9
10
-
This guide explains how these steps work, their key features, and best practices for using them effectively.
11
-
12
10
> info "Public Beta"
13
11
> Event-Triggered Journeys is in public beta, and Segment is actively working on this feature. Some functionality may change before it becomes generally available. Event-Triggered Journeys is not currently HIPAA eligible.
14
12
15
13
## Hold Until: smart pauses in journeys
16
14
17
-
The **Hold Until** step adds a deliberate pause in a journey, waiting for specific user actions or a predefined time limit before progressing. This lets you create highly personalized experiences by responding to user behavior—or lack thereof—at the right moment.
18
-
19
-
Because the hold until step introduces a checkpoint in your journey where the next action depends on user behavior, it creates opportunities for:
15
+
The **Hold Until** step adds a deliberate pause in a journey, waiting for specific user actions or a predefined time limit before progressing. This lets you create highly personalized experiences by responding to user behavior (or the lack thereof) at the right moment.
20
16
17
+
Because the Hold Until step introduces a checkpoint in your journey where the next action depends on user behavior, it creates opportunities for:
21
18
- Personalization, by tailoring user interactions based on their actions.
22
19
- Efficiency, helping you avoid sending irrelevant messages by waiting for meaningful triggers.
23
20
24
21
### How Hold Until works
25
22
26
-
When a journey reaches a hold until step:
23
+
When a journey reaches a Hold Until step:
27
24
28
25
1. It pauses and waits for one of the configured events to occur.
29
-
2. If the event occurs, the instance moves down the corresponding branch immediately.
30
-
3. If no event occurs within the specified time, the instance moves down the default "maximum hold duration" branch.
26
+
2. If the event occurs, the journey moves down the corresponding branch immediately.
27
+
3. If no event occurs within the specified time, the journey moves down the default maximum hold duration branch.
31
28
32
29
### Configurable parameters
33
30
@@ -37,19 +34,21 @@ The following table explains the parameters you can configure for the Hold Until
| Branches | Configure up to 4 event branches, each tied to a specific event and optional event property filters. <br> Events must share a unique identifier with the entry event if the journey allows re-entry. <br> Branches must be mutually exclusive to avoid validation errors. |
39
36
| Filters | Event properties refine the triggering conditions for a branch. |
40
-
| Maximum hold duration | The fallback branch activates after the hold period, ranging from 5 minutes to 182 days (approximately 6 months) |
37
+
| Maximum hold duration | The fallback branch activates after the hold period, ranging from 5 minutes to 182 days (about 6 months) |
41
38
42
39
### Additional features
43
40
41
+
The Hold Until step includes optional settings that let you customize how Segment stores and processes events in your journey. These features give you more control over event timing, data inclusion, and journey logic.
42
+
44
43
#### Send profiles back to the beginning of this step
45
44
46
45
The Hold Until step can restart when a specified event reoccurs. This resets the hold duration and updates the [journey context](/docs/engage/journeys/journey-context/) with the most recent event data.
47
46
48
47
When the same event occurs again, the hold timer resets, and Segment updates the journey context with the latest event data. However, Segment only includes events in the journey context if the profile follows the branch where the event was processed.
49
48
50
-
For example, in an abandoned cart journey, if a user modifies their cart during the hold period, the cart contents are updated, and the two-hour timer resets. This prevents premature follow-ups and ensures the latest data is used.
49
+
For example, in an abandoned cart journey, if a user modifies their cart during the hold period, the cart contents are updated and the two-hour timer resets. This prevents premature follow-ups and keeps the data up-to-date.
51
50
52
-
Enable this feature by selecting **Send profiles back to the beginning of this step each time this branch event occurs** in the step configuration. For more details about how journey context handles triggering events, see [Destination Event Payload Schema](/docs/engage/journeys/event-triggered-journeys-steps#destination-event-payload-schema).
51
+
Enable this feature by selecting **Send profiles back to the beginning of this step each time this branch event occurs** in the step configuration. For more details about how journey context handles triggering events, see [Destination event payload schema](/docs/engage/journeys/event-triggered-journeys-steps#destination-event-payload-schema).
53
52
54
53
Segment recommends putting branches for recurring events at the top of the list to improve readability.
0 commit comments