Spotify Ads Field Reference

Sample

 

https://connectors.windsor.ai/spotify?api_key=[your API key]&date_preset=last_7d&fields=date,spend,impressions,clicks,ctr


Fields

IDTypeNameDescription
TEXTAdDimension for Ad.
ad_setTEXTAd SetDimension for Ad set.
advertiserTEXTAdvertiserDimension for advertiser.
campaignTEXTCampaignDimension for campaign.
clicksNUMERICClicksThe number of impressions in which your ad was clicked (#)
completesNUMERICCompletesThe number of ads served that was played to the end (#)
completion_rateNUMERICCompletion_rateThe percentage of ads served that were played to the end (%)
conversion_ratePERCENTConversion_rateThe percentage of users who listened to the artist after seeing or hearing an ad served by the campaign (%)
cost_typeTEXTCost typeDimension for cost_type.
countryCOUNTRYCountryDimension for country.
ctrPERCENTCtrThe percentage of ads that were clicked (%)
currencyTEXTCurrencyDimension for currency.
dateDATEDateDimension for date.
dmaTEXTDMADimension for DMA.
ecpclNUMERICEcpclThe average cost per 1,000 completed listens
ecpmNUMERICEcpmThe average cost per 1,000 impressions
errorsNUMERICErrorsThe number of times an error occurred (#)
fetch_reachNUMERICFetch_reachThe number of unique users with FETCH events (#)
fetchesNUMERICFetchesThe number of times an ad is called from the ad server (#)
first_quartilesPERCENTFirst_quartilesThe percentage of users who listened or viewed a given percentage of the ad (%)
impressionsNUMERICImpressionsThe number of times an ad has been successfully served (#)
intent_ratePERCENTIntent_rateThe rate at which listeners indicated an intent to stream the artist again in the future (%)
listenersNUMERICListenersThe number of users who listened to the artist after hearing/seeing an ad (#)
midpointsNUMERICMidpointsThe number of users for which the ad played to the midpoint of the ads total length (#)
monthTEXTMonthDimension for month.
new_listener_conversion_ratePERCENTNew_listener_conversion_rateThe percentage of users who listened to the artist for the first time in at least a month after seeing or hearing the ad (%)
new_listener_streamsNUMERICNew_listener_streamsThe total number of streams from new listeners who saw/heard the ad (#)
new_listenersNUMERICNew_listenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the ad (#)
off_spotify_impressionsNUMERICOff_spotify_impressionsoff spotify impressions
NUMERICPaid_listen_freqThe average frequency for listens on a CPCL campaign
NUMERICPaid_listen_reachThe number of unique users who had a paid listen for this CPCL campaign
NUMERICPaid_listensThe number of listens for a CPCL campaign where a user did NOT skip the ad
platformTEXTPlatformDimension for platform.
regionTEXTRegionDimension for region.
render_ratioNUMERICRender_ratioThe percentage of impressions in which a creative is actually displayed to the user (#)
serve_freqNUMERICServe_freqThe average number of times each person heard or viewed your ad (#)
serve_reachNUMERICServe_reachThe number of unique users who received your ad (#)
servesNUMERICServesThe total number of ads served (#)
skipsNUMERICSkipsThe number of times a user skips an ad
spendNUMERICSpendThe total amount spent in this campaign
startsNUMERICStartsThe number of times a user starts hearing/viewing your ad (#)
streamsNUMERICStreamsThe total number of streams from listeners who saw/heard the ad (#)
streams_per_new_listenerNUMERICStreams_per_new_listenerThe average number of times each new listener streamed the artist after seeing/hearing the ad (#)
streams_per_userNUMERICStreams_per_userThe average number of times each listener streamed the artist after seeing/hearing the ad (#)
third_quartilesPERCENTThird_quartilesThe percentage of users who listened or viewed a given percentage of the ad (%)
yearTEXTYearDimension for year.