Klaviyo Integration
Learn how to integrate Lantern with Klaviyo to sync customer data and trigger events
Lantern provides a rich integration with Klaviyo that pushes properties to customer profiles and triggers Metrics when events happen within Lantern.
Getting Started
Step 1: Generate a Klaviyo API Key
Generate a private API key in Klaviyo following their instructions:
- Give it a name like "Lantern" to remember what you generated it for
- Select Full Access under Access Level
- Make note of the generated key
Step 2: Configure the Integration in Lantern
- Go to the Lantern Admin in Shopify
- Go to Settings → Integrations
- Enter the API Key you generated into the field under the Klaviyo heading and save
Step 3: Test the Integration
- Click the Send test events to Klaviyo button to verify the integration
- Check the Metrics Activity Feed in Klaviyo to see examples of each Metric Lantern triggers
Customer Profile Properties
Lantern syncs the following properties to customer profiles in Klaviyo:
General Properties
| Property | Description |
|---|---|
LanternBirthDate | The customer's birth date |
Loyalty Properties
| Property | Description |
|---|---|
LanternEnrolledAt | When the customer was enrolled in the loyalty program |
LanternPotentialLoyaltyPoints | The potential points a customer can earn if they signup for an account |
LanternLoyaltyPoints | The customer's current loyalty points balance |
LanternLoyaltyTier | The customer's current loyalty tier |
LanternLoyaltyCurrentTierSpendThreshold | Spend threshold for current tier |
LanternLoyaltyCurrentTierSpendRemaining | Spend required to maintain current tier |
LanternLoyaltyCurrentTierSpendPercentage | Percentage progress to maintain current tier |
LanternLoyaltySpend | Current period spend amount |
LanternLoyaltyNextTierName | Handle of the next available tier |
LanternLoyaltyNextTierSpendThreshold | Spend threshold for next available tier |
LanternLoyaltyNextTierSpendPercentage | Percentage progress towards next tier (0-100) |
LanternLoyaltyNextTierSpendRemaining | Spend remaining to reach next tier |
LanternLoyaltyTierResetDate | Date that the tier will be recalculated |
LanternLoyaltyPointExpirationDate | Date that the user's points will expire |
Wishlist Properties
| Property | Description |
|---|---|
LanternWishlistItems | A list of all product variant IDs in the customer's wishlist |
Note: Lantern also syncs any customer properties you collect using earn event forms.
Available Metrics
General Events
Lantern Account Created
Triggered when a customer signs up for an account.
Lantern Account Invite
Triggered when a customer checks the Account Sign Up extension in Checkout.
Parameters:
potentialPoints- The points the customer will earn when they finish activating their accountactivationLink- The unique link to activate the account
Lantern Account Activate
Triggered when a customer account invite is sent from Shopify.
Parameters:
activationLink- The unique link to activate the account
Lantern Earn Event Awarded
Triggered when a customer earns an Earn Event.
Parameters:
handle- The handle of the Earn Event earnedpoints- The number of points earnedawardType- The type of award earned- Possible values:
points,reward,none
- Possible values:
rewardType- The type of reward earned- Possible values:
Discount Code,Gift Card,Product,Custom,Store Credit
- Possible values:
code- The code associated with the reward (Gift Card code or Discount Code)discountCode- The discount code associated with the rewardgiftCard- The gift card associated with the rewardrewardValue- The value of the rewardrewardValueType- The type of value of the reward- Possible values:
Percent,Amount
- Possible values:
productVariantId- The product variant ID associated with the reward
Loyalty Events
Lantern Loyalty Opted In
Triggered when a customer opts into the loyalty program.
Lantern Tier Change
Triggered when a customer moves to a new loyalty tier.
Parameters:
tier- The new tier the customer is now in
Lantern Tier Increase
Triggered when a customer moves up a loyalty tier.
Parameters:
tier- The new tier the customer is now in
Lantern Tier Decrease
Triggered when a customer moves down a loyalty tier.
Parameters:
tier- The new tier the customer is now in
Lantern Points Awarded
Triggered whenever a customer earns loyalty points.
Parameters:
points- The number of points awarded
Referral Events
Lantern Referral Invite
Triggered when an advocate uses the email invite to send a referral.
Parameters:
advocateFirstName- First name of the advocateadvocateLastName- Last name of the advocatemessage- The message the advocate wants to include with the invitereferralLink- The advocate's unique referral link
Lantern Referral Awarded
Triggered on an advocate's profile when their friend is successfully referred.
Parameters:
code- The unique code for the discount or gift card that was awarded
Lantern Referred
Triggered on a friend's profile when they successfully complete a referral.
Parameters:
code- The unique code for the discount or gift card that was awarded
Wishlist Events
Lantern Back In Stock
Triggered when a product variant that a customer has added to their wishlist becomes back in stock.
Parameters:
productVariantId- The ID of the product variant that is now back in stock
Lantern On Sale
Triggered when a product variant that a customer has added to their wishlist goes on sale.
Parameters:
productVariantId- The ID of the product variant that went on sale