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 lists in Listrak. You can send email lists to Listrak using any of the following processes:

The Listrak Email API
SFTP for email address lists, along with product catalogs, orders, and ordered items

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 lists to Listrak to automate downstream workflows.

An Listrak destination works like this:

Use a query or segment to build a list of email addresses for whom you have opt-in/out data.
Configure a destination for sending lists of email addresses to Listrak using your preferred workflow: API or SFTP.

Listrak prefers to use a single list for managing email addresses. 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.
Send a test from Amperity using your preferred workflow, and then from within Listrak verify that the email 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.
Use email lists to build responsive email campaigns.

Email API¶

Use Amperity to manage email address lists in Listrak using the Listrak Email API .

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

Get details¶

Listrak requires the following configuration details:

	A client ID and secret for an email integration. This integration 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.
	The name of the list that will be managed in Listrak. This is often, but not always, named “Master List”.
	A query or segment that returns a list of email addresses.

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.

To add a destination

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

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.

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.

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.

When finished, click Save.

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.

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”.

By default a destination is available to all users who have permission to view personally identifiable information (PII).

A destination may be configured to restrict access to only users assigned to the Datagrid Operator and Datagrid Administrator policies. Enable the Admin only checkbox.
A destination may be configured to allow users with limited access to PII. Enable the PII setting checkbox.

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.

Review all settings, and then click Save.

Important

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

SFTP¶

Configure Amperity to send email addresses 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.

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

	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. Enter the name of the data template and a description. For example: “Listrak” and “Send audience lists to Listrak.”.
	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. 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.
	Verify all configuration settings. 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.
	Review all settings, and then click Save. 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.