Skip to main content

Smart by Wunderkind Beta Klaviyo Integration Guide

Updated

Overview

  1. Create a Klaviyo Private API Key
  2. Create the Metric in Klaviyo that will be used for your Wunderkind flow
  3. Create and Configure your Wunderkind flow
  4. Optional but Recommended: Set up URL appending for increased identification

1. Create a Klaviyo Private API Key

To ensure we can seamlessly integrate and manage your email marketing campaigns on Klaviyo, we need access to an API key from your account. Please follow these steps, or watch the instructional video below for a visual guide:

  1. Navigate to https://www.klaviyo.com/integrations and log in using your Klaviyo credentials
  2. Click on "Account" (bottom left hand side. Note that the actual name will reflect your Klaviyo Account.)
  3. Click "Settings" and select "API Keys"
  4. Click "Create Private API Key"
  5. In the "Private API Key Name" field, we recommend using Wunderkind for easy reference. However, if this name is already in use, please select an alternative of your choice.
  6. Select the "Full Access Key" radio button
  7. Click "Create"
  8. Since this is the only opportunity to view the key value, we strongly recommend downloading it.

 

2. Create your Metric in Klaviyo

Your Klaviyo Integrations utilizes a Wunderkind metric in order to send emails. Please follow these steps in order to begin the configuration process.

  1. Download this CSV
  2. Navigate to https://www.klaviyo.com/integrations and log in using your Klaviyo credentials
  3. Click on "Manage Sources", then “Import via CSV”
  4. Upload the CSV that you downloaded in Step 1 and click “Next”
  5. In the "Name of event / action" field, enter Wunderkind
  6. Click "Next"
  7. Click "Done" once the Import is successful (Green Status bar is full)

 

3. Create and Configure your wunderkind Flow

Now, you will configure your Wunderkind flow. Please follow these instructions exactly, as the names that you give need to match exactly. Please also note: Once a Metric is selected, it cannot be changed. You will have to delete the flow with the wrong Metric and create a new flow. 

  1. Click "Flows" in the left-hand menu
  2. Click the "Create flow" button on the top right
  3. Click "Build your own" button on the top right
  4. Name the flow Wunderkind
  5. In the "Tags" dropdown, create a tag named wknd, and make sure it's checked
  6. Click "Create manually"
  7. Click "Your metrics" (middle tab on the left-hand menu)
  8. Click "API", then find and select the Wunderkind metric
  9. Click "Save", then "Confirm and save"
  10. Click the Email box under the ACTIONS heading in the left-hand menu and drag it under the “Trigger” box
  11. Click inside the white box named "Email #1"
  12. In the right-hand menu, scroll down to "Settings"
  13. Make sure that "Skip recently emailed profile" and "Enable UTM Tracking" are NOT checked and click “Save”
  14. Click the three dots in the top right corner of the box named "Email #1" and click "Edit"
  15. In the “Subject line” field, replace the default text with: {{event.subject | safe}}
  16. Click on the "HTML" box (middle-right)
  17. Copy and Paste the code below to replace the default HTML code in Klaviyo
<html>
<head>
<style>
body {margin:0!important;}
a {text-decoration:none;}
a[x-apple-data-detectors] {color:inherit!important;}
@media screen and (min-device-width:10px) and (max-width:600px) {
.full {width:100%!important;height:auto!important;}
.hide {width:0!important;height:0!important;font-size:0!important;line-height:0!important;overflow:hidden!important;float:left!important;display:none!important;}
.show {display:block!important;width:100%!important;height:auto!important;overflow:visible!important;float:none!important;clear:both!important;}
table.show {display:table!important;}
span.show {display:inline!important;}
.block {display:block!important;}
.center {margin:0 auto!important;text-align:center!important;float:none!important;clear:both!important;}
.box {width:90%!important;}
.prod {width:80%!important;}
}
@media screen and (min-device-width:10px) and (max-width:450px) {
h1 {font-size:30px!important;line-height:1.2!important; }
}
</style>
<!--[if gte mso 9]><xml><o:OfficeDocumentSettings><o:AllowPNG/><o:PixelsPerInch>96</o:PixelsPerInch></o:OfficeDocumentSettings></xml><![endif]-->
</head>
<body style="padding:0;-webkit-font-smoothing:antialiased;" class="body">
{{ event.body | safe }}
</body>
</html>
  1. Click "Save", then “Done”
  2. Click the "Draft" dropdown in the bottom right corner of the "Email #1" box email box and change the status to Live
  3. Click the "Exit" button in the top right corner 

4. Enable URL Identification

This step is optional, as it will not impact your ability send Wunderkind messages. However, we recommend that you take the time to enable URL Identifications as it will help you scale the number of emails that we can send and drive more incremental revenue

 

  1. Click on "Account" (bottom left hand side. Note that the actual name will reflect your Klaviyo Account.)
  2. Click "Settings"
  3. Click the tab named "Other"
  4. Select "UTM tracking"
  5. Click "Add UTM parameter" and enter the following values for each field:
    1. UTM parameter: bxid
    2. Campaign value: Klaviyo profile id
    3. Flow value: Klaviyo profile id
  6. Make sure that “Automatically add UTM parameters to links” is enabled
  7. Click "Save"

Related articles

Powered by Zendesk