Openpixly – Conversion Tracking & Product Feed for OpenAI Ads

Deskripzioa

Openpixly installs the official ChatGPT Ads Measurement Pixel on every
page and sends the standard conversion events for you:

• page_viewed on every page.
• contents_viewed on WooCommerce product pages.
• items_added on add to cart (classic, AJAX and block/Store API carts).
• checkout_started on the checkout page.
• order_created on the order-received page, and again from the server
  through the Conversions API with the same event ID so OpenAI deduplicates it.
• registration_completed when a user or customer registers.

Amounts are sent as integers in the currency’s ISO 4217 minor unit, customer
identifiers are normalized and SHA-256 hashed on the server before they reach
the browser, and a <noscript> image tag covers visitors without JavaScript.

Consent

Choose “Require consent first” to initialize the pixel with consent set to
false. Grant consent from your cookie banner with window.openPixel.grantConsent();
the WP Consent API “marketing” category is detected automatically.

Conversions API

Enable it and paste the API key from the Conversions tab of Ads Manager.
Orders are delivered asynchronously with retries and logged under
WooCommerce > Status > Logs (source: openpixly). A “Send test event”
button validates your credentials without recording anything.

Product feed for ChatGPT Ads

The Product feed tab builds a catalog file from your WooCommerce products in
the OpenAI product feed format (or the Google-compatible profile) as CSV, TSV
or JSONL: one row per simple product or variation, with group_id and
variant_dict for variants, prices as “79.99 USD”, availability, images,
brand, category, GTIN/MPN and is_ads_eligible. The file is rebuilt on a
schedule and served at a private tokenized URL you can hand to OpenAI, or
downloaded for upload to the SFTP location shown in Ads Manager > Feeds.

Extensible

The plugin is a small pixel manager: integrations emit normalized events on
a bus and each provider maps them to its own API. Additional providers
(Meta, Google Ads, TikTok, …) can be registered with the
openpixel_pixel_providers filter.

External services

This plugin is an integration with OpenAI’s ChatGPT Ads measurement services. Openpixly is developed by Unbelievable Digital and is not affiliated with or endorsed by OpenAI. Nothing is loaded or sent until a site administrator enables the OpenAI provider and enters a Pixel ID.

OpenAI Measurement Pixel (browser SDK) — https://bzrcdn.openai.com/sdk/oaiq.min.js and https://bzrcdn.openai.com/pixel-config/ — loaded on every front-end page while the provider is enabled, to measure ad conversions. The SDK sends measurement events to https://bzr.openai.com: page views (page id and title), product views, add-to-cart, checkout and purchase events (WooCommerce product ids, names, quantities and amounts), and registrations. The SDK reads and sets first-party cookies (__oppref, __obref) for click attribution and may collect the visitor’s IP address and user agent as part of the request. When “Send hashed customer data” is on, the plugin also passes SHA-256 hashes of the logged-in user’s or the order’s billing email, phone, first and last name, and the plain-text billing country, city, region and postal code, to improve conversion matching. Raw email, phone or names are never sent.

OpenAI image tag (no-JavaScript fallback) — https://bzr.openai.com/v1/sdk/events — when enabled, a 1×1 image records a page view for visitors without JavaScript. It carries only the Pixel ID and event name.

OpenAI Conversions API (server-to-server) — https://bzr.openai.com/v1/events — only when enabled with your Conversions API key. When an order is paid, the plugin sends the order id, total, currency and line items (product ids, names, quantities, amounts, variant attributes), the SHA-256 hashed billing email, phone, first and last name, the billing country, city, region and postal code, the customer’s IP address and user agent, and the attribution cookie values captured at checkout. The admin “Send test event” button sends a synthetic event with validate_only set, which OpenAI validates but does not store.

The product feed feature does not contact OpenAI by itself; it generates a file on your server that you choose to give to OpenAI.

Service provider: OpenAI, L.L.C. Terms of use: https://openai.com/policies/terms-of-use/ — Privacy policy: https://openai.com/policies/privacy-policy/ — ChatGPT Ads developer documentation: https://developers.openai.com/ads

Consent. Measurement is opt-in for the site owner (disabled until configured) and administrators are excluded by default. To make it opt-in for visitors, choose “Require consent first”: the pixel then starts with consent revoked and only measures after your cookie banner calls window.openPixel.grantConsent() or the WP Consent API reports the “marketing” category as allowed. Disclose the use of the OpenAI pixel in your site’s privacy policy.