Meta Ads (Facebook & Instagram) — data fields

Campaign, ad set and ad performance from Facebook and Instagram ads. Every field id you can pass to fields= in the API, Looker Studio, exports and AI chats. Shared ids line up across sources so they blend.

All sources Meta Ads (Facebook & Instagram)Google Ads TikTok Ads LinkedIn Ads Google Analytics 4 Google Search Console Facebook Pages (organic)Instagram (organic)YouTube Analytics Shopify WooCommerce Klaviyo

Field id	Name	Section	Kind	Type	Description
`account_id`	Account ID		dimension	string
`account_name`	Account name		dimension	string
`ad_id`	Ad ID	Ad	dimension	string
`ad_name`	Ad name	Ad	dimension	string
`ad_status`	Ad status	Ad	dimension	string	Effective status now
`add_payment_info`	Payment info added	Conversions	metric	float
`add_to_cart`	Adds to cart	Conversions	metric	float
`add_to_cart_value`	Adds to cart value	Conversions	metric	currency
`adset_billing_event`	Ad set billing event	Ad set	dimension	string
`adset_daily_budget`	Ad set daily budget	Ad set	metric	currency
`adset_id`	Ad set ID	Ad set	dimension	string
`adset_lifetime_budget`	Ad set lifetime budget	Ad set	metric	currency
`adset_name`	Ad set name	Ad set	dimension	string
`adset_optimization_goal`	Ad set optimisation goal	Ad set	dimension	string
`adset_status`	Ad set status	Ad set	dimension	string	Effective status now
`age`	Age bracket	Breakdown	dimension	string
`campaign`	Campaign name	Campaign	dimension	string
`campaign_bid_strategy`	Campaign bid strategy	Campaign	dimension	string
`campaign_daily_budget`	Campaign daily budget	Campaign	metric	currency	Current daily budget
`campaign_id`	Campaign ID	Campaign	dimension	string
`campaign_lifetime_budget`	Campaign lifetime budget	Campaign	metric	currency
`campaign_status`	Campaign status	Campaign	dimension	string	Effective status now (ACTIVE, PAUSED, ...)
`clicks`	Clicks (all)	Clicks	metric	integer
`complete_registration`	Registrations completed	Conversions	metric	float
`conversion_rate_ranking`	Conversion rate ranking	Ad quality	dimension	string
`conversions`	Purchases	Conversions	metric	float	Purchase actions (omni/pixel)
`cost_per_add_to_cart`	Cost per add to cart	Conversions	metric	currency
`cost_per_landing_page_view`	Cost per landing page view	Conversions	metric	currency
`cost_per_lead`	Cost per lead	Conversions	metric	currency
`cost_per_outbound_click`	Cost per outbound click	Clicks	metric	currency
`cost_per_thruplay`	Cost per ThruPlay	Video	metric	currency
`country`	Country	Breakdown	dimension	string
`cpc`	CPC	Clicks	metric	currency
`cpm`	CPM	Delivery	metric	currency
`creative_body`	Ad primary text	Creative	dimension	string
`creative_cta`	Call to action	Creative	dimension	string
`creative_thumbnail_url`	Ad thumbnail URL	Creative	dimension	string
`creative_title`	Ad headline	Creative	dimension	string
`ctr`	CTR (%)	Clicks	metric	percent
`datasource`	Data source		dimension	string	Connector the row came from
`date`	Date	Time	dimension	date
`device_platform`	Device platform	Breakdown	dimension	string
`engagement_rate_ranking`	Engagement rate ranking	Ad quality	dimension	string
`frequency`	Frequency	Delivery	metric	float
`gender`	Gender	Breakdown	dimension	string
`impression_device`	Impression device	Breakdown	dimension	string
`impressions`	Impressions	Delivery	metric	integer
`initiate_checkout`	Checkouts initiated	Conversions	metric	float
`initiate_checkout_value`	Checkouts initiated value	Conversions	metric	currency
`landing_page_views`	Landing page views	Conversions	metric	float
`leads`	Leads	Conversions	metric	float
`link_clicks`	Link clicks	Clicks	metric	integer
`messaging_conversations`	Messaging conversations started	Conversions	metric	float
`objective`	Campaign objective	Campaign	dimension	string
`outbound_clicks`	Outbound clicks	Clicks	metric	integer	Clicks that leave Meta
`page_engagement`	Page engagement	Engagement	metric	float
`platform_position`	Placement (feed, stories, reels...)	Breakdown	dimension	string
`post_engagement`	Post engagement	Engagement	metric	float
`publisher_platform`	Platform (facebook/instagram/...)	Breakdown	dimension	string
`quality_ranking`	Quality ranking	Ad quality	dimension	string
`reach`	Reach	Delivery	metric	integer
`region`	Region	Breakdown	dimension	string
`revenue`	Purchase value	Conversions	metric	currency	Purchase conversion value
`spend`	Spend	Delivery	metric	currency
`thruplays`	ThruPlays	Video	metric	float	Played to completion or for 15s+
`unique_clicks`	Unique clicks	Clicks	metric	integer
`video_3s_views`	3-second video views	Video	metric	float
`video_p100`	Video watched 100%	Video	metric	float
`video_p25`	Video watched 25%	Video	metric	float
`video_p50`	Video watched 50%	Video	metric	float
`video_p75`	Video watched 75%	Video	metric	float
`video_p95`	Video watched 95%	Video	metric	float
`video_plays`	Video plays	Video	metric	float
`view_content`	Content views	Conversions	metric	float

Date parts

Available on any source with date. Metrics are re-aggregated to the period.

weekWeek (starting Monday)year_weekYear-week (2026-W42)monthMonth (2026-10)quarterQuarter (2026-Q4)yearYearday_of_weekDay of week (Mon..Sun)

Calculated metrics

Computed after aggregation wherever the inputs exist.

roasrevenue / nullif(spend, 0)cpaspend / nullif(conversions, 0)conversion_rateconversions / nullif(clicks, 0) * 100aovrevenue / nullif(orders, 0)

Filters

Pass JSON in filters=:

[["spend","gt",100],"and",
 ["campaign","contains","brand"]]

Operators: eq, neq, gt, gte, lt, lte, contains, ncontains, null, notnull, in.