About this plugin
GlobalDev SignalBridge for OpenAI Ads adds the OpenAI Ads Measurement Pixel to WordPress and provides configurable tracking for WordPress content, WooCommerce commerce actions, common form submissions, registrations, subscription events, URL-based success events, and custom events. For WooCommerce purchases it can also send paid order_created events through the OpenAI Conversions API from the server.
The plugin accepts the complete OpenAI base pixel snippet from Ads Manager. For security, it does not store or execute arbitrary pasted JavaScript. It extracts the pixelId and debug setting, then generates the fixed official SDK loader itself.
Current standard events supported:
- page_viewed – selectable public WordPress post types plus optional archive/search/taxonomy/404 routes.
- contents_viewed – WooCommerce single product pages.
- items_added – successful WooCommerce AJAX/Blocks add-to-cart actions plus non-AJAX fallback.
- checkout_started – WooCommerce checkout page with cart value/currency/contents when available.
- order_created – paid WooCommerce order on a valid order-received URL, with order value/currency/contents, stable event ID, mandatory order-key validation, and a persistent one-time database guard.
- lead_created – successful Contact Form 7, Elementor Pro Form, and WPForms AJAX submissions, plus optional success URL rules.
- registration_completed – frontend WordPress/WooCommerce registrations plus optional success URL rules.
- appointment_scheduled – configurable success URL rules or JavaScript API.
- trial_started – configurable success URL rules, JavaScript API, and automatic WooCommerce Subscriptions trial detection when available.
- subscription_created – configurable success URL rules, JavaScript API, and automatic WooCommerce Subscriptions parent-order detection when available.
- custom – configurable custom event name and URL rule, plus JavaScript API.
The plugin maps each standard event to the OpenAI data type documented by the official OpenAI Ads Measurement Pixel GTM template:
- contents: page_viewed, contents_viewed, items_added, checkout_started, order_created.
- customer_action: lead_created, registration_completed, appointment_scheduled.
- plan_enrollment: trial_started, subscription_created.
- custom: custom event.
gdOpenAIAdsTrack() for integrations that need to fire a standard event at a business-specific success point.
Optional server-side purchase tracking uses the OpenAI Conversions API. com/v1/events using the same wc_order_{ID} identifier as the browser Pixel so OpenAI can deduplicate browser and server delivery. The Conversions API key is stored only in WordPress options and is never exposed to frontend JavaScript.
Successful server delivery is recorded in WooCommerce order metadata and failed deliveries are retried a limited number of times.
WooCommerce attribution diagnostics can record an OpenAI Ads click when the official oppref signal is present and can record a direct ChatGPT referral when a browser referrer is available. These local records are stored on WooCommerce orders and are diagnostic only; OpenAI Ads Manager determines final ad attribution.
An optional enhanced matching setting can add supported customer matching fields to Pixel initialization when they are available. Email, phone, first name, last name and external customer ID are normalized and SHA-256 hashed server-side. Supported location fields are passed in the format accepted by the OpenAI Pixel.
This setting is disabled by default and should be enabled only when the site owner’s privacy and consent configuration permits it.
This community plugin is developed by GlobalDev and is not affiliated with or endorsed by OpenAI. OpenAI and ChatGPT are trademarks of their respective owner.
External services
This plugin connects to OpenAI Ads measurement services when configured.
The browser loads the official JavaScript SDK from:
js
Measurement events are transmitted by the OpenAI SDK according to the configured Pixel ID and enabled events. When Conversions API / server-side tracking is enabled, paid WooCommerce order_created events are also sent from the WordPress server to:
com/v1/events
Server requests use the saved Conversions API key in an Authorization header and the configured Pixel ID as the pid query parameter. This external service is required for OpenAI Ads tracking functionality.
OpenAI terms and privacy information:
com/policies/terms-of-use/
com/policies/privacy-policy/
Site owners are responsible for appropriate privacy disclosures and for obtaining any consent required by applicable law before enabling measurement technologies.
Privacy
The plugin stores its WordPress configuration, including Pixel ID, debug preference, event toggles, post-type selections, URL trigger rules, product identifier preference, attribution setting, enhanced-matching setting, Conversions API enablement, and the Conversions API key when supplied.
When local attribution is enabled and a qualifying OpenAI Ads or ChatGPT source signal is detected, the plugin may set a signed first-party attribution cookie for up to 30 days and save source metadata on the resulting WooCommerce order. The OpenAI oppref value, when available, is stored with the order for diagnostics.
When enhanced matching is enabled, supported customer identifiers are normalized and hashed before being added to OpenAI measurement payloads. Supported location values may be sent in the documented format. For Conversions API purchase events, the OpenAI browser reference ( __obref ), customer IP address, and user agent may also be sent when available.
Frontend measurement data is sent through the OpenAI Ads Measurement Pixel when configured. Review OpenAI documentation and your applicable privacy/consent obligations before deployment.