Try our plataform
X Ads

Creating the data source

Requirements

  • X Ads (Twitter Ads) advertiser account with at least one active ad account

Instructions

  1. In Kondado, click "Add Connection" and select "X Ads".
  2. You will be redirected to X (Twitter) to authorize access. Log in with your account that has access to the ad accounts.
  3. After authorizing, you will be redirected back to Kondado.
  4. Create a new pipeline and select the ad accounts, entities (campaigns, ad groups, etc.), metrics and segmentations you want.
  5. Configure the time granularity and the update window.

Pipelines

Summary

Relationship chart

Click to expand

Ad performance

Replication type: Full

Parameters:

  • Segmentation: Adds an extra dimension to segment the metrics. Options: Age, Gender, Languages, Locations, Regions, Platforms, Platform Versions, Devices, Interests, Conversations, Conversion Tags, Tailored Audiences, Events. Leave blank for no segmentation.
  • Update window (days): Number of days to look back and update on each run. Recommended: 7 days to capture delayed attribution conversions.
  • Ad placements: Defines where ads were displayed. Options: Twitter (ads shown on Twitter), Audience Platform (ads shown on partner apps and websites).
  • Time grouping: Defines the time granularity of the data. Options: Hour (hourly metrics), Day (daily metrics), Week (weekly metrics), Month (monthly metrics).
  • Read start date: Date from which data will be extracted. Data available from 07/14/2015.
  • Ad accounts: Select the ad accounts to extract data from. Leave blank to fetch all available accounts.
  • Detail level: Defines the data aggregation level. Options: Account (aggregated by account), Funding Source (by payment source), Campaign (by campaign), Ad Group (by ad group/line item), Promoted Tweet (by promoted tweet), Organic Tweet (by organic tweet).

X Ads (Twitter Ads) advertising performance report, with media metrics (impressions, engagements, clicks, spend, video, etc.) and derived metrics aggregated by date and by the dimensions of the selected entity (account, campaign, line item, promoted tweet or funding instrument), supporting segmentation and multiple placements.

Campo Tipo

metric_date

date

[en] Reference date for the metric in X Ads

account_id

text

[en] Twitter Ads account ID

account_name

text

[en] Twitter Ads Account Name

campaign_id

text

[en] Campaign ID

campaign_name

text

[en] Campaign name

lineitem_id

text

[en] Line Item ID

lineitem_name

text

[en] Line Item name

promoted_tt_id

text

[en] Promoted Tweet ID

tweet_id

text

[en] Tweet ID

funding_id

text

[en] Funding Instrument ID

funding_name

text

[en] Funding Instrument Name

media_url

text

[en] URL of the ad media file. On a video ad it is the .mp4 file itself; on an image ad it is the image file. Use media_type to tell them apart. Only exists when the integration's level of detail is Promoted Tweet — on the other levels the column is not created. Blank when the ad has no media (text-only ad) or when the original post was deleted on X.

media_type

text

[en] Ad media format: VIDEO or IMAGE. Determines the file type pointed to by media_url. Only exists when the integration's level of detail is Promoted Tweet — on the other levels the column is not created.

media_key

text

[en] Identifier of the media file in the X media library. The same file reused across several ads repeats the same media_key, so it is the key to group performance by creative. Only exists when the integration's level of detail is Promoted Tweet — on the other levels the column is not created.

time_period

timestamp

[en] Time Period

segment_name

text

[en] Segment Name

segment_value

text

[en] Segment Value

app_clicks

float

[en] App clicks (clicks that send the user to the app store)

billed_charge_local_micro

float

[en] Total spend

billed_engagements

float

[en] Total number of billed engagements

card_engagements

float

[en] Total number of card engagements

carousel_swipes

float

[en] Total swipes on Carousel images or videos

clicks

float

[en] Total number of clicks, including favorites and other engagements

conversion_custom_metric

float

[en] Number of custom conversions (web)

conversion_custom_order_quantity

float

[en] Order quantity for custom conversions (web)

conversion_custom_order_quantity_engagement

float

[en] Order quantity for post-engagement custom conversions (web)

conversion_custom_order_quantity_view

float

[en] Order quantity for post-view custom conversions (web)

conversion_custom_post_engagement

float

[en] Post-engagement custom conversions (web)

conversion_custom_post_view

float

[en] Post-view custom conversions (web)

conversion_custom_sale_amount

float

[en] Sale amount for custom conversions (web)

conversion_custom_sale_amount_engagement

float

[en] Sale amount for post-engagement custom conversions (web)

conversion_custom_sale_amount_view

float

[en] Sale amount for post-view custom conversions (web)

conversion_downloads_metric

float

[en] Number of downloads conversions (web)

conversion_downloads_order_quantity

float

[en] Order quantity for downloads conversions (web)

conversion_downloads_order_quantity_engagement

float

[en] Order quantity for post-engagement downloads conversions (web)

conversion_downloads_order_quantity_view

float

[en] Order quantity for post-view downloads conversions (web)

conversion_downloads_post_engagement

float

[en] Post-engagement downloads conversions (web)

conversion_downloads_post_view

float

[en] Post-view downloads conversions (web)

conversion_downloads_sale_amount

float

[en] Sale amount for downloads conversions (web)

conversion_downloads_sale_amount_engagement

float

[en] Sale amount for post-engagement downloads conversions (web)

conversion_downloads_sale_amount_view

float

[en] Sale amount for post-view downloads conversions (web)

conversion_purchases_assisted

float

[en] Assisted purchase conversions (web)

conversion_purchases_metric

float

[en] Number of purchase conversions (web)

conversion_purchases_order_quantity

float

[en] Order quantity for purchase conversions (web)

conversion_purchases_order_quantity_engagement

float

[en] Order quantity for post-engagement purchase conversions (web)

conversion_purchases_order_quantity_view

float

[en] Order quantity for post-view purchase conversions (web)

conversion_purchases_post_engagement

float

[en] Post-engagement purchase conversions (web)

conversion_purchases_post_view

float

[en] Post-view purchase conversions (web)

conversion_purchases_sale_amount

float

[en] Sale amount for purchase conversions (web)

conversion_purchases_sale_amount_engagement

float

[en] Sale amount for post-engagement purchase conversions (web)

conversion_purchases_sale_amount_view

float

[en] Sale amount for post-view purchase conversions (web)

conversion_sign_ups_assisted

float

[en] Assisted sign-up conversions (web)

conversion_sign_ups_metric

float

[en] Number of sign-up conversions (web)

conversion_sign_ups_order_quantity

float

[en] Order quantity for sign-up conversions (web)

conversion_sign_ups_order_quantity_engagement

float

[en] Order quantity for post-engagement sign-up conversions (web)

conversion_sign_ups_order_quantity_view

float

[en] Order quantity for post-view sign-up conversions (web)

conversion_sign_ups_post_engagement

float

[en] Post-engagement sign-up conversions (web)

conversion_sign_ups_post_view

float

[en] Post-view sign-up conversions (web)

conversion_sign_ups_sale_amount

float

[en] Sale amount for sign-up conversions (web)

conversion_sign_ups_sale_amount_engagement

float

[en] Sale amount for post-engagement sign-up conversions (web)

conversion_sign_ups_sale_amount_view

float

[en] Sale amount for post-view sign-up conversions (web)

conversion_site_visits_metric

float

[en] Number of site visit conversions (web)

conversion_site_visits_order_quantity

float

[en] Order quantity for site visit conversions (web)

conversion_site_visits_order_quantity_engagement

float

[en] Order quantity for post-engagement site visit conversions (web)

conversion_site_visits_order_quantity_view

float

[en] Order quantity for post-view site visit conversions (web)

conversion_site_visits_post_engagement

float

[en] Post-engagement site visit conversions (web)

conversion_site_visits_post_view

float

[en] Post-view site visit conversions (web)

conversion_site_visits_sale_amount

float

[en] Sale amount for site visit conversions (web)

conversion_site_visits_sale_amount_engagement

float

[en] Sale amount for post-engagement site visit conversions (web)

conversion_site_visits_sale_amount_view

float

[en] Sale amount for post-view site visit conversions (web)

engagements

float

[en] Total number of engagements

follows

float

[en] Total number of follows

impressions

float

[en] Total number of impressions

likes

float

[en] Total number of likes

media_engagements

float

[en] Total number of clicks of media across Videos, Vines, GIFs, and Images.

media_views

float

[en] Total number of views (autoplay and click) of media across Videos, Vines, GIFs, and Images.

mobile_conversion_achievements_unlocked_assisted

float

[en] Assisted achievements unlocked conversions (mobile app)

mobile_conversion_achievements_unlocked_order_quantity

float

[en] Order quantity for achievements unlocked conversions (mobile app)

mobile_conversion_achievements_unlocked_post_engagement

float

[en] Post-engagement achievements unlocked conversions (mobile app)

mobile_conversion_achievements_unlocked_post_view

float

[en] Post-view achievements unlocked conversions (mobile app)

mobile_conversion_achievements_unlocked_sale_amount

float

[en] Sale amount for achievements unlocked conversions (mobile app)

mobile_conversion_add_to_carts_assisted

float

[en] Assisted add to cart conversions (mobile app)

mobile_conversion_add_to_carts_order_quantity

float

[en] Order quantity for add to cart conversions (mobile app)

mobile_conversion_add_to_carts_post_engagement

float

[en] Post-engagement add to cart conversions (mobile app)

mobile_conversion_add_to_carts_post_view

float

[en] Post-view add to cart conversions (mobile app)

mobile_conversion_add_to_carts_sale_amount

float

[en] Sale amount for add to cart conversions (mobile app)

mobile_conversion_add_to_wishlists_assisted

float

[en] Assisted add to wishlist conversions (mobile app)

mobile_conversion_add_to_wishlists_order_quantity

float

[en] Order quantity for add to wishlist conversions (mobile app)

mobile_conversion_add_to_wishlists_post_engagement

float

[en] Post-engagement add to wishlist conversions (mobile app)

mobile_conversion_add_to_wishlists_post_view

float

[en] Post-view add to wishlist conversions (mobile app)

mobile_conversion_add_to_wishlists_sale_amount

float

[en] Sale amount for add to wishlist conversions (mobile app)

mobile_conversion_checkouts_initiated_assisted

float

[en] Assisted checkout initiated conversions (mobile app)

mobile_conversion_checkouts_initiated_order_quantity

float

[en] Order quantity for checkout initiated conversions (mobile app)

mobile_conversion_checkouts_initiated_post_engagement

float

[en] Post-engagement checkout initiated conversions (mobile app)

mobile_conversion_checkouts_initiated_post_view

float

[en] Post-view checkout initiated conversions (mobile app)

mobile_conversion_checkouts_initiated_sale_amount

float

[en] Sale amount for checkout initiated conversions (mobile app)

mobile_conversion_content_views_assisted

float

[en] Assisted content view conversions (mobile app)

mobile_conversion_content_views_order_quantity

float

[en] Order quantity for content view conversions (mobile app)

mobile_conversion_content_views_post_engagement

float

[en] Post-engagement content view conversions (mobile app)

mobile_conversion_content_views_post_view

float

[en] Post-view content view conversions (mobile app)

mobile_conversion_content_views_sale_amount

float

[en] Sale amount for content view conversions (mobile app)

mobile_conversion_downloads_order_quantity

float

[en] Order quantity for downloads conversions (mobile app)

mobile_conversion_downloads_post_engagement

float

[en] Post-engagement downloads conversions (mobile app)

mobile_conversion_downloads_post_view

float

[en] Post-view downloads conversions (mobile app)

mobile_conversion_downloads_sale_amount

float

[en] Sale amount for downloads conversions (mobile app)

mobile_conversion_installs_assisted

float

[en] Assisted install conversions (mobile app)

mobile_conversion_installs_order_quantity

float

[en] Order quantity for install conversions (mobile app)

mobile_conversion_installs_post_engagement

float

[en] Post-engagement install conversions (mobile app)

mobile_conversion_installs_post_view

float

[en] Post-view install conversions (mobile app)

mobile_conversion_installs_sale_amount

float

[en] Sale amount for install conversions (mobile app)

mobile_conversion_installs_skan

float

[en] install conversions attributed via SKAdNetwork (SKAN) (mobile app)

mobile_conversion_invites_assisted

float

[en] Assisted invite conversions (mobile app)

mobile_conversion_invites_order_quantity

float

[en] Order quantity for invite conversions (mobile app)

mobile_conversion_invites_post_engagement

float

[en] Post-engagement invite conversions (mobile app)

mobile_conversion_invites_post_view

float

[en] Post-view invite conversions (mobile app)

mobile_conversion_invites_sale_amount

float

[en] Sale amount for invite conversions (mobile app)

mobile_conversion_key_page_views_post_engagement

float

[en] Post-engagement key page view conversions (mobile app)

mobile_conversion_key_page_views_post_view

float

[en] Post-view key page view conversions (mobile app)

mobile_conversion_levels_achieved_assisted

float

[en] Assisted level achieved conversions (mobile app)

mobile_conversion_levels_achieved_order_quantity

float

[en] Order quantity for level achieved conversions (mobile app)

mobile_conversion_levels_achieved_post_engagement

float

[en] Post-engagement level achieved conversions (mobile app)

mobile_conversion_levels_achieved_post_view

float

[en] Post-view level achieved conversions (mobile app)

mobile_conversion_levels_achieved_sale_amount

float

[en] Sale amount for level achieved conversions (mobile app)

mobile_conversion_lifetime_value_achievements_unlocked_metri

float

[en] Lifetime value (LTV) - Number of achievements unlocked conversions (mobile app)

mobile_conversion_lifetime_value_achievements_unlocked_order

float

[en] Lifetime value (LTV) - Order quantity for achievements unlocked conversions (mobile app)

mobile_conversion_lifetime_value_achievements_unlocked_sale_

float

[en] Lifetime value (LTV) - Sale amount for achievements unlocked conversions (mobile app)

mobile_conversion_lifetime_value_add_to_carts_metric

float

[en] Lifetime value (LTV) - Number of add to cart conversions (mobile app)

mobile_conversion_lifetime_value_add_to_carts_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for add to cart conversions (mobile app)

mobile_conversion_lifetime_value_add_to_carts_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for add to cart conversions (mobile app)

mobile_conversion_lifetime_value_add_to_wishlists_metric

float

[en] Lifetime value (LTV) - Number of add to wishlist conversions (mobile app)

mobile_conversion_lifetime_value_add_to_wishlists_order_quan

float

[en] Lifetime value (LTV) - Order quantity for add to wishlist conversions (mobile app)

mobile_conversion_lifetime_value_add_to_wishlists_sale_amoun

float

[en] Lifetime value (LTV) - Sale amount for add to wishlist conversions (mobile app)

mobile_conversion_lifetime_value_checkouts_initiated_metric

float

[en] Lifetime value (LTV) - Number of checkout initiated conversions (mobile app)

mobile_conversion_lifetime_value_checkouts_initiated_order_q

float

[en] Lifetime value (LTV) - Order quantity for checkout initiated conversions (mobile app)

mobile_conversion_lifetime_value_checkouts_initiated_sale_am

float

[en] Lifetime value (LTV) - Sale amount for checkout initiated conversions (mobile app)

mobile_conversion_lifetime_value_invites_metric

float

[en] Lifetime value (LTV) - Number of invite conversions (mobile app)

mobile_conversion_lifetime_value_invites_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for invite conversions (mobile app)

mobile_conversion_lifetime_value_invites_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for invite conversions (mobile app)

mobile_conversion_lifetime_value_levels_achieved_metric

float

[en] Lifetime value (LTV) - Number of level achieved conversions (mobile app)

mobile_conversion_lifetime_value_levels_achieved_order_quant

float

[en] Lifetime value (LTV) - Order quantity for level achieved conversions (mobile app)

mobile_conversion_lifetime_value_levels_achieved_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for level achieved conversions (mobile app)

mobile_conversion_lifetime_value_payment_info_additions_metr

float

[en] Lifetime value (LTV) - Number of payment info addition conversions (mobile app)

mobile_conversion_lifetime_value_payment_info_additions_orde

float

[en] Lifetime value (LTV) - Order quantity for payment info addition conversions (mobile app)

mobile_conversion_lifetime_value_payment_info_additions_sale

float

[en] Lifetime value (LTV) - Sale amount for payment info addition conversions (mobile app)

mobile_conversion_lifetime_value_purchases_metric

float

[en] Lifetime value (LTV) - Number of purchase conversions (mobile app)

mobile_conversion_lifetime_value_purchases_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for purchase conversions (mobile app)

mobile_conversion_lifetime_value_purchases_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for purchase conversions (mobile app)

mobile_conversion_lifetime_value_rates_metric

float

[en] Lifetime value (LTV) - Number of rate conversions (mobile app)

mobile_conversion_lifetime_value_rates_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for rate conversions (mobile app)

mobile_conversion_lifetime_value_rates_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for rate conversions (mobile app)

mobile_conversion_lifetime_value_reservations_metric

float

[en] Lifetime value (LTV) - Number of reservation conversions (mobile app)

mobile_conversion_lifetime_value_reservations_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for reservation conversions (mobile app)

mobile_conversion_lifetime_value_reservations_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for reservation conversions (mobile app)

mobile_conversion_lifetime_value_shares_metric

float

[en] Lifetime value (LTV) - Number of share conversions (mobile app)

mobile_conversion_lifetime_value_shares_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for share conversions (mobile app)

mobile_conversion_lifetime_value_shares_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for share conversions (mobile app)

mobile_conversion_lifetime_value_sign_ups_metric

float

[en] Lifetime value (LTV) - Number of sign-up conversions (mobile app)

mobile_conversion_lifetime_value_sign_ups_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for sign-up conversions (mobile app)

mobile_conversion_lifetime_value_sign_ups_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for sign-up conversions (mobile app)

mobile_conversion_lifetime_value_spent_credits_metric

float

[en] Lifetime value (LTV) - Number of spent credit conversions (mobile app)

mobile_conversion_lifetime_value_spent_credits_order_quantit

float

[en] Lifetime value (LTV) - Order quantity for spent credit conversions (mobile app)

mobile_conversion_lifetime_value_spent_credits_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for spent credit conversions (mobile app)

mobile_conversion_lifetime_value_tutorials_completed_metric

float

[en] Lifetime value (LTV) - Number of tutorial completed conversions (mobile app)

mobile_conversion_lifetime_value_tutorials_completed_order_q

float

[en] Lifetime value (LTV) - Order quantity for tutorial completed conversions (mobile app)

mobile_conversion_lifetime_value_tutorials_completed_sale_am

float

[en] Lifetime value (LTV) - Sale amount for tutorial completed conversions (mobile app)

mobile_conversion_lifetime_value_updates_metric

float

[en] Lifetime value (LTV) - Number of update conversions (mobile app)

mobile_conversion_lifetime_value_updates_order_quantity

float

[en] Lifetime value (LTV) - Order quantity for update conversions (mobile app)

mobile_conversion_lifetime_value_updates_sale_amount

float

[en] Lifetime value (LTV) - Sale amount for update conversions (mobile app)

mobile_conversion_logins_assisted

float

[en] Assisted login conversions (mobile app)

mobile_conversion_logins_order_quantity

float

[en] Order quantity for login conversions (mobile app)

mobile_conversion_logins_post_engagement

float

[en] Post-engagement login conversions (mobile app)

mobile_conversion_logins_post_view

float

[en] Post-view login conversions (mobile app)

mobile_conversion_logins_sale_amount

float

[en] Sale amount for login conversions (mobile app)

mobile_conversion_payment_info_additions_assisted

float

[en] Assisted payment info addition conversions (mobile app)

mobile_conversion_payment_info_additions_order_quantity

float

[en] Order quantity for payment info addition conversions (mobile app)

mobile_conversion_payment_info_additions_post_engagement

float

[en] Post-engagement payment info addition conversions (mobile app)

mobile_conversion_payment_info_additions_post_view

float

[en] Post-view payment info addition conversions (mobile app)

mobile_conversion_payment_info_additions_sale_amount

float

[en] Sale amount for payment info addition conversions (mobile app)

mobile_conversion_purchases_assisted

float

[en] Assisted purchase conversions (mobile app)

mobile_conversion_purchases_order_quantity

float

[en] Order quantity for purchase conversions (mobile app)

mobile_conversion_purchases_post_engagement

float

[en] Post-engagement purchase conversions (mobile app)

mobile_conversion_purchases_post_view

float

[en] Post-view purchase conversions (mobile app)

mobile_conversion_purchases_sale_amount

float

[en] Sale amount for purchase conversions (mobile app)

mobile_conversion_purchases_skan

float

[en] purchase conversions attributed via SKAdNetwork (SKAN) (mobile app)

mobile_conversion_rates_assisted

float

[en] Assisted rate conversions (mobile app)

mobile_conversion_rates_order_quantity

float

[en] Order quantity for rate conversions (mobile app)

mobile_conversion_rates_post_engagement

float

[en] Post-engagement rate conversions (mobile app)

mobile_conversion_rates_post_view

float

[en] Post-view rate conversions (mobile app)

mobile_conversion_rates_sale_amount

float

[en] Sale amount for rate conversions (mobile app)

mobile_conversion_re_engages_assisted

float

[en] Assisted re-engagement conversions (mobile app)

mobile_conversion_re_engages_order_quantity

float

[en] Order quantity for re-engagement conversions (mobile app)

mobile_conversion_re_engages_post_engagement

float

[en] Post-engagement re-engagement conversions (mobile app)

mobile_conversion_re_engages_post_view

float

[en] Post-view re-engagement conversions (mobile app)

mobile_conversion_re_engages_sale_amount

float

[en] Sale amount for re-engagement conversions (mobile app)

mobile_conversion_reservations_assisted

float

[en] Assisted reservation conversions (mobile app)

mobile_conversion_reservations_order_quantity

float

[en] Order quantity for reservation conversions (mobile app)

mobile_conversion_reservations_post_engagement

float

[en] Post-engagement reservation conversions (mobile app)

mobile_conversion_reservations_post_view

float

[en] Post-view reservation conversions (mobile app)

mobile_conversion_reservations_sale_amount

float

[en] Sale amount for reservation conversions (mobile app)

mobile_conversion_searches_assisted

float

[en] Assisted search conversions (mobile app)

mobile_conversion_searches_order_quantity

float

[en] Order quantity for search conversions (mobile app)

mobile_conversion_searches_post_engagement

float

[en] Post-engagement search conversions (mobile app)

mobile_conversion_searches_post_view

float

[en] Post-view search conversions (mobile app)

mobile_conversion_searches_sale_amount

float

[en] Sale amount for search conversions (mobile app)

mobile_conversion_shares_assisted

float

[en] Assisted share conversions (mobile app)

mobile_conversion_shares_order_quantity

float

[en] Order quantity for share conversions (mobile app)

mobile_conversion_shares_post_engagement

float

[en] Post-engagement share conversions (mobile app)

mobile_conversion_shares_post_view

float

[en] Post-view share conversions (mobile app)

mobile_conversion_shares_sale_amount

float

[en] Sale amount for share conversions (mobile app)

mobile_conversion_sign_ups_assisted

float

[en] Assisted sign-up conversions (mobile app)

mobile_conversion_sign_ups_order_quantity

float

[en] Order quantity for sign-up conversions (mobile app)

mobile_conversion_sign_ups_post_engagement

float

[en] Post-engagement sign-up conversions (mobile app)

mobile_conversion_sign_ups_post_view

float

[en] Post-view sign-up conversions (mobile app)

mobile_conversion_sign_ups_sale_amount

float

[en] Sale amount for sign-up conversions (mobile app)

mobile_conversion_site_visits_order_quantity

float

[en] Order quantity for site visit conversions (mobile app)

mobile_conversion_site_visits_post_engagement

float

[en] Post-engagement site visit conversions (mobile app)

mobile_conversion_site_visits_post_view

float

[en] Post-view site visit conversions (mobile app)

mobile_conversion_site_visits_sale_amount

float

[en] Sale amount for site visit conversions (mobile app)

mobile_conversion_spent_credits_assisted

float

[en] Assisted spent credit conversions (mobile app)

mobile_conversion_spent_credits_order_quantity

float

[en] Order quantity for spent credit conversions (mobile app)

mobile_conversion_spent_credits_post_engagement

float

[en] Post-engagement spent credit conversions (mobile app)

mobile_conversion_spent_credits_post_view

float

[en] Post-view spent credit conversions (mobile app)

mobile_conversion_spent_credits_sale_amount

float

[en] Sale amount for spent credit conversions (mobile app)

mobile_conversion_tutorials_completed_assisted

float

[en] Assisted tutorial completed conversions (mobile app)

mobile_conversion_tutorials_completed_order_quantity

float

[en] Order quantity for tutorial completed conversions (mobile app)

mobile_conversion_tutorials_completed_post_engagement

float

[en] Post-engagement tutorial completed conversions (mobile app)

mobile_conversion_tutorials_completed_post_view

float

[en] Post-view tutorial completed conversions (mobile app)

mobile_conversion_tutorials_completed_sale_amount

float

[en] Sale amount for tutorial completed conversions (mobile app)

mobile_conversion_updates_assisted

float

[en] Assisted update conversions (mobile app)

mobile_conversion_updates_order_quantity

float

[en] Order quantity for update conversions (mobile app)

mobile_conversion_updates_post_engagement

float

[en] Post-engagement update conversions (mobile app)

mobile_conversion_updates_post_view

float

[en] Post-view update conversions (mobile app)

mobile_conversion_updates_sale_amount

float

[en] Sale amount for update conversions (mobile app)

qualified_impressions

float

[en] Qualified impressions (impressions meeting the X Ads viewability criteria)

replies

float

[en] Total number of replies

retweets

float

[en] Total number of retweets

url_clicks

float

[en] Total clicks on the link or Website Card in an ad, including earned.

video_15s_views

float

[en] Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed

video_3s100pct_views

float

[en] Total number of views where at least 3 seconds were played while 100% in view (legacy video_total_views)

video_6s_views

float

[en] Total number of views where at least 6 seconds of the video was viewed

video_content_starts

float

[en] Total number of video playback starts

video_cta_clicks

float

[en] Total clicks on the call to action

video_total_views

float

[en] Total number of video views

video_views_100

float

[en] Total number of views where at least 100% of the video was viewed.

video_views_25

float

[en] Total number of views where at least 25% of the video was viewed.

video_views_50

float

[en] Total number of views where at least 50% of the video was viewed.

video_views_75

float

[en] Total number of views where at least 75% of the video was viewed.

followers_cpm

float

[en] Cost per mille (CPM)

video_views

float

[en] Total Video Views

cost_per_1000_qualified_impressions

float

[en] Cost per mille (CPM)

derived_link_clicks

float

[en] Total Link Clicks

derived_media_views

float

[en] Total Media Views

qualified_impressions_impressions

float

[en] Total Impressions

derived_engagements

float

[en] Total Engagements

leads

float

[en] Total Leads

cplc

float

[en] Cost per Link Click

media_view_rate

float

[en] Media View Rate

derived_impressions

float

[en] Total Impressions

video_rate

float

[en] Video Rate

cpac

float

[en] Cost per App Click

leads_cpm

float

[en] Cost per mille (CPM)

video_views_impressions

float

[en] Total Impressions

derived_click_rate

float

[en] Click Rate

cost_per_view

float

[en] Cost Per View

cpi

float

[en] Cost per App Install

derived_app_clicks

float

[en] Total App Clicks

cpm

float

[en] Cost per mille (CPM)

follow_rate

float

[en] Follow Rate

cpa

float

[en] Cost per Conversion

derived_qualified_impressions

float

[en] Total Qualified Impressions

derived_engagement_rate

float

[en] Engagement Rate

derived_conversion

float

[en] Conversion

cpe

float

[en] Cost per engagement (CPE)

cpf

float

[en] Cost per Conversion

derived_conversion_rate

float

[en] Conversion Rate

lead_rate

float

[en] Lead Rate

followers

float

[en] Total Followers

cost_per_lead

float

[en] Cost Per Lead

qualified_impression_rate

float

[en] Qualified Impression Rate

Notes

  • Historical data available from July 14, 2015.
  • Part of this documentation was automatically generated by AI and may contain errors. We recommend verifying critical information
  • Part of this documentation was automatically generated by AI and may contain errors. We recommend verifying critical information

Frequently asked questions

What X Ads (Twitter Ads) data can I replicate with Kondado?▼
Kondado replicates campaign, ad group (line item), and ad-level performance from X Ads, including impressions, clicks, spend, conversions, and engagement metrics. The data lands in your destination ready for cross-channel reporting.
How do I authorize X Ads on Kondado?▼
On the new source page, select X Ads and follow the "Continue with X" flow. Sign in with the user that has access to the X Ads account you want to replicate and approve the read permissions.
Can I combine X Ads with other paid-media platforms?▼
Yes. Once X Ads is loading into your destination, you can join it with Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads in your BI tool to compare performance across channels.
Where can I send my X Ads data?▼
X Ads data can be sent to any of the supported destinations, including Power BI, Looker Studio, Google Sheets, Excel, BigQuery, PostgreSQL, MySQL, and Redshift. See the destinations page for the full list.
How often is X Ads data updated?▼
Pipelines run at the frequency you choose in Kondado. Each run reads the latest performance data from the X Ads API and updates the tables in your destination.
Does the connector support incremental replication?▼
Reporting tables typically use a date-window approach so Kondado refreshes recent days to capture late attribution updates. You configure the update window when setting up the pipeline.
Written by·Published 2025-12-11·Updated 2026-04-26