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.

Google Ads performance by where the ad actually appeared — websites, mobile apps, YouTube channels, and YouTube videos.

What this data model represents

Grain: one row per date × ad_account × campaign × adset × placement. 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: Google Ads API, daily refresh.
This is the budget-protection model. The two highest-leverage actions: exclude the low-quality placements wasting spend, and promote the top performers into managed-placement lists.

Slice by

Unique to this data model:
DimensionTypeValues
placement_typeStringWebsite, Mobile App, YouTube Channel, YouTube Video, Other
placement_urlStringURL or identifier of where the ad appeared
placement_display_nameStringHuman-readable name (site, app, channel, or video title)
Plus the standard campaign hierarchy, time, and account dimensions — documented once on the Google Ads Overview.

Use it to answer

  • Which placements waste budget with no conversions — candidates for the exclusion list?
  • Which placements consistently convert — promote to managed placements?
  • Are any placement URLs misaligned with our brand?
  • Which YouTube channels and apps perform best for video and in-app ads?

Available metrics

Everything you can compute on this data model. Need a metric not listed? See the Google Ads metric availability matrix.
MetricFormula
Spend & revenue
Ad SpendSum of daily spend
Conversion ValueSum of reported revenue
ROASConversion Value ÷ Ad Spend
ConversionsSum of attributed conversion events
AOVConversion Value ÷ Conversions
Clicks & impressions
ClicksSum of clicks
ImpressionsSum of impressions
CTRClicks ÷ Impressions × 100
Cost efficiency
CPCAd Spend ÷ Clicks
CPMAd Spend ÷ Impressions × 1,000
CPAAd Spend ÷ Conversions
RPCConversion Value ÷ Clicks
Engagement
EngagementsSum
InteractionsSum
CPEAd Spend ÷ Engagements
CPIAd Spend ÷ Interactions
Conversion
Conversion RateConversions ÷ Clicks × 100
View Through ConversionsSum of conversions from impressions without clicks
Video
Video ViewsSum
ad_spend · conversion_value · conversions · clicks · impressions · engagements · interactions · view_through_conversions · video_views