ConvoPixel Conversion Tracking for ChatGPT Ads

ConvoPixel is an independent product. It is not affiliated with, endorsed by, or sponsored by OpenAI or Automattic. ChatGPT, OpenAI and WooCommerce are trademarks of their respective owners and are referenced here only to describe compatibility.

ConvoPixel is conversion tracking for ChatGPT Ads (OpenAI Ads) on any WordPress site. Paste your Pixel ID and ConvoPixel reports your leads, calls, sign-ups and page views to ChatGPT Ads Manager – plus every WooCommerce event if you run a shop – so you can see which results your ads bring in and run conversion-optimised campaigns.

Without conversion tracking, ChatGPT Ads can’t see your leads or sales. ConvoPixel installs the official OpenAI Ads Measurement Pixel, can send leads, sign-ups and purchases from your server through the Conversions API as well, and makes sure each conversion is counted once.

Built for lead generation

• Form leads from 10 form plugins, detected automatically: Contact Form 7, WPForms, Gravity Forms, Elementor Pro Forms, Fluent Forms, Formidable Forms, Ninja Forms, Jetpack Forms, MC4WP (Mailchimp for WordPress) and Forminator.

• Only real submissions count. Leads are recorded when the form plugin confirms a successful submission, so spam and failed validation are left out.

• Any other form – theme, page-builder or custom forms – by adding its CSS selector.

• Thank-you pages for leads and appointments, for booking plugins and forms that redirect.

• Calls and chat. Click-to-call and click-to-chat links can be counted as leads, ideal for local businesses.

• Lead value. Give leads an average value (for example 500 INR) so ChatGPT Ads can report conversion value.

• Sign-ups from WordPress registration, WooCommerce and membership plugins that create WordPress users.

Also for online shops

With WooCommerce active, ConvoPixel adds product views, add to cart, checkout, purchases, completed orders, coupons, cart and wishlist events, with order revenue sent in the currency the customer paid.

Why ConvoPixel

• Two-minute setup. Install, paste your Pixel ID, save. No code, no Google Tag Manager.

• Browser pixel + Conversions API. Leads, sign-ups and purchases are also sent server-side, so ad blockers and closed tabs don’t lose conversions.

• Automatic deduplication. Browser and server use the same event ID, so ChatGPT Ads keeps one conversion.

• Ad click matching. Passes the ChatGPT ad click reference (oppref) and browser reference (obref) with every server event.

• Better matching, private by design. Email, phone and name from forms, accounts and orders are normalised and hashed with SHA-256 before they leave your site.

• Works with caching. Events from AJAX forms and carts are delivered through a cache-safe queue.

Events

Any WordPress site – standard ChatGPT Ads events: page_viewed, contents_viewed (the content types you choose, such as services, listings or courses), lead_created, registration_completed, appointment_scheduled. Custom events: search, phone_clicked, chat_clicked, email_clicked, file_downloaded.

WooCommerce – standard events: contents_viewed (products and variations), items_added, checkout_started, order_created. Custom events: cart_viewed, item_removed, coupon_applied, wishlist_added, order_submitted, order_completed.

Standard events can be used as campaign goals in ChatGPT Ads; custom events are reported for insight. Every event can be switched off.

Built-in testing tools

• “Send test event” checks your Pixel ID and API key without recording anything

• Log of recent server-side events with response codes and ad-click matches

• An order note on every WooCommerce order that was sent

• Debug mode that prints every pixel event in the browser console

ConvoPixel is an independent plugin. It is not affiliated with, endorsed by or sponsored by OpenAI or Automattic. ChatGPT and OpenAI are trademarks of OpenAI.

WooCommerce is a trademark of Automattic Inc. Other plugin names are trademarks of their respective owners.

ConvoPixel is built and maintained by Jaseel, a growth marketer working on paid acquisition and conversion measurement. me/tools/convopixel.

External services

ConvoPixel connects your site to the ChatGPT Ads (OpenAI Ads) measurement service, operated by OpenAI, so conversions from your ad campaigns can be reported. Nothing is loaded or sent until you enter a Pixel ID under Settings > ConvoPixel. Administrators, editors and shop managers are not tracked by default, and with Consent set to “Wait for marketing consent” nothing is sent until the visitor agrees.

1. OpenAI Ads Measurement Pixel (in the visitor’s browser)

• What it is: OpenAI’s JavaScript pixel, loaded from https://bzrcdn.openai.com/sdk/oaiq.min.js. It sends events to OpenAI’s servers (bzr.openai.com) and stores OpenAI’s first-party cookies used for ad attribution.

• When: on front-end page loads and visitor actions, for each event you have switched on in the plugin settings.

• What is sent: the event name (for example page_viewed, lead_created, order_created), page URL, content or product IDs, names and quantities, amounts and currency, the order ID for purchases, and, if “Customer matching” is on, SHA-256 hashes of the visitor’s email, phone number, first and last name and user ID (from submitted forms, their account or their order), plus country, city, region and postcode for WooCommerce orders. Email, phone and names are never sent in plain text. Click events send only the event name (and the file name for downloads).

2. OpenAI Conversions API (from your server)

• What it is: a server-to-server HTTPS request to https://bzr.openai.com/v1/events.

• When: only if you add a Conversions API key. Events are sent when a supported form is submitted successfully, when a visitor creates an account, when a WooCommerce order reaches one of your “purchase” statuses or is marked Completed, and when you click “Send test event” (validate only, nothing is recorded).

• What is sent: the event name, time and ID, the lead value or order total and currency, WooCommerce products, the page URL the form or checkout was on, OpenAI’s ad click reference and browser reference when available, and, if “Customer matching” is on, the SHA-256 hashed customer details listed above plus the visitor’s IP address and browser user agent.

OpenAI’s terms and privacy information:

• Advertising Terms: https://openai.com/policies/advertising-terms/

• Conversion Terms and all other OpenAI policies: https://openai.com/policies/

• Privacy Policy: https://openai.com/policies/privacy-policy/

As the site owner you are responsible for telling visitors about this tracking in your own privacy policy and for collecting consent where the law requires it.

Developers

revokeConsent();

PHP: ConvoPixel_Forms::lead( ‘my-plugin’, $form_id, array( array( ‘key’ => ’email’, ‘value’ => $email ) ) ); records a lead from any custom form handler.

php: define( ‘CONVOPIXEL_PIXEL_ID’, ‘…’ ); define( ‘CONVOPIXEL_CAPI_KEY’, ‘…’ );

Filters: convopixel_event_enabled, convopixel_page_events, convopixel_lead_value, convopixel_track_form_submission, convopixel_capi_lead_event, convopixel_capability, convopixel_paid_statuses, convopixel_order_value, convopixel_items_added_data, convopixel_capi_order_eligible, convopixel_capi_order_event, convopixel_capi_registration_event, convopixel_exclude_user, convopixel_add_order_notes. Action: convopixel_lead_tracked.