Klaviyo

Zellify's Klaviyo integration automatically captures user emails during funnel interactions and tracks their conversion journey. When users engage with your funnels, their emails are added to designat

How It Works

1. User interacts with your funnel

   • The user enters their email during the funnel flow or authenticates using Google OAuth

2. Automatic Klaviyo sync

   • Email is automatically added to the Klaviyo list specified in your campaign

   • Profile is created with unconverted status and metadata

   • Note: Campaign must have Klaviyo List ID configured for sync to occur

3. Conversion tracking

   • When user completes a purchase, status updates to converted

   • Conversion date and additional metadata are recorded

4. Campaign attribution

   • Klaviyo campaigns can be tracked and attributed to conversions

---

Setup Process

1. Connect Your Klaviyo Account

• Navigate to Settings > Integrations in your Zellify dashboard

• Click Connect next to the Klaviyo integration

• Enter your Klaviyo Private API Key

Finding Your API Key: Your Klaviyo Private API Key can be found in your Klaviyo account under Settings → API Keys.

2. API Key Validation

Zellify automatically validates your API key by:

• Testing connection to Klaviyo API

• Fetching available lists from your account

• Confirming proper permissions

3. Configure Klaviyo List ID in Campaigns

This step is required for the integration to work. For each campaign, you must specify which Klaviyo list will receive the emails:

• Navigate to Tracking Links in your dashboard

• Click Create New Campaign or edit an existing campaign

• In the Integrations section, enter your Klaviyo List ID

• Save the campaign

Finding Your List ID: In your Klaviyo account, go to Lists & Segments, select your list, and find the List ID in the URL or list details.

4. Campaign Assignment

Once both steps are complete, emails will be automatically added to the specified Klaviyo list when users:

• Authenticates through your funnel

• Interact with campaign tracking links

---

Features

Automatic Email Collection

• Email Tracking: User emails collected when entered manually or via Google OAuth during the funnel flow

• Deduplication: Smart profile matching prevents duplicate entries

Conversion Tracking

• Status management: Tracks unconverted → converted journey

• Timestamp recording: Captures signup and conversion dates

• Metadata enrichment: Includes funnel ID, organization ID, and custom properties

Profile Management

• Smart matching: Finds existing profiles by email before creating new ones

• Property updates: Maintains consistent profile data across interactions

• Error resilience: Failed syncs don't interrupt funnel flows

---

Profile Data Structure

When emails are added to Klaviyo, profiles include the following properties:

{
  "email": "[email protected]",
  "properties": {
    "conversion_status": "unconverted",
    "signup_date": "2024-01-15T10:30:00Z",
    "organization_id": "org_abc123",
    "funnel_id": "funnel_xyz789",
    "funnel_name": "Product Quiz"
  }
}

After conversion:

{
  "properties": {
    "conversion_status": "converted",
    "conversion_date": "2024-01-16T14:20:00Z"
    // ... other properties remain
  }
}

---

Integration Points

Funnel Event	Klaviyo Action	Status
User Authentication	Add email to list	unconverted
Purchase Complete	Update conversion status	converted

---

Error Handling

The Klaviyo integration is designed to be non-blocking:

• Failed API calls don't interrupt funnel flows

• Rate limiting is handled with exponential backoff

• Invalid API keys are detected during validation

• Network errors trigger automatic retries (up to 3 attempts)

This ensures your funnels continue working even if Klaviyo is temporarily unavailable.

---

Best Practices

Campaign Attribution

• Use consistent UTM parameters in your funnel links

• Configure Klaviyo to track these parameters for proper attribution

• Set up segments based on conversion_status for targeted campaigns

List Management

• Create dedicated lists for different funnels or campaigns

• Use Klaviyo's segmentation to target unconverted leads

• Set up automated flows for new subscribers

Data Hygiene

• Regularly review conversion rates by funnel

• Clean up duplicate profiles if any exist

• Monitor API usage to stay within Klaviyo limits

---

Troubleshooting

Common Issues

Integration not working:

• Verify API key has proper permissions in Settings > Integrations

• Check that Klaviyo List ID is configured in your campaign (most common issue)

• Ensure the List ID exists in your Klaviyo account

• Confirm organization ID is correctly configured

Missing emails:

• Verify Klaviyo List ID is set in Tracking Links > Campaign configuration

• Check that the specified Klaviyo list exists and is accessible

• Verify email validation is working in your funnels

• Review error logs in Zellify dashboard

Conversion tracking issues:

• Confirm payment provider webhooks are properly configured

• Check that purchase events are being recorded

• Verify email addresses match between signup and purchase

---

Summary

	Klaviyo Integration
Setup Time	< 5 minutes
API Key Required	✅ Yes (Private Key)
List ID Required	✅ Yes (Per Campaign)
Real-time Sync	✅ Yes
Conversion Tracking	✅ Yes
Error Resilient	✅ Yes
List Management	✅ Automatic