Fields listing for Spotify Ads

A unique identifier for an IMAGE or VIDEO asset with 9:16 aspect ratio.

The ID provided back when an upload url is requested. Note this does not mean it's processed successfully; you will need to check the status for that.

A unique identifier for an IMAGE asset.

Brand name of the Ad.

The link to the ads desired landing page activated by a button labelled CTA below and also the cover art image.

The ID provided back when an companion image upload url is requested. Note this does not mean its Processed successfully, you will need to check the status for that* bbbv , cv.

Date the Ad was created.

Id of an Ad.

URL the campaign will direct to

Name given to identify your ad.

Ad reject reason

Allowed values:'ACTIVE', 'PAUSED', 'ARCHIVED'

The artist promotion target id of Ad Set

The artist promotion conversion tracking event type of Ad Set

The artist promotion goal of Ad Set

The artist promotion name of Ad Set

The artist promotion target id of Ad Set

The artist promotion target type of Ad Set

The ad set bid amount.

Allowed values:'UNSET', 'AD_COMPLETES', 'CLICKS', 'EVEN_IMPRESSION_DELIVERY', 'REACH'

Allowed values:'UNSET', 'MAX_BID'

Total budget for the ad set

Currency of the budget

Allowed values: "DAILY", "LIFETIME"

Allowed values:'CPCL', 'CPM', 'CPC', 'UNSET'

Date the Ad Set was created.

Date the ad set will end on.

Id of an Ad Set.

Ad Set name that will be displayed to the user

The Ad Set reject reason.

The Ad Set serving issues.

Date the ad set will start on.

Allowed values:'ACTIVE', 'APPROVED', 'ARCHIVED', 'COMPLETED', 'PENDING_APPROVAL', 'READY', 'REJECTED'

When an Ad Set is created or updated, it is assigned a new version.

Allowed values: "ACTIVE", "PENDING", "PENDING_USER_APPROVAL", "PENDING_ADMIN_APPROVAL", "APPROVED", "REJECTED", "ARCHIVED", "UNRECOGNIZED"

Tagline of the Ad.

Version of the Ad.

The type of audio asset. Allowed values: "BACKGROUND_MUSIC", "STOCK_BACKGROUND_MUSIC", "USER_UPLOADED_AUDIO Example: "USER_UPLOADED_AUDIO"

Date the Audio Asset was created.

The duration of the asset. This value is populated as part of asset processing, and will be null until the asset is in ready state

The file type of the audio asset as defined by the 'file type' specification of the ISO base media file format standard. Allowed values: "MP3", "OGG", "WAV"

Id of an Audio Asset.

Name of an Audio Asset.

The current status of an asset throughout lifecycle processes. Allowed values: "ERROR", "PROCESSING", "READY", "WAITING_UPLOAD" Example: "READY"

Audio Asset Type.

Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

URL of asset. Will be either Google Cloud Storage URL or CDN URL depending on the asset type and the transcoding completion status.

Date the Campaign was created.

Id of a Campaign.

Campaign name that will be displayed to the user

Objective for a campaign. UNSET should not be used.

A purchase order number, to be shown on your invoice, for your own personal organization.

Allowed values:'UNSET', 'ACTIVE', 'PAUSED', 'ARCHIVED', 'UNRECOGNIZED'

Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

The number of impressions in which your ad was clicked (#)

The number of ads served that was played to the end (#)

The percentage of users who listened to the artist for the first time in at least a month after seeing or hearing the ad (%)

The percentage of ads that were clicked (%)

Year, month, and day.

Day of the year

Week of the year

The average cost per 1,000 completed listens - NOTE: Applies to active audio/CPCL campaigns only

The average cost per 1,000 impressions

The percentage of users who listened or viewed a given percentage of the ad (%)

The average number of times each person heard or viewed your ad (#)

Hour of the day

String representation of all supported aspect ratios Allowed values: "HORIZONTAL_16_9", "HORIZONTAL_1_91_1", "SQUARE", "VERTICAL_9_16"

Date the Image Asset was created.

The file type of the image asset as defined by the 'file type' specification of the ISO base media file format standard. Allowed values: "JPEG", "PNG"

Height of an image asset.

Id of an image asset.

The type of image asset. Allowed values: "COMPANION", "LOGO", "USER_UPLOADED_IMAGE" Example: "COMPANION"

Name of an image asset.

Status of an image asset. it can be READY, PROCESSING, WAITING_UPLOAD, PENDING_APPROVAL or ERROR.

Image Asset Type.

Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

URL of an image asset.

Width of an image asset.

The number of times an ad has been successfully served (#) -- NOTE: The API reports on exact impressions, whereas the UI only reports impressions delivered within budgets

The percentage of users who listened to the artist for the first time in at least a month after seeing or hearing the ad (%)

The number of users for which the ad played to the midpoint of the ads total length (#)

Month and day

Month of the year

The percentage of users who listened to the artist for the first time in at least a month after seeing or hearing the ad (%)

The number of times a user skips an ad -- NOTE: Skippable ads are currently supported in AU only (#)

The percentage of users who listened to the artist for the first time in at least a month after seeing or hearing the ad (%)

The number of ads served off of Spotify (#)

The number of listens for a CPCL campaign where a user did NOT skip the ad -- NOTE: Applies to active audio/CPCL campaigns only

The average frequency for listens on a CPCL campaign -- NOTE: Applies to CPCL campaigns only

The number of unique users who had a paid listen for this CPCL campaign -- NOTE: Applies to active audio/CPCL campaigns only

Quarter of the year

The number of unique users who received your ad (#)

The number of times a user skips an ad -- NOTE: Skippable ads are currently supported in AU only (#)

The total amount spent in this campaign, represented in micros -- i.e., multiplied by 10 to the power of 6 (#)

The number of times a user starts hearing/viewing your ad (#)

The total number of streams from listeners who saw/heard the ad (#)

The average number of times each listener streamed the artist after seeing/hearing the ad (#)

The average number of times each new listener streamed the artist after seeing/hearing the ad (#)

The percentage of users who listened or viewed a given percentage of the ad (%)

The number of users who listened to the artist after hearing/seeing an ad (#)

String representation of all supported aspect ratios Allowed values: "HORIZONTAL_16_9", "HORIZONTAL_1_91_1", "SQUARE", "VERTICAL_9_16"

Date the Video Asset was created.

Duration of a Video Asset in seconde.

The file type of the video asset as defined by the 'file type' specification of the ISO base media file format standard. Allowed values: "MP4", "QUICKTIME"

The file type of the video asset as defined by the 'file type' specification of the ISO base media file format standard. Allowed values: "MP4", "QUICKTIME"

Height of a video asset.

Id of a Video Asset.

Name of a Video Asset.

Status of a Video Asset. It can be READY, PROCESSING, WAITING_UPLOAD, PENDING_APPROVAL, REJECTED or ERROR.

URL of thumbnail image of the video asset. Example: "https://adstudio-video-preview-image.spotifycdn.com/123-preview"

Video Asset Type.

Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

URL of a Video Asset.

Width of a video asset.

Week of the year

Week of the year

Year such as 2017.

Year and month.

Year, month, day, and hour.

Year and quarter.

Year and week.