# Spotify Ads API v3 — Enum Values

## Campaign Enums

### CampaignStatus
- `UNSET`
- `ACTIVE`
- `PAUSED`
- `ARCHIVED`
- `AGENT_CONTROLLED`
- `ACTIVE_RESTRICTED`
- `PENDING_ADVERTISER_REVIEW`
- `UNRECOGNIZED`

### CampaignDerivedStatus
- `ACTIVE`
- `REJECTED`
- `READY`
- `COMPLETED`
- `PENDING_APPROVAL`
- `PENDING_ADVERTISER_APPROVAL`
- `STOPPED`
- `UNKNOWN`

### OptimizationPrefs (Campaign Objective)
- `REACH`
- `EVEN_IMPRESSION_DELIVERY`
- `CLICKS`
- `VIDEO_VIEWS`
- `CONVERSIONS`
- `LEAD_GEN`

---

## Ad Set Enums

### AdSetStatus
- `ACTIVE`
- `PENDING`
- `REJECTED`
- `ARCHIVED`
- `PAUSED`
- `COMPLETED`
- `READY`

### AssetFormat
- `AUDIO`
- `VIDEO`
- `IMAGE`
- `AUDIO_PODCAST`
- `AUDIO_PROGRAMMATIC`
- `SURVEY`
- `URI`
- `MULTI`
- `CATALOG`
- `TEXT`

### BidStrategy
**Important:** This is a plain **string enum**, NOT an object. Use as `"bid_strategy": "MAX_BID"`.
- `MAX_BID` — The `bid_micro_amount` acts as a bid cap (maximum CPM). **This is the typical default.** Always set `bid_micro_amount` when using MAX_BID.
- `COST_PER_RESULT` — Only compatible with the CLICKS campaign objective. The `bid_micro_amount` acts as a target Cost Per Click.
- `UNSET` — Let the system handle bidding automatically. Use when bid cap is not needed (e.g., LIFETIME budgets).

### BudgetType
- `DAILY`
- `LIFETIME`

### CostModel
- `CPM`
- `CPC`
- `CPA`
- `CPL`

### Delivery
- `ON`
- `OFF`

### Pacing
- `PACING_EVEN`
- `PACING_ACCELERATED`

---

## Ad Enums

### AdStatus
- `APPROVED`
- `ARCHIVED`
- `PENDING`
- `PENDING_APPROVAL`
- `REJECTED`

### Placement
- `MUSIC`
- `PODCAST`
- `VIDEO`

---

## Asset Enums

### AssetType
- `IMAGE`
- `AUDIO`
- `VIDEO`

### AssetStatus
- `READY`
- `PROCESSING`
- `REJECTED`

### AssetSubtype (for audio assets)
- `ADSTUDIO_SUPPLIED_AUDIO`
- `BACKGROUND_MUSIC`
- `USER_UPLOADED_AUDIO`

### MediaFileType
- `JPEG`
- `PNG`
- `MP4`
- `QUICKTIME`
- `MP3`
- `OGG`
- `WAV`

---

## Audience Enums

### AudienceType
- `CUSTOM`
- `LOOKALIKE`

### AudienceStatus
- `ACTIVE`
- `INACTIVE`
- `EXPIRED`

---

## Report Enums

### ReportFieldType (Aggregate & Insight Reports)
Used with the `fields` query parameter on aggregate and insight report endpoints.
**Important:** These are different from AsyncReportMetric values. Do NOT use async metric names (like `AD_COMPLETES`, `CPM`) in aggregate reports.

- `IMPRESSIONS`
- `SPEND` — in micro-amounts (divide by 1,000,000 for dollars)
- `CLICKS`
- `REACH`
- `FREQUENCY`
- `LISTENERS`
- `NEW_LISTENERS`
- `STREAMS`
- `COMPLETES` — (NOT `AD_COMPLETES`)
- `COMPLETION_RATE`
- `STARTS`
- `FIRST_QUARTILES`
- `MIDPOINTS`
- `THIRD_QUARTILES`
- `VIDEO_VIEWS`
- `CTR`
- `OFF_SPOTIFY_IMPRESSIONS`

### ReportEntityType
- `CAMPAIGN`
- `AD_SET`
- `AD`
- `AD_ACCOUNT`

### TimeDimensionType (Granularity)
- `HOUR` — date range must be within the last 2 weeks
- `DAY` — date range must be within 90 days
- `LIFETIME` — date range must be within 90 days

### AsyncReportGranularity
- `DAY`
- `LIFETIME`

### AsyncReportDimension
- `AD_ACCOUNT_NAME`
- `AD_ACCOUNT_CURRENCY`
- `CAMPAIGN_NAME`
- `CAMPAIGN_STATUS`
- `CAMPAIGN_OBJECTIVE`
- `AD_SET_NAME`
- `AD_SET_STATUS`
- `AD_SET_BUDGET`
- `AD_SET_COST_MODEL`
- `AD_NAME`

### AsyncReportMetric
**Important:** These are for async CSV reports only. For aggregate reports, use `ReportFieldType` values instead.

- `IMPRESSIONS_ON_SPOTIFY`
- `IMPRESSIONS_OFF_SPOTIFY`
- `SPEND`
- `CLICKS`
- `REACH`
- `FREQUENCY`
- `LISTENERS`
- `NEW_LISTENERS`
- `STREAMS`
- `AD_COMPLETES` — (in aggregate reports, use `COMPLETES` instead)
- `CTR`
- `CPM`
- `COMPLETION_RATE`

### AsyncReportEntityStatus
- `ACTIVE`
- `PAUSED`
- `COMPLETED`
- `PENDING_APPROVAL`
- `REJECTED`
- `ARCHIVED`

### InsightDimensionType
- `GENDER`
- `PLATFORM`
- `LOCATION`
- `ARTIST`
- `GENRE`

---

## Sorting Enums

### SortDirection
- `ASC`
- `DESC`

### CampaignSortField
- `CREATED_AT`
- `UPDATED_AT`
- `NAME`

### AdSetSortField
- `CREATED_AT`
- `UPDATED_AT`
- `NAME`

### AdSortField
- `CREATED_AT`
- `UPDATED_AT`

### AudienceSortField
- `CREATED_AT`
- `UPDATED_AT`
- `NAME`

---

## Targeting Enums

### Platform
- `ANDROID`
- `DESKTOP`
- `IOS`

**Important:** Do NOT use `MOBILE` or `CONNECTED_DEVICE` — those are not valid API values.

### AdCallToActionKey
- `APPLY_NOW`
- `BOOK_NOW`
- `BUY_NOW`
- `BUY_TICKETS`
- `CLICK_NOW`
- `DOWNLOAD`
- `FIND_STORES`
- `GET_COUPON`
- `GET_INFO`
- `LEARN_MORE`
- `LISTEN_NOW`
- `MORE_INFO`
- `ORDER_NOW`
- `PRE_SAVE`
- `SAVE_NOW`
- `SHARE`
- `SHOP_NOW`
- `SIGN_UP`
- `VISIT_PROFILE`
- `VISIT_SITE`
- `WATCH_NOW`

**Important:** The field name in requests is `key`, NOT `type` or `text`.

### Gender
- `MALE`
- `FEMALE`
- `NON_BINARY`