Signal Beam Conversion Tracking

By signalbeam

0+ active installationsVersion 1.0.1

Send WooCommerce orders and form leads to Meta, TikTok and other ad platforms from your server, so ad blockers don't hide them.

Description

Signal Beam Conversion Tracking connects your WordPress site to your Signal Beam account, which sends your conversions to the ad platforms you use.

WooCommerce orders from your server. A purchase is sent when an order is paid, even if the buyer never reaches the thank you page or uses an ad blocker. Add to cart is sent from your server too. Product views and checkouts are sent from the browser.

Form leads from your server. Submissions are sent after the form plugin has accepted them, from Contact Form 7, Elementor Pro Forms, Fluent Forms, Gravity Forms, Ninja Forms and WPForms. Only what’s needed to identify the lead is sent: name, email address and phone number. Messages stay on your site.

Counted once. The browser pixel and the server share an event ID for each purchase and form lead, so ad platforms can remove duplicates. For a form, the ID is kept in a cookie for a few minutes at most, and only once tracking is allowed. The pixel only fires for a form your server has sent under that ID.

Follows consent. The plugin works with the WP Consent API, and with Complianz directly. With a consent tool that supports it, nothing is tracked until a visitor agrees to marketing, and a visitor who refuses isn’t sent.

Nothing happens until you connect. Installing the plugin doesn’t load anything or send anything. It starts after you’ve entered your details and ticked the box to agree.

You need a Signal Beam account, which is a paid service after a free trial. All of this plugin’s code is included here, with nothing locked behind a licence.

External services

This plugin connects to Signal Beam, a conversion tracking service. It’s what the plugin is for, and it needs a Signal Beam account. Nothing is loaded or sent until you’ve entered your details and agreed in Settings > Signal Beam.

In a visitor’s browser, on every page of your site, the plugin loads Signal Beam’s tracker from https://app.signalbeam.co/signal-beam-tracker.js. The tracker sends the page address, referrer, browser details, a visitor ID it stores in a cookie, and advertising identifiers from the page’s address and cookies to https://app.signalbeam.co. If your site requires consent, none of this happens until the visitor agrees.

Forms in the browser. When a visitor submits a form that the plugin doesn’t send from your server, such as one from a form plugin it doesn’t support, the tracker sends the form’s name and the values of its text, email and phone fields to Signal Beam. Message boxes, hidden fields, and anything that looks like a password or a card number aren’t sent. Signal Beam picks out the lead’s name, email address and phone number, and only those are passed on.

From your server, when an order is paid, a product is added to a cart or a form is submitted, the plugin sends that event to https://app.signalbeam.co/api/plugin/events. It includes the buyer or lead’s name, email address and phone number where given, their IP address and browser, advertising identifiers from their cookies, and for orders, the products, amount and order number.

Signal Beam hashes personal details before passing them to the ad platforms you’ve connected.

Ad platforms’ pixels. The tracker also loads the browser pixel of each ad platform you’ve connected in your Signal Beam account, from that company’s own servers, and sends it the page views and conversions it tracks. Only the ones you’ve connected are loaded, and only once a visitor has agreed, if your site requires consent. Each pixel also collects what that company’s own script collects, as its terms describe.

Installation

  1. Create an account at app.signalbeam.co, and add your site, choosing WordPress.
  2. Install and activate this plugin.
  3. On your site’s page in Signal Beam, copy your site ID and create a server key.
  4. In WordPress, go to Settings > Signal Beam. Enter both, tick the box to agree, and save.
  5. Clear any page cache, then click Verify on your site’s page in Signal Beam.

FAQ

Do I need WooCommerce?

No. Without it, the plugin tracks page views and form submissions.

Does this slow my site down?

The tracker loads asynchronously. Orders are sent in the background using WooCommerce’s Action Scheduler, and form submissions are sent at the end of the request.

What if I use a form plugin that isn’t listed?

Regular forms on your page are still captured in the browser. Forms inside an iframe from another site can’t be.

What if my consent tool doesn’t support the WP Consent API?

With the WP Consent API installed but no consent tool using it, Signal Beam’s tracker looks for a consent banner it can read itself, and tracks nothing in the browser until the visitor chooses. If it finds none, nothing is tracked in the browser. WordPress can’t tell what the visitor chose, so orders and forms are still sent from your server. Signal Beam drops them if your site requires consent in Signal Beam and the visitor hasn’t agreed.

What happens when an order is paid later?

Details of the visit are saved with the order at checkout, and the purchase is sent once it’s paid. Unpaid orders, orders you create in the admin, and subscription renewals aren’t sent.

How do I stop it?

Untick the box in Settings > Signal Beam, or deactivate the plugin. Deleting the plugin removes its settings.

Screenshots

Changelog

1.0.1

  • With Complianz and no WP Consent API, the browser now waits for Complianz too. Where Complianz needs no click, as in an opt-out region, tracking starts straight away.
  • With the WP Consent API but no consent tool using it, the API’s default yes no longer counts as the visitor agreeing.
  • A form’s pixel only fires when your server sent the lead under the same ID. Spam, leads the server didn’t send, and leads it sent under its own ID no longer fire it.
  • Two forms on one page no longer clear each other’s ID.
  • A visitor’s choice is checked again each time a form is sent.
  • Ninja Forms caught in the browser only sends the fields that identify the lead.
  • Form plugins’ success events are heard when jQuery loads late.
  • Deleting the plugin also removes orders waiting in WP-Cron.
  • WooCommerce’s personal data eraser now removes the visit saved with an order.
  • An order from a buyer who hadn’t agreed at checkout is left to the tracker on the order page, which waits for their choice.
  • The privacy policy link points to the right page.

1.0.0

  • First release.