Demographic-cohort performance — how age groups and genders respond to your ads.Documentation Index
Fetch the complete documentation index at: https://docs.ocular.dev/llms.txt
Use this file to discover all available pages before exploring further.
What this data model represents
Grain: one row perdate × ad_account × campaign × adset × ad × age_segment × gender.
Metrics, grouped by category — every number you can compute on this data model. Expand below for examples in each.
Show sample metrics in each category
Show sample metrics in each category
Show sample dimensions in each category
Show sample dimensions in each category
Slice by
Unique to this data model:| Dimension | Type | Values |
|---|---|---|
age_segment | String | 13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65+ |
gender | String | Male, Female, Unknown |
Use it to answer
- Which age × gender cohorts give the highest ROAS — where should I shift budget?
- Which cohorts click a lot but don’t convert — creative–landing-page mismatch?
- How does AOV vary across age groups — does that change pricing or product strategy?
- Should video length differ by audience? (shorter for younger, more informational for older)
Available metrics
Everything you can compute on this data model. Need a metric not listed? See the Meta Ads metric availability matrix.| Metric | Formula |
|---|---|
| Spend & revenue | |
| Ad Spend | Sum of daily spend |
| Conversion Value | Sum of reported revenue |
| ROAS | Conversion Value ÷ Ad Spend |
| Conversions | Sum of reported orders |
| AOV | Conversion Value ÷ Conversions |
| Clicks & impressions | |
| Clicks (All) | Sum of clicks (inline + outbound) |
| Impressions | Sum of impressions |
| CTR (All) | Clicks ÷ Impressions × 100 |
| Outbound Clicks | Sum of clicks leading off Meta |
| Inline Clicks | Sum of on-platform engagement clicks |
| Unique Clicks | Avg of deduplicated user clicks |
| Cost efficiency | |
| CPC (All) | Ad Spend ÷ Clicks |
| CPM | Ad Spend ÷ Impressions × 1,000 |
| CPA | Ad Spend ÷ Conversions |
| Cost Per Outbound Click | Ad Spend ÷ Outbound Clicks |
| Revenue Per Link Click | Conversion Value ÷ Outbound Clicks |
| Engagement | |
| Landing Page Views | Sum |
| Post Engagement | Sum (reactions + comments + shares + clicks) |
| Inline Post Engagement | Sum (on-platform-only) |
| Post Reactions | Sum (Like, Love, Haha, Wow, Sad, Angry) |
| Post Shares | Sum |
| Cost Per Post Engagement | Ad Spend ÷ Post Engagements |
| Cost Per Inline Post Engagement | Ad Spend ÷ Inline Post Engagements |
| Conversion funnel | |
| View Content | Sum |
| Add to Cart | Sum |
| Checkouts Initiated | Sum |
| Add Payment Info | Sum |
| Video | |
| Video Plays | Sum |
| Video 25% Watched | Sum |
| Video 50% Watched | Sum |
| Video 75% Watched | Sum |
| Video 100% Watched | Sum |
Hook Rate and Hold Rate are not precomputed here — use Platform & Device for those, or derive them from raw fields below.
Raw fields (for custom calculations)
Raw fields (for custom calculations)
This data model exposes a near-complete raw field set (one of the richest, alongside Platform & Device):
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 · post_reaction · add_payment_info · post_share · video_play_actions · video_views_pct_25 · video_views_pct_50 · video_views_pct_75 · video_views_pct_100