Webaround Pixel and Conversions API for OpenAI Ads

Adds the OpenAI Ads Measurement Pixel to your site and sends the same conversions from your server through the Conversions API (CAPI), so a conversion measured in both places is counted once rather than twice. OpenAI Ads are the ads that run in ChatGPT. If you buy them, this is how your site tells OpenAI which visits turned into leads, orders or registrations - in the browser, on the server, or both. This is an independent community integration. It is not created, certified, endorsed or supported by OpenAI. "OpenAI" and "ChatGPT" are trademarks of OpenAI. What it does

• Loads the official OpenAI Ads Pixel, once, in your site head.
• Sends server-side conversions through the Conversions API, deduplicated against the browser half by a shared event id.
• Hashes email addresses, phone numbers and names with SHA-256 before they leave your server, using the normalization OpenAI documents.
• Strips query strings from the page address, so search terms and password-reset tokens do not reach an ad platform.
• Defers to your existing consent mechanism, so GDPR and ePrivacy choices your site already collects are the ones that decide. It ships no cookie banner.
• Never makes the visitor wait: conversions go out after the page does, handed to Action Scheduler where the site has it.

Integrations Contact Form 7, Elementor Forms, Gravity Forms, WPForms, Fluent Forms and Ninja Forms are detected automatically. A lead is recorded when the submission is accepted, never when the button is clicked. Contact Form 7 and Elementor also fire the matching browser event, sharing one event id. For ecommerce, WooCommerce measures product views, add to cart, checkout start and paid orders. A purchase is reported only once payment is confirmed - never for a pending, failed or cancelled order - and never twice, however many times the gateway or a webhook triggers it. Amounts use the currency's own minor unit. Easy Digital Downloads reports a purchase once payment completes. WooCommerce Subscriptions reports trial_started or subscription_created. WordPress registration reports registration_completed, off by default because user_register also fires for an administrator adding a colleague. Each can be switched off under OpenAI Ads -> Integrations. Tag manager endpoint Optional, off by default. Lets Google Tag Manager hand a conversion to your site, which forwards it to OpenAI - server-side measurement without a paid GTM server container. Protected by a generated secret. For developers Record a conversion at a confirmed boundary: openai_ads_track( 'lead_created', [], [ 'event_id' => $lead_id, 'user' => [ 'email' => $email ] ] ); Also openai_ads_event_id(), openai_ads_pixel_event(), openai_ads_hash_user(), openai_ads_image_tag() and openai_ads_is_configured(), plus filters and actions for consent, event data, identity and integrations. Every event OpenAI documents for the web is supported, plus custom. Full documentation: https://github.com/webaroundlabs/openai-ads-toolkit

1. Install and activate the plugin.
2. Go to OpenAI Ads in the admin menu and enter your Pixel ID and Conversions API key.
3. Open Integrations and read what the Consent section reports. If it found none, decide what you want before going further.
4. Use "Send a test event" on the General screen. It uses the API's validation mode, so no fake conversion is recorded.

Nothing requires editing a file. To keep credentials out of the database, define them as constants in wp-config.php instead.

0.3.0

• Renamed to Webaround Pixel and Conversions API for OpenAI Ads. Your settings, and anything built on the openai_ads_* functions and hooks, are unaffected - but the address of the settings screen changed, so update a bookmark.
• Scripts are now registered with WordPress rather than printed into the page, which lets caching and optimisation plugins see them.
• Translations now come from translate.wordpress.org instead of being bundled.

0.2.1

• Fixed: the three consent-mode labels on the settings screen were never translatable, so they stayed English in every language.
• Clean pass of the official Plugin Check tool.

0.2.0

• Translated into Bulgarian, Dutch, French, German, Greek, Hungarian, Polish, Portuguese, Romanian and Spanish.
• Suggested privacy policy wording now appears under Tools -> Privacy.
• Corrected this readme: with no consent mechanism installed the plugin measures everybody and says so on its settings screen. A section claimed otherwise.

0.1.2

• The settings moved into their own menu: General, Integrations, Tag manager.
• Fixed: saving one settings screen could blank the settings on another.

0.1.1

• No change to this plugin.

0.1.0

• First release: Pixel, Conversions API, deduplication and the first three integrations.