Skip to content

Tracking & pixels

Waveband Signal is the first-party measurement layer: impression pixels and click redirects are attached to your creatives automatically, and a lightweight site tag captures visits and conversions on your site. Everything lands in one reporting model: no third-party trackers.

Tracking page with the site tag and pixel snippets
Console → Tracking: copy the workspace-specific site tag and per-event pixels.

Site tag

Install once, site-wide, from Console → Tracking (the snippet is workspace-specific):

<script async src="https://<your-host>/t.js?w=<workspace-id>"></script>

The tag records pageviews (including single-page-app navigations), captures click ids from landing URLs (wbclid), and exposes a tiny API:

// Track a conversion (name must match a conversion event you created)
window.waveband.conversion("Purchase", 49.99, { orderId: "A-1001" });

// Associate a hashed email for cross-device attribution (optional)
window.waveband.identify({ email: "[email protected]" });

// Stop and restart sending, e.g. when a visitor changes their cookie choice
window.waveband.pause();
window.waveband.resume();

Values are dollars; we convert to minor units at ingest. identify hashes the email in the browser before sending: the raw address never reaches our servers. While paused, the tag sends nothing.

To hold the tag until a visitor accepts your cookie banner, start it paused: put this before the tag snippet (not after it, where it would replace the API). It then fires no visit pixel and sets no cookies until resume(), which records the page view. If your banner can be answered before the tag has loaded, set window.waveband.paused = false instead of calling resume() (which exists only once the tag has loaded).

<script>window.waveband = { paused: true };</script>
<script async src="https://<your-host>/t.js?w=<workspace-id>"></script>

Impression & click tracking

Nothing to install: creatives trafficked through Waveband automatically carry an impression pixel and a click redirect that stamps wbclid onto your landing page URL. Keep that parameter intact through redirects.

Attribution

Conversions are attributed once, through the strongest available lane:

  1. Click: the conversion carries an wbclid from an ad click.
  2. Person: the same visitor previously arrived via an ad click.
  3. Household (CTV and DOOH; audio when it launches): the conversion came from a network that saw an impression (IPs are salted-hashed; raw addresses are never stored).

Results appear in Reports and via GET /api/v1/reports.

Third-party pixels on your creatives

Add external impression trackers per creative via the impressionTrackers field. Useful when a client's ad server also needs to count delivery.

Tracking & pixels · Waveband Docs