Connecting TV Squared on Clarisights
TVSquared (now part of Innovid) is the cross-platform TV ad measurement platform that attributes spots and sessions for linear, addressable, and CTV / OTT campaigns. Connecting TVSquared to Clarisights lets you analyze cost, audience impressions, sessions, acquisitions, and orders per campaign, segment, and spot side-by-side with your other paid channels.
⚠ Platform note — TVSquared was acquired by Innovid in 2022 and is now branded "TVSquared by Innovid". The underlying Attribution API is still operated by Innovid; this integration uses the legacy
tvsquared.compartner-domain endpoints. Reach out to Clarisights support if your account has been migrated to a new Innovid endpoint.
At a glance
| Authentication | HTTP Basic auth — username + password issued by TVSquared / Innovid |
| Permissions needed | API user with read access on the Attribution API for the partner / clients / brands you want to report on |
| Account discovery | Automatic — every (client, brand) tuple visible to your API user is offered as a separate Account |
| Data freshness | Daily |
| Lookback window | 30 days (rolling window pulled on each refresh) |
| Backfill on connect | Last 30 days; longer history available on request |
| Timezone | Per (client, brand) tuple as configured in TVSquared |
| Currency | Per brand as configured in TVSquared; converted to your reporting currency by Clarisights |
| Levels supported | Account (client+brand) · Campaign · Segment · Spot |
| Limited rollout | No |
Prerequisites
An active TVSquared (by Innovid) account with at least one client and brand configured
API access enabled on your TVSquared account — confirm with your TVSquared / Innovid Customer Success Manager if unsure
Your Partner Domain — the subdomain TVSquared uses for your partner; usually provided by the TVSquared support team. The full API base URL is
https://{partner_domain}.tvsquared.com/api/v2/attribution.
Steps to Connect
Step 1 — Confirm API access and partner domain
Ask your TVSquared / Innovid CSM to confirm that your user has Attribution API access enabled and to provide your Partner Domain. The partner domain is not always visible in the TVSquared UI — it's the subdomain used in the API URL (e.g., acme.tvsquared.com means the partner domain is acme).
⚠ Don't know your partner domain? → Ask the TVSquared support team. The partner domain is required for the API call to reach the right Innovid measurement instance — the integration will not work without it.
Step 2 — Add TV Squared in Clarisights
In Clarisights, go to Integrations → TV Squared → Add Account.
[TODO: Screenshot needed — Integrations page TV Squared row with Add Account button]
Step 3 — Enter your TVSquared credentials
Fill in:
Username — your TVSquared API username
Password — your TVSquared API password
Partner Domain — from Step 1
Click Validate. Clarisights authenticates with the TVSquared Attribution API and discovers every (client, brand) tuple your user can see.
⚠ "Authentication error, please check your credentials" → Confirm the username and password are correct (they are case sensitive) and that the partner domain matches the TVSquared URL you use to log in. If the credentials work in the TVSquared UI but fail here, the API role may not be enabled on the user — ask your CSM to enable it.
Step 4 — Select brands to connect
Each TVSquared brand is shown as a separate Account row (with its parent client). Pick the brands you want to connect, optionally rename them, and click Create Accounts.
Verify the connection
Go to Integrations → TV Squared. Each connected brand should show a "Connected" status with the client and brand IDs visible.
First data appears within 24 hours, after the next scheduled sync.
Quick start: create a new report, add TV Squared as the data source, and add Account · Campaign · Spots · Cost · Audience Impressions · Sessions.
Data available
Hierarchy
How TVSquared's native levels map to the standard Clarisights levels:
Native level (TVSquared) | Clarisights level |
Client + Brand | Account (each client/brand pair becomes one Account) |
Campaign | Campaign |
Segment (audience) | Ad Group (TVSquared segments are reported as Ad Groups for cross-channel compatibility) |
Spot (TV airing) | Ad (each spot — a TV airing of a creative — is mapped to the Ad level) |
Dimensions
Available dimensions vary by report type (spot metrics vs. spot attribution). The most common are:
Dimension | Level | Description |
Account / Account ID | Account | Client + brand identifier |
Campaign / Campaign ID | Campaign | TV campaign name and ID |
Segment / Segment ID | Ad Group | Audience segment name and ID |
Spot / Spot ID | Ad | Individual TV airing |
Datetime | Spot | When the spot aired |
Daypart | Spot | Daypart classification (morning, primetime, etc.) |
Length | Spot | Spot length in seconds |
Saleshouse | Spot | Sales house responsible for the placement |
Programme / Genre | Spot | Programme aired alongside and its genre |
Clocknumber | Spot | Creative clocknumber identifier |
Region | Spot | Geographic region |
Channel / PIB / PIP | Spot | TV channel and pre/post-promotion identifiers |
Metrics
Metric | Description |
Spots | Number of TV airings |
Sessions | Web / app sessions attributed to a spot |
Cost | Spot cost in account currency |
Ratecard Cost | Ratecard / list-price cost |
Audience Impressions | Modeled audience impressions delivered |
Orders / Acquisitions / Reorders / Installs | Conversion events attributed to TV exposure |
GRP / BTRP | Gross Rating Point and broadcaster Target Rating Point |
CPA · CPO · CPV · Cost Per Spot | Derived efficiency metrics |
Limitations & known constraints
Granularity: TVSquared exposes daily-bucketed reporting. Sub-daily granularity below the spot timestamp is not available.
Modeled data: audience impressions and sessions attributed to TV are modeled by TVSquared / Innovid. Numbers reconcile to the TVSquared UI but should not be expected to match exact deterministic counts.
Restatement window: TVSquared restates attribution as more sessions / conversions land. Clarisights re-pulls a 30-day rolling window so recent days will continue to update for several days after airing.
Lookback: rolling 30 days. Historic backfills are available on request.
Custom metric names: TVSquared lets each brand define custom metric names (acquisition, install, order, etc.). These flow through to Clarisights using the names configured in TVSquared.
Carousel / non-spot inventory: only standard TV spots are ingested. Innovid-only inventory (e.g., CTV impressions captured via Innovid XP without a TVSquared spot record) is not surfaced via this integration.
Operating notes
Refresh schedule: daily.
Lookback: rolling 30 days.
Multi-account: a single API user can connect every (client, brand) tuple visible to it. Add additional users to onboard brands managed under different TVSquared partner contracts.
Currency conversion: native brand currency is preserved on ingest and converted to your reporting currency by Clarisights.
Credential rotation: if the API password is rotated, update it from Integrations → TV Squared → Edit Credentials. The partner domain rarely changes; reach out to support if it does.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and brand ID (Integrations → TV Squared)
The exact error message or screenshot
The step where the issue occurred
When the issue started