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.

SKU-level performance — which products are paying back, which are losing money in the catalog, and where the funnel breaks per SKU.
Populated for catalog-based campaigns (Dynamic Product Ads, Advantage+ Catalog, Collection Ads with a product feed). Non-catalog campaigns won’t appear here — they live in the other data models.

What this data model represents

Grain: one row per date × ad_account × campaign × adset × ad × product_id. 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:
DimensionTypeExample values
product_idStringSKU-12345, PROD-67890
Plus the standard campaign hierarchy, time, account, and attribution dimensions — documented once on the Meta Ads Overview.

Use it to answer

  • Which products have the highest ROAS — where should I increase promotion?
  • Which products get clicks but don’t convert — pricing or landing page issue?
  • Which products have CPA higher than their margin — candidates to exclude from the catalog?
  • What does the View Content → Add to Cart → Checkout → Purchase funnel look like per SKU?

Available metrics

Everything you can compute on this data model. Need a metric not listed? See the Meta Ads metric availability matrix.
MetricFormula
Spend & revenue
Ad SpendSum of daily spend
Conversion ValueSum of reported revenue
ROASConversion Value ÷ Ad Spend
ConversionsSum of reported orders
AOVConversion Value ÷ Conversions
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
Revenue Per Link ClickConversion Value ÷ Outbound Clicks
Engagement
Landing Page ViewsSum
Post EngagementSum (reactions + comments + shares + clicks)
Post SharesSum
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
Add Payment InfoSum
Only data model with SKU-level AOV and the full funnel through Add Payment Info. Pair CPA with your per-product margin to find SKUs where Meta spend is unprofitable — the highest-leverage catalog cleanup move.
This data model exposes:ad_spend · clicks · impressions · reported_orders · reported_revenue · inline_clicks · outbound_clicks · landing_page_views · add_to_cart · checkouts_initiated · view_content · add_payment_info · post_engagement · post_share