Waveband Docs

Audiences

Build first-party audiences from your tracked site activity, upload customer lists, or add third-party segments from the data marketplace — then attach any of them to a line item's targeting in one click.

Audiences page with segments and the marketplace browser
Console → Audiences: first-party segments, uploads, and the marketplace.

Pixel-based audiences

If the site tag is installed, three rule-based audience types re-evaluate automatically on a rolling window:

  • Site visitors — everyone who visited your site, optionally filtered to URLs containing a substring (e.g. /pricing), over a 1–180 day lookback.
  • Converters — everyone with an attributed conversion, optionally restricted to one conversion event or a minimum order value. Attach as an exclusion to suppress existing customers.
  • Event rule — everyone who fired a specific tracked event, such as add_to_cart.

Pixel-based audiences need at least 100 matched users before they can be attached — this protects delivery and prevents overly narrow targeting.

Customer list uploads

CRM lists accept emails, phone numbers, or pre-hashed SHA-256 lines — one identifier per line. Raw values are normalized and hashed the moment they arrive; the original email or phone number is never stored. IP lists accept IPv4 and IPv6 addresses for household and CTV targeting.

Data marketplace

Browse and search the mirrored third-party catalog by name, category path, description, or data provider. Each listing shows the data CPM (billed per thousand matched impressions on top of media) and estimated reach. Adding a segment makes it available for attachment immediately; the catalog refreshes daily (and on demand from Admin → Doctor), so CPM and availability stay in sync. Segments that leave the upstream catalog are flagged as unavailable and cannot be newly attached.

Attaching to line items

Attach a segment to include it (multiple attached segments must all match — AND logic) or exclude it to suppress those users. Changes sync to delivery automatically. The same operations are available in the console, the REST API (POST /v1/audiences/:id/attach), and to AI agents through the attach_audience and detach_audience tools — agent attachments respect your agent permission policy, so you can require human approval for audience changes.

API

  • GET /v1/audiences, POST /v1/audiences — list and create segments
  • POST /v1/audiences/:id/members — upload CRM or IP lines
  • POST /v1/audiences/:id/attach — attach/detach on a line item
  • GET /v1/marketplace-segments?q=… — browse/search the marketplace catalog (optional provider, offset)
Audiences — Waveband Docs