X Ads metrics

Documented metrics available in the native reporting reference on X Ads through an AI assistant: 75 in total, 0 of them computed by the gateway, each…

View as Markdown

The 75 metrics you can request on X Ads. The key is what you pass to a tool; the field is what the platform returns.

Native X pagination, attribution and account-currency micros are preserved. Uploads take images up to 5 MB, GIFs up to 15 MB and MP4 videos up to 16 MB. Cross-platform business reviews and creative galleries do not yet include X Ads.

MOBILE_CONVERSION (23)

MOBILE_CONVERSION (23)
Key	Name	Field	Notes
`mobile_conversion_spent_credits`	mobile_conversion_spent_credits	`mobile_conversion_spent_credits`	Format: json.
`mobile_conversion_installs`	mobile_conversion_installs	`mobile_conversion_installs`	Format: json.
`mobile_conversion_content_views`	mobile_conversion_content_views	`mobile_conversion_content_views`	Format: json.
`mobile_conversion_add_to_wishlists`	mobile_conversion_add_to_wishlists	`mobile_conversion_add_to_wishlists`	Format: json.
`mobile_conversion_checkouts_initiated`	mobile_conversion_checkouts_initiated	`mobile_conversion_checkouts_initiated`	Format: json.
`mobile_conversion_reservations`	mobile_conversion_reservations	`mobile_conversion_reservations`	Format: json.
`mobile_conversion_tutorials_completed`	mobile_conversion_tutorials_completed	`mobile_conversion_tutorials_completed`	Format: json.
`mobile_conversion_achievements_unlocked`	mobile_conversion_achievements_unlocked	`mobile_conversion_achievements_unlocked`	Format: json.
`mobile_conversion_searches`	mobile_conversion_searches	`mobile_conversion_searches`	Format: json.
`mobile_conversion_add_to_carts`	mobile_conversion_add_to_carts	`mobile_conversion_add_to_carts`	Format: json.
`mobile_conversion_payment_info_additions`	mobile_conversion_payment_info_additions	`mobile_conversion_payment_info_additions`	Format: json.
`mobile_conversion_re_engages`	mobile_conversion_re_engages	`mobile_conversion_re_engages`	Format: json.
`mobile_conversion_shares`	mobile_conversion_shares	`mobile_conversion_shares`	Format: json.
`mobile_conversion_rates`	mobile_conversion_rates	`mobile_conversion_rates`	Format: json.
`mobile_conversion_logins`	mobile_conversion_logins	`mobile_conversion_logins`	Format: json.
`mobile_conversion_updates`	mobile_conversion_updates	`mobile_conversion_updates`	Format: json.
`mobile_conversion_levels_achieved`	mobile_conversion_levels_achieved	`mobile_conversion_levels_achieved`	Format: json.
`mobile_conversion_invites`	mobile_conversion_invites	`mobile_conversion_invites`	Format: json.
`mobile_conversion_key_page_views`	mobile_conversion_key_page_views	`mobile_conversion_key_page_views`	Format: json.
`mobile_conversion_downloads`	mobile_conversion_downloads	`mobile_conversion_downloads`	Format: json.
`mobile_conversion_purchases`	mobile_conversion_purchases	`mobile_conversion_purchases`	Format: json.
`mobile_conversion_sign_ups`	mobile_conversion_sign_ups	`mobile_conversion_sign_ups`	Format: json.
`mobile_conversion_site_visits`	mobile_conversion_site_visits	`mobile_conversion_site_visits`	Format: json.

LIFE_TIME_VALUE_MOBILE_CONVERSION (15)

WEB_CONVERSION (13)

WEB_CONVERSION (13)
Key	Name	Field	Notes
`conversion_purchases`	conversion_purchases	`conversion_purchases`	Format: json.
`conversion_sign_ups`	conversion_sign_ups	`conversion_sign_ups`	Format: json.
`conversion_site_visits`	conversion_site_visits	`conversion_site_visits`	Format: json.
`conversion_downloads`	conversion_downloads	`conversion_downloads`	Format: json.
`conversion_custom`	conversion_custom	`conversion_custom`	Format: json.
`conversion_add_to_carts`	conversion_add_to_carts	`conversion_add_to_carts`	Format: json.
`conversion_checkouts_initiated`	conversion_checkouts_initiated	`conversion_checkouts_initiated`	Format: json.
`conversion_content_views`	conversion_content_views	`conversion_content_views`	Format: json.
`conversion_payment_info_additions`	conversion_payment_info_additions	`conversion_payment_info_additions`	Format: json.
`conversion_add_to_wishlists`	conversion_add_to_wishlists	`conversion_add_to_wishlists`	Format: json.
`conversion_searches`	conversion_searches	`conversion_searches`	Format: json.
`conversion_landing_page_views`	conversion_landing_page_views	`conversion_landing_page_views`	Format: json.
`conversion_subscriptions`	conversion_subscriptions	`conversion_subscriptions`	Format: json.

ENGAGEMENT (12)

ENGAGEMENT (12)
Key	Name	Field	Notes
`engagements`	engagements	`engagements`	Format: number.
`impressions`	impressions	`impressions`	Format: number.
`retweets`	retweets	`retweets`	Format: number.
`replies`	replies	`replies`	Format: number.
`likes`	likes	`likes`	Format: number.
`follows`	follows	`follows`	Format: number.
`card_engagements`	card_engagements	`card_engagements`	Format: number.
`clicks`	clicks	`clicks`	Format: number.
`app_clicks`	app_clicks	`app_clicks`	Format: number.
`url_clicks`	url_clicks	`url_clicks`	Format: number.
`qualified_impressions`	qualified_impressions	`qualified_impressions`	Format: number.
`carousel_swipes`	carousel_swipes	`carousel_swipes`	Format: number.

VIDEO (10)

VIDEO (10)
Key	Name	Field	Notes
`video_total_views`	video_total_views	`video_total_views`	Format: number.
`video_views_25`	video_views_25	`video_views_25`	Format: number.
`video_views_50`	video_views_50	`video_views_50`	Format: number.
`video_views_75`	video_views_75	`video_views_75`	Format: number.
`video_views_100`	video_views_100	`video_views_100`	Format: number.
`video_cta_clicks`	video_cta_clicks	`video_cta_clicks`	Format: number.
`video_content_starts`	video_content_starts	`video_content_starts`	Format: number.
`video_3s100pct_views`	video_3s100pct_views	`video_3s100pct_views`	Format: number.
`video_6s_views`	video_6s_views	`video_6s_views`	Format: number.
`video_15s_views`	video_15s_views	`video_15s_views`	Format: number.

BILLING (2)

BILLING (2)
Key	Name	Field	Notes
`billed_engagements`	billed_engagements	`billed_engagements`	Format: number.
`billed_charge_local_micro`	billed_charge_local_micro	`billed_charge_local_micro`	Format: micro_currency.

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.

Key	Name	Field	Notes
`mobile_conversion_lifetime_value_purchases`	mobile_conversion_lifetime_value_purchases	`mobile_conversion_lifetime_value_purchases`	Format: json.
`mobile_conversion_lifetime_value_sign_ups`	mobile_conversion_lifetime_value_sign_ups	`mobile_conversion_lifetime_value_sign_ups`	Format: json.
`mobile_conversion_lifetime_value_updates`	mobile_conversion_lifetime_value_updates	`mobile_conversion_lifetime_value_updates`	Format: json.
`mobile_conversion_lifetime_value_tutorials_completed`	mobile_conversion_lifetime_value_tutorials_completed	`mobile_conversion_lifetime_value_tutorials_completed`	Format: json.
`mobile_conversion_lifetime_value_reservations`	mobile_conversion_lifetime_value_reservations	`mobile_conversion_lifetime_value_reservations`	Format: json.
`mobile_conversion_lifetime_value_add_to_carts`	mobile_conversion_lifetime_value_add_to_carts	`mobile_conversion_lifetime_value_add_to_carts`	Format: json.
`mobile_conversion_lifetime_value_add_to_wishlists`	mobile_conversion_lifetime_value_add_to_wishlists	`mobile_conversion_lifetime_value_add_to_wishlists`	Format: json.
`mobile_conversion_lifetime_value_checkouts_initiated`	mobile_conversion_lifetime_value_checkouts_initiated	`mobile_conversion_lifetime_value_checkouts_initiated`	Format: json.
`mobile_conversion_lifetime_value_levels_achieved`	mobile_conversion_lifetime_value_levels_achieved	`mobile_conversion_lifetime_value_levels_achieved`	Format: json.
`mobile_conversion_lifetime_value_achievements_unlocked`	mobile_conversion_lifetime_value_achievements_unlocked	`mobile_conversion_lifetime_value_achievements_unlocked`	Format: json.
`mobile_conversion_lifetime_value_shares`	mobile_conversion_lifetime_value_shares	`mobile_conversion_lifetime_value_shares`	Format: json.
`mobile_conversion_lifetime_value_invites`	mobile_conversion_lifetime_value_invites	`mobile_conversion_lifetime_value_invites`	Format: json.
`mobile_conversion_lifetime_value_payment_info_additions`	mobile_conversion_lifetime_value_payment_info_additions	`mobile_conversion_lifetime_value_payment_info_additions`	Format: json.
`mobile_conversion_lifetime_value_spent_credits`	mobile_conversion_lifetime_value_spent_credits	`mobile_conversion_lifetime_value_spent_credits`	Format: json.
`mobile_conversion_lifetime_value_rates`	mobile_conversion_lifetime_value_rates	`mobile_conversion_lifetime_value_rates`	Format: json.