Skip to main content

Overview

The Equativ connector exports identifiers into a segment in Decentriq's Equativ account, via Equativ's Audience Data (Data Sync) API v2. It is the same destination as the Equativ (custom) connector, with one difference: you do not need an Equativ account or credentials of your own. Decentriq is the audience data provider on your behalf.

Your dataset must be a single-column CSV with no header row — one identifier per row and nothing else. What those values mean comes entirely from the identifier type you select, because Equativ's API carries no type field for most types.

Choose the identifier type carefully

For all types except ID5 and Utiq, Equativ infers the type from the shape of the value. A mismatch is therefore not rejected — the values are ingested and simply match nobody. Decentriq checks each value against the type you select and skips ones that clearly do not fit, but the check cannot catch every case.

The connector is append-only: each run adds the dataset's identifiers to the segment and never removes anyone. Each segment carries a membership duration (time-to-live), so members who stop being re-exported age out on their own. Re-running the export keeps the segment warm, and it is also the safe way to repair a run that failed part-way through.

Prerequisites

None on your side — there is no Equativ account to set up and no credentials to enter.

This connector is disabled by default. Contact your customer success representative to have it enabled for your organisation.

What Decentriq controls

Because every customer's segments live in one shared Equativ account, some settings are not yours to choose:

  • Segment name prefix. The name you enter is a base name. Decentriq automatically prefixes it with your organisation's name, so your segments are clearly labelled among every other customer's. The prefix is derived from your organisation and cannot be changed or overridden.
  • Segment price and activation. Every segment is created active, since Equativ only accepts identifiers into an active segment, and with a price of 0. Segments in Decentriq's account are not visible to other Equativ users. Decentriq manages both settings afterwards; they are not shown in the export form.
  • Segment Provider ID, region and credentials. These belong to Decentriq's account and are never exposed.

Step-by-step guide

  1. Follow the steps to select a dataset for export and choose Equativ from the list of connectors.

  2. Enter the required information:

    • Identifier type: What the values in your dataset are — ID5, Utiq, Equativ cookie ID, mobile advertising ID (MAID), publisher-provided ID, IP address or postal code (ZIP). Equativ has no hashed-email type. Postal codes must carry their country: an upper-case ISO country code (two or three letters), a colon and the code itself, for example FR:75001 or GB:SW1A 1AA. The code is written in upper case with no space after the colon. A code without a country, or written any other way, matches nobody in Equativ and is rejected before it is exported. Mobile advertising IDs must be hyphenated IDFAs or GAIDs, for example 38400000-8cf0-11bd-b23e-10b96e40000d; the all-zero ID a device reports when ad tracking is limited is rejected too.
    • Segment name: A base name for the segment; your organisation prefix is added automatically.
    • Description: Optional; shown to buyers in Equativ.
    • Membership duration (days): How long an identifier stays in the segment after it is exported. Leave empty to keep the current duration of an existing segment, or to use Equativ's default of 30 days for a new one.

  3. After clicking the Export button, navigate to the Imports/Exports tab on the Datasets page to track the export status.

  4. Once the export completes, the segment exists in Decentriq's Equativ account under your organisation's prefix. The first export of a new segment can take up to ten minutes longer: Equativ may need a moment before a new segment accepts identifiers, so the export waits until it does. If Equativ has not made it available by then, the export fails and can be re-run.

Re-exporting and snapshots

The segment is identified by an ID derived from your organisation and your base name, so exporting the same base name again adds to the existing segment rather than creating a new one. Two organisations using the same segment name always get separate segments.

If you would rather have a separate, clean segment per run, export under a different base name — for example Loyal customers 2026-09. Each new name then produces a new segment, and the previous one is left to age out.

note

The export details show the base name you entered. The full, prefixed segment name as it exists in Equativ is recorded in the export's result.