Connecting Spotify Ads on Clarisights
Connect your Spotify Ad Studio accounts to monitor audio, video, and podcast ad performance, audience engagement, and reach metrics across every Spotify ad format alongside the rest of your marketing stack.
At a glance
| Authentication | OAuth 2.0 (Spotify Ads partner API) |
| Permissions needed | User access to one or more Spotify Ads businesses and ad accounts |
| Account discovery | Automatic on credential validation — every business and ad account your user can see is offered |
| Data freshness | Daily (rolling 7-day refresh) |
| Lookback window | 7 days |
| Backfill on connect | Last 7 days |
| Timezone | UTC (reports requested by day in UTC) |
| Currency | Account native currency (auto-converted via Currency Conversion) |
| Levels supported | Account · Campaign · Ad Set · Ad |
| Limited rollout | No |
Prerequisites
An active Spotify Ad Studio (Spotify Ads) account with at least one business and ad account
A Spotify user that can sign in to ads.spotify.com and view the ad accounts you want to connect
Permission to authorize third-party apps for that Spotify user
Steps to Connect
Step 1 — Sign in with Spotify from Clarisights
In Clarisights, go to Integrations → Spotify Advertising and click Connect. You'll be redirected to Spotify to authenticate. Sign in with the user that has access to the ad accounts you want to connect.
[TODO: Screenshot needed — Clarisights Integrations page Spotify Advertising row.]
Step 2 — Authorize Clarisights
Spotify will display a permission screen listing the access Clarisights requires (read access to ad accounts, campaigns, ads, and aggregate reports). Click Agree.
⚠ Common error: "You do not have permission to authorize this app." → The Spotify user you signed in with does not have access to any Spotify Ads business. Ask your Spotify Ads admin to add you to the relevant business in Ad Studio, then retry.
Step 3 — Select ad accounts
After authorization, Clarisights walks every business linked to your user and discovers all ad accounts under each business. Select the accounts you want to connect, optionally rename them, and click Create Accounts.
⚠ An ad account is missing → Spotify only returns ad accounts under businesses your user has access to. Confirm in Spotify Ad Studio that the missing account's business has your user added, then re-open the integration in Clarisights to refresh.
Verify the connection
Go to Integrations → Spotify Advertising. Each connected account should show a "Connected" status with its account ID.
First data appears within 24 hours of the next scheduled sync.
Quick start: create a new report, add Spotify Advertising as the data source, and add Account · Campaign · Ad Set · Impressions · Clicks · Spend.
Data available
Hierarchy
How Spotify's native levels map to the standard Clarisights levels:
Native level (Spotify) | Clarisights level |
Ad Account | Account |
Campaign | Campaign |
Ad Set | Ad Group |
Ad | Ad |
Dimensions
Dimension | Level | Description |
Account / Account ID | Account | Spotify ad account name and ID |
Account Currency | Account | Billing currency configured for the ad account |
Campaign / Campaign ID | Campaign | Campaign name and ID |
Campaign Status | Campaign | Active, Paused, Ended |
Campaign Objective | Campaign | Reach, brand awareness, conversion, etc. |
Ad Set / Ad Set ID | Ad Group | Ad set name and ID |
Ad Set Status | Ad Group | Active, Paused, Ended |
Ad Format | Ad Group | Audio, video, podcast, sponsored session, etc. |
Ad / Ad ID | Ad | Creative name and ID |
Ad Status | Ad | Active, Paused, Rejected |
Ad Preview | Ad | Link to creative preview |
Metrics
Core delivery
Metric | Description |
Impressions | Total ad impressions served |
Clicks | Total clicks on the ad |
Spend | Total spend in account currency |
Reach | Unique listeners reached |
Frequency | Average impressions per unique listener |
Audio & video listening
Metric | Description |
Listens / Streams | Audio plays driven by the ad |
Listen-Through Rate | Share of impressions that played to completion |
25% / 50% / 75% / 100% Quartile Completes | Listeners reaching each playback quartile |
Video Views | Video ad views (for video formats) |
Video Completions | Video ads played to 100% |
Engagement
Metric | Description |
CTR | Click-through rate (clicks ÷ impressions) |
CPM | Cost per thousand impressions |
CPC | Cost per click |
CPCV | Cost per completed view (video formats) |
New Followers | New followers gained on linked Spotify artist / podcast pages |
Limitations & known constraints
7-day lookback: Spotify's aggregate report endpoint exposes a rolling 7-day window. Older history is preserved in Clarisights once it has been ingested but cannot be re-fetched on demand.
Daily granularity: reports are pulled per day; intra-day breakdowns are not available.
UTC-only requests: Spotify's reporting API accepts UTC date ranges. Account-level timezones are not honored at request time.
Limited segment breakdowns: Spotify's API does not expose breakdowns by demographics, device, region, or genre.
Token revocation: if you revoke Clarisights' access in your Spotify account, the integration stops syncing until you re-authenticate.
Operating notes
Refresh schedule: data is pulled daily on a rolling 7-day window so any backfill or restatement Spotify makes within a week is captured automatically.
Lookback: 7 days.
Adding new ad accounts: when a new ad account or business is added in Spotify Ad Studio, return to Clarisights and re-open the Spotify integration to discover and add it.
Currency conversion: native amounts are pulled as-is and converted to your reporting currency by Clarisights.
Credential rotation: OAuth tokens refresh automatically. You only need to re-authenticate if you change your Spotify password or revoke access.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and account ID (Integrations → Spotify Advertising)
The exact error message or screenshot
The step where the issue occurred
When the issue started