Description
PixelCue CAPI Events for WooCommerce is a lightweight server-side purchase tracking plugin for WooCommerce stores.
The plugin sends one server-side Purchase event to the Meta Conversions API when a WooCommerce order first reaches Processing or Completed status. It is designed to keep WooCommerce order status handling as the source of truth and to avoid duplicate Purchase events by storing a sent marker on each order.
Features:
- Sends WooCommerce Purchase events to the Meta Conversions API.
- Triggers from WooCommerce order status changes.
- Sends only for Processing and Completed orders by default.
- Sends each order only once.
- Supports Test mode and Live mode.
- Includes hashed customer matching data when available.
- Includes
_fbp,_fbc, IP address, and user agent when available. - Includes commerce fields such as currency, value, order ID, content IDs, contents, and number of items.
- Compatible with WooCommerce High-Performance Order Storage (HPOS).
- Provides developer filters for consent checks, allowed statuses, payload customization, and API version control.
PixelCue does not add a browser pixel, consent banner, or consent-management interface. Store owners are responsible for configuring any required consent, privacy disclosures, and browser-side event deduplication.
Third-party services
This plugin connects to the Meta Graph API / Conversions API to send configured WooCommerce Purchase events.
Service endpoint used by default:
https://graph.facebook.com/v25.0/{pixel_id}/events
Data sent may include:
- Purchase event name, time, event ID, and order-received URL.
- Order currency, total value, order ID, item IDs, item quantities, item prices, and item count.
- Hashed customer matching fields such as email, phone, name, city, state, postcode, and country when available.
_fbpand_fbccookies when available.- Customer IP address and browser user agent when available.
This data is sent only when the plugin is configured with a Pixel ID and Conversions API access token, and when an eligible WooCommerce order reaches Processing or Completed status.
Meta terms and policies:
- https://www.facebook.com/legal/terms
- https://www.facebook.com/privacy/policy/
- https://developers.facebook.com/docs/marketing-api/conversions-api/
Developer filters
Allow or block a Purchase event before it is sent:
pixelcue_capi_events_can_send_purchase_event
Customize the eligible statuses:
pixelcue_capi_events_allowed_purchase_statuses
Customize the outgoing payload:
pixelcue_capi_events_purchase_payload
Customize the Graph API version:
pixelcue_capi_events_api_version
Installation
- Upload the plugin files to the
/wp-content/plugins/pixelcue-capi-events-for-woocommerce/directory, or install the plugin through the WordPress Plugins screen. - Activate the plugin.
- Go to WooCommerce > PixelCue CAPI.
- Enter your Meta Pixel ID and Conversions API access token.
- Choose Test mode or Live mode.
- In Test mode, enter the Test Event Code from Meta Events Manager.
- Save settings and place a new test order.
FAQ
-
When does PixelCue send a Purchase event?
-
By default, PixelCue sends one Purchase event when an order first reaches Processing or Completed status.
-
Does PixelCue send events for On hold orders?
-
No. By default, PixelCue sends Purchase events only for Processing and Completed orders.
-
Does PixelCue send duplicate Purchase events?
-
PixelCue stores a sent marker on each order after Meta accepts the event. If the same order changes status again later, the event is skipped.
-
Does PixelCue add a browser pixel?
-
No. PixelCue sends server-side Purchase events only. It does not add browser pixel code.
-
What event ID does PixelCue use?
-
PixelCue uses this format:
wc_order_ORDER_NUMBERFor browser/server deduplication, your browser Purchase event should use the same event ID.
-
No. PixelCue does not include a consent banner or consent-management interface. Developers can use the
pixelcue_capi_events_can_send_purchase_eventfilter to prevent sending when consent is not available. -
Is PixelCue compatible with HPOS?
-
Yes. PixelCue declares compatibility with WooCommerce High-Performance Order Storage.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“PixelCue CAPI Events for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “PixelCue CAPI Events for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.1
- Removed the Plugin URI header so the plugin and author URI values are not duplicated for WordPress.org submission.
1.0.0
- Initial release.