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.
Click-Through Rate (CTR) Metric
The percentage of ads within the ad set that were clicked.
Clicks Metric
The total number of times an ad was clicked.
Completes Metric
The number of times an ad was played to 100% completion.
Completion Rate Metric
The percentage of ads that were played to 100% completion.
Conversion Rate Metric
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 Quartiles Metric
The number of times an ad was played up to 25% of its duration.
Frequency Metric
The average number of times a unique user was exposed to an ad.
Impressions Metric
The total number of times an ad was served to users.
Intent Rate Metric
The rate at which users show intent to engage further with the ad or brand, beyond just a click or listen.
Listeners Metric
The number of unique users who listened to an ad.
Midpoints Metric
The number of times an ad was played up to 50% of its duration.
New Listener Conversion Rate Metric
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 Streams Metric
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 Listeners Metric
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 Impressions Metric
The total number of times an ad was served outside of the Spotify platform.
Paid Listens Metric
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 Frequency Metric
The average number of times each user streamed the promoted content for at least 30 seconds within a paid campaign.
Paid Listens Reach Metric
The number of unique users who streamed the promoted content for at least 30 seconds within a paid campaign.
Purchases Metric
The number of purchase conversion events attributed to your advertising campaigns. This metric is available in aggregate reports and can be used to understand the effectiveness of your ads in driving sales or completed transactions. To protect user privacy, conversion counts are masked as -5 when the actual number is between 1 and 4.
Reach Metric
The number of unique users who were exposed to an ad.
Skips Metric
The number of times users skipped the ad.
Spend Metric
The total amount of money spent on an ad or campaign.
Starts Metric
The number of times an ad started playing or was initiated.
Streams Metric
The total count of times the ad's content (audio or video) was streamed or played.
Streams per New Listener Metric
The average number of content streams per new listener acquired through advertising.
Streams per User Metric
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 Quartiles Metric
The number of times an ad was played up to 75% of its duration.
Unmutes Metric
The number of times users unmuted the ad or the Spotify application while an ad was playing.
Video Views Metric
The total number of views for video ad creatives.
ad_account_id Dimension
The unique identifier for the ad account.
date Dimension
The specific date for which the data is reported.
entity_id Dimension
The unique identifier for the entity (e.g., ad, ad set, or campaign).
entity_name Dimension
The name of the entity (e.g., ad, ad set, or campaign).
entity_status Dimension
The current operational status of the entity (e.g., active, paused).
entity_type Dimension
The type of advertising entity, such as AD, AD_SET, or CAMPAIGN.
parent_entity Dimension
The parent entity in the advertising hierarchy (e.g., the ad set containing an ad, or the campaign containing an ad set).
parent_entity.id Dimension
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.name Dimension
The name of the parent entity in the ad hierarchy.
parent_entity.status Dimension
The current operational status of the parent entity in the ad hierarchy.