| 开发者 |
zgrkaralar
unbelievabledigital |
|---|---|
| 更新时间 | 2026年10月2日 16:27 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
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.<noscript> image tag covers visitors without JavaScript.
Meta (Facebook & Instagram) pixel
Enable the Meta provider and enter your Pixel ID to send the same events to
Meta: PageView, ViewContent, AddToCart, InitiateCheckout, Purchase
and CompleteRegistration, with content_ids / contents that match the
Meta catalog feed. Advanced matching data is normalized and SHA-256 hashed on
the server. With a Conversions API access token, Purchase is also sent from
the server with the same event ID, the _fbp / _fbc cookies captured at
checkout, and the customer's IP address and user agent, so Meta deduplicates
browser and server events. Each provider has its own "Track WooCommerce
events" switch.
Google Ads & GA4
Enable the Google provider with a GA4 Measurement ID and/or a Google Ads
Conversion ID. GA4 receives page_view, view_item, add_to_cart,
begin_checkout, purchase (with transaction_id and items[]),
sign_up and generate_lead; Google Ads receives a conversion for every
event you give a conversion label. Enhanced conversions data is hashed on the
server. "Require consent first" uses Consent Mode v2 with all four types
denied until your banner grants them.
Lead forms
Contact Form 7, WPForms and Gravity Forms submissions become
lead_created / Lead / generate_lead events on every enabled provider:
fired in the browser straight from the form's AJAX response and sent from
the server through the Conversions APIs with the same event ID. Email, phone
and name are read from the submitted fields (adjust with the
openpixel_lead_user filter).
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, on the server (no consent = false is printed once the category is allowed) and in the browser.
Conversions API
Orders, registrations and leads are sent from the server. Enable it and paste the API key from the Conversions tab of Ads Manager (for
Meta: the access token from Events Manager). Orders are delivered
asynchronously with retries and logged under WooCommerce > Status > Logs
(source: openpixly). The OpenAI "Send test event" button validates your
credentials without recording anything; the Meta one sends the event with
your test event code so it only shows under Events Manager > Test events.
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.
Meta catalog feed
Switch on "Also build a Meta catalog feed" and the same build writes a second
CSV in Meta's catalog format (id, title, description, availability, condition,
price, link, image_link, brand, sale_price, item_group_id, ...), served at its
own private URL. Paste it in Commerce Manager > Catalog > Data sources > Data
feed > Scheduled feed. Item ids equal the pixel's content_ids, which is what
Advantage+ catalog ads need.
Debugging
The Events tab records, for 24 hours after you enable it, every event the
plugin tracks: the page or request that raised it, the exact payload each
pixel received and whether the Conversions API accepted it. Customer data is
reduced to the names of the fields present.
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
(Google Ads, TikTok, ...) can be registered with the
openpixel_pixel_providers filter.
openpixly folder to /wp-content/plugins/.In ChatGPT Ads Manager, Conversions tab. For Meta: Events Manager > Data sources (Pixel / dataset ID) and the dataset's Settings > Conversions API > Generate access token.
Allow script-src https://bzrcdn.openai.com, connect-src https://bzr.openai.com https://bzrcdn.openai.com
and img-src https://bzr.openai.com. For the Google tag add script-src https://www.googletagmanager.com and connect-src / img-src https://www.google-analytics.com https://www.googleadservices.com https://googleads.g.doubleclick.net https://www.google.com. For the Meta pixel add script-src https://connect.facebook.net and connect-src / img-src https://www.facebook.com. Use the openpixel_script_nonce filter to add your nonce to the inline snippets.
Yes. The plugin only uses the WooCommerce CRUD order API and declares HPOS compatibility.
channel => 'both' for custom events: browser event plus a server copy whose IP, user agent, URL and attribution cookies are filled from the current request._fbp / _fbc captured at checkout, async delivery with retries, test event code support.