Description
X Pixel installs the X website tag on your WordPress site so you can measure conversions from your X Ads campaigns.
- Base pixel on every public page once a Pixel ID is saved
- Connect X Ads to fill in the Pixel ID, Conversion API token, and store event IDs
- Or paste a Pixel ID from X Ads Manager
- WooCommerce product view, add to cart, checkout, and purchase events
- Easy Digital Downloads download view, add to cart, checkout, and purchase events
- WP eCommerce product view, add to cart, checkout, and purchase events
- Conversion API events use the same conversion ID as the browser event so X can deduplicate them
Nothing is loaded on your site and no data is sent to X until you connect X Ads or save a Pixel ID on the settings page.
External services
This plugin connects to services operated by X Corp. It does not contact any other third party.
X website tag (static.ads-twitter.com)
Once a Pixel ID is saved, every public page loads the X website tag script from https://static.ads-twitter.com/uwt.js in the visitor’s browser. The script reports page views and the store events listed below to X, together with the visitor’s IP address, user agent, the page URL, and the X click identifier (twclid) if the visitor arrived from an X ad. X may set first-party cookies such as _twclid on your domain.
X Conversion API (ads-api.x.com)
If a Conversion API token is saved, your server also sends store events to https://ads-api.x.com. Each event can include the order value and currency, the number of items, the product IDs, names, and prices, the page URL, the visitor’s IP address and user agent, the X click identifier, and a SHA-256 hash of the customer’s email address, phone number, first name, and last name. Raw email addresses, phone numbers, and names are never sent.
X Ads connect (ads.x.com and api.x.com)
When you click Connect X Ads, your browser is sent to https://ads.x.com and https://api.x.com to authorize the connection. X returns the Pixel ID, Conversion API token, and event IDs to this site. No visitor data is involved in this step.
X Terms of Service: https://x.com/tos
X Privacy Policy: https://x.com/privacy
X Ads policies: https://business.x.com/en/help/ads-policies.html
You are responsible for displaying any visitor consent notice required in your jurisdiction before the pixel loads, and for describing this data sharing in your site’s privacy policy.
Installation
- Upload the plugin or install it from Plugins Add New.
- Activate X Pixel.
- Go to Settings X Pixel.
- Click Connect X Ads, or paste your Pixel ID.
FAQ
-
Do I need WooCommerce?
-
No. The base pixel works on any WordPress site. Store events are added automatically when WooCommerce, Easy Digital Downloads, or WP eCommerce is active, and all three use the same four event IDs from the settings page.
-
Where do I find my Pixel ID?
-
X Ads Manager Events Manager Install Pixel.
-
Does the plugin track anyone before it is configured?
-
No. The pixel script is not loaded and no requests are made to X until a Pixel ID is saved. Nothing is loaded in the WordPress admin.
-
What happens when I uninstall?
-
All plugin options, connection transients, and the per-order markers the plugin stores are removed.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“X Pixel” is open source software. The following people have contributed to this plugin.
Contributors
Translate “X Pixel” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.4.3
- Ignore crawler add-to-cart hits, make queued browser events cache-safe, standard pixel integration label.
0.4.2
- Security hardening for WordPress.org review.
0.4.1
- Finish the X Ads connection with a redirect instead of a form post.
0.4.0
- Easy Digital Downloads and WP eCommerce events, reusing the WooCommerce event IDs.
0.3.0
- Connect X Ads, Conversion API, and WooCommerce events.