Listrak (Actions) Destination

Destination Info
Partner Owned
  • This integration is partner owned. Please reach out to the partner's support for any issues.

The Listrak Destination is in beta, and Listrak is still developing the destination. To join Listrak’s beta program or to give any feedback to help improve the Listrak Destination and its documentation, let Listrak know.

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:

  1. 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.
  2. From your Segment workspace, go to Connections > Catalog and select the Destinations tab.
  3. Search for Listrak (Actions) in the Catalog and select the destination.
  4. Click Add destination.
  5. 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.
  6. On the Settings tab, name your destination. For example, Listrak.
  7. In the same section of the Settings tab, enter your Listrak API client ID and client secret.
  8. Click Save Changes.
  9. Follow the steps in the Destinations Actions documentation to customize mappings or follow the steps below to Sync an Engage Audience.
  10. Enable the destination and click Save Changes.

Sync an Engage Audience

To sync an Engage audience with your Listrak (Actions) destination:

  1. 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).
  2. In Listrak, go to Contacts > Profile Fields and click Create Field Group.
  3. Enter a name for the Profile Field Group (eg. Engage Audiences) and Click Save.
  4. Enter a name for the audience for the Field Name.
  5. Select Check Box for the Data Type.
  6. Click the Update button.
  7. Go to Help & Support > API ID Information and note the list ID and profile field ID.
  8. In Segment, open the previously created Listrak destination.
  9. In the Mappings tab, click New Mapping and select Update Email Contact Profile Fields.
  10. Under Select events to map and send, select Track for the Event Type.
  11. Click Add Condition and add this condition: Event Name is Audience Entered.
  12. Click Add Condition and add this condition: Event Property audience_key is my_audience (where my_audience is the Audience Key found on the Audience settings page).
  13. Under Select mappings, enter the list ID and map the email address if context.traits.email is not desired.
  14. Under Select mappings, in the section for mapping the Profile Field Values, enter the profile field ID for the Enter Key Name textbox on the right and on in the textbox for its value to the left. Click Save.
  15. Repeat steps 9 through 14 using Audience Exited instead of Audience Entered in step 11 and off instead of on in step 14.
  16. Enable both mappings.
  17. Go to the Settings tab for the destination and Enable the destination. Click Save Changes.
  18. Select the Engage space and navigate to Engage > Audiences. Select the source audience to send to the Listrak destination.
  19. Click Add Destination and select the Listrak Audience destination.
  20. In the settings that appear on the right-hand side, toggle the Send Track option on and disable Send Identify.
  21. Click Save.
  22. To filter email sends in Listrak using the new audience profile field, see the help article.
  23. 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.

Click to show / hide fields

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: 18 Jan 2024



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account