X (Twitter) - Supported Columns
Every column the X (Twitter) connector can download.
These are the columns available to a X (Twitter) connector. The recommended template uses a small subset of them, listed on the X (Twitter) page. The rest can be added to a connector through the Advanced Editor, which stops that connector receiving template updates.
Dimensions
Entity.name
String
The name for the entity.
Entity.start_time
DateTime
The time, expressed in ISO 8601, that the entity will begin serving.
Entity.end_time
DateTime
The time, expressed in ISO 8601, that the entity will stop serving.
Entity.created_at
DateTime
The time, expressed in ISO 8601, when the entity was created.
Entity.updated_at
DateTime
The time, expressed in ISO 8601, when the entity was for the last time updated.
Entity.entity_status
String
The campaign status. Possible values: ACTIVE, DRAFT, PAUSED.
Entity.deleted
Boolean
Indicates if the campaign is deleted.
Entity.purchase_order_number
String
The booking reference number. Use this field to help with invoice reconciliation. Maximum length: 50 characters.
Entity.servable
Boolean
Indicates if campaign is servable.
Entity.effective_status
String
The campaign's effective status. Possible values: RUNNING.
Entity.standard_delivery
Boolean
Indicates if standard or accelerated delivery should be enabled.
Entity.reasons_not_servable
String
Reasons why this campaign is not servable. Possible values are: PAUSED_BY_ADVERTISER, INCOMPLETE, DELETED.
Entity.bid_strategy
String
The bidding mechanism. AUTO automatically optimizes bidding based on daily budget and campaign flight dates. MAX sets the maximum allowable bid and is not available when the objective is set to REACH or FOLLOWERS. TARGET attempts to make daily bid averages within 20% of the specified bid_amount_local_micro and is available when the objective is set to REACH, FOLLOWERS, OR WEBSITE_CLICKS. If set to AUTO, bid_amount_local_micro will be ignored. Cannot be set in the same request as automatically_set_bid. Default based on objective.
Entity.pay_by
String
The unit to charge this line item by. This setting can only be modified for line items using the APP_INSTALLS objective. The default pay_by is automatically set based upon the campaign objective and line item's bid unit. Possible values: APP_CLICK.
Entity.product_type
String
The type of promoted product that this line item will contain. Possible values: MEDIA, PROMOTED_ACCOUNT, PROMOTED_TWEETS.
Entity.objective
String
The campaign objective for this line item. Possible values: APP_ENGAGEMENTS, APP_INSTALLS, REACH, FOLLOWERS, ENGAGEMENTS, VIDEO_VIEWS, PREROLL_VIEWS, WEBSITE_CLICKS.
Entity.creative_source
String
The source of creative for this line item. Possible values: MANAUL.
Entity.advertiser_domain
String
TThe website domain for this advertiser, without the protocol specification.
Entity.primary_web_event_tag
String
The identifier of the primary web event tag. Allows more accurate tracking of engagements for the campaign pertaining to this line item.
Entity.automatically_select_bid
Boolean
Indicates if automatically optimize bidding based on daily budget and campaign flight dates is set.
Entity.placements
String
Lists the places where Twitter ads will be displayed. The possible values are: ALL_ON_TWITTER, PUBLISHER_NETWORK, TWITTER_PROFILE, TWITTER_SEARCH, TWITTER_TIMELINE, TAP_BANNER, TAP_FULL, TAP_FULL_LANDSCAPE, TAP_NATIVE, TAP_MRECT.
Entity.tracking_tags
String
The tracking partner enum and the tracking tag url provided by the tracking partner, separated by a dash. The only currently accepted partner enum is: DOUBLE_CLICK. Example: DOUBLE_CLICK-https://partner_provided_url.
Entity.categories
String
The relevant IAB categories for this advertiser.
Entity.automatic_tweet_promotion
String
Not documented.
Entity.android_app_store_identifier
String
The Google App Store identifier for promoted applications.
Entity.ios_app_store_identifier
String
The numeric portion of the Apple App Store identifier for promoted applications.
Entity.goal
String
The optimization setting to use with this line item. The APP_CLICKS and APP_INSTALLS options are available for APP_INSTALL and APP_ENGAGEMENTS and may require using a supported MACT partner. Default based on objective. Possible values: APP_CLICKS, APP_INSTALLS, ENGAGEMENT, FOLLOWERS, LINK_CLICKS, MAX_REACH, PREROLL, PREROLL_STARTS, REACH_WITH_ENGAGEMENT, VIDEO_VIEW, VIEW_3S_100PCT, VIEW_6S, VIEW_15S, WEBSITE_CONVERSIONS.
Entity.description
String
Description of funding instrument.
Entity.type
String
The type of funding instrument. Possible values: AGENCY_CREDIT_LINE, CREDIT_CARD, CREDIT_LINE, INSERTION_ORDER, PARTNER_MANAGED.
Entity.able_to_fund
Boolean
Indicates if this funding instrument is able to be used for funding.
Entity.reasons_not_able_to_fund
String
Reasons why this funding instrument cannot be used for funding. Possible values are: DELETED, PAUSED or CANCELLED.
Entity.approval_status
String
Status of approval. Possible values include: ACCEPTED, REJECTED, and UNDER_REVIEW.
Entity.card_uri
String
Gets the card URI of the Tweet connected to the promoted tweet.
Entity.card_name
String
Gets the card name of the Tweet connected to the promoted tweet.
Entity.landing_url
String
The URL of the website to direct a user to. This should only be used with TAP images (or 'display creatives'). This value will be ignored if used with preroll assets.
Entity.coordinates
String
Entity.retweeted
Boolean
display_text_range
String
Entity.geo
String
Entity.id_str
String
Entity.in_reply_to_user_id
String
Entity.truncated
Boolean
Entity.in_reply_to_status_id
String
Entity.conversation_settings
String
Entity.nullcast
Boolean
Entity.place
String
Entity.scheduled_at
DateTime
Entity.tweet_type
String
The type of the Tweet connected to the promoted tweet. Possible values: DRAFT, PUBLISHED, SCHEDULED.
Entity.favorited
Boolean
Entity.full_text
String
Gets the full text of the Tweet connected to the promoted tweet.
Entity.lang
String
contributors
String
Entity.in_reply_to_screen_name
String
Entity.card_type
String
Metrics
engagements
Long
ENGAGEMENT
Total number of engagements
impressions
Long
ENGAGEMENT
Total number of impressions
retweets
Long
ENGAGEMENT
Total number of retweets
replies
Long
ENGAGEMENT
Total number of replies
likes
Long
ENGAGEMENT
Total number of likes
follows
Long
ENGAGEMENT
Total number of follows
card_engagements
Long
ENGAGEMENT
Total number of card engagements
clicks
Long
ENGAGEMENT
Total number of clicks, including favorites and other engagements
app_clicks
Long
ENGAGEMENT
Number of app install or app open attempts
qualified_impressions
Long
ENGAGEMENT
Total number of qualified impressions
billed_engagements
Long
BILLING
Total number of billed engagements
billed_charge_local_micro
Long
BILLING
Total spend in micros
video_total_views
Long
VIDEO
Total number of video views
video_views_25
Long
VIDEO
Total number of views where at least 25% of the video was viewed.
video_views_50
Long
VIDEO
Total number of views where at least 50% of the video was viewed.
video_views_75
Long
VIDEO
Total number of views where at least 75% of the video was viewed.
video_views_100
Long
VIDEO
Total number of views where at least 100% of the video was viewed.
video_cta_clicks
Long
VIDEO
Total clicks on the call to action
video_content_starts
Long
VIDEO
Total number of video playback starts
video_3s100pct_views
Long
VIDEO
Total number of views where at least 3 seconds were played while 100% in view (legacy video_total_views)
video_6s_views
Long
VIDEO
Total number of views where at least 6 seconds of the video was viewed.
media_views
Long
MEDIA
Total number of views (autoplay and click) of media across Videos, Vines, GIFs, and Images.
media_engagements
Long
MEDIA
Total number of clicks of media across Videos, Vines, GIFs, and Images.
conversion_purchases_order_quantity_engagement
Long
WEB_CONVERSION
Number of order engagements of type PURCHASE
conversion_purchases_sale_amount_engagement
Long
WEB_CONVERSION
Amount of sale engagements of type PURCHASE
conversion_purchases_sale_amount_view
Long
WEB_CONVERSION
Amount of sale view of type PURCHASE
conversion_purchases_post_view
Long
WEB_CONVERSION
Number of post views of type PURCHASE
conversion_purchases_order_quantity
Long
WEB_CONVERSION
Number of orders of type PURCHASE
conversion_purchases_assisted
Long
WEB_CONVERSION
Number of assisted of type PURCHASE
conversion_purchases_post_engagement
Long
WEB_CONVERSION
Number of post engagements of type PURCHASE
conversion_purchases_sale_amount
Long
WEB_CONVERSION
Amount of sales of type PURCHASE
conversion_purchases_metric
Long
WEB_CONVERSION
Metric of type PURCHASE
conversion_purchases_order_quantity_view
Long
WEB_CONVERSION
Number of order views of type PURCHASE
conversion_sign_ups_order_quantity_engagement
Long
WEB_CONVERSION
Number of order engagements of type SIGN_UP
conversion_sign_ups_sale_amount_engagement
Long
WEB_CONVERSION
Amount of sale engagements of type SIGN_UP
conversion_sign_ups_sale_amount_view
Long
WEB_CONVERSION
Amount of sale view of type SIGN_UP
conversion_sign_ups_post_view
Long
WEB_CONVERSION
Number of post views of type SIGN_UP
conversion_sign_ups_order_quantity
Long
WEB_CONVERSION
Number of orders of type SIGN_UP
conversion_sign_ups_assisted
Long
WEB_CONVERSION
Number of assisted of type SIGN_UP
conversion_sign_ups_post_engagement
Long
WEB_CONVERSION
Number of post engagements of type SIGN_UP
conversion_sign_ups_sale_amount
Long
WEB_CONVERSION
Amount of sales of type SIGN_UP
conversion_sign_ups_metric
Long
WEB_CONVERSION
Metric of type SIGN_UP
conversion_sign_ups_order_quantity_view
Long
WEB_CONVERSION
Number of order views of type SIGN_UP
conversion_site_visits_order_quantity_engagement
Long
WEB_CONVERSION
Number of order engagements of type SITE_VISIT
conversion_site_visits_sale_amount_engagement
Long
WEB_CONVERSION
Amount of sale engagements of type SITE_VISIT
conversion_site_visits_sale_amount_view
Long
WEB_CONVERSION
Amount of sale view of type SITE_VISIT
conversion_site_visits_post_view
Long
WEB_CONVERSION
Number of post views of type SITE_VISIT
conversion_site_visits_order_quantity
Long
WEB_CONVERSION
Number of orders of type SITE_VISIT
conversion_site_visits_post_engagement
Long
WEB_CONVERSION
Number of post engagements of type SITE_VISIT
conversion_site_visits_sale_amount
Long
WEB_CONVERSION
Amount of sales of type SITE_VISIT
conversion_site_visits_metric
Long
WEB_CONVERSION
Metric of type SITE_VISIT
conversion_site_visits_order_quantity_view
Long
WEB_CONVERSION
Number of order views of type SITE_VISIT
conversion_downloads_order_quantity_engagement
Long
WEB_CONVERSION
Number of order engagements of type DOWNLOAD
conversion_downloads_sale_amount_engagement
Long
WEB_CONVERSION
Amount of sale engagements of type DOWNLOAD
conversion_downloads_sale_amount_view
Long
WEB_CONVERSION
Amount of sale view of type DOWNLOAD
conversion_downloads_post_view
Long
WEB_CONVERSION
Number of post views of type DOWNLOAD
conversion_downloads_order_quantity
Long
WEB_CONVERSION
Number of orders of type DOWNLOAD
conversion_downloads_post_engagement
Long
WEB_CONVERSION
Number of post engagements of type DOWNLOAD
conversion_downloads_sale_amount
Long
WEB_CONVERSION
Amount of sales of type DOWNLOAD
conversion_downloads_metric
Long
WEB_CONVERSION
Metric of type DOWNLOAD
conversion_downloads_order_quantity_view
Long
WEB_CONVERSION
Number of order views of type DOWNLOAD
conversion_custom_order_quantity_engagement
Long
WEB_CONVERSION
Number of order engagements of type CUSTOM
conversion_custom_sale_amount_engagement
Long
WEB_CONVERSION
Amount of sale engagements of type CUSTOM
conversion_custom_sale_amount_view
Long
WEB_CONVERSION
Amount of sale view of type CUSTOM
conversion_custom_post_view
Long
WEB_CONVERSION
Number of post views of type CUSTOM
conversion_custom_order_quantity
Long
WEB_CONVERSION
Number of orders of type CUSTOM
conversion_custom_post_engagement
Long
WEB_CONVERSION
Number of post engagements of type CUSTOM
conversion_custom_sale_amount
Long
WEB_CONVERSION
Amount of sales of type CUSTOM
conversion_custom_metric
Long
WEB_CONVERSION
Metric of type CUSTOM
conversion_custom_order_quantity_view
Long
WEB_CONVERSION
Number of order views of type CUSTOM
mobile_conversion_spent_credits_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by post_view
mobile_conversion_spent_credits_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by order_quantity
mobile_conversion_spent_credits_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by assisted
mobile_conversion_spent_credits_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by post_engagement
mobile_conversion_spent_credits_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by sale_amount
mobile_conversion_installs_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INSTALL by post_view
mobile_conversion_installs_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INSTALL by order_quantity
mobile_conversion_installs_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INSTALL by assisted
mobile_conversion_installs_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INSTALL by post_engagement
mobile_conversion_installs_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INSTALL by sale_amount
mobile_conversion_content_views_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CONTENT_VIEW by post_view
mobile_conversion_content_views_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CONTENT_VIEW by order_quantity
mobile_conversion_content_views_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CONTENT_VIEW by assisted
mobile_conversion_content_views_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CONTENT_VIEW by post_engagement
mobile_conversion_content_views_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CONTENT_VIEW by sale_amount
mobile_conversion_add_to_wishlists_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by post_view
mobile_conversion_add_to_wishlists_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by order_quantity
mobile_conversion_add_to_wishlists_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by assisted
mobile_conversion_add_to_wishlists_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by post_engagement
mobile_conversion_add_to_wishlists_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by sale_amount
mobile_conversion_checkouts_initiated_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view
mobile_conversion_checkouts_initiated_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by order_quantity
mobile_conversion_checkouts_initiated_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by assisted
mobile_conversion_checkouts_initiated_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_engagement
mobile_conversion_checkouts_initiated_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by sale_amount
mobile_conversion_reservations_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by post_view
mobile_conversion_reservations_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by order_quantity
mobile_conversion_reservations_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by assisted
mobile_conversion_reservations_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by post_engagement
mobile_conversion_reservations_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by sale_amount
mobile_conversion_tutorials_completed_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view
mobile_conversion_tutorials_completed_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by order_quantity
mobile_conversion_tutorials_completed_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by assisted
mobile_conversion_tutorials_completed_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_engagement
mobile_conversion_tutorials_completed_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by sale_amount
mobile_conversion_achievements_unlocked_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view
mobile_conversion_achievements_unlocked_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by order_quantity
mobile_conversion_achievements_unlocked_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by assisted
mobile_conversion_achievements_unlocked_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_engagement
mobile_conversion_achievements_unlocked_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by sale_amount
mobile_conversion_searches_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SEARCH by post_view
mobile_conversion_searches_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SEARCH by order_quantity
mobile_conversion_searches_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SEARCH by assisted
mobile_conversion_searches_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SEARCH by post_engagement
mobile_conversion_searches_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SEARCH by sale_amount
mobile_conversion_add_to_carts_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by post_view
mobile_conversion_add_to_carts_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by order_quantity
mobile_conversion_add_to_carts_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by assisted
mobile_conversion_add_to_carts_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by post_engagement
mobile_conversion_add_to_carts_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by sale_amount
mobile_conversion_payment_info_additions_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view
mobile_conversion_payment_info_additions_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by order_quantity
mobile_conversion_payment_info_additions_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by assisted
mobile_conversion_payment_info_additions_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_engagement
mobile_conversion_payment_info_additions_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by sale_amount
mobile_conversion_re_engages_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RE_ENGAGE by post_view
mobile_conversion_re_engages_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RE_ENGAGE by order_quantity
mobile_conversion_re_engages_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RE_ENGAGE by assisted
mobile_conversion_re_engages_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RE_ENGAGE by post_engagement
mobile_conversion_re_engages_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RE_ENGAGE by sale_amount
mobile_conversion_shares_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by post_view
mobile_conversion_shares_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by order_quantity
mobile_conversion_shares_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by assisted
mobile_conversion_shares_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by post_engagement
mobile_conversion_shares_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by sale_amount
mobile_conversion_rates_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by post_view
mobile_conversion_rates_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by order_quantity
mobile_conversion_rates_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by assisted
mobile_conversion_rates_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by post_engagement
mobile_conversion_rates_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by sale_amount
mobile_conversion_logins_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LOGIN by post_view
mobile_conversion_logins_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LOGIN by order_quantity
mobile_conversion_logins_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LOGIN by assisted
mobile_conversion_logins_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LOGIN by post_engagement
mobile_conversion_logins_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LOGIN by sale_amount
mobile_conversion_updates_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by post_view
mobile_conversion_updates_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by order_quantity
mobile_conversion_updates_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by assisted
mobile_conversion_updates_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by post_engagement
mobile_conversion_updates_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by sale_amount
mobile_conversion_levels_achieved_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by post_view
mobile_conversion_levels_achieved_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by order_quantity
mobile_conversion_levels_achieved_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by assisted
mobile_conversion_levels_achieved_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by post_engagement
mobile_conversion_levels_achieved_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by sale_amount
mobile_conversion_invites_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by post_view
mobile_conversion_invites_order_quantity
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by order_quantity
mobile_conversion_invites_assisted
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by assisted
mobile_conversion_invites_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by post_engagement
mobile_conversion_invites_sale_amount
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by sale_amount
mobile_conversion_key_page_views_post_view
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type KEY_PAGE_VIEW by post_view
mobile_conversion_key_page_views_post_engagement
Long
MOBILE_CONVERSION
Breakdown of mobile conversions of type KEY_PAGE_VIEW by post_engagement
mobile_conversion_lifetime_value_purchases_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type PURCHASE by metric
mobile_conversion_lifetime_value_purchases_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type PURCHASE by order_quantity
mobile_conversion_lifetime_value_purchases_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type PURCHASE by sale_amount
mobile_conversion_lifetime_value_sign_ups_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SIGN_UP by metric
mobile_conversion_lifetime_value_sign_ups_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SIGN_UP by order_quantity
mobile_conversion_lifetime_value_sign_ups_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SIGN_UP by sale_amount
mobile_conversion_lifetime_value_updates_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by metric
mobile_conversion_lifetime_value_updates_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by order_quantity
mobile_conversion_lifetime_value_updates_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type UPDATE by sale_amount
mobile_conversion_lifetime_value_tutorials_completed_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by metric
mobile_conversion_lifetime_value_tutorials_completed_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by order_quantity
mobile_conversion_lifetime_value_tutorials_completed_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type TUTORIAL_COMPLETED by sale_amount
mobile_conversion_lifetime_value_reservations_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by metric
mobile_conversion_lifetime_value_reservations_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by order_quantity
mobile_conversion_lifetime_value_reservations_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type RESERVATION by sale_amount
mobile_conversion_lifetime_value_add_to_carts_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by metric
mobile_conversion_lifetime_value_add_to_carts_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by order_quantity
mobile_conversion_lifetime_value_add_to_carts_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_CART by sale_amount
mobile_conversion_lifetime_value_add_to_wishlists_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by metric
mobile_conversion_lifetime_value_add_to_wishlists_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by order_quantity
mobile_conversion_lifetime_value_add_to_wishlists_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ADD_TO_WISHLIST by sale_amount
mobile_conversion_lifetime_value_checkouts_initiated_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by metric
mobile_conversion_lifetime_value_checkouts_initiated_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by order_quantity
mobile_conversion_lifetime_value_checkouts_initiated_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type CHECKOUT_INITIATED by sale_amount
mobile_conversion_lifetime_value_levels_achieved_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by metric
mobile_conversion_lifetime_value_levels_achieved_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by order_quantity
mobile_conversion_lifetime_value_levels_achieved_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type LEVEL_ACHIEVED by sale_amount
mobile_conversion_lifetime_value_achievements_unlocked_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by metric
mobile_conversion_lifetime_value_achievements_unlocked_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by order_quantity
mobile_conversion_lifetime_value_achievements_unlocked_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by sale_amount
mobile_conversion_lifetime_value_shares_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by metric
mobile_conversion_lifetime_value_shares_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by order_quantity
mobile_conversion_lifetime_value_shares_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SHARE by sale_amount
mobile_conversion_lifetime_value_invites_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by metric
mobile_conversion_lifetime_value_invites_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by order_quantity
mobile_conversion_lifetime_value_invites_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type INVITE by sale_amount
mobile_conversion_lifetime_value_payment_info_additions_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by metric
mobile_conversion_lifetime_value_payment_info_additions_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by order_quantity
mobile_conversion_lifetime_value_payment_info_additions_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by sale_amount
mobile_conversion_lifetime_value_spent_credits_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by metric
mobile_conversion_lifetime_value_spent_credits_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by order_quantity
mobile_conversion_lifetime_value_spent_credits_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type SPENT_CREDIT by sale_amount
mobile_conversion_lifetime_value_rates_metric
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by metric
mobile_conversion_lifetime_value_rates_order_quantity
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by order_quantity
mobile_conversion_lifetime_value_rates_sale_amount
Long
LIFE_TIME_VALUE_MOBILE_CONVERSION
Breakdown of mobile conversions of type RATE by sale_amount
Entity.daily_budget_amount_local_micro
Long
The daily budget amount to be allocated to the campaign. The currency associated with the specified funding instrument will be used. For USD, $5.50 is represented as 5500000.
Entity.total_budget_amount_local_micro
Long
The total budget amount to be allocated to the entity. The currency associated with the specified funding instrument will be used. For USD, $37.50 is represented as 37500000.
Entity.duration_in_days
Long
The time period within which the frequency_cap is achieved. Possible values: 1, 7, 30.
Entity.frequency_cap
Long
The maximum number of times an ad could be delivered to a user.
Entity.bid_amount_local_micro
Long
The bid amount to be associated with this line item. The currency associated with the specified funding instrument will be used. For USD, $5.50 is represented as 5500000.
Entity.credit_remaining_local_micro
Decimal
It is valid for CREDIT_LINE and AGENCY_CREDIT_LINE type funding instruments. It represents the credit_limit_local_micro minus the amount already spent on that funding instrument. It does not represent the difference between funded_amount_local_micro and the amount spent.
Entity.credit_limit_local_micro
Decimal
It is only valid for CREDIT_CARD or CREDIT_LINE type funding instruments and represents the credit limit for that instrument.
Entity.funded_amount_local_micro
Decimal
It is only valid for INSERTION_ORDER type funding instruments and represents the allocated budget.
Entity.tweet.favorite_count
Long
Indicates approximately how many times Tweet connected to the promoted tweet has been liked by Twitter users.
Entity.tweet.retweet_count
Long
Number of times Tweet connected to the promoted tweet has been retweeted.
{CPM}
Double
Calculated as billed_charge_local_micro/impressions/1000
{billed_charge_local}
Double
Calculated as billed_charge_local_micro/1000000 rounded to 2 decimal places
Entity.favorite_count
Long
Entity.retweet_count
Long
Other columns
Entity.id
String
The identifier for the retrieved entity.
Entity.currency
String
The type of a currency that is identified using ISO-4217 standard.
Entity.funding_instrument_id
String
The identifier for the funding instrument under which the campaign was created.
Entity.campaign_id
String
The identifier for the campaign that this line item was created under.
Entity.advertiser_user_id
Long
The Twitter user identifier for the handle promoting a PREROLL_VIEWS ad.
Entity.account_id
String
The identifier for the leveraged account.
Entity.io_header
String
Insertion order header ID.
Entity.line_item_id
String
A reference to the line item to which entity belongs.
Entity.tweet_id
String
Identifier of the Tweet.
Entity.user_id
String
Identifier of the User which created this account.
Entity.account_media_id
String
A reference to the account media entity that is connected to this media creative.
Entity.source
String
Was this helpful?