Skip to main content

Dotdigital - Integration Manual

Connect Dotdigital to send loyalty points, tiers and referral links to your contacts as data fields

Written by Jason Leader

The Dotdigital integration is available on the Classic plan and above. To see which plans include it, see our pricing page.

In this article:

Why LoyaltyLion and Dotdigital?

Dotdigital is a customer experience and data platform.
​
Sync your product, customer and ecommerce data into Dotdigital and use it to build intelligent marketing campaigns and automated programs. Using dynamic content, personalization, data-driven product recommendations, back in stock alerts and much more, you can engage your customers on their preferred channel including email, SMS, Facebook, and Whatsapp.
​
Using LoyaltyLion and Dotdigital together allows you to use loyalty program data in your marketing campaigns to drive more engagement, conversions and loyalty.

Benefits of integrating with Dotdigital

  • Increase repeat purchases with reward available emails

  • Engage with customers via monthly loyalty summary emails

  • Increase customer acquisition with referral prompt emails

  • Target specific customer groups with segmentation and offer richer personalization

How to integrate LoyaltyLion with Dotdigital?

  1. In LoyaltyLion, go to Integrations, then under Available integrations, click Dotdigital.

  2. Sign in to your Dotdigital account and create a new API user. The Installation card in LoyaltyLion links straight to the right page in Dotdigital.

  3. Copy the email address shown in the Dotdigital form, which ends in @apiconnector.com, and paste it into LoyaltyLion.

  4. In Dotdigital, enter LoyaltyLion as the description.

  5. Copy the password LoyaltyLion shows you and paste it into the Password and Confirm Password fields in Dotdigital.

  6. Click Save in Dotdigital to create the API user.

  7. Back in LoyaltyLion, choose the customer properties to send: Send all current and future customer properties, Do not send any customer properties, or Choose customer properties to send.

  8. Optionally, tick Only update existing contacts. LoyaltyLion then only updates customers who are already contacts in Dotdigital, and skips the rest instead of adding them as new contacts. This suits you if you manage your Dotdigital audience by hand.

  9. Click Complete installation, decide whether to tick Backfill data for all customers, then click Install.

When the installation finishes, you will see an Integration installed message. If you tick the backfill, we send the properties you chose for every customer in your program. If you do not, we only send customers whose loyalty data changes after you install. LoyaltyLion sends customer properties to Dotdigital, not events.

What fields are synchronized to Dotdigital?

Property

Dotdigital data field

What it is

Total points

LL_POINTS_TOTAL

The number of points this customer currently has, including pending points

Approved points

LL_POINTS_APPROVED

The number of points this customer has available to spend

Pending points

LL_POINTS_PENDING

Points this customer has earned but can't yet spend, e.g. from unpaid orders

Spent points

LL_POINTS_SPENT

The number of points this customer has spent

Lifetime points

LL_POINTS_LIFETIME

The total number of points this customer has ever earned, including spent points

Number of rewards claimed

LL_REWARDS_CLAIMED

The number of rewards this customer has claimed

Number of rewards used

LL_REWARDS_USED

The number of rewards this customer has used

Blocked

LL_BLOCKED

Whether this customer is blocked from earning or spending points

Date enrolled in program

LL_ENROLL_DATE

The date and time this customer joined the Loyalty Program

Referral URL

LL_REFERRAL_URL

This customer's unique referral URL

Loyalty Tier

LL_LOYALTY_TIER

The name of this customer's current Loyalty Tier

Birthday

LL_BIRTHDAY

This customer's birth date

Insights segment

LL_INSIGHTS_SEGMENT

This customer's Insights Segment (one of "Loyal", "At Risk", "Win Back")

Tier expiration date

LL_TIER_EXP_DATE

When the customer's current tier ends

Tier progress

LL_TIER_PROG

The customer's current progress toward maintaining or upgrading their tier

Projected tier progress at expiration

LL_TIER_PROG_EXP

The customer's projected progress when their current tier expires

Progress needed to renew tier

LL_TIER_RENEW

How much more progress the customer needs to keep their current tier when it expires

Progress needed to upgrade tier

LL_TIER_UPGRD

How much more progress the customer needs to reach the next tier

Next tier

LL_TIER_UNAME

The next tier the customer would reach if they upgrade

Forecasted tier at expiration

LL_TIER_FNAME

The tier the customer is forecasted to be in when their current tier expires

Receipt upload URL

LL_UPLOAD_URL

A receipt upload URL associated with this customer

Loyalty Pass URL

LL_PASS_URL

This customer's Loyalty Pass link

Loyalty Pass installed

LL_PASS_INSTALLED

Whether this customer has installed their Loyalty Pass

Not sure how to use them in your email templates? Check out Dotdigital's guide to data field personalization.

FAQ

How can I use this data to help my business?
This data will help you increase revenue, engagement and customer acquisition, as well as segmenting customers based on their loyalty properties, prompt customers to refer their friends by emailing them with their referral link and more.

I've connected Dotdigital, but the LoyaltyLion fields don't appear.

LoyaltyLion only sends data while your program is live. If you didn't tick Backfill data for all customers when you installed, customers appear in Dotdigital as their loyalty data changes. After that, changes are sent as they happen.

Did this answer your question?