Skip to content
Clarisights Knowledge Center home
InboxAsk a human

Connecting Vibe TV on Clarisights

Vibe is a CTV / OTT advertising platform that runs streaming TV campaigns across major connected-TV channels. Connecting Vibe to Clarisights lets you analyze impressions, completed views, installs, purchases, and signups per advertiser, campaign, strategy, and creative alongside your other paid channels.

At a glance

AuthenticationAPI key issued by Vibe
Permissions neededA Vibe API key with access to reporting for your advertisers
Account discoveryAutomatic: every advertiser linked to your API key is added as a separate Account
Data freshnessHourly
Lookback windowRolling 3 days (re-pulled on each refresh)
Backfill on connectLast 3 days; longer history available on request
TimezoneUTC
CurrencyUSD
Levels supportedAccount (Advertiser) · Campaign · Ad Group (Strategy) · Ad (Creative)
Limited rolloutYes. Not shown on the Integrations page; contact Clarisights support to enable it.

Prerequisites

  • An active Vibe advertiser account

  • A Vibe API key issued for your account; request one from your Vibe Customer Success Manager. Vibe's help center has background on its reporting API.

  • The attribution window you want to use. Vibe supports 1 hour, 6 hours, 12 hours, 24 hours, 48 hours, 72 hours, 7 days and 30 days. The default is 7 days.

Steps to Connect

Step 1: Obtain your Vibe API key

Contact your Vibe CSM and request an API key for your advertiser. Copy the full key value.

Treat your API key like a password. It grants read access to all advertisers linked to it.

Step 2: Ask Clarisights support to connect Vibe

Vibe TV is not listed on the Integrations page, so the connection is set up by Clarisights. Contact Clarisights support from the in-app messenger and tell us:

  • That you want to connect Vibe TV

  • The attribution window you want (7 days if you have no preference)

  • Whether conversions should be dated by when the conversion happened (the default) or by when the ad impression was served

Support will tell you how to share the API key securely. Do not paste it into a chat or email unless support asks you to.

Step 3: Confirm your advertisers

Once the key is validated, every advertiser linked to it is added as a separate Account in Clarisights and starts syncing. Let support know if there are advertisers you don't want included.

⚠ "Invalid API key. Please check your authentication credentials and try again." → The API key has either expired, been revoked, or was copied with extra whitespace. Re-issue or re-copy the key from Vibe and share it with support again. If the key is recent, confirm with your Vibe CSM that it has been activated for the Reporting API.

Verify the connection

  • First data appears within about an hour of the connection being set up (Vibe data syncs hourly).

  • Quick start: create a new report, add Vibe TV as the data source, and add Account · Campaign · Ad Group · Impressions · Spend · Completed Views.

Data available

Hierarchy

How Vibe's native levels map to the standard Clarisights levels:

Native level (Vibe)

Clarisights level

Advertiser

Account

Campaign

Campaign

Strategy

Ad Group (Vibe Strategies are the targeting / bidding unit; surfaced as Ad Groups in Clarisights)

Creative

Ad

Dimensions

Dimension

Level

Description

Advertiser ID / Advertiser Name

Account

Vibe advertiser identifier and display name

Campaign ID / Campaign Name

Campaign

Vibe campaign identifier and display name

Strategy ID / Strategy Name

Ad Group

Vibe strategy identifier and display name

Creative ID / Creative Name

Ad

Vibe creative identifier and display name

Data is reported per day (the impression date).

Metrics

Metric

Description

Impressions

Total CTV impressions served

Spend

Total spend, in USD

Completed Views

Impressions where the creative played to 100%

Installs

App installs attributed to a Vibe impression / view

Number of Purchases / Amount of Purchases

Purchase events and total revenue attributed to Vibe

Number of Signups

Signup events attributed to Vibe

Number of Custom 1 / 2 / 3 · Cost per Custom 1 / 2 / 3

Up to three customer-defined custom conversion events plus their cost-per-event efficiency metric

Limitations & known constraints

  • Not self-serve: Vibe TV does not appear on the Integrations page. Connecting it, changing the API key, and changing the attribution window are done by Clarisights support.

  • Rate limits: Vibe limits how many reports can be requested per hour. Clarisights queues report requests within this limit, so very large advertiser sets may take longer to backfill.

  • Default 3-day rolling window: regular pulls cover the last 3 days. Reach out to support to backfill longer history.

  • Currency: spend is imported in USD.

  • Timezone: reporting days are in UTC.

Operating notes

  • Refresh schedule: hourly.

  • Lookback: rolling 3 days.

  • Multi-account: a single API key connects every advertiser linked to it. Use separate keys to onboard advertisers managed by different Vibe CSMs.

  • Currency conversion: spend is imported in USD and converted to your reporting currency by Clarisights.

  • Credential rotation: when you rotate the Vibe API key, contact Clarisights support to update it.

  • Attribution window: default 7 days. Supported values: 1 hour, 6 hours, 12 hours, 24 hours, 48 hours, 72 hours, 7 days, 30 days. Ask support to change it.

  • Conversion dating: conversions are dated by when they happened (default) or by when the impression was served. Ask support to change it.

Need help?

When contacting support from the in-app messenger, please include:

  • The integration name and Vibe advertiser ID

  • The exact error message or screenshot

  • The step where the issue occurred

  • When the issue started