X Ads (Twitter) fields

  • Updated on Sep 11, 2025
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your X Ads (Twitter) data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

158 metrics138 dimensions

ACCOUNT

account
Field label Account
Description The ad account name
Field type dimension
Data type string.text.value
account_id
Field label Account ID
Description The unique ID for the ad account
Field type dimension
Data type string.text.value
account_ui_id
Field label Account UI ID
Description Converted account ID to base-10 to match the UI value
Field type dimension
Data type int.number.value

AD GROUP

line_item_name
Field label Ad group
Description Formerly called line item
Field type dimension
Data type string.text.value
line_item_id
Field label Ad group ID
Description Formerly called line item id
Field type dimension
Data type string.text.value
ad_group_ui_id
Field label Ad group UI ID
Description Converted ad group ID to base-10 to match the UI value
Field type dimension
Data type int.number.value
line_item_objective
Field label Objective
Field type dimension
Data type string.text.value
line_item_goal
Field label Goal
Description The optimization setting used for this ad group
Field type dimension
Data type string.text.value
line_item_product_type
Field label Product type
Field type dimension
Data type string.text.value
line_item_placements
Field label Placements
Field type dimension
Data type string.text.value
line_item_charge_by
Field label Charge by
Field type dimension
Data type string.text.value
line_item_bid_type
Field label Bid type
Field type dimension
Data type string.text.value
line_item_bid_amount
Field label Bid amount
Field type dimension
Data type float.currency.value
line_item_total_budget_amount
Field label Ad group total budget
Description The maximum amount you are willing to spend on the ad group, for the duration of the ad group flight length. Formerly called line item total budget
Field type dimension
Data type float.currency.value
line_item_advertiser_domain
Field label Advertiser domain
Field type dimension
Data type string.text.value
line_item_primary_web_event_tag
Field label Primary web event tag
Field type dimension
Data type string.text.value
line_item_created_at
Field label Ad group creation date
Description Formerly called line item creation date
Field type dimension
Data type string.time.date
line_item_start_date
Field label Ad group start date
Description The date when the ad group began serving
Field type dimension
Data type string.time.date
line_item_end_date
Field label Ad group end date
Description The date when the ad group stopped serving
Field type dimension
Data type string.time.date
line_item_status
Field label Ad group status
Description The ad group status, with possible values ACTIVE, DRAFT, or PAUSED
Field type dimension
Data type string.text.value
line_item_deleted
Field label Ad group deleted
Description Formerly called line item deleted
Field type dimension
Data type bool
line_item_categories
Field label Categories
Field type dimension
Data type string.text.value
line_item_include_sentiment
Field label Include sentiment
Field type dimension
Data type string.text.value

CAMPAIGN

campaign_name
Field label Campaign
Field type dimension
Data type string.text.value
campaign_id
Field label Campaign ID
Description The unique ID for each campaign
Field type dimension
Data type string.text.value
campaign_ui_id
Field label Campaign UI ID
Description Converted campaign ID to base-10 to match the UI value
Field type dimension
Data type int.number.value
campaign_created_at
Field label Campaign creation date
Field type dimension
Data type string.time.date
campaign_start_time
Field label Campaign start date
Description The date your campaign is scheduled to launch. This field is deprecated by Twitter, please use Ad group start date instead
Field type dimension
Data type string.time.date
campaign_end_time
Field label Campaign end date
Description The date when the campaign ends. This field is deprecated by Twitter, please use Ad group end date instead
Field type dimension
Data type string.time.date
campaign_servable
Field label Campaign servable
Field type dimension
Data type bool
campaign_status
Field label Campaign status
Description The campaign status, with possible values ACTIVE, DRAFT, or PAUSED
Field type dimension
Data type string.text.value
campaign_deleted
Field label Campaign deleted
Field type dimension
Data type bool
campaign_currency
Field label Campaign currency
Description The currency used for all spend-related metrics and billing
Field type dimension
Data type string.currency.code
campaign_standard_delivery
Field label Campaign standard delivery
Field type dimension
Data type bool
campaign_total_budget_amount
Field label Campaign total budget
Description The maximum amount you're willing to spend on each campaign for the duration of the campaign
Field type dimension
Data type float.currency.value
campaign_daily_budget_amount
Field label Campaign daily budget
Description The maximum amount you're willing to spend on each campaign on average per day
Field type dimension
Data type float.currency.value
campaign_budget_optimization
Field label Campaign budget optimization
Description Type of the campaign budget optimization. Possible values - CAMPAIGN and LINE_ITEM
Field type dimension
Data type string.text.value

DATASOURCE

dataSourceName
Field label Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
Destinations API, Data warehouse
system_metadata.data_source_logins
Field label Data source logins
Description The data source login accounts that were used to authenticate against the data source
Field type dimension
Data type string.text.json
system_metadata.data_source_login_owners
Field label Data source login owners
Description The Supermetrics users that created the data source login connections
Field type dimension
Data type string.text.json

DEPRECATED

promoted_tweet_card_display_url
Field label Tweet card display URL
Description Please note this field will be removed on 2021-08-24
Field type dimension
Data type string.text.url
audienceCategory
Field label Audience category
Description Name of audience category, e.g. White collar worker. Please note this field will be removed on 2020-01-30
Field type dimension
Data type string.text.value
line_item_optimization
Field label Optimization
Description Please note this field will be removed on 2021-08-24
Field type dimension
Data type string.text.value
audienceName
Field label Audience name
Description Name of audience, e.g. Occupation. Please note this field will be removed on 2020-01-30
Field type dimension
Data type string.text.value
audienceSource
Field label Source of audience data
Description The providing party of audience data. Please note this field will be removed on 2020-01-30
Field type dimension
Data type string.text.value
audienceType
Field label Audience type
Description Type of an audience, e.g. ALL_ON_TWITTER. Please note this field will be removed on 2020-01-30
Field type dimension
Data type string.text.value
interactionType
Field label Interaction type
Description Type of interaction; applicable to some audience types. Please note this field will be removed on 2020-01-30
Field type dimension
Data type string.text.value
line_item_tracking_tags
Field label Tracking tags
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2022-02-15
line_item_paused
Field label Ad group paused
Description Formerly called line item paused.
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2022-11-30
line_item_automatically_select_bid
Field label Automatically select bid
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2022-02-15
campaign_paused
Field label Campaign paused
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2022-11-30
promoted_tweet_card_id
Field label Tweet card ID
Description Please note this field will be removed on 2021-08-24
Field type dimension
Data type string.text.value
matchRate
Field label Match rate
Description 90 day active Twitter users divided by number of users provided by the source of audience data. Please note this field will be removed on 2020-01-30
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric
percentage
Field label Percentage
Description Representation of a category within an audience. Please note this field will be removed on 2020-01-30
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric

FUNDING INSTRUMENTS

funding_instrument_id
Field label Funding instrument ID
Description A reference to the funding instrument
Field type dimension
Data type string.text.value
funding_instrument_ui_id
Field label Funding instrument UI ID
Description Converted funding instrument ID to base-10 to match the UI value
Field type dimension
Data type int.number.value
funding_instrument_description
Field label Funding instrument description
Description Funding instrument description
Field type dimension
Data type string.text.value
funding_instrument_type
Field label Funding instrument type
Description Funding instrument type
Field type dimension
Data type string.text.value
funding_instrument_status
Field label Funding instrument status
Description Funding instrument status
Field type dimension
Data type string.text.value
funding_instrument_currency
Field label Funding instrument currency
Description Funding instrument currency
Field type dimension
Data type string.text.value
funding_instrument_start_date
Field label Funding instrument start date
Description The date for the funding instrument to become active and usable
Field type dimension
Data type string.time.date
funding_instrument_end_date
Field label Funding instrument end date
Description The date for the funding instrument to become inactive
Field type dimension
Data type string.time.date
funding_instrument_credit_limit
Field label Funding instrument credit limit
Description The total credit available against funding instrument
Field type dimension
Data type float.currency.value
funding_instrument_funded_amount
Field label Funding instrument funded amount
Description The total budget amount allocated to funding instrument
Field type dimension
Data type float.currency.value
funding_instrument_credit_remaining
Field label Funding instrument credit remaining
Description The total credit remaining to funding instrument
Field type dimension
Data type float.currency.value
funding_instrument_reasons_not_able_to_fund
Field label Reasons funding instrument was not able to fund
Description Reasons funding instrument was not able to fund
Field type dimension
Data type string.text.value
funding_instrument_io_header
Field label Insertion order header ID
Description ID for the associated insertion order. Note that a single ID may be associated with multiple funding instruments
Field type dimension
Data type string.text.value

GENERAL METRICS

impressions
Field label Impressions
Description The number of times your ad is shown to users, including earned
Field type metric
Data type int.number.value
cost
Field label Cost
Field type metric
Data type float.currency.value
cost_eur
Field label Cost (EUR)
Field type metric
Data type float.currency.value
Services Currency conversion
cost_usd
Field label Cost (USD)
Field type metric
Data type float.currency.value
Services Currency conversion
cost_gbp
Field label Cost (GBP)
Field type metric
Data type float.currency.value
Services Currency conversion
CPM
Field label CPM
Field type metric
Data type float.currency.value
mediaViews
Field label Media views
Description Total views (autoplay and click) of your media across videos, Vines, GIFs, and images. This includes views you are not billed for
Field type metric
Data type int.number.value
mediaViewRate
Field label Media view rate
Description Total media views divided by number of impressions
Field type metric
Data type float.number.ratio
media_engagements
Field label Media engagements
Description Total number of clicks of media across videos, Vines, GIFs, and images
Field type metric
Data type int.number.value
conversions
Field label Conversions
Field type metric
Data type int.number.value
V1_conversionRate
Field label Conversion rate (%)
Field type metric
Data type float.number.ratio

MEDIA CREATIVE

media_creative_id
Field label Media creative ID
Description ID of the media creative
Field type dimension
Data type string.text.value
media_creative_created_at
Field label Media creative creation date
Description Creation date of the media creative
Field type dimension
Data type string.time.date
media_creative_type
Field label Media creative type
Description Type of the media creative
Field type dimension
Data type string.text.value
media_name
Field label Media name
Description Name of the media object
Field type dimension
Data type string.text.value
media_url
Field label Media url
Description URL to the media object
Field type dimension
Data type string.text.value

MOBILE CONVERSION METRICS

mobile_conversion_achievement_unlocked
Field label Mobile conversion achievements unlocked
Description Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_add_to_cart
Field label Mobile conversion add to cart
Description Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_added_payment_infos
Field label Mobile conversion added payment infos
Description Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_add_to_wishlist
Field label Mobile conversion add to wishlist
Description Breakdown of mobile conversions of type ADD_TO_WISHLIST by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_checkout_initiated
Field label Mobile conversion checkout initiated
Description Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_content_views
Field label Mobile conversion content views
Description Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_installs
Field label Mobile conversion installs
Description Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
V1_mobile_conversion_installs_post_view
Field label Mobile conversion installs post view
Field type metric
Data type int.number.value
V1_mobile_conversion_installs_post_engagement
Field label Mobile conversion installs post engagement
Field type metric
Data type int.number.value
mobile_conversion_invites
Field label Mobile conversion invites
Description Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_level_achieved
Field label Mobile conversion level achieved
Description Breakdown of mobile conversions of type LEVEL_ACHIEVED
Field type metric
Data type int.number.value
mobile_conversion_logins
Field label Mobile conversion logins
Description Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_purchases
Field label Mobile conversion purchases
Field type metric
Data type int.number.value
mobile_conversion_re_engages
Field label Mobile conversion re-engages
Description Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_sign_ups
Field label Mobile conversion sign ups
Description Breakdown of mobile conversions of type SIGN_UP
Field type metric
Data type int.number.value
mobile_conversion_rated
Field label Mobile conversion rated
Field type metric
Data type int.number.value
mobile_conversion_reservations
Field label Mobile conversion reservations
Description Breakdown of mobile conversions of type RESERVATION by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_searches
Field label Mobile conversion searches
Description Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_shares
Field label Mobile conversion shares
Description Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_spent_credits
Field label Mobile conversion spent credits
Description Breakdown of mobile conversions of type SPENT_CREDIT
Field type metric
Data type int.number.value
mobile_conversion_tutorial_completes
Field label Mobile conversion tutorial completes
Description Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_updates
Field label Mobile conversion updates
Description Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_achievement_unlocked_breakdown
Field label Mobile conversion achievement unlocked breakdown
Description Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_add_to_cart_breakdown
Field label Mobile conversion add to cart breakdown
Description Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_add_to_wishlist_breakdown
Field label Mobile conversion add to wishlist breakdown
Description Breakdown of mobile conversions of type ADD_TO_WISHLIST
Field type metric
Data type int.number.value
mobile_conversion_added_payment_infos_breakdown
Field label Mobile conversion added payment infos breakdown
Description Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_checkout_initiated_breakdown
Field label Mobile conversion checkout initiated breakdown
Description Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_content_views_breakdown
Field label Mobile conversion content views breakdown
Description Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_installs_breakdown
Field label Mobile conversion installs breakdown
Description Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_invites_breakdown
Field label Mobile conversion invites breakdown
Description Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_level_achieved_breakdown
Field label Mobile conversion level achieved breakdown
Description Breakdown of mobile conversions of type LEVEL_ACHIEVED by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_logins_breakdown
Field label Mobile conversion logins breakdown
Description Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_order_quantity
Field label Mobile conversion order quantity
Field type metric
Data type int.number.value
mobile_conversion_purchases_breakdown
Field label Mobile conversion purchases breakdown
Description Breakdown of mobile conversions of type PURCHASE
Field type metric
Data type int.number.value
mobile_conversion_rated_breakdown
Field label Mobile conversion rated breakdown
Field type metric
Data type int.number.value
mobile_conversion_re_engages_breakdown
Field label Mobile conversion re-engages breakdown
Description Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_reservations_breakdown
Field label Mobile conversion reservations breakdown
Description Breakdown of mobile conversions of type RESERVATION
Field type metric
Data type int.number.value
mobile_conversion_sale_amount_local_micro
Field label Mobile conversion sale amount
Field type metric
Data type float.currency.value
mobile_conversion_searches_breakdown
Field label Mobile conversion searches breakdown
Description Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_shares_breakdown
Field label Mobile conversion shares breakdown
Description Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_sign_ups_breakdown
Field label Mobile conversion mobile conversion sign ups breakdown
Description Breakdown of mobile conversions of type SIGN_UP
Field type metric
Data type int.number.value
mobile_conversion_spent_credits_breakdown
Field label Mobile conversion spent credits breakdown
Description Breakdown of mobile conversions of type SPENT_CREDIT
Field type metric
Data type int.number.value
mobile_conversion_tutorial_completes_breakdown
Field label Mobile conversion tutorial completes breakdown
Description Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value
mobile_conversion_updates_breakdown
Field label Mobile conversion updates breakdown
Description Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount
Field type metric
Data type int.number.value

OBJECTIVE APP INSTALLS

V1_app_installs
Field label App installs
Field type metric
Data type int.number.value
app_clicks
Field label App clicks
Description Total number of clicks to install or open your app. This includes earned clicks that you're not billed for
Field type metric
Data type int.number.value
app_click_rate
Field label App click rate (%)
Description Total number of app clicks divided by impressions
Field type metric
Data type float.number.ratio
app_install_rate
Field label App install rate (%)
Field type metric
Data type float.number.ratio
CPAC
Field label Cost per app click (CPAC)
Description Total spend divided by the number of app clicks, including earned. You only pay the first time someone clicks to install or open your app
Field type metric
Data type float.currency.value
CPI
Field label Cost per install (CPI)
Field type metric
Data type float.currency.value

OBJECTIVE FOLLOWERS

followers
Field label Followers
Description Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you
Field type metric
Data type int.number.value
followersRate
Field label Followers rate (%)
Description Total followers divided by total impressions. This helps you understand how well your ad is attracting new followers
Field type metric
Data type float.number.ratio
CPF
Field label Cost per follower (CPF)
Description Total spend divided by the number of followers, including earned. You only pay when someone follows you
Field type metric
Data type float.currency.value

OBJECTIVE LEAD GENERATION

leads
Field label Leads
Description The number of leads you acquired as a result of a user submitting their contact information on Twitter through the Lead Generation Card
Field type metric
Data type int.number.value
lead_rate
Field label Lead rate (%)
Description Total leads divided by the number of impressions, including earned. You only pay the first time a user submits a Lead Generation Card
Field type metric
Data type float.number.ratio
CPL
Field label Cost per lead
Description Total spend divided by the number of leads, including earned. You only pay for leads generated by your ad
Field type metric
Data type float.currency.value

OBJECTIVE TWEET ENGAGEMENTS

engagements
Field label Engagements
Description All clicks on your Tweet, including Retweets, replies, likes, poll votes, and hashtag clicks. This includes earned clicks that you're not billed for
Field type metric
Data type int.number.value
billed_engagements
Field label Engagements (billed)
Field type metric
Data type int.number.value
CPE
Field label Cost per engagement (CPE)
Description Total spend divided by the number of Tweet engagements, including earned. You only pay the first time someone engages with your ad (e.g. Retweets, replies, likes, or other clicks)
Field type metric
Data type float.currency.value
engagementsRate
Field label Engagements rate (%)
Description Tweet engagements divided by impressions. This helps you understand the rate of engagements with your ad
Field type metric
Data type float.number.ratio
likes
Field label Likes (paid)
Description The number of people who liked your ad by clicking the heart button
Field type metric
Data type int.number.value
retweets
Field label Retweets
Description The number of people that Retweeted your ad by clicking the Retweet button
Field type metric
Data type int.number.value
replies
Field label Replies
Description The number of people that responded to your Tweet by clicking the reply button
Field type metric
Data type int.number.value
follows
Field label Follows
Description Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you
Field type metric
Data type int.number.value
card_engagements
Field label Card engagements
Description Total number of card engagements
Field type metric
Data type int.number.value
qualified_impressions
Field label Qualified impressions
Field type metric
Data type int.number.value

OBJECTIVE VIDEO VIEWS

promoted_video_total_views
Field label Video views
Description Video views only count when your video is watched in 50% view for 2 seconds or more, or when a user clicks to expand/unmute your video. This includes views you are not billed for
Field type metric
Data type int.number.value
video_view_rate
Field label Video view rate (%)
Description Total video views divided by impressions. Regardless of your bid type, this is always calculated using video ad views
Field type metric
Data type float.number.ratio
CPV
Field label Cost per video view
Description Total spend divided by the number of views, including earned. You only pay the first time someone watches your video
Field type metric
Data type float.currency.value
promoted_video_cta_clicks
Field label Video CTA clicks
Description Total clicks on the call to action in the video player. This includes clicks you are not billed for
Field type metric
Data type int.number.value
video_3s100pct_views
Field label 3s/100% video views
Description Total number of views where at least 3 seconds were played while 100% in view
Field type metric
Data type int.number.value
video_6s_views
Field label 6s video views
Description Total number of views where at least 6 seconds of the video was viewed
Field type metric
Data type int.number.value
video_15s_views
Field label 15s video views
Description Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed
Field type metric
Data type int.number.value
promoted_video_starts
Field label Video starts
Description The number of people who started the video, regardless of how much of the video player is in view. You're not billed for these
Field type metric
Data type int.number.value
promoted_video_views_25
Field label Video views (25% complete)
Description The number of people who watched 25% of the video, regardless of how much of the video player is in view. You're not billed for these
Field type metric
Data type int.number.value
promoted_video_views_50
Field label Video views (50% complete)
Description The number of people who watched 50% of the video, regardless of how much of the video player is in view. You're not billed for these
Field type metric
Data type int.number.value
promoted_video_views_75
Field label Video views (75% complete)
Description The number of people who watched 75% of the video, regardless of how much of the video player is in view. You're not billed for these
Field type metric
Data type int.number.value
promoted_video_views_100
Field label Video views (completed)
Description The number of people who watched 100% of the video, regardless of how much of the video player is in view. You're not billed for these
Field type metric
Data type int.number.value

OBJECTIVE WEBSITE CLICKS OR CONVERSIONS

clicks
Field label Clicks
Description Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks
Field type metric
Data type int.number.value
url_clicks
Field label URL clicks
Description Total clicks on the link or Website Card in your ad, including earned. This includes clicks you're not billed for
Field type metric
Data type int.number.value
CTR
Field label CTR
Description Total clicks on a link or a Website Card divided by total impressions, including earned
Field type metric
Data type float.number.ratio
CPC
Field label CPC
Description Total clicks on a link or a Website Card divided by total clicks, including earned
Field type metric
Data type float.currency.value
CPA
Field label Cost per acquisition
Field type metric
Data type float.currency.value
conversion_site_visits
Field label Site visits
Field type metric
Data type int.number.value
conversion_sign_ups
Field label Sign-ups
Description Total number of sign ups. This is the same as the sum of post views, post engagements and assisted sign ups. This is also the sum of website and mobile app sign ups
Field type metric
Data type int.number.value
conversion_downloads
Field label Downloads
Field type metric
Data type int.number.value
conversion_purchases
Field label Purchases
Description Total number of purchases. The sum of post view, post engagement, and assisted purchases for both your website and mobile app
Field type metric
Data type int.number.value
conversion_order_quantity
Field label Order quantity
Description The order quantity of the purchase, e.g. 1 unit
Field type metric
Data type int.number.value
conversion_sale_amount
Field label Sale amount
Description The total sale amount of the purchase
Field type metric
Data type float.currency.value
conversion_custom
Field label Custom conversions
Field type metric
Data type int.number.value

PROMOTED TWEET

promoted_tweet_id
Field label Tweet ID
Description Unique numeric ID of the original tweet being used in the promoted tweet ad
Field type dimension
Data type string.text.value
promoted_tweet_ad_id
Field label Tweet ad ID
Description Unique alphanumeric ID for the promoted tweet ad
Field type dimension
Data type string.text.value
promoted_tweet_created_at
Field label Tweet creation date
Field type dimension
Data type string.time.date
ad_name
Field label Ad name
Description Ad name as displayed in X user interface. Derived from promoted tweet name, or card name if tweet name is not set
Field type dimension
Data type string.text.value
promoted_tweet_name
Field label Tweet name
Description Name of the promoted tweet. Note that this can be empty for older Tweets or ones created without a name
Field type dimension
Data type string.text.value
promoted_tweet_text
Field label Tweet text
Field type dimension
Data type string.text.value
promoted_tweet_source
Field label Tweet source
Description Source client of the tweet, e.g. twitter.com or Twitter for Android
Field type dimension
Data type string.text.value
promoted_tweet_scheduled_status
Field label Tweet scheduled status
Description Whether the tweet is scheduled for later or not
Field type dimension
Data type string.text.value
promoted_tweet_scheduled_at
Field label Tweet scheduled at
Description Tweet scheduled to publish at
Field type dimension
Data type string.time.datetime
promoted_tweet_type
Field label Tweet type
Description Tweet type, e.g. PUBLISHED
Field type dimension
Data type string.text.value
promoted_tweet_language
Field label Tweet language
Description Language of the tweet (automatically identified)
Field type dimension
Data type string.language.twolettercode
promoted_tweet_hashtags
Field label Tweet hashtags
Description Hashtags included in the tweet
Field type dimension
Data type string.text.value
promoted_tweet_symbols
Field label Tweet symbols
Description Symbols included in the tweet
Field type dimension
Data type string.text.value
promoted_tweet_user_mentions
Field label Tweet mentions
Description Users mentioned in the tweet
Field type dimension
Data type string.text.value
tweet_url
Field label Link to tweet
Field type dimension
Data type string.text.url
promoted_tweet_first_url
Field label Tweet first URL
Field type dimension
Data type string.text.url
promoted_tweet_card_title
Field label Tweet card title
Field type dimension
Data type string.text.value
promoted_tweet_card_name
Field label Tweet card name
Field type dimension
Data type string.text.value
promoted_tweet_card_type
Field label Tweet card type
Field type dimension
Data type string.text.value
promoted_tweet_card_destination_url
Field label Tweet card destination URL
Field type dimension
Data type string.text.url
promoted_tweet_card_image_url
Field label Tweet card image URL
Field type dimension
Data type string.text.url
promoted_tweet_card_image
Field label Tweet card image
Field type dimension
Data type string.text.formula
promoted_tweet_card_uri
Field label Tweet card URI
Description The unique identifier of the card. Replaces Tweet card ID
Field type dimension
Data type string.text.value
promoted_tweet_destination_url
Field label Tweet destination URL
Field type dimension
Data type string.text.url
promoted_tweet_media_type
Field label Tweet media type
Description Type of tweet media
Field type dimension
Data type string.text.value
utm_source
Field label Source (utm)
Description Value of the utm_source parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_medium
Field label Medium (utm)
Description Value of the utm_medium parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_content
Field label Content (utm)
Description Value of the utm_content parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_term
Field label Term (utm)
Description Value of the utm_term parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_campaign
Field label Campaign (utm)
Description Value of the utm_campaign parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value

PROMOTED TWEETS

V1_promoted_tweet_retweets
Field label Tweet retweets
Description The number of people that Retweeted your ad by clicking the Retweet button
Field type metric
Data type int.number.value
V1_promoted_tweet_likes
Field label Likes (paid+organic)
Description The number of people who liked your ad by clicking the heart button
Field type metric
Data type int.number.value

PROMOTED TWEETS (PROFILE)

promoted_tweet_profile_impressions
Field label Impressions (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_qualified_impressions
Field label Qualified impressions (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_clicks
Field label Clicks (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_engagements
Field label Engagements (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_favorites
Field label Favorites (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_follows
Field label Follows (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_replies
Field label Replies (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_retweets
Field label Retweets (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_url_clicks
Field label URL clicks (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_card_engagements
Field label Card engagements (profile) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_profile_media_views
Field label Media views (profile) (deprecated)
Field type metric
Data type int.number.value

PROMOTED TWEETS (SEARCH)

promoted_tweet_search_impressions
Field label Impressions (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_qualified_impressions
Field label Qualified impressions (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_clicks
Field label Clicks (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_engagements
Field label Engagements (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_engagement_rate
Field label Engagement rate (search) (deprecated)
Field type metric
Data type float.number.ratio
Aggregation Non-aggregatable metric
promoted_tweet_search_favorites
Field label favorites (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_follows
Field label Follows (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_replies
Field label Replies (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_retweets
Field label Retweets (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_url_clicks
Field label URL clicks (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_card_engagements
Field label Card engagements (search) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_search_media_views
Field label Media views (search) (deprecated)
Field type metric
Data type int.number.value

PROMOTED TWEETS (TIMELINE)

promoted_tweet_timeline_impressions
Field label Impressions (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_qualified_impressions
Field label Qualified impressions (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_clicks
Field label Clicks (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_engagements
Field label Engagements (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_engagement_rate
Field label Engagement rate (timeline) (deprecated)
Field type metric
Data type float.number.ratio
Aggregation Non-aggregatable metric
promoted_tweet_timeline_favorites
Field label Favorites (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_follows
Field label Follows (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_replies
Field label Replies (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_retweets
Field label Retweets (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_url_clicks
Field label URL clicks (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_media_views
Field label Media views (timeline) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_timeline_card_engagements
Field label Card engagements (timeline) (deprecated)
Field type metric
Data type int.number.value

PROMOTED TWEETS (TWITTER PUBLISHER NETWORK)

promoted_tweet_tpn_media_views
Field label Media views (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_qualified_impressions
Field label Qualified impressions (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_card_engagements
Field label Card engagements (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_engagement_rate
Field label Engagement rate (TPN) (deprecated)
Field type metric
Data type float.number.ratio
Aggregation Non-aggregatable metric
promoted_tweet_tpn_engagements
Field label Engagements (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_clicks
Field label Clicks (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_favorites
Field label Favorites (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_follows
Field label Follows (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_impressions
Field label Impressions (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_replies
Field label Replies (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_retweets
Field label Retweets (TPN) (deprecated)
Field type metric
Data type int.number.value
promoted_tweet_tpn_url_clicks
Field label URL clicks (TPN) (deprecated)
Field type metric
Data type int.number.value

PROMOTEDACCOUNT METRICS

promoted_account_follows
Field label Follows (promoted act)
Field type metric
Data type int.number.value
promoted_account_follow_rate
Field label Follow rate (promoted act)
Field type metric
Data type float.number.ratio
Aggregation Non-aggregatable metric
promoted_account_impressions
Field label Impressions (promoted act)
Field type metric
Data type int.number.value
promoted_account_profile_visits
Field label Profile visits (promoted act)
Field type metric
Data type int.number.value

QUERY

system_metadata.query_date_range_start
Field label Start date
Description The start date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_date_range_end
Field label End date
Description The end date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_timezone
Field label Timezone
Description The timezone that is supplied to the query
Field type dimension
Data type string.time.timezone
system_metadata.query_filters
Field label Filters
Description All filters used in the query
Field type dimension
Data type string.text.json
system_metadata.query_date_start
Field label Start
Description When the query was started
Field type dimension
Data type string.time.datetime
system_metadata.query_date_end
Field label End
Description When the query completed
Field type dimension
Data type string.time.datetime
system_metadata.query_duration
Field label Duration
Description The duration in seconds of the query
Field type dimension
Data type int.duration.seconds
system_metadata.query_accounts
Field label Accounts
Description A list of accounts of which the data was pulled from
Field type dimension
Data type string.text.json

REACH

total_audience_reach
Field label Total audience reach
Description The total number of people who have been reached by the campaign
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
average_frequency
Field label Average frequency
Description The average number of times a person saw ads related to this campaign
Field type metric
Data type float.number.value
Aggregation Non-aggregatable metric

SEGMENTATION

AGE
Field label Age
Field type dimension
Data type string.person.age
APP_STORE_CATEGORY
Field label App store category
Field type dimension
Data type string.text.value
CONVERSION_TAGS
Field label Conversion tag
Field type dimension
Data type string.text.value
EVENTS
Field label Event
Field type dimension
Data type string.text.value
GENDER
Field label Gender
Field type dimension
Data type string.person.gender
INTERESTS
Field label Interest
Field type dimension
Data type string.text.value
KEYWORDS
Field label Keyword
Field type dimension
Data type string.text.value
LANGUAGES
Field label Language
Field type dimension
Data type string.language.value
LOCATIONS
Field label Country
Field type dimension
Data type string.geo.country
countryCode
Field label Country code
Description Two-letter county code
Field type dimension
Data type string.geo.country.twolettercode
REGIONS
Field label Region
Field type dimension
Data type string.geo.region
CITIES
Field label City
Field type dimension
Data type string.geo.city
PLATFORMS
Field label Platform
Field type dimension
Data type string.text.value
SIMILAR_TO_FOLLOWERS_OF_USER
Field label Similar to follower
Field type dimension
Data type string.text.value
TV_SHOWS
Field label TV show
Field type dimension
Data type string.text.value

TIME

today
Field label Today
Description Today's date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
Destinations API, Data warehouse
year
Field label Year
Description Year, e.g. 2017
Field type dimension
Data type string.time.year
yearofweek
Field label Year of week (Sun-Sat)
Description Year of week for US weeks, e.g. 2017
Field type dimension
Data type string.time.year
yearofweekiso
Field label Year of week (Mon-Sun)
Description Year of week for ISO weeks, e.g. 2017
Field type dimension
Data type string.time.year
yearmonth
Field label Year & month
Description Year and month, e.g. 2017|06
Field type dimension
Data type string.time.yearmonth
quarter
Field label Quarter
Description Quarter, e.g. 1
Field type dimension
Data type string.time.quarter
month
Field label Month
Description Month, e.g. 6
Field type dimension
Data type string.time.month
yearweek
Field label Year & week (Sun-Sat)
Description Year and week for US weeks, e.g. 2017|08
Field type dimension
Data type string.time.yearweek
yearweekiso
Field label Year & week (Mon-Sun)
Description Year and week for ISO weeks, e.g. 2017|08
Field type dimension
Data type string.time.yearweekiso
week
Field label Week (Sun-Sat)
Description US week number, e.g. 51
Field type dimension
Data type string.time.week
weekiso
Field label Week (Mon-Sun)
Description ISO week number, e.g. 51
Field type dimension
Data type string.time.weekiso
dayOfWeekName
Field label Day of week (Sun-Sat)
Description Day of week name for US weeks, e.g. 0 Sunday
Field type dimension
Data type string.time.dayofweekiso
dayOfWeekNameIso
Field label Day of week (Mon-Sun)
Description Day of week name for ISO weeks, e.g. 1 Monday
Field type dimension
Data type string.time.dayofweek
dayOfMonth
Field label Day of month
Description Day of month, e.g. 2
Field type dimension
Data type string.time.dayofmonth
date
Field label Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date