Send data to Listrak

Listrak enables personalized cross-channel interactions that help automate campaigns, build customer loyalty, and increase conversion rates.

How this destination works

Amperity can manage email and SMS lists in Listrak. You can send email and SMS lists to Listrak using any of the following processes:

Additional attributes may be appended using any of these processes.

Amperity automatically adds a field attribute to all contact lists that are sent to Listrak. This field is located inside a field group named “Amperity Message Attributes” within Listrak.

Send email and SMS lists to Listrak to automate downstream workflows.

An Listrak destination works like this:

  1. Use a query or segment to build a list of email addresses or phone numbers for whom you have opt-in/out data.

  2. Configure a destination for sending lists of email addresses and phone numbers to Listrak using your preferred workflow: API or SFTP.

    Listrak prefers to use a single list for managing email addresses and phone numbers. These lists are named “Master List” by default within Listrak. This is the name of the list that is most often managed when data is sent to Listrak from Amperity.

  3. Send a test from Amperity using your preferred workflow, and then from within Listrak verify that the email and phone lists are updated.

    Tip

    Lists are available from the Contacts page within the Listrak user interface. If you are not sure which list (or lists) should be managed by Amperity, work with your Listrak representative to determine the best approach for list management.

  4. Use email lists to build responsive email campaigns.

  5. Use SMS lists to grow your mobile list and engage with your customers.

Email and SMS APIs

Use Amperity to manage email address and phone number lists in Listrak using the Listrak Email API or Listrak SMS API .

Build a query or segment that returns an email field or phone field, and then send that list to Listrak.

Get details

Listrak requires the following configuration details:

Detail one.

A client ID and secret for an email integration and/or a client ID and secret for an SMS integration. These integrations must already be set up in Listrak.

Important

The Amperity IP address for allowlists must also be added to the allowlist of the Listrak integration.

Detail one.

The name of the list that will be managed in Listrak. This is often, but not always, named “Master List”.

Detail one.

A query or segment that returns a list of email addresses or phone numbers.

Add destination

Configure Amperity to send audience lists directly to Listrak.

Note

You may append additional profile attributes to the query or segment that you use to build the list of email addresses or phone numbers.

To add a destination

Step 1.

Open the Destinations tab to configure a destination for Listrak. Click the Add Destination button to open the Destination dialog box.

Name, description, choose plugin.

Enter a name for the destination and provide a description. For example: “Listrak” and “This sends audience lists to Listrak”.

From the Plugin drop-down, start typing “lis” to filter the list, and then select Listrak.

Step 2.

Credentials allow Amperity to connect to Listrak.

The credential type is set automatically. You may use an existing credential or you may add a new one.

Choose an existing credential or add credential.

Select an existing credential from the Credential drop-down.

– or –

Select Create a new credential from the Credential drop-down. This opens the Credential dialog box.

Choose an existing credential or add credential.

Enter the name for the credential, and then add a description.

Listrak has the following settings:

  • A client ID and secret for an email integration that is already set up in Listrak.

  • A client ID and secret for an SMS integration that is already set up in Listrak.

When finished, click Save.

Step 3.

Each destination has settings that define how Amperity will deliver data to Listrak. These settings are listed under the Settings section of the Destination dialog box.

Settings for Listrak.

The following settings are specific to Listrak:

Setting

Description

List name

The name of the list that will be managed in Listrak. This is often, but not always, named “Master List”.

Step 4.

Business users are assigned to the Amp360 User and/or AmpIQ User policies. (Amp360 User allows access to queries and orchestrations and AmpIQ User allows access to segments and campaigns.) A business user cannot select a destination that is not visible to them.

Business users – including users assigned to the DataGrid Operator policy – may have restricted access to PII.

What is restricted access to PII?

Restricted PII access is enabled when the Restrict PII access policy option that prevents users who are assigned to that option from viewing data that is marked as PII anywhere in Amperity and from sending that data to any downstream workflow.

You can make this destination visible to orchestrations and allow users with restricted access to PII to use this destination by enabling one (or both) of the following options:

Allow business users access to this destination.

Note

To allow business users to use this destination with campaigns, you must enable the Available to campaigns option within the data template. This allows users to send campaign results from Amperity to Listrak.

The other two settings may be configured within the data template instead of the destination.

Step 5.

Review all settings, and then click Save.

Save the destination.

Important

You must configure a data template for this destination before you can send data to Listrak.

SFTP

Configure Amperity to send email addresses and/or phone numbers to Listrak using SFTP. This option uses the SFTP destination that is built into Amperity and should follow the steps and requirements that are outlined in the Listrak file import guide .

You can use SFTP to send the following sets of data to Listrak.

  1. Customers

  2. Products

  3. Orders

  4. Order items

Work with your Listrak representatives to determine which of these sets will be useful for your workflows within Listrak, and then verify that attributes sent from Amperity are mapped correctly to the appropriate data schema within Listrak.

Add data template

A data template defines how columns in Amperity data structures are sent to downstream workflows. A data template is part of the configuration for sending query and segment results from Amperity to an external location.

To add a data template

Step 1.

From the Destinations tab, open the menu for a destination that is configured for Listrak, and then select Add data template.

This opens the Add Data Template dialog box.

Step 1

Enter the name of the data template and a description. For example: “Listrak” and “Send audience lists to Listrak.”.

Step 2.

Verify business user access to queries and orchestrations and access to segments and campaigns.

A business user may also have restricted access to PII, which prevents them from viewing and sending customer profile data.

Step 2.

If business user access was not configured as part of the destination, you may configure access from the data template.

Important

To allow business users to use this destination with campaigns, you must enable the Available to campaigns option. This allows users to send campaign results from Amperity to Listrak.

If you enable this option, the data extension settings require using campaign name and group name template variables to associate the name of the data extension to your campaign.

Step 3.

Verify all configuration settings.

Verify settings for the data template.

Note

When the settings required by Listrak were are not configured as part of the destination, you must configure them as part of the data template before making this destination available to campaigns.

Step 4.

Review all settings, and then click Save.

Save the data template.

After you have saved the data template, and depending on how you configured it, business users can send query results and/or send campaigns to Listrak.