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
Audience	Audience	A dimension representing the targeted audience segment.	dimension
CLICKS	Clicks	The total number of times an ad was clicked.	metric
Campaign	Campaign	A dimension representing the advertising campaign.	dimension
Campaign Name	Campaign Name	The name of the campaign.	dimension
Campaign.current_status	Campaign.current_status	The current operational status of the campaign.	dimension
Campaign.id	Campaign.id	The unique identifier for the campaign.	dimension
Campaign.name	Campaign.name	The name of the campaign.	dimension
Click-Through Rate (CTR)	Click-Through Rate (CTR)	The percentage of impressions that resulted in a click on the ad.	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
DAY	Day	A time dimension representing the specific day for which data is reported.	dimension
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
Format	Format	A dimension representing the format of the ad creative (e.g., audio, video).	dimension
Frequency	Frequency	The average number of times a unique user was exposed to an ad.	metric
Geo	Geo	A dimension representing the geographical location targeted by the ad.	dimension
Goal	Goal	A dimension representing the primary objective or goal of the advertising campaign.	dimension
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
Language	Language	A dimension representing the language targeting of the ad.	dimension
Listeners	Listeners	The number of unique users who listened to an ad.	dimension
Media Source	Media Source	A dimension representing the source or channel through which the media was delivered.	dimension
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 rate at which new listeners convert after exposure to an ad.	metric
New Listener Streams	New Listener Streams	The number of streams generated by new listeners acquired through advertising.	metric
New Listeners	New Listeners	The total number of unique listeners acquired as a result of an advertising campaign.	metric
Objective	Objective	A dimension representing the marketing objective of the campaign (e.g., brand awareness, web traffic, app installs).	dimension
Off Spotify Impressions	Off Spotify Impressions	The number of times an ad was served outside of the Spotify platform.	metric
Paid Listens	Paid Listens	The number of listens attributed to paid advertising.	metric
Paid Listens Frequency	Paid Listens Frequency	The average number of times a unique user listened to a paid ad.	metric
Paid Listens Reach	Paid Listens Reach	The number of unique users who listened to a paid ad.	metric
Partner	Partner	A dimension representing the advertising partner involved in the campaign.	dimension
Platform	Platform	A dimension representing the platform where the ad was displayed (e.g., iOS, Android, Web).	dimension
Reach	Reach	The number of unique users who were exposed to an ad.	metric
Region	Region	A dimension representing the geographical region for reporting.	dimension
SPEND	Amount Spent	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
STREAMED_IMPRESSIONS	STREAMED_IMPRESSIONS		metric
Skips	Skips	The number of times users skipped an ad before its completion.	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 number of content streams initiated by users, potentially influenced by ads.	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 content streams per user who was exposed to an ad.	metric
Tactic	Tactic	A dimension representing the specific advertising tactic or strategy used.	dimension
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 an ad, initially muted by the user, was unmuted.	metric
Video Expand Rate	Video Expand Rate		metric
Video Expands	Video Expands		metric
Video Views	Video Views	The total number of views for video ad creatives.	metric
Year	Year	A time dimension representing the year for which data is reported. Note: This dimension has been deprecated in the Spotify Ads API.	metric
ad_account_id	ad_account_id	The unique identifier for the ad account.	dimension
ad_audience	ad_audience	The specific audience segment targeted by the ad.	dimension
ad_campaign	ad_campaign	The campaign to which the ad belongs.	dimension
ad_creative_name	ad_creative_name		dimension
ad_geo	ad_geo	The geographical targeting setting for the individual ad.	dimension
ad_goal	ad_goal	The primary objective or goal set for the individual ad.	dimension
ad_language	ad_language	The language targeting setting for the individual ad.	dimension
ad_objective	ad_objective	The marketing objective of the individual ad.	dimension
ad_partner	ad_partner	The advertising partner associated with the individual ad.	dimension
adgroup_ads_Clicks	adgroup_ads_Clicks	The number of times users clicked on ads within an ad group.	metric
adgroup_ads_Completes	adgroup_ads_Completes	The number of times ads within an ad group were played to completion.	metric
adgroup_ads_Impressions	adgroup_ads_Impressions	The number of times ads within an ad group were served to users.	metric
adgroup_ads_Spend	adgroup_ads_Spend	The total amount of money spent on ads within an ad group.	metric
adgroup_ads_entity_id	adgroup_ads_entity_id	The unique identifier for an ad within an ad group.	dimension
adgroup_ads_entity_name	adgroup_ads_entity_name	The name of an ad within an ad group.	dimension
adgroup_audience	adgroup_audience	The specific audience segment targeted by the ad group.	dimension
adgroup_campaign	adgroup_campaign	The campaign to which the ad group belongs.	dimension
adgroup_entity_id	adgroup_entity_id	The unique identifier for the ad group (also referred to as Ad Set ID).	dimension
adgroup_entity_name	adgroup_entity_name	The name of the ad group (also referred to as Ad Set Name).	dimension
adgroup_geo	adgroup_geo	The geographical targeting setting for the ad group.	dimension
adgroup_goal	adgroup_goal	The primary objective or goal set for the ad group.	dimension
adgroup_language	adgroup_language	The language targeting setting for the ad group.	dimension
adgroup_objective	adgroup_objective	The marketing objective of the ad group, such as brand awareness or conversions.	dimension
campaign_id	campaign_id	The unique identifier for the campaign.	dimension
campaign_name	campaign_name	The name of the campaign.	dimension
campaign_status	campaign_status	The current operational status of the campaign.	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
id	id	A unique identifier for the specific entity (e.g., ad, ad set, or campaign).	dimension
identifier	identifier	A unique identifier for an entity.	dimension
name	name	The name of the specific entity (e.g., 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	platform	A dimension representing the platform where the ad was displayed (e.g., iOS, Android, Web).	dimension
spend	spend	The total amount of money spent on an ad or campaign.	metric
status	status	The current operational status of the entity.	dimension