Klaviyo Integration
Connect Klaviyo with Scout to automatically send your e-commerce events to Klaviyo.
Requirements
Setup for Store Owners
Create Klaviyo API Key
Klaviyo Dashboard > Settings > API Keys > Create Private API Key. Grant Full Access for Profiles and Events.
Add Destination in Scout
Dnomia Dashboard > Scout > Destinations > New Destination. Select Klaviyo, paste Private API Key. System will validate the key and display account name.
Event Routing Setup
From Scout > Rules, define which events to send to Klaviyo. Create rules for events like Purchase, AddToCart, ViewContent.
Test and Verify
Send a test event from Scout > Events. Verify that Placed Order or other events appear in Klaviyo > Analytics > Metrics.
Event Mapping
Scout events are automatically transformed to Klaviyo metrics:
Profile Management
A Klaviyo profile is created or updated (upsert) with each event. Email is required. Profile fields sent: email, phone, first_name, last_name, UTM parameters, browser IDs (_fbp, _fbc, gclid), session data.
If profile already exists (409 Conflict), the existing profile ID is automatically retrieved and the event is linked to that profile.
Item-Level Events
A separate Ordered Product event is sent for each product in an order. This enables segmentation in Klaviyo like 'customers who bought Product X'.
Session and Attribution Data
Scout adds session and attribution data to each event: session_count, is_new_visitor, UTM parameters (source, medium, campaign), referrer, and landing page.
Error Handling
Consent Management
Scout filters events based on consent status. Events with denied status are not sent to Klaviyo. GDPR-compliant data processing.
Troubleshooting
Events not appearing in Klaviyo
Events without an email address are not sent to Klaviyo. Use the SDK identify method to send email. Check event status in Scout > Events.
Profile duplicates
Scout uses Klaviyo's profile upsert mechanism. Profiles with the same email are automatically merged.
Rate limit exceeded
Klaviyo API is limited to 5 requests per second. Scout automatically manages this limit and retries when needed.