How to get these dimensions and metrics in your workspace? | What do you need? |
| All plans |
Each data source connects to one Spotify ad account and gets daily performance data for its ads.
Dimensions
Date: The date of the event.
Currency: The currency of Spend.
Business ID: The ID of the Spotify business that the ad account belongs to.
Business Name: The name of the Spotify business that the ad account belongs to.
Ad Account ID: The ID of the ad account.
Ad Account Name: The name of the ad account.
Advertiser Name: The name of the advertiser shown in the ad.
Campaign ID: The ID of the campaign.
Campaign Name: The name of the campaign.
Ad Set ID: The ID of the ad set.
Ad Set Name: The name of the ad set.
Ad Set Status: The current status of the ad set.
Ad Set Start Date: The start date of the ad set.
Ad Set End Date: The end date of the ad set.
Ad Set Cost Model: The cost model of the ad set.
Ad Set Budget: The current budget of the ad set.
Ad ID: The ID of the ad.
Ad Name: The name of the ad.
Ad Status: The current status of the ad.
Clickthrough URL: The URL people go to when they click the ad.
Country: The country the ad set targets, as an ISO-3166 code.
Metrics
Delivery and engagement
Impressions: The number of ads served.
Off Spotify Impressions: Impressions for podcast ads served off Spotify. Only available in the US.
Clicks: The number of clicks on the ad.
Spend: The amount spent on the ad.
Starts: The number of times a user starts hearing or viewing your ad.
Ad played to 25%: The number of times the ad played to 25% of its length.
Ad played to 50%: The number of times the ad played to 50% of its length.
Ad played to 75%: The number of times the ad played to 75% of its length.
Ad played to 100%: The number of times the ad played to the end.
Ad Listens: The number of paid listens. Only available in Australia.
Reach
Reach: The number of unique users who were served the ad. This is a non-aggregatable metric.
Ad Set Reach: The number of unique users reached at the ad set level. This is a non-aggregatable metric.
Campaign Reach: The number of unique users reached at the campaign level. This is a non-aggregatable metric.
Note: Non-aggregatable metrics such as Reach, Ad Set Reach and Campaign Reach count unique users, so summing them across dimensions or dates double-counts users. See Working with non-aggregatable (non-agg) metrics in Funnel.
Listeners and streams
Unique Listeners: The number of users who listened to the artist for the given day after hearing or seeing an ad.
New Listeners: The total number of users who listened to the artist for the first time in at least a month after seeing or hearing the ad.
New Listener Streams: The total number of streams from new listeners who saw or heard the ad.
Streams: The total number of streams from listeners who saw or heard the ad.
Conversions
These metrics count actions attributed to your ads within a 30-day window.
Page Views: The total number of page views attributed to your ads. Page views are counted when a webpage loads in the browser, based on information from the data sources you connected to Spotify.
Leads: The number of lead events attributed to your ads. You define lead events when you set up your data source and connect it to Spotify.
Products: The number of product view events attributed to your ads. You define product view events when you set up your data source and connect it to Spotify.
Sign Ups: The number of sign-up events attributed to your ads. You define sign-up events when you set up your data source and connect it to Spotify.
Note: Conversion metrics only have data if you set up a data source, such as a tracking pixel or a measurement partner, and connect it to your Spotify ad account. Without one, these metrics show 0 or no data.
API documentation
For full field definitions and updates, see the Spotify Ads API aggregate report documentation.
Change history
Added Campaign Reach and Ad Set Reach
From 17 Sep, 2026, the Campaign Reach and Ad Set Reach metrics are available. They count unique users reached at the campaign and ad set level.
Added Reach
From 27 Aug, 2026, the Reach metric is available. It counts unique users who were served each ad.
Added ad account and business dimensions
From 19 May, 2026, the Ad Account ID, Ad Account Name, Business ID and Business Name dimensions are available.
