Listrak (Actions) Destination
Listrak is the retail industry’s leading customer engagement platform. Listrak delivers results for more than 1,000 retailers by providing best-in-class email, text message marketing, identity resolution marketing and push notifications through seamless cross-channel orchestration. Listrak’s data-first approach delivers 1:1 personalization at scale so you can send messages at precisely the right time across the right combination of channels and devices to maximize customer engagement, revenue, and lifetime value.
Listrak maintains this destination. For any issues with the destination, contact the Listrak Support team.
Getting started
To add the Listrak Actions destination:
- Set up the Listrak Source first before connecting to the Listrak Actions Destination. Note the API client ID and client secret after creating the integration in Listrak.
- From your Segment workspace, go to Connections > Catalog and select the Destinations tab.
- Search for Listrak (Actions) in the Catalog and select the destination.
- Click Add destination.
- On the Select data source step, select your desired source. The source should not be a Listrak source. If you want to sync an Engage Audience, select the Engage space as the source. Click Confirm Source.
- On the Settings tab, name your destination. For example,
Listrak
. - In the same section of the Settings tab, enter your Listrak API client ID and client secret.
- Click Save Changes.
- Follow the steps in the Destinations Actions documentation to customize mappings or follow the steps below to Sync an Engage Audience.
- Enable the destination and click Save Changes.
Sync an Engage Audience
To sync an Engage audience with your Listrak (Actions) destination:
- Each Engage audience to be synced to Listrak must only include email addresses subscribed to the list. To do this, add a condition to the Engage audience that ensures the custom trait for the list exists (eg. have a Custom Trait listrak_list_12345 exists, where 12345 is the list ID).
- In Listrak, go to Contacts > Profile Fields and click Create Field Group.
- Enter a name for the Profile Field Group (eg.
Engage Audiences
) and Click Save. - Enter a name for the audience for the Field Name.
- Select Check Box for the Data Type.
- Click the Update button.
- Go to Help & Support > API ID Information and note the list ID and profile field ID.
- In Segment, open the previously created Listrak destination.
- In the Mappings tab, click New Mapping and select Update Email Contact Profile Fields.
- Under Select events to map and send, select Track for the Event Type.
- Click Add Condition and add this condition: Event Name is
Audience Entered
. - Click Add Condition and add this condition: Event Property
audience_key
ismy_audience
(wheremy_audience
is the Audience Key found on the Audience settings page). - Under Select mappings, enter the list ID and map the email address if
context.traits.email
is not desired. - Under Select mappings, in the section for mapping the
Profile Field Values
, enter the profile field ID for theEnter Key Name
textbox on the right andon
in the textbox for its value to the left. Click Save. - Repeat steps 9 through 14 using
Audience Exited
instead ofAudience Entered
in step 11 andoff
instead ofon
in step 14. - Enable both mappings.
- Go to the Settings tab for the destination and Enable the destination. Click Save Changes.
- Select the Engage space and navigate to Engage > Audiences. Select the source audience to send to the Listrak destination.
- Click Add Destination and select the Listrak Audience destination.
- In the settings that appear on the right-hand side, toggle the Send Track option on and disable Send Identify.
- Click Save.
- To filter email sends in Listrak using the new audience profile field, see the help article.
- Repeat steps 1 through 21, if you want to sync another audience.
Destination Settings
Setting | Description |
---|---|
API Client ID | Required. Your Listrak API client ID. Find this on the setup tab of your Segment integration under Integrations > Integrations Management in https://admin.listrak.com. |
API Client Secret | Required. Your Lisrak API client secret. Find this on the setup tab of your Segment integration under Integrations > Integrations Management in https://admin.listrak.com. |
Available Actions
Build your own Mappings. Combine supported triggers with the following Listrak-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Update Email Contact Profile Fields
One or more list imports will be started to update the specified contact profile fields on the specified list.
Update Email Contact Profile Fields is a Cloud action.
Field | Description |
---|---|
List ID* | Type: INTEGER Identifier used to locate the list. Find this under Help & Support > API ID Information in https://admin.listrak.com. |
Email Address* | Type: STRING Email address of the contact. |
Profile Field Values* | Type: OBJECT Add key value pairs to set one or more profile fields. The key is the profile field ID you want to set. Find this under Help & Support > API ID Information in https://admin.listrak.com. The value is the profile field value. (i.e. 1234 = on) |
Batch Data to Listrak* | Type: BOOLEAN When enabled, multiple events will be sent to Listrak in a single request, which is recommended for optimal performance. |
Engage
You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo.
For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true
. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Engage sets that value to false
.
When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.
Real-time to batch destination sync frequency
Real-time audience syncs to Listrak (Actions) may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.
Settings
Segment lets you change these destination settings from the Segment app without having to touch any code.
Setting | Description |
---|---|
API Client ID (required) |
string . Your Listrak API client ID. Find this on the setup tab of your Segment integration under Integrations > Integrations Management in https://admin.listrak.com. |
API Client Secret (required) |
password . Your Lisrak API client secret. Find this on the setup tab of your Segment integration under Integrations > Integrations Management in https://admin.listrak.com. |
This page was last modified: 06 May 2024
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!