Integrate with WooCommerce

read
Last updated at:

Overview

This article walks through enabling the WooCommerce integration in your Klaviyo account.

The main steps to integrating with WooCommerce are:

  • Install the Klaviyo WooCommerce plugin
  • Enable the WooCommerce integration

We'll also walk through adding an opt-in checkbox to your WooCommerce checkout page and connect it to your Klaviyo subscription list. 

The WooCommerce integration syncs data into Klaviyo in real time.

Install the Klaviyo WooCommerce Plugin

The Klaviyo WooCommerce Wordpress plugin allows you to add a newsletter signup form to your website, enable website activity tracking, and get data about when people start checkouts and view products so you can send out abandoned cart emails. 

To upload the plugin head over to WooCommerce. Hover over the Plugins tab and click Add New
WooInt1.png

Search for Klaviyo within Search plugins. When you've located the Klaviyo plugin, click Install Now.
WooInt2.png

Click Activate to activate the plugin. 
WooInt3.png

Your plugin is now installed. To configure your plugin you'll need your Public API Key / Site ID.

Switch over to Klaviyo and navigate to Account > Settings > API Keys. Copy your API Key.

WooInt4.png

Head back to WordPress and navigate to Plugins. Scroll down to find the Klaviyo plugin and click Settings.
WooInt5.png
Fill in these settings:

  • Public API Key: Also known as your Site ID. Paste the Public API Key/Site ID you copied above.
  • Add a subscribe to newsletter checkbox on the checkout page: Enable this option so that your customers can opt into communications directly from your WooCommerce checkout. Paste the List ID of your newsletter list here. 
  • Subscribe to newsletter text: This is the label for your opt-in button. Be sure the label text is clear so customers understand that they are opting-in to your newsletter.

WooInt6.png
Select Enable Klaviyo signup forms so your customers can subscribe through Klaviyo. Then click Save Settings

Your Plugin is updated directly through your WordPress store. Release Notes can be found bundles with your plugin updates. For more information about installing updates or finding Release Notes read: Find WooCommerce Extension Updates and Release Notes.

Enable the WooCommerce Integration

To enable the WooCommerce integration, first you'll create an API key and secret in your WooCommerce account. Then, you'll head over to Klaviyo and add the API and secret to your WooCommerce integration settings. 

From Wordpress, navigate to WooCommerce > Settings > Advanced > Rest API. Generate an API key and secret by clicking Add key.
WooInt7.png

Fill in the Key details:

  • Description: type in a friendly name like "klaviyo"
  • User: keep the default user, or pick another one from the dropdown
  • Permissions: choose Read/Write

Click Generate API key.

You've created a consumer key and a consumer secret. Keep this tab open because you'll need both these values in the next step. 
Switch into your Klaviyo account and navigate to Integrations. On the All Integrations tab search for the WooCommerce Integration. Then, click Add Integration.

Enter your integration settings:

  • Store URL: This is the same URL customers use to access your site.
  • WooCommerce Consumer Key: Paste the consumer key that you created in the previous step. 
  • WooCommerce Consumer Secret: Paste the consumer secret that you created in the previous step.
  • Subscribe new customers to a Klaviyo list: We generally recommend that this option NOT be checked. When selected, this option will sync all new contacts who purchase to a list. Since Woo Commerce doesn't by default provide an "accepts marketing" checkbox, this means that many checkout forms don't have them, and thus the shopper is not aware that they are opting in. So in most cases, this checkbox should be left unchecked. If you do choose to enable this checkbox, select a list from the dropdown as well. 

    Remember that you are able to add an "accepts marketing" checkbox to your checkout via the WooCommerce plugin by enabling the Add a subscribed to newsletter on the checkout page option in your WooCommerce plugin settings. This setting was covered earlier in the Install the Klaviyo WooCommerce Plugin section of this guide. If you choose to enable this plugin setting, you'll need to specify a list ID as well. Click here to review those instructions.

WooInt10.png

Click Connect to WooCommerce.

If you're experiencing trouble with this step, double-check that you're using the correct store URL, consumer key, and consumer secret. Note that the store URL is the same URL customers use to access your site.

Your data will begin to sync with Klaviyo in minutes. You've successfully enabled the WooCommerce integration.

Test Your WooCommerce Integration

To test out your integration and plugin, go to your website and follow these instructions:

  1. Add an item to your cart.
  2. Go to the checkout page.
  3. Fill in your email address on the checkout page. 
  4. Go to your activity feed on your dashboard, look for the Started Checkout metric, and you should see your checkout appear.

Sync a WooCommerce Sign Up Form to a Klaviyo List

The last thing you'll want to do is customize your newsletter subscription form so it connects to Klaviyo. Go to Appearance > Widgets from your WordPress Dashboard. Select "Klaviyo: Email Signup" and select the type of subscription you want (depending on your Wordpress theme). If you need help finding your Klaviyo List ID, follow these instructions.

Monitoring the Historical Data Sync

When you first integrate with WooCommerce, Klaviyo will sync the last 90 days of your WooCommerce data so you can get started right away with engaging your most recent customers. After the sync of your most recent 90 days of data, Klaviyo will begin your complete historical data sync. Depending on how many orders, customers, and products your store has, it can take anywhere from a few minutes to several days to sync all of your data.

Once the historical sync is complete, new WooCommerce data will sync to Klaviyo in real time.

To check the progress of the initial sync, click on the Metrics tab in the sidebar.

Find the Placed Order metric and change the date range of the graph to see which dates have been fully synced. When the sync is complete, the WooCommerce integration in the Integrations tab will be marked complete. If you want to verify for yourself that all data from WooCommerce is synced, you can cross-check the total orders for a few days or a week. Before you start validating, make sure your account's timezone matches the settings in WooCommerce.

To check or update your account's timezone, go to the Account Settings page and check the Contact Information > Organization section.

Data Synced into Klaviyo

WooCommerce sends ecommerce events over to Klaviyo which can be viewed in the Metrics tab of your Klaviyo account. Navigate to Metrics and select WooCommerce from the dropdown to view only WooCommerce events. Notice that WooCommerce events are associated with a WooCommerce icon.

WC_metrics_1.png

  • Started Checkout metric is created when:
    • A customer logs into their account, adds something to their cart, and then views the checkout page.
    • A customer adds something to their cart, views the checkout page, and enters a billing address.
  • Placed Order metric is created when a customer completes the checkout process and creates an order in WooCommerce.
  • Ordered Product metric is created when a customer places an order for a specific item. If a customer orders two of one item, two Ordered Product metrics are tracked.
  • Fulfilled Order metric is created when a customer order is marked "shipped" in your WooCommerce store.
Note: By default, Klaviyo syncs the following statuses for Placed Order: processing, completed, refunded, cancelled.

For example, say a customer logs into their account and adds two red belts and a tan belt to their cart. A Started Checkout metric is tracked. Then, the customer places an order for the red belts and the tan belt. One Placed Order metric is recorded, and three Ordered Product metrics are recorded - two for each of the red belts and one for the tan belt. When the products are marked shipped, a Fulfilled Order metric is recorded.

Other Resources

Congratulations on getting set up! Now that you've got your integration running, it's time to start adding Klaviyo's core features so you can start making money and grow your business.

Use the WooCommerce Setup Checklist for ideas on what to complete next.

Rebuilding Carts from an Abandoned Cart Flow

You can use WooCommerce Data to Rebuild Carts from an Abandoned Cart Flow.

We will generate a key on the Started Checkout event that allows you to create a link that rebuilds the customer's cart in case they return to their cart via an email triggered by this event on another device. You can create this link using the following url parameter in an Abandoned Cart flow email triggered by a Started Checkout:

?wck_rebuild_cart={{ event.extra.CartRebuildKey }}

Assembled, the url should look like the following:

{{ organization.url }}cart?wck_rebuild_cart={{ event.extra.CartRebuildKey }}

The dynamically-generated product title link pulls directly from the URL you have inserted in your account settings. You may need to add a forward slash to your URL parameters between {{ organization.url }} and cart to resolve any errors with the destination URL. To add the forward slash, navigate to Table Block > Rows > Column 2 and double click the hyperlinked product title tag. Add the forward slash to the URL in the window and click OK.

forwardslash.png

Using WooCommerce Subscriptions Data

Learn about using WooCommerce Subscriptions Data in Campaigns and Flows.

x
Was this article helpful?
341 out of 522 found this helpful