Skip to main content
Cross-platform and device performance — for comparing Facebook, Instagram, Messenger, and Audience Network across placements and devices.
This is the richest Meta Ads data model. It carries nearly every available metric, plus exclusives like Reach, Frequency, Hook Rate, Hold Rate, and per-funnel-step cost. Start here when you don’t know which data model to pick.

What this data model represents

Grain: one row per date × ad_account × campaign × adset × ad × ad_platform × placement × impression_device. Metrics, grouped by category — every number you can compute on this data model. Expand below for examples in each.
Dimensions, grouped by category — every way you can split, filter, or group those metrics. Expand below for examples in each.
Source: Meta Ads API, daily refresh.

Slice by

Unique to this data model: Plus the standard campaign hierarchy, time, account, and attribution dimensions — documented once on the Meta Ads Overview.
Querying all three slice-by dimensions at once is highly granular and can produce sparse rows. Start with one or two and add the third only when you need that level of detail.

Use it to answer

  • How does ROAS compare across Facebook vs. Instagram vs. Messenger vs. Audience Network?
  • Which placement × device combinations are winning, and which are losing money?
  • Does creative format need to change by platform? (vertical for Reels, square for Feed)
  • How do Hook Rate and Hold Rate vary by platform to inform video strategy?

Available metrics

Everything you can compute on this data model. Need a metric not listed? See the Meta Ads metric availability matrix.
Hook Rate and Hold Rate are exclusive to this data model. If you need them at audience or creative level, derive from raw fields (video_play_actions, video_views_pct_100).
This data model exposes a near-complete raw field set (one of the richest, alongside Age & Gender):ad_spend · clicks · impressions · reported_orders · reported_revenue · unique_clicks · inline_clicks · inline_post_engagement · outbound_clicks · landing_page_views · add_to_cart · checkouts_initiated · view_content · post_engagement · page_engagement · post_reaction · add_payment_info · post_share · video_play_actions · video_view_avg_time · video_views_pct_25 · video_views_pct_50 · video_views_pct_75 · video_views_pct_100