Documentation

Start typing to search.

Spotify Ads

Written by Ilya Sudakov

Updated on Oct 27, 2026

Description

‍Spotify is a digital music service. This data source covers Spotify Ads — the campaigns you buy on Spotify and how they performed, including the streams and listeners attributed to those ads.

Connect it when Spotify belongs next to the rest of your paid media in one report. For the listening activity of a Spotify account itself — the artists it follows, the albums and tracks it has saved, its playlists — use the Spotify Organic data source instead.

Setup guide

Follow our setup guide to connect Spotify Ads to Improvado.

Choose an authorization option. Improvado supports two ways to connect Spotify Ads — pick the one that fits your situation.

Connect with Spotify

The standard route. You sign in with your Spotify account and Improvado handles the rest — there is no Spotify Developer app to create.

Select Connect with Spotify in the authentication dropdown.

Fill in Organization Name — a free-form label, usually the advertiser or business name. It becomes the name of the connection in Improvado, so pick something your team will recognize.

Click Authorize.

You'll be redirected to Spotify. Sign in with the Spotify account that has access to your Ad Account, and approve the connection.

Connect with Your Own App

Optional. Use this when you want the connection to run through a Spotify app your own team owns and approves.

Go to developer.spotify.com/dashboard and click Create app.

Fill in the form:

  • App name: any descriptive name, e.g. <Your Company> — Improvado Connector.
  • App description: e.g. Connector that pulls Spotify Ads campaign delivery and spend into Improvado.
  • Website: your company website (optional).
  • Which API/SDKs are you planning to use?: select Ads API.
  • Redirect URIs: add all three Improvado redirect URLs (one per Improvado cluster) so the connection works regardless of which cluster your workspace is on:
    • https://connections.improvado.io/stat_provider_client/oauth_redirect/spotify_ads/
    • https://connections.eu.improvado.io/stat_provider_client/oauth_redirect/spotify_ads/
    • https://connections.us.improvado.io/stat_provider_client/oauth_redirect/spotify_ads/

Click Save and copy the Client ID and Client Secret from your app overview page.

Open adsmanager.spotify.com/api-terms and accept the Ads API Terms with the same Client ID. It can take up to one hour for the allowlist to propagate.

Back in Improvado, select Connect with Your Own App in the authentication dropdown, fill in Organization Name (a free-form label that becomes the name of the connection), paste your Client ID and Client Secret, and click Authorize.

You'll be redirected to Spotify. Sign in with the Spotify account that owns the Ad Account, and approve the connection.

‍Step 2. After completing the connection process, the Spotify Ads connection will appear in your Connected sources list.

‍Step 3. When the connection status is Active, and the account status column shows a number of accounts, you can move on to data extraction.

To extract data from the connected sources, check the instructions on how to set up data extraction.

Schema information

The schema information shows all report types you can use to extract data from Spotify Ads.

Release notes

You can find information about the latest API changes in the official Release notes.

Was this article helpful?

Questions? The Improvado team is always happy to help. Send us an email, contact your Customer Success Manager, or raise a request in the Improvado Service Desk.