How to Connect Convertful with Klaviyo
With Convertful you can easily integrate your account with Klaviyo and use widgets to grow and segment your mailing list. Just follow the guide below to set up Klaviyo integration and set up relevant actions.
Connecting Integration #
In your Convertful site’s Integrations tab, add new integration by choosing Klaviyo from the list. It will request your API key, which you will need to create in your Klaviyo account.
Go to Settings in your Klaviyo Account, click on API Keys and create a custom Private API Key for use with Convertful.
Select "Read/Write Access" for the options "List" , "Profiles" and "Subscriptions".
Copy and Paste the API Key from Klaviyo to Convertful and click the Connect button.
Default Settings #
Once Klaviyo is connected, by default, each widget will automatically add subscribers with the default settings that you specify in the integrations’ settings.
Note, that default settings are not mandatory and you can always specify custom lists manually for each specific widget while editing its button's actions.
Double Opt-in #
Note that if you have Double Opt-in enabled in Klaviyo for API or for the specific Klaviyo List that you are using, contacts will not be added to Klaviyo until they have opted in via the email sent to them by Klaviyo. You can read more about Double Opt-in Settings in Klaviyo here.
Mapping Custom Fields #
We try to find the most relevant Klaviyo custom field for every Convertful field automatically. But if you need to fine-tune which fields we should use, you can do this in the integration settings, by editing Custom Fields list:
Actions #
When editing your widget's button, inside its settings you can see “On Submit Actions” / “On Click Actions” which you can use to perform actions provided by Klaviyo integration:
- Add subscriber with default settings
- Add subscriber to a list
- Remove subscriber from a list
- Update custom field
When updating custom fields you can send the dynamic data to the integration:
Widgets Display Rules #
Once the integration is connected you’ll be able to use the new Show If targeting options in the widgets’ Display Rules:
Identifying Visitors #
To target widgets by the integration’s data, Convertful needs to identify a visitor. This happens when either:
- The visitor submits his/her email address via one of your widgets.
- The visitor opens your site with the special conv_email tracking parameter that contains his/her email address.
So you can add the:
?conv_email={{ email|default:'' }}
to your Klaviyo emails’ links, and when your subscribers open these links, they will be properly identified for targeting rules:
In Convertful, Site > Subscribers section, you can view the synchronized custom fields for each of the identified subscribers.