WooCommerce Setup

Install Meta Conversions API on WooCommerce by adding the PixelFlow script.

Advanced settings

All options below live in Settings → PixelFlow Settings under WooCommerce Settings. The defaults suit most stores, so change them only when you need a specific behavior.

Send Purchase events only for a customer's first order

Turn on Only the customer's first purchase (under Additional options) to stop repeat orders and subscription renewals from counting as new Purchase conversions. It is off by default, including after upgrading.

1. Under Count previous orders from, choose All time or The last N days. The day field takes a whole number of 1 or more and defaults to 60.

2. Leave Ignore previous free orders on (its default) so an earlier free order does not block the customer's first paid order.

3. Save your settings.

PixelFlow matches the customer by their WooCommerce account or a valid billing email and suppresses Purchase when a processing, completed, or refunded order already exists in your lookback period. A suppressed order sends no Purchase event and no blocked-event report. The setting affects new events only: orders already processed are not resent.

Store controls

The remaining options under Additional options control what your store sends to Meta:

• Product IDs for catalog ads. Send product IDs with your events in the format your Meta catalog uses, for dynamic product ads and catalog reporting.

• Exclude SKUs. Stop specific products (gift cards, samples, wholesale items) from triggering events.

• Free products. Choose whether free products trigger Add to Cart, Checkout, and Purchase events.

• Pick your events. Turn Add to Cart, Initiate Checkout, or Purchase on or off individually.

• Exclude script for user roles. Turn off the script for specific roles like admin or editor.

Automatic form tracking

Turn on form tracking and PixelFlow detects the forms on your site from the most popular form plugins:

• Contact Form 7

• Elementor Pro Forms

• Fluent Forms

• Gravity Forms

• Ninja Forms

• WPForms

Choose the event each form sends (Lead, CompleteRegistration, and more) and which fields to use. Contact details are normalised and SHA-256 hashed before they leave your server, and message text is never sent, stored, or logged. Only have one name field? Pick it for both first and last name and PixelFlow splits it automatically.