WooCommerce Integration

Integrate WooCommerce with CustomerLabs to track user behavior, capture ecommerce events, and unify customer profiles for better marketing performance across your martech stack.

How the Integration Works

The WooCommerce integration consists of two components:

1. Plugin-Based Tracking (Browser Events)

The CustomerLabs WordPress plugin automatically tracks:

• Product Viewed
• Category Viewed
• Add to Cart
• Remove from Cart
• Checkout Initiated
• Purchase Completed

2. Webhook-Based Tracking (Server Events)

When an order is created in WooCommerce:

• A webhook sends enriched order data
• CustomerLabs processes the payload
• Customer profiles are updated automatically

1. Prerequisites

• Ensure you have admin access to your WooCommerce (WordPress) store and an active CustomerLabs account.
• The WooCommerce REST API must be enabled to send purchase data via webhooks.

2. Install CustomerLabs Plugin

Step 2.1: Install the Plugin

1. Log in to your WordPress Admin panel

2. Navigate to: Plugins → Add New

   

3. Search for CustomerLabs

4. Click Install Now

5. Click Activate

   

   Note

   To update: Plugins → Search “CustomerLabs” → Click Update Now

Step 2.2: Configure Plugin Settings

1. Log in to CustomerLabs

2. Copy your Account ID from the dashboard

3. Go to: WordPress → Plugins → CustomerLabs → Settings

   

4. Paste the Account ID into the CustomerLabs App ID field

5. Click Save

   

Step 2.3: Enable Event Tracking

In the plugin settings, enable the following events:

• Product Viewed
• Category Viewed
• Add to Cart
• Remove from Cart
• Checkout Initiated
• Purchase

Click Save Settings.

Tip

Recommended: Enable all events to capture the complete customer journey.

3. Create WooCommerce Source in CustomerLabs

Step 3.1: Generate REST API Keys

CustomerLabs requires API access to receive enriched order data.

1. Navigate to: WooCommerce → Settings → Advanced → REST API

2. Click Add Key

   

3. Enter the following details:

   Field	Value
   Description	CustomerLabs Integration
   User	Admin
   Permissions	Read/Write

4. Click Generate API Key

   

You will receive a Consumer Key (ck_...) & Consumer Secret (cs_...). Save these securely.

Step 3.2: Configure Source in CustomerLabs

1. Log in to CustomerLabs

2. Navigate to Sources

3. Select WooCommerce

   

4. Enter the following:

   Field	Value
   Store Domain	yourdomain.com
   Consumer Key	ck_xxxxx
   Consumer Secret	cs_xxxxx

5. Click Save

   

After saving:

• A unique Workflow URL will be generated

• Webhook configuration will be automatically enabled

  

4. Webhook Configuration & Verification

Webhooks are created automatically during setup.

To Verify:

1. Go to: WooCommerce → Settings → Advanced → Webhooks

2. Confirm the following:

   Field	Expected Value
   Name	CustomerLabs Integration
   Status	Active
   Topic	Order Created
   Delivery URL	Workflow URL from CustomerLabs
   Secret	Empty
   API Version	Default

5. Workflow Templates Available

After source creation, you can use pre-built templates:

• CL_All_Purchasers: Captures all WooCommerce orders.
• WooCommerce Repeat Users: Triggers when a returning customer places an order.
• WooCommerce New Users: Triggers for first-time customers.