Spotify Ads: Most-used fields

The table below gives information about most-used fields that you can import from Spotify Ads. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
Click-Through Rate (CTR)	Click-Through Rate (CTR)	The percentage of ads within the ad set that were clicked.	metric
Clicks	Clicks	The total number of times an ad was clicked.	metric
Completes	Completes	The number of times an ad was played to 100% completion.	metric
Completion Rate	Completion Rate	The percentage of ads that were played to 100% completion.	metric
Conversion Rate	Conversion Rate	The percentage of users who completed a desired action (conversion) after interacting with the ad.	metric
Effective Cost Per Click (eCPC)	Effective Cost Per Click (eCPC)	The average cost incurred for each click on an ad.	metric
Effective Cost Per Mille (eCPM)	Effective Cost Per Mille (eCPM)	The average cost incurred for one thousand ad impressions.	metric
First Quartiles	First Quartiles	The number of times an ad was played up to 25% of its duration.	metric
Frequency	Frequency	The average number of times a unique user was exposed to an ad.	metric
Impressions	Impressions	The total number of times an ad was served to users.	metric
Intent Rate	Intent Rate	The rate at which users show intent to engage further with the ad or brand, beyond just a click or listen.	metric
Listeners	Listeners	The number of unique users who listened to an ad.	metric
Midpoints	Midpoints	The number of times an ad was played up to 50% of its duration.	metric
New Listener Conversion Rate	New Listener Conversion Rate	The percentage of unique users exposed to your ad who are new listeners and played at least 30 seconds of the promoted content within 14 days of hearing or seeing your ad.	metric
New Listener Streams	New Listener Streams	The total number of streams from new listeners who played at least 30 seconds of the promoted content within 14 days of hearing or seeing your ad, and had not streamed the content in the last 28 days.	metric
New Listeners	New Listeners	The number of unique Spotify users who played at least 30 seconds of the promoted content within 14 days of hearing or seeing your ad and have not streamed the content in the last 28 days.	metric
Off Spotify Impressions	Off Spotify Impressions	The total number of times an ad was served outside of the Spotify platform.	metric
Paid Listens	Paid Listens	The number of times your ad was listened to until completion. This corresponds to the AD_COMPLETES metric in the Spotify Ads API.	metric
Paid Listens Frequency	Paid Listens Frequency	The average number of times each user streamed the promoted content for at least 30 seconds within a paid campaign.	metric
Paid Listens Reach	Paid Listens Reach	The number of unique users who streamed the promoted content for at least 30 seconds within a paid campaign.	metric
Reach	Reach	The number of unique users who were exposed to an ad.	metric
Skips	Skips	The number of times users skipped the ad.	metric
Spend	Spend	The total amount of money spent on an ad or campaign.	metric
Starts	Starts	The number of times an ad started playing or was initiated.	metric
Streams	Streams	The total count of times the ad’s content (audio or video) was streamed or played.	metric
Streams per New Listener	Streams per New Listener	The average number of content streams per new listener acquired through advertising.	metric
Streams per User	Streams per User	The average number of times each listener streamed the promoted artist or content for at least 30 seconds within 14 days of hearing or seeing the ad.	metric
Third Quartiles	Third Quartiles	The number of times an ad was played up to 75% of its duration.	metric
Unmutes	Unmutes	The number of times users unmuted the ad or the Spotify application while an ad was playing.	metric
Video Views	Video Views	The total number of views for video ad creatives.	metric
ad_account_id	ad_account_id	The unique identifier for the ad account.	dimension
calc_ad_name	calc_ad_name	The name given to identify the individual ad.	dimension
campaign_id	campaign_id	A unique identifier for the advertising campaign.	dimension
campaign_name	campaign_name	The name given to identify the advertising campaign.	dimension
campaign_status	campaign_status	The current operational state of the campaign, indicating if it’s active, paused, archived, or pending review.	dimension
date	date	The specific date for which the data is reported.	dimension
entity_id	entity_id	The unique identifier for the entity (e.g., ad, ad set, or campaign).	dimension
entity_name	entity_name	The name of the entity (e.g., ad, ad set, or campaign).	dimension
entity_status	entity_status	The current operational status of the entity (e.g., active, paused).	dimension
entity_type	entity_type	The type of advertising entity, such as AD, AD_SET, or CAMPAIGN.	dimension
parent_entity	parent_entity	The parent entity in the advertising hierarchy (e.g., the ad set containing an ad, or the campaign containing an ad set).	dimension
parent_entity.id	parent_entity.id	The unique identifier of the parent entity in the ad hierarchy (e.g., the Ad Set ID for an Ad, or Campaign ID for an Ad Set).	dimension
parent_entity.name	parent_entity.name	The name of the parent entity in the ad hierarchy.	dimension
parent_entity.status	parent_entity.status	The current operational status of the parent entity in the ad hierarchy.	dimension
platform_name	platform_name	The platform where the ad is displayed, such as iOS or Android. This is also used for targeting.	dimension