# Klaviyo Profile Data & Dynamic Text Tokens

### **How Our Klaviyo Integration Works**

Because integrates with Klaviyo via their **open API**, allowing us to retrieve a visitor’s **exchange ID** when they land on your site. This helps us determine if they have a **Klaviyo customer profile**. If they do, we use their **person ID** to pull in relevant **profile data**—like their first name, loyalty balance, or past purchases.

#### **Why This is a Game-Changer**

Before, users could only personalize their site by creating **Klaviyo segments** (e.g., “Customers with 100+ loyalty points”). But segments **group customers into broad categories** instead of allowing **true 1:1 personalization** (e.g., “Ashland, you have 201 points!”).

Now, with our **enhanced integration**, you can pull in real-time customer data in two powerful ways:

1️⃣ **New Rules in the Because Rules Engine** – Create targeted campaigns based on Klaviyo profile attributes.

2️⃣ **Dynamic Text Tokens in the Editor** – Insert real-time customer data directly into campaign messaging.

***

### **New! Klaviyo Profile Attribute Rule in the Rules Engine**

We’ve introduced a **Klaviyo Profile Attribute rule**, which allows you to personalize website content based on specific **Klaviyo profile attributes**—without needing to create a segment in Klaviyo.

<figure><img src="/files/WXqP634nZWz4GwSKGWTw" alt=""><figcaption></figcaption></figure>

#### **What This Rule Does**

With the **Klaviyo Profile Attribute** rule, you can:

✔️ \*\*\*\*Target visitors based on their **loyalty tier** (e.g., Gold, Silver, VIP)

✔️ Show personalized messages based on their **points balance**

✔️ Display custom messaging for subscribers based on their **status**

#### **Example Use Cases**

✅ **Show a VIP discount banner only to Gold-tier customers**

* **Rule:** If Klaviyo Profile Attribute `loyalty_tier` = **Gold**
* **Message:** “Gold Members get **free shipping** on every order!”

✅ **Display a personalized cart message for repeat buyers**

* **Rule:** If Klaviyo Profile Attribute `total_orders` > **5**
* **Message:** “Thanks for your loyalty! You’ve placed **6 orders** with us!”

✅ **Encourage customers to level up their rewards**

* **Rule:** If Klaviyo Profile Attribute `loyalty_points` < **500**
* **Message:** “You’re just **50 points away** from the next reward tier!”

### **How to Set Up This Rule in Because**

1. **Create a New Campaign** in the Because app.
2. Navigate to the **Rules Engine** and select **Klaviyo** and then select the **Klaviyo Profile Attribute** rule.
3. Choose the **specific Klaviyo attribute** you want to target (e.g., loyalty\_tier, loyalty\_points).
4. Set the **conditions** (e.g., “equals Gold” or “is greater than 500”).
5. Design your personalized message and **publish the campaign**!

💡 **Tip:** Combine this rule with **Dynamic Text Tokens** to insert real-time data into your message.

***

### **Klaviyo Dynamic Text Tokens Available in the Editor**

Below are the **Klaviyo dynamic tokens** you can use to personalize campaign messaging:

* **Klaviyo Person First Name** → `{|klaviyo.first_name|}`
* **Klaviyo Person Last Name** → `{|klaviyo.last_name|}`
* **Klaviyo Custom Property** → `{|klaviyo.custom.{property_name}|}` *(Replace {property\_name} with the specific data field you want to pull from Klaviyo, such as loyalty points or subscription status.)*

#### **Where to Find These Tokens**

Within the **Because campaign editor**, when editing a text field:

1. **Highlight a word** in your message.
2. Look for the **dynamic token icon** {D} in the font tools.
3. Click {D} and scroll to the bottom of the **Dynamic Tokens menu** to find the **Klaviyo tokens**.

💡 **Tip:** Use these tokens to **insert live customer data** directly into your messaging for a truly **personalized experience!**

***

### **What This Integration Unlocks**

With Because’s deeper Klaviyo integration, you can create hyper-personalized experiences **for every site visitor**. Here’s what’s possible:

#### **1. Personalized Greetings**

* Use the visitor’s **first name** to create a friendly, engaging experience.
  * **Example:** “Welcome back, **Ashland**!”
    * **Dynamic Token:** `{|klaviyo.first_name|}`
* Add a “Default” state for any Klaviyo dynamic text token where the data may not always be available, ensuring a fallback value is displayed instead of an empty space.
  * **Example**:
    * Default Text Field: "there"
    * Dynamic Token: `{|klaviyo.first_name|default:there|}`
    * Final output: "Hey there!" (if first name is missing)

#### **2. Real-Time Loyalty & Rewards Messaging**

* Show a visitor’s **current loyalty points**: “You have **300 points** to redeem!”
* Display how many **points they need for the next tier**: “You’re **50 points away from Gold Tier!**”
* Highlight **tier-specific perks**: “Gold members get **free shipping**!”
* No need to build Klaviyo segments—this pulls live customer data dynamically.

#### **3. Tier-Specific Cart Messaging**

* Show how many **loyalty points a visitor’s cart qualifies for**, based on their membership tier.
* **Example:** “Your cart qualifies for **150 bonus points**!”
* **How It Works:** You set how much **$1 is worth in points**, and Because automatically calculates the total.

#### **4. Exclusive Discount Codes & Offers**

* Display **personalized discount codes** stored in Klaviyo.
* **Example:** “Here’s your **10% off** code: **SAVE10**”
* **Dynamic Token:** `{|klaviyo.custom.discount_code|}`

#### **5. Subscription Data for Subscribers**

* Show a customer’s **subscription status** or **next shipment date**.
* **Example:** “Your next order ships on **March 5**!”
* **Dynamic Token:** `{|klaviyo.custom.next_shipment_date|}`

***

📩 Need help setting up your first Klaviyo-powered campaign? Our team is here to help! Contact us at <support@trybecause.com>. 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://because.gitbook.io/because/integrations/klaviyo-integration/klaviyo-profile-data-and-dynamic-text-tokens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
