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

IDTypeNameDescriptionReport
account_idTEXTAccount IDThe account ID
account_nameTEXTAccount NameThe account name
TEXTAdDimension for ad.Ad
ad_clicksNUMERICSpotify Ad ClicksThe number of impressions in which your ad was clickedAd
ad_completesNUMERICAd CompletesThe number of ads served that was played to the endAd
ad_conversion_ratePERCENTAd Conversion RateThe percentage of users who listened to the artist after seeing or hearing an ad served by the adAd
ad_ctrPERCENTAd CTRThe percentage of ads that were clicked (%)Ad
ad_ecpclNUMERICAd Effective Cost per Completed ListenThe average cost per 1,000 completed listensAd
ad_ecpmNUMERICAd Effective Cost Per MilleThe average cost per 1,000 impressionsAd
ad_entity_idTEXTAd Entity IdAd Entity IdAd
ad_entity_statusTEXTAd Entity StatusAd Entity StatusAd
ad_first_quartilesNUMERICAd First QuartilesThe number of users who listened or viewed 25% of the ad's total lengthAd
ad_frequencyNUMERICAd Frequency of Ads ServedThe average number of times each person heard or viewed your adAd
ad_impressionsNUMERICAd ImpressionsThe number of times an ad has been successfully servedAd
ad_intent_ratePERCENTAd Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Ad
ad_listenersNUMERICAd ListenersThe number of users who listened to the artist after hearing/seeing an adAd
ad_midpointsNUMERICAd MidpointsThe number of users for which the ad played to the midpoint of the ads total lengthAd
ad_new_listener_conversion_ratePERCENTAd New 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 adAd
ad_new_listener_streamsNUMERICAd New Listener StreamsThe total number of streams from new listeners who saw/heard the adAd
ad_new_listenersNUMERICAd New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adAd
ad_off_spotify_impressionsNUMERICAd Off Spotify ImpressionsThe number of ads served off of SpotifyAd
ad_paid_listen_frequencyNUMERICAd Paid Listen FrequencyThe average frequency for listens on a CPCL ad -- NOTE: Applies to CPCL ads onlyAd
ad_paid_listen_reachNUMERICAd Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL ad -- NOTE: Applies to active audio/CPCL ads onlyAd
ad_paid_listensNUMERICAd Paid ListensThe number of listens for a CPCL ad where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL ads onlyAd
ad_parent_entity_idTEXTAd Parent Entity IdAd Parent Entity IdAd
ad_parent_entity_nameTEXTAd Parent Entity NameAd Parent Entity NameAd
ad_parent_entity_statusTEXTAd Parent Entity StatusAd Parent Entity StatusAd
ad_reachNUMERICAd Reach of Ads ServedThe number of unique users who received your adAd
ad_setTEXTAd_SetDimension for ad_set.Ad_Set
ad_set_clicksNUMERICAd_Set ClicksThe number of impressions in which your ad was clickedAd_Set
ad_set_completesNUMERICAd_Set CompletesThe number of impressions in which your ad was clickedAd_Set
ad_set_conversion_ratePERCENTAd_Set Conversion RateThe percentage of users who listened to the artist after seeing or hearing an ad served by the ad_setAd_Set
ad_set_ctrPERCENTAd_Set CTRThe percentage of ads that were clicked (%)Ad_Set
ad_set_ecpclNUMERICAd_Set Effective Cost per Completed ListenThe average cost per 1,000 completed listensAd_Set
ad_set_ecpmNUMERICAd_Set Effective Cost Per MilleThe average cost per 1,000 impressionsAd_Set
ad_set_entity_idTEXTAd Set Entity IdAd Set Entity IdAd
ad_set_entity_statusTEXTAd Set Entity StatusAd Set Entity StatusAd
ad_set_first_quartilesNUMERICAd_Set First QuartilesThe number of users who listened or viewed 25% of the ad's total lengthAd_Set
ad_set_frequencyNUMERICAd_Set Frequency of Ads ServedThe average number of times each person heard or viewed your adAd_Set
ad_set_impressionsNUMERICAd_Set ImpressionsThe number of times an ad has been successfully servedAd_Set
ad_set_intent_ratePERCENTAd_Set Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Ad_Set
ad_set_listenersNUMERICAd_Set ListenersThe number of users who listened to the artist after hearing/seeing an adAd_Set
ad_set_midpointsNUMERICAd_Set MidpointsThe number of users for which the ad played to the midpoint of the ads total lengthAd_Set
ad_set_new_listener_conversion_ratePERCENTAd_Set New 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 adAd_Set
ad_set_new_listener_streamsNUMERICAd_Set New Listener StreamsThe total number of streams from new listeners who saw/heard the adAd_Set
ad_set_new_listenersNUMERICAd_Set New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adAd_Set
ad_set_off_spotify_impressionsNUMERICAd_Set Off Spotify ImpressionsThe number of ads served off of SpotifyAd_Set
ad_set_paid_listen_frequencyNUMERICAd_Set Paid Listen FrequencyThe average frequency for listens on a CPCL ad_set -- NOTE: Applies to CPCL ad_sets onlyAd_Set
ad_set_paid_listen_reachNUMERICAd_Set Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL ad_set -- NOTE: Applies to active audio/CPCL ad_sets onlyAd_Set
ad_set_paid_listensNUMERICAd_Set Paid ListensThe number of listens for a CPCL ad_set where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL ad_sets onlyAd_Set
ad_set_parent_entity_idTEXTAd Set Parent Entity IdAd Set Parent Entity IdAd
ad_set_parent_entity_nameTEXTAd Set Parent Entity NameAd Set Parent Entity NameAd
ad_set_parent_entity_statusTEXTAd Set Parent Entity StatusAd Set Parent Entity StatusAd
ad_set_reachNUMERICAd_Set Reach of Ads ServedThe number of unique users who received your adAd_Set
ad_set_skipsNUMERICAd_Set SkipsThe number of times a user skips an ad -- NOTE: Skippable ads are currently supported in AU onlyAd_Set
ad_set_spendNUMERICAd_Set Amount SpentThe total amount spent in this ad_setAd_Set
ad_set_startsNUMERICAd_Set StartsThe number of times a user starts hearing/viewing your adAd_Set
ad_set_streamsNUMERICAd_Set StreamsThe total number of streams from listeners who saw/heard the ad (#)Ad_Set
ad_set_streams_per_new_listenerNUMERICAd_Set Streams per new listenerThe average number of times each new listener streamed the artist after seeing/hearing the ad (#)Ad_Set
ad_set_streams_per_userNUMERICAd_Set Streams Per ListenerThe average number of times each listener streamed the artist after seeing/hearing the ad (#)Ad_Set
ad_set_third_quartilesNUMERICAd_Set Third QuartilesThe number of users who listened or viewed 75% of the ad's total lengthAd_Set
ad_skipsNUMERICAd SkipsThe number of times a user skips an ad -- NOTE: Skippable ads are currently supported in AU onlyAd
ad_spendNUMERICAd Amount SpentThe total amount spent in this adAd
ad_startsNUMERICAd StartsThe number of times a user starts hearing/viewing your adAd
ad_streamsNUMERICAd StreamsThe total number of streams from listeners who saw/heard the ad (#)Ad
ad_streams_per_new_listenerNUMERICAd Streams per new listenerThe average number of times each new listener streamed the artist after seeing/hearing the ad (#)Ad
ad_streams_per_userNUMERICAd Streams Per ListenerThe average number of times each listener streamed the artist after seeing/hearing the ad (#)Ad
ad_third_quartilesNUMERICAd Third QuartilesThe number of users who listened or viewed 75% of the ad's total lengthAd
ageTEXTAgeDimension for age.Age
age_clicksNUMERICAge ClicksThe number of impressions in which your ad was clickedAge
age_conversion_ratePERCENTAge Conversion RateThe percentage of users who listened to the artist after seeing or hearing an ad served by the ageAge
age_ctrPERCENTAge CTRThe percentage of ads that were clicked (%)Age
age_ecpmNUMERICAge Effective Cost Per MilleThe average cost per 1,000 impressionsAge
age_entityTEXTAge EntityEntity nameAge
age_impressionsNUMERICAge ImpressionsThe number of times an ad has been successfully servedAge
age_intent_ratePERCENTAge Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Age
age_listenersNUMERICAge ListenersThe number of users who listened to the artist after hearing/seeing an adAge
age_new_listener_conversion_ratePERCENTAge New 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 adAge
age_new_listener_streamsNUMERICAge New Listener StreamsThe total number of streams from new listeners who saw/heard the adAge
age_new_listenersNUMERICAge New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adAge
age_paid_listen_reachNUMERICAge Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL age -- NOTE: Applies to active audio/CPCL ages onlyAge
age_paid_listensNUMERICAge Paid ListensThe number of listens for a CPCL age where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL ages onlyAge
age_reachNUMERICAge Reach of Ads ServedThe number of unique users who received your adAge
age_streamsNUMERICAge StreamsThe total number of streams from listeners who saw/heard the ad (#)Age
age_streams_per_new_listenerNUMERICAge Streams per new listenerThe average number of times each new listener streamed the artist after seeing/hearing the ad (#)Age
age_streams_per_userNUMERICAge Streams Per ListenerThe average number of times each listener streamed the artist after seeing/hearing the ad (#)Age
campaignTEXTCampaignDimension for campaign.Campaign
campaign_clicksNUMERICCampaign ClicksThe number of impressions in which your ad was clickedCampaign
campaign_completesNUMERICCampaign CompletesThe number of ads served that was played to the endCampaign
campaign_conversion_ratePERCENTCampaign Conversion RateThe percentage of users who listened to the artist after seeing or hearing an ad served by the campaignCampaign
campaign_ctrPERCENTCampaign CTRThe percentage of ads that were clicked (%)Campaign
campaign_ecpclNUMERICCampaign Effective Cost per Completed ListenThe average cost per 1,000 completed listensCampaign
campaign_ecpmNUMERICCampaign Effective Cost Per MilleThe average cost per 1,000 impressionsCampaign
campaign_first_quartilesNUMERICCampaign First QuartilesThe number of users who listened or viewed 25% of the ad's total lengthCampaign
campaign_frequencyNUMERICCampaign Frequency of Ads ServedThe average number of times each person heard or viewed your adCampaign
campaign_impressionsNUMERICCampaign ImpressionsThe number of times an ad has been successfully servedCampaign
campaign_intent_ratePERCENTCampaign Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Campaign
campaign_listenersNUMERICCampaign ListenersThe number of users who listened to the artist after hearing/seeing an adCampaign
campaign_midpointsNUMERICCampaign MidpointsThe number of users for which the ad played to the midpoint of the ads total lengthCampaign
campaign_new_listener_conversion_ratePERCENTCampaign New 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 adCampaign
campaign_new_listener_streamsNUMERICCampaign New Listener StreamsThe total number of streams from new listeners who saw/heard the adCampaign
campaign_new_listenersNUMERICCampaign New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adCampaign
campaign_off_spotify_impressionsNUMERICCampaign Off Spotify ImpressionsThe number of ads served off of SpotifyCampaign
campaign_paid_listen_frequencyNUMERICCampaign Paid Listen FrequencyThe average frequency for listens on a CPCL campaign -- NOTE: Applies to CPCL campaigns onlyCampaign
campaign_paid_listen_reachNUMERICCampaign Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL campaign -- NOTE: Applies to active audio/CPCL campaigns onlyCampaign
campaign_paid_listensNUMERICCampaign Paid ListensThe number of listens for a CPCL campaign where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL campaigns onlyCampaign
campaign_reachNUMERICCampaign Reach of Ads ServedThe number of unique users who received your adCampaign
campaign_skipsNUMERICCampaign SkipsThe number of times a user skips an ad -- NOTE: Skippable ads are currently supported in AU onlyCampaign
campaign_spendNUMERICCampaign Amount SpentThe total amount spent in this campaignCampaign
campaign_startsNUMERICCampaign StartsThe number of times a user starts hearing/viewing your adCampaign
campaign_streamsNUMERICCampaign StreamsThe total number of streams from listeners who saw/heard the ad (#)Campaign
campaign_streams_per_new_listenerNUMERICCampaign Streams per new listenerThe average number of times each new listener streamed the artist after seeing/hearing the ad (#)Campaign
campaign_streams_per_userNUMERICCampaign Streams Per ListenerThe average number of times each listener streamed the artist after seeing/hearing the ad (#)Campaign
campaign_third_quartilesNUMERICCampaign Third QuartilesThe number of users who listened or viewed 75% of the ad's total lengthCampaign
countryCOUNTRYCountryDimension for country.Country
country_clicksNUMERICCountry ClicksThe number of impressions in which your ad was clickedCountry
country_conversion_ratePERCENTCountry Conversion RateThe percentcountry of users who listened to the artist after seeing or hearing an ad served by the countryCountry
country_ctrPERCENTCountry CTRThe percentcountry of ads that were clicked (%)Country
country_ecpmNUMERICCountry Effective Cost Per MilleThe avercountry cost per 1,000 impressionsCountry
country_entityCOUNTRYCountry EntityCountry entityCountry
country_impressionsNUMERICCountry ImpressionsThe number of times an ad has been successfully servedCountry
country_intent_ratePERCENTCountry Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Country
country_listenersNUMERICCountry ListenersThe number of users who listened to the artist after hearing/seeing an adCountry
country_new_listener_conversion_ratePERCENTCountry New Listener Conversion RateThe percentcountry of users who listened to the artist for the first time in at least a month after seeing or hearing the adCountry
country_new_listener_streamsNUMERICCountry New Listener StreamsThe total number of streams from new listeners who saw/heard the adCountry
country_new_listenersNUMERICCountry New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adCountry
country_paid_listen_reachNUMERICCountry Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL country -- NOTE: Applies to active audio/CPCL countrys onlyCountry
country_paid_listensNUMERICCountry Paid ListensThe number of listens for a CPCL country where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL countrys onlyCountry
country_reachNUMERICCountry Reach of Ads ServedThe number of unique users who received your adCountry
country_streamsNUMERICCountry StreamsThe total number of streams from listeners who saw/heard the ad (#)Country
country_streams_per_new_listenerNUMERICCountry Streams per new listenerThe avercountry number of times each new listener streamed the artist after seeing/hearing the ad (#)Country
country_streams_per_userNUMERICCountry Streams Per ListenerThe avercountry number of times each listener streamed the artist after seeing/hearing the ad (#)Country
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateDate
day_of_monthTEXTDay of monthDay of the month
genderTEXTGenderDimension for gender.Gender
gender_clicksNUMERICGender ClicksThe number of impressions in which your ad was clickedGender
gender_conversion_ratePERCENTGender Conversion RateThe percentgender of users who listened to the artist after seeing or hearing an ad served by the genderGender
gender_ctrPERCENTGender CTRThe percentgender of ads that were clicked (%)Gender
gender_ecpmNUMERICGender Effective Cost Per MilleThe avergender cost per 1,000 impressionsGender
gender_entityTEXTGender EntityDimension for gender.Gender
gender_impressionsNUMERICGender ImpressionsThe number of times an ad has been successfully servedGender
gender_intent_ratePERCENTGender Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Gender
gender_listenersNUMERICGender ListenersThe number of users who listened to the artist after hearing/seeing an adGender
gender_new_listener_conversion_ratePERCENTGender New Listener Conversion RateThe percentgender of users who listened to the artist for the first time in at least a month after seeing or hearing the adGender
gender_new_listener_streamsNUMERICGender New Listener StreamsThe total number of streams from new listeners who saw/heard the adGender
gender_new_listenersNUMERICGender New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adGender
gender_paid_listen_reachNUMERICGender Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL gender -- NOTE: Applies to active audio/CPCL genders onlyGender
gender_paid_listensNUMERICGender Paid ListensThe number of listens for a CPCL gender where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL genders onlyGender
gender_reachNUMERICGender Reach of Ads ServedThe number of unique users who received your adGender
gender_streamsNUMERICGender StreamsThe total number of streams from listeners who saw/heard the ad (#)Gender
gender_streams_per_new_listenerNUMERICGender Streams per new listenerThe avergender number of times each new listener streamed the artist after seeing/hearing the ad (#)Gender
gender_streams_per_userNUMERICGender Streams Per ListenerThe avergender number of times each listener streamed the artist after seeing/hearing the ad (#)Gender
genreTEXTGenreDimension for genre.Genre
genre_clicksNUMERICGenre ClicksThe number of impressions in which your ad was clickedGenre
genre_conversion_ratePERCENTGenre Conversion RateThe percentgenre of users who listened to the artist after seeing or hearing an ad served by the genreGenre
genre_ctrPERCENTGenre CTRThe percentgenre of ads that were clicked (%)Genre
genre_ecpmNUMERICGenre Effective Cost Per MilleThe avergenre cost per 1,000 impressionsGenre
genre_entityTEXTGenre EntityDimension for genre.Genre
genre_impressionsNUMERICGenre ImpressionsThe number of times an ad has been successfully servedGenre
genre_intent_ratePERCENTGenre Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Genre
genre_listenersNUMERICGenre ListenersThe number of users who listened to the artist after hearing/seeing an adGenre
genre_new_listener_conversion_ratePERCENTGenre New Listener Conversion RateThe percentgenre of users who listened to the artist for the first time in at least a month after seeing or hearing the adGenre
genre_new_listener_streamsNUMERICGenre New Listener StreamsThe total number of streams from new listeners who saw/heard the adGenre
genre_new_listenersNUMERICGenre New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adGenre
genre_paid_listen_reachNUMERICGenre Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL genre -- NOTE: Applies to active audio/CPCL genres onlyGenre
genre_paid_listensNUMERICGenre Paid ListensThe number of listens for a CPCL genre where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL genres onlyGenre
genre_reachNUMERICGenre Reach of Ads ServedThe number of unique users who received your adGenre
genre_streamsNUMERICGenre StreamsThe total number of streams from listeners who saw/heard the ad (#)Genre
genre_streams_per_new_listenerNUMERICGenre Streams per new listenerThe avergenre number of times each new listener streamed the artist after seeing/hearing the ad (#)Genre
genre_streams_per_userNUMERICGenre Streams Per ListenerThe avergenre number of times each listener streamed the artist after seeing/hearing the ad (#)Genre
monthTEXTMonthNumber of the month
platformTEXTPlatformDimension for platform.Platform
platform_clicksNUMERICPlatform ClicksThe number of impressions in which your ad was clickedPlatform
platform_conversion_ratePERCENTPlatform Conversion RateThe percentplatform of users who listened to the artist after seeing or hearing an ad served by the platformPlatform
platform_ctrPERCENTPlatform CTRThe percentplatform of ads that were clicked (%)Platform
platform_ecpmNUMERICPlatform Effective Cost Per MilleThe averplatform cost per 1,000 impressionsPlatform
platform_entityTEXTPlatform EntityDimension for platform.Platform
platform_impressionsNUMERICPlatform ImpressionsThe number of times an ad has been successfully servedPlatform
platform_intent_ratePERCENTPlatform Intent RateThe rate at which listeners indicated an intent to stream the artist again in the future the artist again in the future (%)Platform
platform_listenersNUMERICPlatform ListenersThe number of users who listened to the artist after hearing/seeing an adPlatform
platform_new_listener_conversion_ratePERCENTPlatform New Listener Conversion RateThe percentplatform of users who listened to the artist for the first time in at least a month after seeing or hearing the adPlatform
platform_new_listener_streamsNUMERICPlatform New Listener StreamsThe total number of streams from new listeners who saw/heard the adPlatform
platform_new_listenersNUMERICPlatform New ListenersThe total number of users who listened to the artist for the first time in at least a month after seeing or hearing the adPlatform
platform_paid_listen_reachNUMERICPlatform Reach of Paid ListensThe number of unique users who had a paid listen for this CPCL platform -- NOTE: Applies to active audio/CPCL platforms onlyPlatform
platform_paid_listensNUMERICPlatform Paid ListensThe number of listens for a CPCL platform where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL platforms onlyPlatform
platform_reachNUMERICPlatform Reach of Ads ServedThe number of unique users who received your adPlatform
platform_streamsNUMERICPlatform StreamsThe total number of streams from listeners who saw/heard the ad (#)Platform
platform_streams_per_new_listenerNUMERICPlatform Streams per new listenerThe averplatform number of times each new listener streamed the artist after seeing/hearing the ad (#)Platform
platform_streams_per_userNUMERICPlatform Streams Per ListenerThe averplatform number of times each listener streamed the artist after seeing/hearing the ad (#)Platform
sourceTEXTSourceThe name of the Windsor connector returning the row
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20