Descripció
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
Instal·lació
- 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.
PMF
-
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.
Ressenyes
No hi ha ressenyes per a aquesta extensió.
Col·laboradors i desenvolupadors
«PixelCue CAPI Events for WooCommerce» és programari de codi obert. La següent gent ha col·laborat en aquesta extensió.
Col·laboradors
Traduïu «PixelCue CAPI Events for WooCommerce» a la vostra llengua.
Interessats en el desenvolupament?
Navegueu pel codi, baixeu-vos el repositori SVN, o subscriviu-vos al registre de desenvolupament per fisl de subscripció RSS.
Registre de canvis
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.