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.
Adds to CartMetric
This metric represents the number of times users added an item to their shopping cart on the advertiser's website after being exposed to a Spotify ad.
Click-Through Rate (CTR)Metric
The percentage of ads within the ad set that were clicked.
ClicksMetric
The total number of times an ad was clicked.
CompletesMetric
The number of times an ad was played to 100% completion.
Completion RateMetric
The percentage of ads that were played to 100% completion.
Conversion RateMetric
The percentage of users who completed a desired action (conversion) after interacting with the ad.
Effective Cost Per Click (eCPC)Metric
The average cost incurred for each click on an ad.
Effective Cost Per Mille (eCPM)Metric
The average cost incurred for one thousand ad impressions.
First QuartilesMetric
The number of times an ad was played up to 25% of its duration.
FrequencyMetric
The average number of times a unique user was exposed to an ad.
ImpressionsMetric
The total number of times an ad was served to users.
Intent RateMetric
The rate at which users show intent to engage further with the ad or brand, beyond just a click or listen.
ListenersMetric
The number of unique users who listened to an ad.
MidpointsMetric
The number of times an ad was played up to 50% of its duration.
New Listener Conversion RateMetric
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.
New Listener StreamsMetric
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.
New ListenersMetric
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.
Off Spotify ImpressionsMetric
The total number of times an ad was served outside of the Spotify platform.
Paid ListensMetric
The number of times your ad was listened to until completion. This corresponds to the AD_COMPLETES metric in the Spotify Ads API.
Paid Listens FrequencyMetric
The average number of times each user streamed the promoted content for at least 30 seconds within a paid campaign.
Paid Listens ReachMetric
The number of unique users who streamed the promoted content for at least 30 seconds within a paid campaign.
PurchasesMetric
This metric represents the number of times users completed a purchase on the advertiser's website after being exposed to a Spotify ad.
ReachMetric
The number of unique users who were exposed to an ad.
SkipsMetric
The number of times users skipped the ad.
SpendMetric
The total amount of money spent on an ad or campaign.
StartsMetric
The number of times an ad started playing or was initiated.
StreamsMetric
The total count of times the ad's content (audio or video) was streamed or played.
Streams per New ListenerMetric
The average number of content streams per new listener acquired through advertising.
Streams per UserMetric
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.
Third QuartilesMetric
The number of times an ad was played up to 75% of its duration.
UnmutesMetric
The number of times users unmuted the ad or the Spotify application while an ad was playing.
Video ViewsMetric
The total number of views for video ad creatives.
ad_account_idDimension
The unique identifier for the ad account.
dateDimension
The specific date for which the data is reported.
entity_idDimension
The unique identifier for the entity (e.g., ad, ad set, or campaign).
entity_nameDimension
The name of the entity (e.g., ad, ad set, or campaign).
entity_statusDimension
The current operational status of the entity (e.g., active, paused).
entity_typeDimension
The type of advertising entity, such as AD, AD_SET, or CAMPAIGN.
parent_entityDimension
The parent entity in the advertising hierarchy (e.g., the ad set containing an ad, or the campaign containing an ad set).
parent_entity.idDimension
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).
parent_entity.nameDimension
The name of the parent entity in the ad hierarchy.
parent_entity.statusDimension
The current operational status of the parent entity in the ad hierarchy.