> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sourcemedium.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Vibe - Integration Instructions

> Connect Vibe connected TV campaigns to SourceMedium with a Vibe client ID and secret.

Vibe is a connected TV (streaming TV) advertising platform. SourceMedium reads daily campaign spend, delivery and Vibe-attributed purchases for the advertisers you choose, alongside your other ad platforms.

> [!NOTE]
>
> Sign in to [SourceMedium](https://urchin.sourcemedium.com), open your store, then choose **Data sources → Connect data source** and select the platform. You need an **Admin** or **Editor** workspace role.
>
> [After you connect](https://docs.sourcemedium.com/docs/data-inputs/platform-integration-instructions/after-you-connect.md) explains the first sync and connection statuses.

## Vendor documentation

| Topic | Official guide |
| - | - |
| Creating API credentials | [Start your Client Credentials flow](https://developers.vibe.co/docs/start-your-client-credentials-flow) |
| Choosing which advertisers credentials cover | [Migration guide: advertiser scope](https://developers.vibe.co/docs/migration-guide-from-api-key) |

## What you need

* A Vibe user who can create apps in the account, under **My Applications** in the Vibe dashboard. If that menu is missing, ask your Vibe partner manager to enable the developer portal for the account, or to issue API credentials for you.

## How to connect

SourceMedium connects with the **client ID** and **client secret** of a Vibe app that uses API Key authentication, then you choose the advertisers to sync.

**1. Create the credentials in Vibe**

In **My Applications**, create an app, choose **API Key** as the authentication method and select the read permissions `account:read`, `advertisers:read`, `campaigns:read` and `reporting:read`. Choose which advertisers the credentials cover, then generate the client ID and client secret (Vibe may show this on the app's Marketplace page). Copy the secret right away; Vibe shows it once.

**2. Add them in SourceMedium**

Find **Vibe** in the connector picker and click **Connect**. Enter the **Client ID** and **Client secret**, then click **Find advertisers**.

**3. Choose your advertisers**

Select the Vibe advertisers that belong to this store and click **Connect Vibe**. Credentials can cover every advertiser in a Vibe account, so select only this store's.

**4. Confirm it is connected**

SourceMedium checks the credentials and the selected advertisers with Vibe before saving. The connection reads **Awaiting first data** until the first sync lands.

## What SourceMedium reads

| Data | Detail |
| - | - |
| Campaign performance by day | Spend, impressions, completed views, Vibe-attributed purchases and purchase value |
| Advertisers and campaigns | Names and statuses |

* **Days are UTC**, and purchases use Vibe's **7-day attribution window**. Purchases and their value are Vibe's own attribution, not SourceMedium's.
* **Amounts are in US dollars**, as Vibe reports them.
* **No clicks or ad-level detail.** Vibe reports neither, so clicks stay empty rather than zero and performance is reported per campaign.
* **Completed views** land in the raw Vibe table (`vibe__campaign_daily`) only; the ad performance tables have no column for them.
* **History:** the first sync loads the last 45 days.
* **Freshness:** SourceMedium syncs daily and re-reads the last 30 days, so late-attributed purchases and corrections replace earlier numbers. Each UTC day loads one day after it ends, because Vibe can still be filling it in for several hours afterward.

## Troubleshooting

* **Vibe refused the credentials.** Check that you pasted the client ID and secret of an API Key app, and that the app has not been deleted. Generate a new pair and connect again.
* **No advertisers are listed.** The credentials cover no advertiser. In Vibe, choose which advertisers the credentials cover, then click **Find advertisers** again.
* **Account verification is pending.** SourceMedium saved the credentials but could not list advertisers: the app may be missing one of the four read permissions, or Vibe was briefly unavailable. Check the app's permissions in Vibe and click **Try again**.
* **Your Vibe account reports in another currency.** SourceMedium loads Vibe accounts that report in US dollars today. Contact us if yours uses another currency.
* **A sync failed but the credentials are fine.** A temporary Vibe outage or a delayed report retries automatically on the next sync; you do not need to reconnect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.