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 people who clicked on your ad after seeing it. This metric is typically calculated as the number of clicks divided by the number of impressions.	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
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
Reach	Reach	The number of unique users who were exposed to an 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
Third Quartiles	Third Quartiles	The number of times an ad was played up to 75% of its duration.	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
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