Troubleshooting Viewed Product tracking

read
Last updated at:

You will learn

Learn how to troubleshoot issues with your Viewed Product tracking, which is used to track when visitors view products on your site. Viewed Product tracking is enabled via a JavaScript code snippet added to your site. For some ecommerce platforms, this snippet is added automatically when you integrate with Klaviyo. For other ecommerce platforms, it must be manually added to your product page template. 

Before you begin

Before consulting this guide, make sure you:

  • Enable Viewed Product tracking, if it was not added automatically through your integration.
  • Enable Klaviyo’s “Active on Site” JavaScript, known as Klaviyo.js, in order for Viewed Product tracking to work. Learn how in the "Active on Site" section below.

For the following ecommerce integrations, Viewed Product tracking works as follows:

All Shopify users (on both vintage and 2.0 themes) with Viewed Product issues are now encouraged to toggle on the Klaviyo app embed in Shopify to enable Viewed Product tracking. 

If you are using BigCommerce, or are a Shopify user who integrated before April 19, 2022, and thus added Viewed Product tracking manually, make sure that the snippet you’ve added to your site matches exactly with the snippets shown in the articles linked above. If you didn’t copy and paste the entire snippet, it will not work correctly. 

If you’re using an ecommerce platform without a pre-built Klaviyo integration, or a custom platform, learn about how to enable Viewed Product tracking on our Developer site

Test Viewed Product tracking

To test that your Viewed Product tracking is set up properly, follow these steps:

  1. Navigate to your website
  2. On your homepage, add the following to the end of the URL, replacing testing.email@gmail.com with your email address:
    ?utm_email=testing.email@gmail.com
    Shopify test store with ?utm_email=example@gmail.com appended to URL
  3. Reload the page
  4. Navigate to a product page on your site
  5. Search in Klaviyo for your email address
    Top corner of Klaviyo dashboard with testing.email@gmail.com in search bar

You should see that a Klaviyo profile has been created for you (if one didn't exist already) and that this product view has been tracked on your activity feed.

To see a feed of all Viewed Product metrics over time:

  1. Click the Analytics dropdown in Klaviyo and select Metrics
  2. Filter by Viewed Product to view tracked data in an activity feed, activity map, charts, best people, and cohort reports
    Metrics tab in Klaviyo with Viewed Product in search bar and Viewed Product in results with gear icon

Once you’ve reviewed the troubleshooting scenarios below and made changes, you should test your tracking again to make sure it’s working correctly. 

Table of contents

This guide covers the following troubleshooting scenarios:

  • Have you enabled Klaviyo's Active on Site tracking?
  • Have you recently switched ecommerce platforms?
  • Have you recently updated your store's theme, or made any other updates to your ecommerce platform?
  • For WooCommerce and Magento users: Are you using the most recent version of your integration plugin?
  • For Shopify and BigCommerce users: Is your ecommerce store connected to multiple Klaviyo accounts?
  • For Shopify users who integrated before April 19, 2022: Are you hosting products in your product.liquid file?
  • For Shopify users: Do you require cookie consent for visitors in the EU, EEA, UK and Switzerland prior to permitting onsite tracking?

Troubleshooting scenarios

Review the following questions in order to diagnose the cause of your Viewed Product issues. Note that some steps are general, and others depend on what ecommerce platform you are using. 

Have you enabled Klaviyo’s “Active on Site” tracking?

In order for Viewed Product tracking to work correctly, you must first enable Klaviyo’s Active on Site tracking which allows your customers to be cookied. Active on Site tracking is enabled via the addition of a JavaScript snippet (known as “Klaviyo’s onsite JavaScript” or “Klaviyo.js”) to your site.

Klaviyo adds Klaviyo.js automatically during the integration, though some integrations require that you check a setting to enable it. Learn about your specific ecommerce platform and how to test that Klaviyo.js is working:

  1. Shopify
    Klaviyo.js is added automatically through the integration or through the Klaviyo app embed in Shopify, if you enable it. If you integrated before April 19, 2022, you did not have the Klaviyo app embed option but can now enable it at any time. Learn more about the app embed and onsite tracking for Shopify
  2. WooCommerce
    Klaviyo.js is added automatically when you integrate with WooCommerce, and you can make sure that you’ve completed all steps by reading our WooCommerce integration guide. To test your onsite JavaScript, click your account name in the lower left corner, select Integrations, then click the Setup Web Tracking button in the upper right. Then, find the step where you can enter your site URL in the box, and follow the instructions to test your tracking. 
  3. BigCommerce
    Make sure you’ve checked the option on your integration settings page to Automatically add Klaviyo onsite JavaScript. Then, follow the steps to test your onsite JavaScript
  4. Magento 1
    Klaviyo.js is added automatically when you integrate with Magento 1, and you can make sure that you’ve completed all steps by reading our Magento 1 integration guide. To test your onsite JavaScript, click your account name in the lower left corner, select Integrations, then click the Setup Web Tracking button in the upper right. Then, find the step where you can enter your site URL in the box, and follow the instructions to test your tracking. 
  5. Magento 2
    Klaviyo.js is added automatically when you integrate with Magento 2, and you can make sure that you’ve completed all steps by reading our Magento 2 integration guide. To test your onsite JavaScript, click your account name in the lower left corner, select Integrations, then click the Setup Web Tracking button in the upper right. Then, find the step where you can enter your site URL in the box, and follow the instructions to test your tracking. 

Have you recently switched ecommerce platforms?

If you’ve recently switched ecommerce platforms, you’ll need to add Viewed Product tracking to your new site. Consult the information in the Before you begin section above to learn about Viewed Product tracking for your new platform. 

Have you recently updated your store’s theme, or made any other updates to your ecommerce platform?

If you’ve recently updated your store’s theme, you may need to reinstall both Klaviyo.js and the Viewed Product snippet on your new theme. Making other updates to your ecommerce platform may also affect the snippets previously added to your site.

To reinstall the Viewed Product snippet for BigCommerce, follow the instructions in the Before you begin section above.

If you’re using WooCommerce or Magento, or are using the Klaviyo app embed in Shopify, but you’ve made changes to your site and now the event isn’t tracking, you should contact Klaviyo support to help diagnose the problem.

For WooCommerce and Magento users: Are you using the most recent version of your integration plugin?

If you are using WooCommerce or Magento, problems with Viewed Product tracking might be related to other issues with your platform’s Klaviyo plugin. 

  1. If Viewed Product events aren’t tracking, check to see if the Started Checkout event is tracking by searching for Started Checkout within Analytics > Metrics in Klaviyo. 
  2. If both Viewed Product and Started Checkout aren’t tracking, there may be an issue with your plugin.
  3. Check to see if you are using the most up-to-date version of the plugin for your integration, if possible. If you are still having issues, please contact Klaviyo support

For Shopify and BigCommerce users: Is your ecommerce store connected to multiple Klaviyo accounts?

If you have one store connected to multiple Klaviyo accounts, this can cause problems with Active on Site and Viewed Product tracking. For instance, if you have a Shopify store integrated with two Klaviyo accounts, and integrated with Klaviyo before April 19, 2022 or are not using the Klaviyo app embed, there might be duplicate Klaviyo.js on your site. Duplicate Klaviyo.js can cause Viewed Product tracking to break. 

To check if you have duplicate Klaviyo.js:

  1. Navigate to your main theme file (in Shopify, typically the theme.liquid file). Klaviyo.js looks like this:
    <script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=API_KEY"></script>
  2. If you search for company_id within the file and find it twice (and see two of the snippets shown above) then you have duplicate Klaviyo.js. There will typically be two different API keys after the equals sign, one from each Klaviyo account. 
  3. To make sure the duplicate is removed correctly from your site, please contact Klaviyo support

For Shopify users who integrated before April 19, 2022: Are you hosting products in your product.liquid file?

The Viewed Product installation instructions for Shopify (non–2.0 themes) given to users who integrated before April 19, 2022 instructed you to add the snippet to the product.liquid file, which is where products are typically hosted. Depending on your store’s theme, you may host products in a different file (e.g., if you use a page builder like Shogun, GemPages, Pagefly, or Debutify build your product pages). Make sure that your Viewed Product snippet is added to the same file where your product code is hosted. To learn how to manually install the Viewed Product snippet on your file, check out our developer portal

For Shopify users: Do you require cookie consent for visitors in the EU, EEA, UK and Switzerland prior to permitting onsite tracking?

Based on your Customer Privacy settings in Shopify, Klaviyo may not track onsite events (including Active on Site, Viewed Product, and Added to Cart) for visitors to your Shopify store in the EU, EEA, UK and Switzerland, unless they have provided consent.

Contacting Klaviyo support

If you are still encountering issues after consulting this list and testing your tracking, please reach out on our Community or to our Support Team

Additional resources

x
Was this article helpful?
32 out of 67 found this helpful