Ads Enumerations

We expose many different types as enumerations (enums) via the Ads API. While we can’t promise that this is an absolute list of any possible value you could see, we will do our best to add and remove ENUMs as they change and document those here.

Accounts

Related endpoints:

approval_status
ACCEPTED
UNDER_REVIEW
REJECTED

Analytics

Related endpoints:

entity
ACCOUNT
FUNDING_INSTRUMENT
CAMPAIGN
LINE_ITEM
PROMOTED_TWEET
ORGANIC_TWEET

metric_groups
ENGAGEMENT
WEB_CONVERSION
MOBILE_CONVERSION
MEDIA
VIDEO
LIFE_TIME_VALUE_MOBILE_CONVERSION
BILLING

placement
ALL_ON_TWITTER
PUBLISHER_NETWORK

status
PROCESSING
SUCCESS
FAILED
CANCELLED

Funding Instruments

Related endpoints:

type
INSERTION_ORDER
CREDIT_LINE
AGENCY_CREDIT_LINE
CREDIT_CARD
PARTNER_MANAGED
LIVE_TV_EVENT_IO

reasons_not_able_to_fund
BUDGET_EXHAUSTED
CREDIT_CARD_APPROVAL_PENDING
CREDIT_CARD_DELETED
CREDIT_CARD_REJECTED
DELETED
EXPIRED
PAUSED
STARTS_IN_FUTURE

Campaigns

Related endpoints:

reasons_not_servable
ACCOUNT_REJECTED
ACCOUNT_UNDER_REVIEW
AWAITING_APPROVAL_BY_ADVERTISER
BUDGET_EXHAUSTED
CONTENT_REVIEW_PROBLEM
DELETED
EXPIRED
FUNDING_PROBLEM
INCOMPLETE
PAUSED_BY_ADVERTISER
STARTS_IN_FUTURE

Line Items (Ad Groups)

Related endpoints:

bid_unit
APP_CLICK
APP_INSTALL
ENGAGEMENT
FOLLOW
LEAD
LINK_CLICK
VIEW
VIEW_3S_100PCT

charge_by
APP_CLICK
APP_INSTALL
ENGAGEMENT
FOLLOW
IMPRESSION
LEAD
LINK_CLICK
VIEW

optimization Description
DEFAULT Use the default optimization for this objective.
ENGAGEMENT Optimize for reach with engagements. Only available with the AWARENESS objective.
WEBSITE_CONVERSIONS Optimize for “high-intent” users who exhibit key behaviors signaling a higher likelihood of a website conversion. Only available with the WEBSITE_CLICKS objective.

placements Description
ALL_ON_TWITTER All possible placement types on Twitter
TWITTER_SEARCH Only search results on Twitter
TWITTER_TIMELINE Only timelines on Twitter
PUBLISHER_NETWORK On the Twitter Audience Platform
TWITTER_PROFILE On Twitter user profiles

product_type Description
MEDIA Media creative used for video pre-roll and TAP
PROMOTED_ACCOUNT Promoted Accounts
PROMOTED_TWEETS Promoted Tweets
LIVE_TV_EVENT Mid-roll Video

tracking_partner (for tracking_tags) Description
DOUBLE_CLICK Google DoubleClick Campaign Manager

Tweets / Scoped Timeline

Related endpoints:

Note: These enum values should be used as lowercase

tweet_mode Description
compat Display the tweet in “classic” mode
extended Display the tweet in “extended” mode

Tailored Audiences

Related endpoints:

reasons_not_targetable
PROCESSING
TOO_SMALL
UPLOAD_FAILED

Tailored Audience Changes

Related endpoints:

state
UPLOADING
PROCESSING
COMPLETED
FAILED

Tailored Audience Memberships

Related endpoints:

membership_type
WEB_MEMBERSHIP
WEB_OPTOUT
LIST_MEMBERSHIP

user_identifier_type
TALIST_PARTNER_USER_ID
TAWEB_PARTNER_USER_ID
EMAIL
HANDLE
TWITTER_ID
DEVICE_ID
PHONE_NUMBER

Targeting

Related endpoints:

Age

The Ads API currently supports all available age buckets.

age_buckets
AGE_13_TO_24
AGE_13_TO_34
AGE_13_TO_49
AGE_13_TO_54
AGE_OVER_13
AGE_18_TO_34
AGE_18_TO_49
AGE_18_TO_54
AGE_OVER_18
AGE_21_TO_34
AGE_21_TO_49
AGE_21_TO_54
AGE_OVER_21
AGE_25_TO_49
AGE_25_TO_54
AGE_OVER_25
AGE_35_TO_49
AGE_35_TO_54
AGE_OVER_35
AGE_OVER_50

Locations

Related endpoints:

Note: In v2, CITIES refers to specific cities, such as San Francisco or London. For more information, see our versions page.

location_type
COUNTRIES
REGIONS
METROS
CITIES
POSTAL_CODES

Event

Related endpoints:

event_types
MUSIC_AND_ENTERTAINMENT
SPORTS
HOLIDAY
CONFERENCE
OTHER

Insights

Related endpoints:

audience_type Description
ALL_ON_TWITTER All users based in the United States.
CAMPAIGN Set of users who were reached, engaged, or converted by your campaigns.
ORGANIC Set of users who have interacted with organic content belonging to the full promotable (primary) user of the ads account.

interaction_type
ENGAGEMENT
IMPRESSION
CONVERSION

Video

Related endpoints:

reasons_not_servable
DMCA_TAKE_DOWN
ERROR
NOT_A_VIDEO
PROCESSING
VIDEO_INCOMPLETE
VIDEO_TOO_LONG

video_cta
WATCH_NOW
VISIT_SITE

Creative Types

Related endpoints:

creative_type Accepted dimensions
BANNER width of 320px and height of 50px
INTERSTITIAL width of 320px and height of 480px
MEDIUM_RECTANGLE width of 300px and height of 250px
BANNER_TABLET width of 728px and height of 90px
INTERSTITIAL_LANDSCAPE width of 480px and height of 320px
INTERSTITIAL_TABLET width of 768px and height of 1024px
INTERSTITIAL_LANDSCAPE_TABLET width of 1024px and height of 768px
PREROLL see promoted video for tech specs
VAST_PREROLL URI to a VAST preroll asset (https only)