Halfborg Pixel Tracking for WooCommerce
| 开发者 | alexhalfborg |
|---|---|
| 更新时间 | 2026年10月26日 09:40 |
| PHP版本: | 7.2 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Meta: ViewContent, AddToCart, InitiateCheckout and Purchase, sent from both the browser and the server with deduplication
- Google Analytics 4: view_item_list, select_item, view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info and purchase, with full item data
- Google Ads: purchase conversion with transaction ID, new-customer flag and optional cart data for Merchant Center, dynamic remarketing (retail) with product IDs that match your Merchant Center feed, and optional enhanced conversions
- Each Google purchase is reported once, even if the thank-you page is reloaded
- Consent Mode defaults that deny storage in the EEA, UK and Switzerland until a consent tool updates them
- Shop managers and administrators are left out of Google tracking by default
- Works with WooCommerce's High-Performance Order Storage (HPOS)
- Works with the classic and the block-based cart and checkout, and with classic and block themes
- Customer data is SHA-256 hashed before it is sent
- As a visitor browses, adds to cart and checks out, the plugin sends each step to the services you have configured
- Google add-to-cart and remove-from-cart events are recorded from WooCommerce's own cart, so they are captured whether the product was added from a product page, a shop page link, an AJAX button or a cart block, and when a quantity is changed
- When a customer completes an order, the purchase is sent with its value, currency, items and order number
- Customer data is hashed with SHA-256 before it leaves your server
安装:
- Upload the plugin files to the
/wp-content/plugins/halfborg-pixel-tracking-for-woocommercedirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the 'Plugins' screen in WordPress
- Go to WooCommerce > Pixel Tracking to configure the plugin
- For Meta, enter your Facebook Conversions API Access Token and Pixel ID
- For Google, enter your GA4 Measurement ID and/or Google Ads Conversion ID and purchase conversion label
- Deactivate any other plugin that sends the same events to Meta or Google, so nothing is counted twice
常见问题:
Where do I find my Facebook Conversions API Access Token?
You can generate an access token in Events Manager. Go to Events Manager > Data Sources > select your Pixel > Settings > Conversions API > Generate access token. Facebook's official instructions: https://developers.facebook.com/docs/marketing-api/conversions-api/get-started/
Where do I find my Facebook Pixel ID?
Your Pixel ID can be found in Events Manager under Data Sources, next to your pixel name. Facebook's official instructions: https://www.facebook.com/business/help/952192354843755
Where do I find my GA4 Measurement ID?
In Google Analytics, go to Admin > Data streams, open your web stream, and copy the Measurement ID (it starts with G-). Google's official instructions: https://support.google.com/analytics/answer/9539598
Where do I find my Google Ads Conversion ID and label?
In Google Ads, go to Goals > Conversions, open your Purchase conversion action, and choose to set up the tag yourself. The event snippet contains send_to: 'AW-XXXXXXXXX/label'. The part before the slash is the Conversion ID and the part after it is the label. Google's official instructions: https://support.google.com/google-ads/answer/6095821
Google Ads says sold item IDs can't be matched to Merchant Center. What do I check?
The product IDs the plugin sends must be the IDs in your Merchant Center feed. Check two settings under WooCommerce > Pixel Tracking: "Remarketing Product ID" must match your feed plugin's ID format, and "Product Variations in Feed" must match whether your feed lists each variation separately or only the parent product. Products you have excluded from your feed are not in Merchant Center, so they can never be matched; their sales still count as conversions.
Google Ads shows 0% basket data coverage for my purchase conversion. Why?
Google Ads only reads sold products from the purchase conversion when it also knows which Merchant Center account they belong to. Enter your Merchant Center ID under WooCommerce > Pixel Tracking. Feed Country and Feed Language default to your store's country and site language; change them only if your feed targets a different country or language.
Can I use it alongside other Google or Meta tracking plugins?
Only if those plugins are not sending the same events. Two plugins sending GA4 or Google Ads events will count every page view, add to cart and purchase twice. Switch the duplicate tracking off in the other plugin, or deactivate it.
Is this plugin compatible with WooCommerce HPOS?
Yes, this plugin is fully compatible with WooCommerce's High-Performance Order Storage (HPOS) feature.
更新日志:
- Google Ads: the purchase conversion can now carry cart data (sold products, Merchant Center ID, feed country and language, discount), so Google Ads reports basket data and which products sold
- New "Merchant Center ID", "Feed Country" and "Feed Language" settings; leave the Merchant Center ID empty to keep the previous behaviour
- Google Ads: variations now send their own product ID by default, matching feeds that list each variation separately, so sold items match Merchant Center
- Google Ads: a variable product's views send its default (or first in-stock) variation instead of the parent, which isn't in such feeds
- New "Product Variations in Feed" setting for feeds that list only parent products
- Adds Google Analytics 4 and Google Ads tracking, configured under WooCommerce > Pixel Tracking
- Loads one Google tag near the top of the page head, with Consent Mode defaults for the EEA, UK and Switzerland
- GA4 events across the funnel: view_item_list, select_item, view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info and purchase
- Google Ads purchase conversion with transaction ID, a choice of conversion value and a new-customer flag, plus retail dynamic remarketing with a choice of product ID format to match your Merchant Center feed
- Optional Google Ads enhanced conversions, hashed on the server
- Works with both the classic and the block-based cart, checkout, mini-cart and order confirmation, and with classic and block themes
- Add-to-cart and remove-from-cart are captured from WooCommerce's cart hooks, so every route into the cart is covered, including quantity changes
- The Google purchase events fire once per order, even if the thank-you page is reloaded
- Shop managers and administrators are excluded from Google tracking by default
- Initial release
- Sends server-side Purchase events to the Facebook Conversions API, plus browser Meta Pixel and Conversions API events fired together with a shared event_id for deduplication
- Server-side + browser ViewContent, AddToCart and InitiateCheckout events, with a REST endpoint so browser-initiated AddToCart events deduplicate against the server event
- Captures the _fbc and _fbp cookies at checkout (reconstructing fbc from an fbclid URL parameter when the cookie is unavailable) and includes them in the payload
- Hashes customer email, phone, name and address fields (SHA-256) before sending, per Facebook Advanced Matching
- Compatible with WooCommerce's High-Performance Order Storage (HPOS)
- Redirects to the settings screen on plugin activation
- Adds a Settings link to the plugin listing on the Plugins screen
- IMPORTANT: disable any other Meta/Facebook pixel (e.g. in Pixel Manager) to avoid duplicate browser events