Skip to main content

Attentive - Integration Manual

Send loyalty properties and events to Attentive, and give customers points when they sign up for SMS

Written by Jason Leader

The Attentive integration sends customer properties on the Classic plan and above. Sending program events to Attentive is included on the Plus plan, or available as an add-on. To learn more, see our pricing page.

Attentive sends messages in a set list of countries, some of them in early access. See Attentive's list of supported countries.

Please note that using one Attentive account with more than one LoyaltyLion program is not supported, and you can only connect one Attentive account per LoyaltyLion program.


Why LoyaltyLion and Attentive?

Connect your loyalty and engagement platform to grow your list of SMS subscribers. Reward your customers with loyalty points when they sign up to receive SMS marketing campaigns. You set the number of points in a LoyaltyLion rule, and Attentive tells LoyaltyLion when a subscriber signs up, using their email address.


Benefits of integrating with Attentive

  • Drive more revenue

  • Target the right audience

  • Engage high-value mobile subscribers with relevant messages

  • Scale your SMS program and exceed your performance goals


How does the integration work?

There are two main components to the Attentive integration:

  • LoyaltyLion integration: push customer events from LoyaltyLion to Attentive

  • Attentive integration: give customers points for signing up to SMS

You can create dynamic segments to use in campaigns for the customers in Attentive using the customer event data.

Properties sent from LoyaltyLion to Attentive:

Property

What it is

How it looks in Attentive

Total points

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

{{subscriber.custom['points_total']}}

Approved points

The number of points this customer has available to spend

{{subscriber.custom['points_approved']}}

Pending points

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

{{subscriber.custom['points_pending']}}

Spent points

The number of points this customer has spent

{{subscriber.custom['points_spent']}}

Lifetime points

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

{{subscriber.custom['points_lifetime']}}

Number of rewards claimed

The number of rewards this customer has claimed

{{subscriber.custom['rewards_claimed']}}

Number of rewards used

The number of rewards this customer has used

{{subscriber.custom['rewards_used']}}

Blocked

Whether this customer is blocked from earning or spending points

{{subscriber.custom['blocked']}}

Date enrolled in program

The date and time this customer joined the Loyalty Program

{{subscriber.custom['enroll_date']}}

Referral URL

This customer's unique referral URL

{{subscriber.custom['referral_url']}}

Loyalty Tier

The name of this customer's current Loyalty Tier

{{subscriber.custom['loyalty_tier']}}

Birthday

This customer's birth date

{{subscriber.custom['birthday']}}

Insights segment

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

{{subscriber.custom['insights_segment']}}

Tier expiration date

When the customer's current tier ends

{{subscriber.custom['tier_expiration_date']}}

Tier progress

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

{{subscriber.custom['tier_progress_value']}}

Projected tier progress at expiration

The customer's projected progress when their current tier expires

{{subscriber.custom['tier_progress_value_at_expiration']}}

Progress needed to renew tier

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

{{subscriber.custom['tier_progress_needed_for_renewal']}}

Progress needed to upgrade tier

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

{{subscriber.custom['tier_progress_needed_for_upgrade']}}

Next tier

The next tier the customer would reach if they upgrade

{{subscriber.custom['tier_upgrade_tier_name']}}

Forecasted tier at expiration

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

{{subscriber.custom['tier_forecasted_tier_name']}}

Receipt upload URL

A receipt upload URL associated with this customer

{{subscriber.custom['receipt_upload_url']}}

Loyalty Pass URL

The URL for this customers loyalty pass

{{subscriber.custom['loyalty_pass_url']}}

Loyalty Pass Installed

Has this customer downloaded and installed their Loyalty Pass

{{subscriber.custom['loyalty_pass_installed']}}

Events that can be used to trigger SMS marketing journeys:

Events are available on the Plus plan, or as an add-on. Each event is listed below as it appears in LoyaltyLion, followed by its name in Attentive:

  • Customer joined the program (LoyaltyLion - Enrolled)

  • Customer's tier has been upgraded (LoyaltyLion - Tier Upgraded)

  • Customer's tier has been downgraded (LoyaltyLion - Tier Downgraded)

  • Customer has new rewards available (LoyaltyLion - Reward Available)

  • Monthly for customers with available rewards (LoyaltyLion - Reward Reminder)

  • Customer refers a friend (LoyaltyLion - Referral Complete)

  • Customer has completed an activity (LoyaltyLion - Rule Completed - followed by the rule title)

  • Customer approaching new tier (LoyaltyLion - Approaching Tier Upgrade)

  • Customer moved to Loyal (LoyaltyLion - Moved to Loyal Segment)

  • Customer moved to At Risk (LoyaltyLion - Moved to At Risk Segment)

  • Customer moved to Win Back (LoyaltyLion - Moved to Win Back Segment)

  • Customer claimed reward (LoyaltyLion - Claimed Reward)

  • Customer's points expiring soon (LoyaltyLion - Points expiring soon)

  • Customer's reward expiring soon (LoyaltyLion - Reward expiring soon)

  • Customer's receipt was approved (LoyaltyLion - Receipt Approved)

  • Customer's receipt was declined (LoyaltyLion - Receipt Declined)

These appear as "A subscriber's activity" when creating segments in Attentive.


How to integrate LoyaltyLion with Attentive?

  1. In LoyaltyLion, go to Integrations.

  2. Under Available integrations, click Attentive.

  3. Under 1. Connect to Attentive, click the Connect to Attentive button.

  4. Authorize LoyaltyLion in Attentive. You are then returned to LoyaltyLion.

  5. Under 2. Configuration, choose the customer properties to send to Attentive.

  6. If you are on the Plus plan or have the add-on, choose the program events to send. We suggest sending all of them.

  7. 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. Past events are never sent.

To find the events in Attentive, go to Segments and create a new segment.

The LoyaltyLion events are listed as Custom Events.


How to give points for signing up to Attentive?

LoyaltyLion finds the customers to give them points for the sign-up rule by their email address. Please ensure your SMS sign-up form includes an email field.

  1. In LoyaltyLion, go to Program, then Rules, and click Create rule.

  2. Click the Custom action option.

  3. Set the Identifier to attentive_sms, and fill in the rest of the fields.

  4. Optionally, add a Description explaining how customers get the points. Customers see it when they open the rule on your loyalty page.

  5. Click Create.

  6. Ask your Attentive CSM to turn on the sign-up callback to LoyaltyLion, so Attentive tells us when customers sign up.


FAQ

Q. Why didn't my customer get points for signing up for SMS?

There are a couple of things you can check to see why a customer didn't get points:

  1. Do you have an email field in your SMS sign-up form? If not, we won't be able to connect the SMS number to the customer.

  2. Did the customer enter the same email address to this form as the one they've registered for the loyalty program? If not, we won't be able to find the correct customer account to give points.
    ​

  3. Is the Loyalty Name in Attentive set up to attentive_sms as described in How to give points for signing up to Attentive?

If all of the above statements are true, there may be an issue - contact support@loyaltylion.com for further support. You can manually give points in the case of user errors like those above, though - click here to find out how.

Q. Why don't I see my LoyaltyLion events appearing in Attentive?

The events appear in real-time as customers complete LoyaltyLion activities, meaning that they will only be available once the event has been completed.

For example, before the refer-a-friend event appears in Attentive, a successful referral needs to be completed. If you have 0 referrals completed on your store, you won't see the referral completed event in Attentive.

If a customer has signed up to SMS prior to creating a loyalty account, they won't receive sign up to SMS points. Attentive won't trigger the API to give points, if they're already registered to receive SMS messages.


​

Did this answer your question?