Listrak Integration
Send loyalty program emails through your Listrak account.
If you use Listrak for marketing emails, you can now send loyalty program-related emails through your Listrak account instead of through Zinrelo. By integrating Zinrelo and your Listrak account, you can manage unsubscribes in a single place and leverage Listrak's capabilities to set up workflows for better customer engagement.
This article explains the steps you need to take to integrate Zinrelo and Listrak.
Generate your Listrak Client ID and Client Secret
Login to your Listrak account and navigate to Integrations. Click on the 'Integrations Management' and choose the 'Email API' integration and then click on 'Setup Integration.
- Give a name to your integration such as 'Zinrelo Integration'.
- Enable the four access levels - List, Contact, Event, Segmentation
- Contact [email protected] to get a list of IP addresses that you will have to whitelist in Listrak.
Note: Below is the list of IPs to be Whitelisted
- 54.243.245.6
- 184.72.245.194
Note: The client secret is displayed only once. If you have not noted it, you will have to redo the integration.
Update the Listrak Client ID and Client Secret in Zinrelo
Login to your Zinrelo account and navigate to Settings >> Apps >> Listrak. Update the Client ID and Client Secret generated in the previous step in Zinrelo.
The moment the details are saved in Zinrelo following actions will be done -
- A list by the name 'Zinrelo Loyalty List' is automatically created in Listrak. This can be viewed by navigating to Contacts >> List Manager.
Note: By default, the newly created list won't be visible to you. You need to ask your Listrak admins (users having admin access to Listrak account) to provide access to Zinrelo Loyalty list. For more details, refer to this document.
- External Event IDs are created in Listrak. These events are the triggers from Zinrelo which you can use to send out program-related emails. To view these events navigate to Help & Support >> API ID information.
External Events | When is this event triggered? |
---|---|
Referral Friend Invitation | Triggered when a user refers friends from Loyalty Dashboard. |
Points Expiration | Triggered when users points are about to expire. |
Referral Coupon Award | Triggered when a referred friend makes a purchase. |
Eligible Rewards | Triggered for users who have enough points to redeem a reward. |
Referral Thank You | Triggered for a referrer as an acknowledgment of a referral done from the loyalty dashboard. |
Account Created | Triggered when a user enrolls into the loyalty program online. |
Winback Award | Triggered for users who have been identified for the winback promotion. |
Referred Friend Incentive | Triggered when a user refers a friend |
Points Earned | Triggered when a user earn points for an activity in the program. |
Batch Customer Created | Triggered when a user enrolls into the program via the batch mode. |
Tier Upgrade | Triggered when a user upgrades to a higher tier. |
Default Coupon Reward | Triggered when a user redeems a coupon based reward. |
Rewards Within Reach | Triggered when a user is between 80% - 100% of the points required to redeem any reward. |
- New fields are created for users in Listrak. These fields can be viewed just below the external events that are created. Whenever the user details are updated in Zinrelo they will automatically be updated in Listrak.
The integration does not automatically update historical data for users in Zinrelo. So for the first sync, export the member's data from Zinrelo and manually update it in the Listrak list.
Note: When you update the access token, Zinrelo emails will be disabled. Be prepared to configure the emails through Listrak when this switch is made.
Explanation of Fields created in Listrak
Variables | Description | Example |
---|---|---|
User name | Full name of the user | Victor S |
Date of birth | Date of birth | 01/01/1990 (mm/dd/yyyy) |
Current tier | User loyalty tier | Gold |
Opted out | Is the loyalty user opted in/ opted out | True/ False |
Next Tier | User next upgraded tier name | Platinum |
User status | Status of the users in Zinrelo System | active/ deleted/ blocked |
Points available | Total points available for user | 1000 |
Winback expiry date | Winback expiry date | 03/01/2019 (mm/dd/yyyy) |
Phone number | Phone number of the user | 1234567890 |
Referral code | Referral code of the user | VIC1FXYP |
Referral URL | Referral URL of the user | https://teststore.zinrelo.com/ref/VIC1FXYP |
Recent activity completed | Recent activity done (reused field) | Made a purchase |
Points current activity | Points associated with the current event (reused field) | 100 (eg. Made a Purchase) |
Points redeemed | Total points redeemed by the user | 100 |
Points expired | Total points expired for the user | 200 |
Points earned | Total points earned by the user | 2000 |
Preferred language | Selected language of the user | english |
Total rewards | Total rewards redeemed by the user | 4 |
Total purchases | Total purchases of the user | 5 |
Total purchase value | Total purchase value of the user | 89.65 |
Referred by | Referrer name | Mike Smith |
Referral email | Referrer email address | [email protected] |
Redeemed reward name | Reward redeemed by the user (reused field) | 5% Off Coupon |
Reward points used | Points redeemed by the user (reused field) | 200 |
Redeemed reward code | Reward code redeemed by user (reused field) | 1 ADEM738 |
Member Id | The unique ID associated with a member | 486878BMA |
Sending loyalty program notification emails from Listrak
You can use Listrak conversations to send emails based on triggers from Zinrelo.
Automation >> Conductor >> Conversations
To set up an automated email, create a new conversation and give it an easily identifiable name.
Click on the 'Trigger' node and the list of external events will be displayed. Select the appropriate event for that email. For example, if you want to set up the email that is sent to customers who are identified for the 'Winback' campaign, you will use the event 'Winback Award'.
Configure the email message that you want to send and then publish the conversation.
You can create more detailed workflows in Listrak to send separate emails to members of different tiers for the same action. To notify members about available rewards, you can create parallel flows for the same action based on the available points of the member. (Available points will determine which rewards the member will be eligible for).
Recommended Emails
Now that you know how to send out loyalty program emails through Listrak, here is a list of emails we recommend setting up.
Referral Emails
-
Email to members soliciting referrals: Periodically, you can solicit referrals from your customers by asking them to share their unique referral link with friends. To update the referral link in emails, you can use the Referral URL field in the Listrak email template.
-
Email Invitation to Friends: Members can also refer friends through the refer-a-friend activity in the loyalty dashboard. In these cases, they have an option to update their friend email addresses in the dashboard and an email is supposed to be sent to the friend on behalf of the member. To set this up, you can create a workflow that listens to the Referral Friend Invitation event and sends out the invitation email to the friend from Listrak. The invitation email template can reference the referrer details through the fields 'Referred by' and 'Referrer Email'.
Reward Emails
- Rewards reminder: It is always a good idea to remind members about the rewards that they are eligible for. Zinrelo will trigger the event 'Eligible Rewards' once a month for all customers who are eligible for any of the rewards in the program. You can either use this trigger or set up your own workflows that remind customers from time to time about the rewards that they are eligible for.
To setup Reward List email, click here.
- Reward acknowledgment: After a member has successfully redeemed a reward, Zinrelo will trigger the 'Default Coupon Reward' event. The corresponding email template can include the following fields:
- 'Redeemed Reward Name' to show the name of the reward
- 'Reward Points Used' to show the points redeemed
- 'Redeemed Reward Code' to show the coupon code issued.
Points Info Emails
- Points earned email: Whenever members earn points for any activity, Zinrelo will trigger the 'Points Earned' event. The email template can use the following variables.
- 'Recent Activity Completed' to show the activity for which points were earned.
- 'Points Current Activity' to show points associated for the current event.
- 'Points Available' to show available points. Based on the available points if eligible rewards can be communicated in the same email, the engagement will be higher.
-
Points expiration: Based on the expiration settings in Zinrelo, Zinrelo will trigger the 'Points Expiration' event. Members can be notified about the approaching expiry date by using the variable 'Points Expiry Date'. This date is always in the UTC timezone.
-
Win-back email: Zinrelo has a built-in win-back activity, where inactive members are identified and a win-back offer is rolled out to them. The trigger to send out the email in the 'Winback Award' event. The win-back offer usually is a fixed number of bonus points and the offer has limited validity. To communicate the date till which the offer is valid use the variable 'Winback Expiry Date'.
Tier Update Emails
Tier upgrade email: Whenever members move up to a higher tier, Zinrelo will trigger the event 'Tier Upgrade'. Let the members know the benefits that they have unlocked as part of the higher tier. The workflow should include a separate email for each tier. The user tier can be checked in the filters using the field 'Current Tier'. At the time of upgrade, this field will be updated to the new tier.
Monthly Statement
To spread awareness and engage users, a monthly summary of the members' loyalty account goes a long way. This email can include their available points, the rewards that they are eligible for, the tier that they belong to and the benefits of their current tier.
Listrak Variables
Common Fields that can be used in all email notifications.
Note: The following table has the attributes which can be used in any email notification sent via Listrak.
Attribute Name | Description | Example |
---|---|---|
User Name | Full name of the user | John Doe |
Date of Birth | Date of birth | 03/26/1991 /(mm/dd/yyyy) |
Current Tier | User Loyalty Tier | Gold |
Opted Out | Is the member opted in/opted out | True/False |
User Status | Status of a user in Zinrelo system | Active/Deleted/Blocked |
Points available | Total Points available for the user | 1000 |
Phone number | Phone number of the user | 98775643256 |
Referral Code | Referral code of the user | V1B1HGFR |
Referral URL | Referral URL of the user | https://wonderblossom.zinrelo.com/ref/SUN1SOPW |
Points Redeemed | Total Points redeemed by the user | 100 |
Points expired | Total Points expired for the user | 200 |
Points Earned | Total points earned by the user, in the scenarios like: - points awarded for an activity in case of points earned event - points which are going to expire in case of points earned event - points needed by a member to earn next rewards in case of rewards within reach event - points will be awarded in case of winback event. | 2000 |
Preferred language | Selected language by the user | English |
Event wise attributes available:
Type of email: Referral Notification
Name of the email notification: Default Email Invitation to Friends
Field Name | Description |
---|---|
Referral Code | Referral code of the user. |
Referrer name | Indicates the name of the person referring. |
Referrer email ID | Denotes the email address of the referrer. |
Referral URL of the user | Represents the unique referral link specific to the referrer. |
Name of the email notification: Default Coupon Award email to Referrer
Field Name | Description |
---|---|
Redeemed Reward Code | Rewards code redeemed by user (Reused field). |
Name of the email notification: Friend incentive email notification
Field Name | Description |
---|---|
Redeemed Reward Code | Reward code redeemed by user (Reused field). |
Referral code of the user | Referral code of the user. |
Referrer name | Indicates the name of the person referring. |
Referrer email ID | Denotes the email address of the referrer. |
Referral URL of the user | Represents the unique referral link specific to the referrer. |
Name of the email notification: Not eligible for coupon notification
Field Name | Description |
---|---|
Referral Code | Referral code of the user. |
Referrer name | Indicates the name of the person referring. |
Referrer email ID | Denotes the email address of the referrer. |
Referral URL of the user | Represents the unique referral link specific to the referrer. |
Type of email: Reward Notification
Name of the email notification: Default Coupon Reward Email
Field Name | Description |
---|---|
Redeemed Reward Code | Reward code redeemed by the user (reused field). |
Redeemed Reward Name | Reward redeemed by the user (reused field). |
Reward Points Used | Points redeemed by the user (reused field). |
Name of the email notification: Rewards within reach notification
Field Name | Description |
---|---|
Points current activity | Points of the current activity. |
Since list fields are not supported in Listrak. So we can achieve this by creating a dynamic content area in the Listrak. You can create a dynamic content area with the help of users' available points and which rewards will be available with those many points. Here are some screenshots which might help you.
Type of email: Award Notifications
Name of the email notification: Default Points Expired Email
Field Name | Description |
---|---|
Points Expiration | Expiration of points allocated for the current activity (reused field). |
Points Expiry Date | The date on which these points will expire. |
Name of the email notification: Send notification for winback bonus
Field Name | Description |
---|---|
Winback Expiry Date | Winback expiry date |
Points earned for the activity, if performed | Points earned for winback activity. |
Name of the email notification: Default Points Earned Email
Field Name | Description |
---|---|
Points Earned | Points earned for the current activity. |
Recent Activity Completed | Recent activity performed. (reused field) |
Type of email: Tier Notifications
Name of the email notification: Tier Upgrade Notification
Field Name | Description |
---|---|
Tier Upgrade | User Loyalty Tier |
Can Zinrelo integrate with multiple lists?
Yes, Zinrelo can be integrated with multiple lists. For more details, reach out to your account manager at [email protected].
Updated about 2 hours ago