Send Journeys data to a Destination
Engage Foundations requires a Business tier account and includes Unify.
See the available plans, or contact Support.
When you send data to destinations, you send a series of events or user lists, depending on the destination type.
Before you begin
Ensure you have connected and enabled destinations in your Space.
Send data to destinations
- Add a Send to destinations step to the journey.
- Enter a Step name. This name should be descriptive of the users you send to the destination. For example,
New subscribed users
. Journeys generates a key based on the step name you enter. Destinations use this key to references the users that Journeys sends to it. For track events, the property name uses this key. For Identify events, the trait name uses the key. - Click Connect destinations to select the destination you’ll send the data to.
- Click Save.
To include an advertising destination in a Journey, ensure you have connected and enabled the destination within your Space, then utilize the Show an Ad step.
Test event payloads
With the Engage event tester, you can send a test event payload to a Destination. As a result, you can confirm that you’ve correctly configured Journey Audiences before you publish your Journey.
Follow these steps to send a test event:
- From the Send to destinations window, select + Add destination.
- Choose the Destination that you want to connect.
- In the Destination pane, select Event tester. This is only available for Event Destinations.
- From the Event Type drop-down, select the event you want to test. Segment generates a test user ID.
- Select Send Event, then view the test event results in the Event lifecycle section.
If your Destination successfully handled the event, Segment displays a 200 OK
HTTP status code along with the full response. If an error occurred, Segment displays any available details in the Event lifecyle section.
Use Trait Activation with Journeys
Use Trait Enrichment and ID Sync to configure sync payloads that you send from Journeys to your destination.
- With Trait Enrichment, use custom, SQL, computed, and predictive traits to enrich the data you map to your destinations.
- Use ID Sync to select identifiers and a sync strategy for the data you send to your destination.
To use Trait Activation with Journeys:
- Navigate to the Journeys builder of a new or existing Journey.
- Select a supported destination from a journey step.
- Select Customized Setup, then add identifier and trait mappings to customize the way you send data to your destination. For more, visit the Trait Enrichment and ID Sync setup docs.
Use Segment’s Duplicate mappings feature to create an exact copy of an existing mapping. The copied mapping has the same configurations and enrichments as your original mapping.
What events are sent to destinations?
The data type you send to a destination depends on whether the destination is an Event destination or a List destination.
To view the events that get generated by an Engage Space’s Journeys, navigate to Unify settings > Debugger to view the list of sources that are configured to generate events for each destination instance. Each source generates events only to its connected destinations. Under the source’s Debugger tab, you’ll find the most recent events generated by that source according the connected destinations’ audiences and computed traits.
The full JSON body of a journey event will have the journey’s specific details found under the context.personas
object. These fields can be useful when building out Destination Filters, Actions destination mappings, and Functions.
The integrations object in these payloads will appear as {"All" : false,}
and only list some destinations. This is due to the fact that each source has multiple destinations connected, while each journey may only have a subset of destinations connected to it. See Filtering with the Integrations Object for more information. The integrations object routing specific events to its specified destinations is also why a destination’s Delivery Overview tab will show a large number of events under the Filtered at destination box, as that destination will only receive the events intended to be sent to it according to the journeys that are connected to that specific destination.
Event destination
The format in which the destination receives updates depends on the call type.
Track calls
When the user enters the step:
{
"context": {
"personas": {
"computation_class": "audience", // the type of computation
"computation_id": "aud_###", // the audience's ID, found in the URL
"computation_key": "j_o_###", // the configured journey key that appears on user profile
"namespace": "spa_###", // the Engage Space's ID
"space_id": "spa_###" // the Engage Space's ID
}
},
"type": "track",
"event": "Audience Entered",
"properties": {
"j_o_first_purchase__opened_email_dje83h": "true"
}
}
Identify calls
When the user enters the step:
{
"context": {
"personas": {
"computation_class": "audience", // the type of computation
"computation_id": "aud_###", // the audience's ID found in the URL
"computation_key": "j_o_###", // the configured journey key that appears on user profile
"namespace": "spa_###", // the Engage Space's ID
"space_id": "spa_###" // the Engage Space's ID
}
},
"type": "identify",
"traits": {
"j_o_first_purchase__opened_email_dje83h": "true"
}
}
List destination
The destination receives a list of users who qualify for the associated journey step. Unlike lists associated with Engage Audiences, users who are added to a journey list cannot be subsequently removed. See best practices for techniques to suppress targeting with journey lists. List destinations do not have access to the Event tester.
For more information, see Using Engage Data.
This page was last modified: 11 Sep 2024
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!