Connect Klaviyo email marketing platform to Spree Commerce

Klaviyo is a powerful marketing automation platform used for email and SMS campaigns. By connecting your store to Klaviyo, you can automatically track user interactions, build audience profiles, and grow your newsletter subscriber base - all without manual setup.

With Spree’s native integration, you can start collecting meaningful data for segmentation and automation with just a few clicks.

Installation

To install the Klaviyo integration, you need to run the following command:

bundle add spree_klaviyo && bundle exec rails g spree_klaviyo:install

After that, you need to make sure to restart the server.

Connect Klaviyo

Sign in to your Spree admin dashboard and navigate to the Integrations tab.

To connect Klaviyo, locate the Klaviyo tile under the Marketing section and click Connect Klaviyo to open the setup form.

You’ll need to enter the following:

• Public API Key: This key identifies your account to Klaviyo.
• Private API Key: Used to authorize and securely send event and profile data.
• Newsletter List ID: The ID of the Klaviyo list you want to use for newsletter signups.
  • This list will be used as the default newsletter list for customers signing up from the storefront or checkout.

Click Create to finalize the integration.

Configure API Key Permissions in Klaviyo

Before you can finalize the creation of your Klaviyo integration, you’ll need to create a Private API Key. To do so navigate to Settings → Account → API Keys in Klaviyo.

Click Create Private API Key to open the key creation form.

When generating your Private API Key in Klaviyo, you must enable specific access scopes for the integration to function properly:

• Events - Read/Write Access
• Lists - Read/Write Access
• Profiles - Read/Write Access
• Subscriptions - Read/Write Access

You can configure this by selecting Custom Key during key configuration, then selecting the required scopes as mentioned above.

Event Tracking

Once the integration is connected, Spree automatically tracks the following customer events and sends them to Klaviyo:

• Product view
• Product list view
• Product search
• Product added to cart
• Product removed from cart
• Checkout step view
• Checkout step complete
• Coupon entered/removed
• Coupon applied/denied
• Checkout email entered
• Newsletter subscription
• Unsubscribe from newsletter
• Order Completed
• Package Shipped
• Cancelled Order

These events populate the Audience → Profiles section in Klaviyo, where you can view each user's tracked activity and properties. Lists used for newsletter subscriptions can be found in Audience → Lists & Segments.

Managing Your Integration

After setup, you can revisit the integration form at any time to:

• Edit keys - useful if you want to swap out a list ID or rotate API keys.
• Update configuration - simply adjust the values and click Update.
• Delete the integration - click the Delete button in the bottom right of the form.