Start Here đ
Our WooCommerce integration is a plugin designed to seamlessly connect your WooCommerce store with Cometly. Once installed, the plugin will:
Automatically add the Cometly Pixel to the
<head>of your WooCommerce site.Install Add to Cart and Initiate Checkout events.
Set up a webhook to automatically send Purchase events to Cometly whenever a purchase is successfully completed.
Important: Read Before Installing
Before you install the Cometly WooCommerce plugin, please review the following key points.
Do Not Manually Install the Pixel
When setting up your Cometly workspace, do not manually install the Cometly Pixel on your WooCommerce store. The plugin will handle this automatically during installation.
Tracks Key Events
The WooCommerce plugin will automatically track Add to Cart, Initiate Checkout, and Purchase events.
Non-WordPress Pages Require Manual Pixel Installation
The WooCommerce plugin will not install the Cometly Base Pixel on non-WordPress landing pages. Youâll need to manually install the base pixel on any such pages to ensure complete tracking.
Plugin Is Workspace-Specific
Each Cometly workspace has its own unique WooCommerce plugin.
If you have multiple stores or workspaces, ensure you use the correct WooCommerce plugin for each workspace.
The plugin will install the pixel and purchase webhook specific to the selected workspace.
Step 1: Download the Cometly WooCommerce plugin
In your Cometly account, navigate to the Integrations page in your Cometly space and scroll down to the Connections section.
Click Add Integration
Select WooCommerce as your integration and click Next
Activate WooCommerce
Download the Cometly WooCommerce plugin.
Important Notice:
â
1. The plugin is specific to your Cometly space. If you have multiple stores, please make sure you download the plugin for the correct space.
â
2. If you have previously set up Cometly with an older plugin version or manually installed the Cometly Pixel, remove before adding the plugin.
Navigate to your WooCommerce store, and go to Plugins
Click Add New
Upload the Cometly WooCommerce plugin
Step 2: Clear Cache on your WooCommerce Store
As a WooCommerce store owner, you are most likely aware that Wordpress sites can have caching issues. Please make sure to clear your cache after you have installed the plugin to ensure tracking pixel accuracy.
If you use a site performance plugin, ensure you are not delaying javascript loading.
WP Rocket Instructions (For users who use WP Rocket)
If you use WP Rocket, you need to navigate to your WP Rocket settings to ensure you have unchecked specific settings.
â
In your WP Rocket settings, please navigate to FILE OPTIMIZATION
Scroll down to JavaScript Files and ensure that all of the following check boxes are UNCHECKED. Do not check these checkboxes or it will cause the Cometly pixel not to load properly.
Troubleshooting For WooCommerce Stores
Purchases Have Stopped Sending To Cometly From Your WooCommerce Store
If purchases have stopped sending to Cometly from your WooCommerce store, itâs possible that the WooCommerce webhook is no longer set to Active. To resolve this, follow our help article to reactivate your webhook and ensure purchases are tracked correctly.
Cometly Pixel Installed On WooCommerce Store Is Not Loading or Verifying In Cometly
If the Cometly Pixel is not loading or verifying in your Cometly account after being installed on your WooCommerce store, check for any site performance plugins that might be deferring or delaying JavaScript. Such plugins can prevent the Cometly Pixel from loading correctly, leading to inaccurate or missed attribution data. Ensure that JavaScript loading is not being delayed to maintain proper tracking.
â
Cometly WooCommerce Plugin Is Not Compatible
In the rare event that the Cometly WooCommerce plugin is not compatible (causing site/store issues, etc.) with your WooCommerce store (this could happen for custom build stores), you will not be able to use the WooCommerce and will have to set up the tracking manually. Follow the instructions below to manually set up tracking for your WooCommerce store:
Uninstall the Cometly Plugin.
Install the Cometly Pixel in the <head> of your WooCommerce store.
Navigate to Space Setup > Install Cometly Pixel to retrieve your pixel code.
You may use Google Tag Manager for pixel installation if needed.
Use Cometly Webhooks and manually place the webhook in your WooCommerce store.
Navigate to WooCommerce settings: On the left-hand menu, hover over âWooCommerceâ and click on âSettingsâ.
Navigate to the Advanced Tab: Within the WooCommerce Settings, click on the âAdvancedâ tab located at the top of the page.
Navigate to Webhooks: In the Advanced settings section, you will see a sub-menu. Click on âWebhooksâ.
Generate a Webhook in Cometly. Follow our Cometly Webhooks guide for this step.
Place the Cometly Webhook in your WooCommerce store:
Webhook name: Cometly
Webhook topic: order.updated
Set Webhook status to 'Active'
Click Save
Use Google Tag Manager to trigger the Add to Cart and Initiate Checkout events when a button is clicked. Follow our Google Tag Manager Guide for setting up Add to Cart and Initiate Checkout events.
Note: The Cometly pixel does not need to be in Google Tag Manager for these events to fire. These events will still fire properly if the Cometly Pixel is hard coded on your WooCommerce store.