Description
Ridoway Pixel makes it easy to add OpenAI Ads (ChatGPT Ads) conversion tracking to your WordPress website — no coding required.
Features:
* Easy setup — just paste your Pixel ID
* Automatic page view and product view tracking
* WooCommerce order tracking (items_added, checkout_started, order_created) with duplicate protection and order status control
* Contact Form 7 and WPForms lead tracking with hashed email matching
* Server-side Conversions API with retry queue — conversions are never lost
* Ad-click attribution (oppref) carried on server events
* Per-event on/off toggles
* GDPR consent support — defer until consent is granted
* Validate-Only test mode and debug mode
* Money amounts in the correct currency minor units for every currency
* Lightweight and fast
Who is this for?
Anyone running ads on ChatGPT (OpenAI Ads) who wants to track conversions on their WordPress site.
External Services
This plugin connects to OpenAI’s servers to send conversion data, and only when a valid Pixel ID is configured:
– Script loaded from: https://bzrcdn.openai.com/sdk/oaiq.min.js
– Browser events sent to: https://bzr.openai.com/v1/sdk/events
– Server-side Conversions API events sent to: https://bzr.openai.com/v1/events
The following data may be sent to OpenAI:
– The page URL and the visitor’s IP address and user agent
– Anonymous browser reference cookies (__oppref, __obref) set by OpenAI Ads for attributing conversions to ad clicks
– For lead forms (Contact Form 7, WPForms): a hashed (SHA-256) version of the visitor’s email address — never the raw email
No data is sent to Ridoway’s servers, and this plugin does not store personal data. Deactivating or deleting the plugin removes all queued data.
OpenAI Privacy Policy: https://openai.com/privacy
Screenshots
Installation
- Upload the plugin to /wp-content/plugins/ridoway-pixel/
- Activate the plugin through the Plugins menu
- Go to Settings > Ridoway Pixel
- Enter your OpenAI Ads Pixel ID
- Save settings — tracking starts immediately
FAQ
-
Where do I find my Pixel ID?
-
Log in to ads.openai.com, go to the Conversions tab, and create a new pixel. Copy the Pixel ID and paste it into the plugin settings.
-
Does this work with WooCommerce?
-
Yes. Enable WooCommerce tracking in settings to automatically track add to cart, checkout, and purchase events.
-
Does this slow down my site?
-
No. The pixel loads asynchronously and has no impact on page speed.
-
Is this plugin free?
-
Yes, completely free.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Ridoway Pixel” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Ridoway Pixel” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.0
- Security: inline script data is now JSON-encoded with HTML-safe flags (JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT)
- Removed load_plugin_textdomain() — translations are loaded automatically on WordPress.org hosted plugins
- Removed WordPress.org repository assets (banner, icons) from the plugin package
1.1.0
- Currency fix: amounts now use the correct minor units for every currency (JPY, BHD, etc.)
- Duplicate protection: reloading the thank-you page can no longer double-report order_created; failed/cancelled/refunded orders are excluded by default
- checkout_started now fires once per cart composition instead of on every reload
- Product pages now send contents_viewed; page_viewed no longer sends a fake contents item
- Server events carry the ad-click id (oppref) and obref for better attribution
- Conversions API delivery via a background queue with automatic retries, so events are not lost
- Validate-Only test mode to verify your setup without recording events
- Per-event tracking toggles (page, product, add to cart, checkout, order, lead)
- Consent support: defer events until consent is granted, with browser (window.ridowayPixelConsent) and server (ridoway_pixel_consent filter) hooks
- Lead events (Contact Form 7, WPForms) now include the hashed email for better matching
- Privacy: external data disclosure documented; deactivation/deletion removes all queued data and cron jobs
1.0.0
- Initial release