Description
MarketingBase is a marketing platform for small businesses, early-stage startups and agencies: ads on Google, Meta, TikTok, LinkedIn, Snapchat and Pinterest in one place, with conversion tracking and attribution. This plugin connects a WordPress site to it.
What it does
- Adds the MarketingBase Universal Pixel to every page of your site, in the
<head>, in the shape front-end optimizers and Cloudflare leave alone. - Connects in one click: sign in to MarketingBase or create a free account, approve, and the pixel key is configured for you. No code to copy.
- WooCommerce events: product views, add to cart, checkout started and searches are tracked with no tagging. Purchases are taken from the store’s orders, not from the browser, so a sale is counted once.
- WooCommerce: when WooCommerce is installed, connecting also turns on order tracking. Orders sync to MarketingBase with their revenue and are matched to the ad clicks that brought them, and checkout keeps the click IDs and UTM parameters on each order.
- Reports a periodic health signal so your site shows as connected in MarketingBase.
- Lets MarketingBase save blog drafts on your site when you ask it to write one. Drafts only; a draft is published only when you ask.
- Disconnect at any time from the plugin settings.
You will need a MarketingBase account. The Free plan needs no card, and you can create the account during the connect flow.
External services
This plugin connects to MarketingBase, a third-party marketing analytics and advertising service, to function. Using the plugin requires connecting your site to a MarketingBase account.
The plugin communicates with the following MarketingBase services:
-
MarketingBase web app (
www.marketingbase.app): when you click Connect, your browser is sent to the MarketingBase authorize page to sign in (or create an account) and approve the connection. Your site’s URL is included so it can be linked to your workspace, and the email address of your WordPress user is included so the sign-in box starts with it filled in (you still confirm it through a link MarketingBase emails you). -
MarketingBase API (
api.marketingbase.app): after you approve, the plugin exchanges a one-time authorization code for your pixel key and a connection token. It then sends an hourly health “heartbeat” with your site URL, this plugin’s version and your WordPress version, and notifies this service when you disconnect. When WooCommerce is installed, the plugin creates a WooCommerce REST API key and sends it to this service, which uses it to import orders and to register order webhooks on your store. -
MarketingBase pixel host (
pixel.marketingbase.app): the pixel loader script (/pixel/<your-pixel-key>.js) is loaded by visitors’ browsers on your site’s pages, and the pixel sends its measurements to the same host. It runs only after you connect the site. On behalf of your MarketingBase account it records: the pages visitors view; on a WooCommerce store, product views, items added to the cart, checkout started and searches, with the product’s id, name, category and price; the advertising click identifiers and campaign (UTM) parameters in the address of the page a visitor arrives on; and the visitor’s IP address and browser details. At checkout it sends a one-way (SHA-256) hash of the customer’s email address, made in the browser; the address itself is not sent by the pixel. The pixel reads the visitor’s choice from your site’s consent manager, if you use one, and sends it with every event.
Stored in the visitor’s browser on a WooCommerce store: for the length of the browser session, the click identifiers, campaign parameters, landing page and referrer of the visit are kept in sessionStorage and in a session cookie named mb_attr. When an order is placed they are saved on the order as _marketingbase_ order meta.
WooCommerce orders: with order tracking on, MarketingBase reads your orders (including customer and billing details) through the WooCommerce REST API key the plugin creates, to report sales and match them to advertising.
The plugin suggests wording covering the above for your privacy policy, under Settings Privacy Policy guide.
MarketingBase may also call this site, at /wp-json/marketingbase/v1/, to save or publish a blog draft you asked it to write. Each request is signed with a key derived from your connection token, is valid for five minutes, and can act only on posts this plugin created.
Data handling by MarketingBase is governed by its terms and privacy policy:
- Terms of Service: https://www.marketingbase.app/tos
- Privacy Policy: https://www.marketingbase.app/privacy
Installation
- In WordPress, go to Plugins Add New Plugin and search for “MarketingBase”.
- Click Install Now, then Activate.
- Go to Settings MarketingBase and click Connect to MarketingBase.
- Sign in or create a free account, choose your workspace, and approve. You are returned to your site with the pixel live, and with order tracking on if WooCommerce is installed.
FAQ
-
Do I need a MarketingBase account first?
-
No. You can create a free account during the connect flow. Account creation happens on the MarketingBase site; the plugin never handles your password.
-
Where does the pixel get added?
-
The plugin prints the Universal Pixel loader tag into your site’s
<head>on every page, as an external script withasyncanddata-cfasync="false", which is the shape optimizer plugins and Cloudflare Rocket Loader leave alone. -
What does order tracking change on my store?
-
It creates a WooCommerce REST API key named “MarketingBase” (WooCommerce Settings Advanced REST API), which MarketingBase uses to import orders and to register four order webhooks named “MarketingBase order.created” and so on. It also adds hidden fields to checkout so each order keeps the click IDs and UTM parameters of the visit. Turning order tracking off removes the key.
-
I had the plugin under its old name, LinkClicks Universal Pixel. What happens?
-
Activating this plugin takes over the connection, deactivates the old plugin so the pixel is not added twice, and keeps your settings. You can delete the old plugin.
-
How do I see my analytics?
-
Open MarketingBase (there is an “Open MarketingBase” button on the plugin settings page after connecting) and sign in with the same method you used to connect.
-
How do I remove the pixel?
-
Click Disconnect on the plugin settings page, or deactivate or delete the plugin. Deleting the plugin removes all stored connection data and the WooCommerce API key it created.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“MarketingBase” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “MarketingBase” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- First release.
- One-click connect: sign in to MarketingBase, approve, and the Universal Pixel is on every page. Your site gets a pixel of its own, named after it.
- WooCommerce order tracking, turned on by the same connect: orders sync with their revenue and are matched to the ad clicks that brought them. Checkout keeps the click IDs, UTM parameters, landing page and referrer on each order, on the classic and the block checkout.
- WooCommerce shopping events: product views, add to cart, checkout started and searches, with no tagging. Purchases come from the store’s orders, so a sale is counted once.
- At checkout the customer is identified to the pixel by a hash of their email, made in the browser; the address itself is not sent.
- Blog drafts: MarketingBase can save a draft you asked it to write, and publish it when you ask.
- Health heartbeat, and disconnect at any time.
