Pixelflow
Wordpress

WooCommerce

This article guides you through the process of how to set up the Facebook Conversions API on WooCommerce using PixelFlow.

1. Install the PixelFlow WordPress Plugin

  1. Download the PixelFlow plugin from here

  2. After installation completes, click Activate

  3. Navigate to Settings → PixelFlow Settings in your WordPress admin menu

  4. Or click the Settings link directly under the plugin name in your Plugins list

PixelFlow plugin with settings link highlighted

2. Login to the Plugin

When you first open PixelFlow Settings, you'll see a Welcome screen with authentication options.

  1. Click Login if you have an account or Start Free Trial if you're just starting

  2. Complete the setup in your dashboard and go back to your WooCommerce store and click Activate PixelFlow in the plugin, then press "Save Changes & Insert Script"

Your PixelFlow tracking script is now active! PixelFlow will automatically begin tracking Page View events on your WordPress site within 2-3 minutes.

Clear your cache: If you use any caching plugin (such as WP Rocket, W3 Total Cache, or WP Super Cache), you must clear your cache to ensure the PixelFlow script loads on your live website.

3. Complete Setup

The final wizard step helps you verify your setup is working correctly.

  1. Visit your live website in a new browser window or incognito/private mode

  2. Navigate to a few pages on your site (e.g., homepage, then click some links)

  3. Return to the PixelFlow wizard and you should see confetti.

  4. Your site status will change to "Connected" in the Pixels table on your Overview page

Setup complete! PixelFlow is now tracking Page View, Add to Cart, Initiate Checkout and Purchase automatically events on your WooCommerce website. Events should appear in your PixelFlow dashboard within 2-3 minutes.

No events appearing? If you don't see events after a few minutes, verify that:

  • "Activate PixelFlow" is toggled ON in the plugin

  • You clicked "Save Settings & Insert Script"

  • You cleared your cache (if using a caching plugin)

  • You're visiting the live site (not a local development environment)

Advanced Configuration

There are a number of additional settings you can enable in the plugin:

Exclude Script for User Roles

You may not want to track events for yourself, editors, or other WordPress user roles. By default, all site visitor actions are tracked.

To exclude specific user roles from tracking:

  1. In Settings → PixelFlow Settings, scroll to the Advanced section

  2. Select the user roles you want to exclude (Administrator, Editor, Shop Manager, etc.)

  3. Click Save Settings

Excluding admin and editor roles prevents test actions from inflating your event counts and ensures your Meta Ads data stays accurate.

Choose Which WooCommerce Events to Track

In your PixelFlow plugin you'll see "Additional Options". This lets you:

  • Toggle ON Track WooCommerce eCommerce Events

  • Select which events to track (all are enabled by default):

    • Add to Cart – Triggered when a customer adds a product to their cart

    • Initiate Checkout – Triggered when a customer begins checkout

    • Purchase – Triggered when a customer completes an order

PixelFlow WooCommerce Settings showing toggles for tracking eCommerce events

What data is tracked? PixelFlow captures all available product data from WooCommerce including product name, ID, price, SKU, categories, quantity, currency, and customer information. This data is automatically enriched and sent to Meta for improved targeting and attribution.

Disable Free Product Tracking

By default, PixelFlow tracks all WooCommerce events including those for free products ($0 value).

To disable tracking for free products:

  1. In WooCommerce Settings, toggle OFF Purchase for free products

  2. Click Save Changes & Insert Script

When disabled, Add to Cart, Initiate Checkout, and Purchase events will not fire for products with a price of $0.

Why track free products? If you offer free trials, lead magnets, or free tiers that convert to paid products, tracking these events helps Meta understand your full conversion funnel and optimize for higher-quality leads.

Manual Tracking with Classes (Optional)

WooCommerce eCommerce events are fully automatic. However, you can still use event classes to track other interactions on your WooCommerce store, such as:

  • Custom buttons (e.g., "Request Quote," "Add to Wishlist")

  • Contact forms

  • Newsletter signups

  • Custom CTAs

See Event Classes on WordPress for instructions on adding tracking classes to custom elements.

Was this helpful?