Skip to main content

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.

Dayparting analysis — which hours of which days are working for your spend, and when to pull back.
This is the only Meta Ads data model that does not expose revenue metrics (Conversion Value, ROAS, AOV). It tracks order count and engagement, not revenue. If you need revenue at hourly granularity, use Platform & Device with a time filter.

What this data model represents

Grain: one row per date × ad_account × campaign × adset × ad × audience_hour. 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:
DimensionTypeValues
audience_hourInteger0 (midnight–1am) … 23 (11pm–midnight)
day_of_weekStringDerived from date — Monday, Tuesday, … Sunday
Plus the standard campaign hierarchy, time, account, and attribution dimensions — documented once on the Meta Ads Overview.

Use it to answer

  • Where are peak conversion hours vs. peak spend hours — and what’s the inefficiency?
  • Which hours should I pause? Which should I bid up?
  • How do hour × day-of-week patterns differ between weekdays and weekends?
  • What time of day has the highest engagement for awareness campaigns?

Available metrics

Everything you can compute on this data model. Need a metric not listed? See the Meta Ads metric availability matrix.
MetricFormula
Spend & conversions
Ad SpendSum of daily spend
ConversionsSum of reported orders
Clicks & impressions
Clicks (All)Sum of clicks (inline + outbound)
ImpressionsSum of impressions
CTR (All)Clicks ÷ Impressions × 100
Outbound ClicksSum of clicks leading off Meta
Inline ClicksSum of on-platform engagement clicks
Cost efficiency
CPC (All)Ad Spend ÷ Clicks
CPMAd Spend ÷ Impressions × 1,000
CPAAd Spend ÷ Conversions
Cost Per Outbound ClickAd Spend ÷ Outbound Clicks
Engagement
Landing Page ViewsSum
Post SharesSum
Engagement RatePost Engagement ÷ Impressions × 100
Cost Per Post EngagementAd Spend ÷ Post Engagements
Cost Per Inline Post EngagementAd Spend ÷ Inline Post Engagements
Conversion funnel
View ContentSum
Add to CartSum
Checkouts InitiatedSum
Engagement Rate as a precomputed metric lives only here. In other data models you’d have to compute it from raw Post Engagement and Impressions.
This data model exposes:ad_spend · clicks · impressions · reported_orders · inline_clicks · outbound_clicks · landing_page_views · add_to_cart · checkouts_initiated · view_content · post_share