Skip to main content

Overview

The Equativ (custom) connector exports identifiers directly from the Decentriq platform into a segment in your own Equativ account, via Equativ's Audience Data (Data Sync) API v2. Buyers can then target that segment in their campaigns.

Your dataset must be a single-column CSV with no header row — one identifier per row and nothing else. There is no column selection: row n is the n-th identifier. 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.

Segments are created active

Equativ only accepts identifiers into an active segment, so the connector creates every new segment active: it is live and targetable in your Equativ account, at the price you set, from the first export onwards. There is no option to create it inactive, so choose the price before the first export.

After that, the connector never changes the segment's activation. If you deactivate the segment in Equativ, it stays deactivated through later exports, and Equativ does not add the identifiers they send to it. Reactivate it in Equativ before exporting to it again.

Prerequisites

  • An Equativ account set up as an audience data provider, with Audience Data API access completed through Equativ's onboarding.
  • Your Segment Provider ID — the identifier Equativ assigns to your data-provider account.
  • OAuth Client ID and Client Secret issued by Equativ for the Audience Data API.
  • The region your account is served from (EU, US or APAC). Segments are global, but profiles are served from the region they were ingested into, so the wrong region produces a segment that matches nobody.
  • Confirmation from Equativ that the identifier type you intend to export is enabled for your Segment Provider ID. Some types need extra setup: ID5 and Utiq require encrypted-eid ingestion, Equativ cookie IDs require a cookie sync, and publisher-provided IDs require a mapping on Equativ's side.

Consent for the data you share is governed by your Equativ data-provider agreement.

Note: If you do not have an Equativ account, the Equativ connector exports into Decentriq's Equativ account instead, with no credentials required from you.

Step-by-step guide

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

  2. Enter the required information:

    • Segment Provider ID: The ID Equativ assigned to your data-provider account.
    • Region: EU, US or APAC.
    • 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 3166-1 country code (two or three letters, such as GB rather than UK), 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 name for the segment.
    • 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.
    • Segment price: The marketplace price. Use 0 if you are activating the data yourself rather than selling it. The segment is targetable at this price as soon as it is created.
    • Client ID and Client Secret: Your Equativ OAuth credentials. They need permission to read profiles as well as write them, since the first export of a new segment reads one identifier back to confirm the segment accepts them.

  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 is available in your Equativ account. 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 a name-derived ID, so exporting the same segment name again adds to the existing segment rather than creating a new one. That is what keeps an audience current.

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

note

The segment's name and price are managed from Decentriq — every export writes the values from the export form, so editing either of them in Equativ directly will be overwritten by the next export. Description and membership duration are updated only when you fill them in; leaving them empty keeps the segment's current values. Activation is set only when the segment is created; see Segments are created active in the overview.