Skip to main content
A breakdown is how Adriel splits a metric into groups. Every widget that shows more than one value at a time uses a breakdown to decide how the underlying rows are grouped — for example, one row per Channel, one bar per Campaign, one segment per Country, one point per Day.

​
Types of breakdowns

Adriel supports two broad categories.

​
Date breakdowns

Date breakdowns split data over time. Available options:
  • Day — one row per day.
  • Week (ISO) — Monday-to-Sunday week.
  • Week (Sun-Sat) — US-style Sunday-to-Saturday week.
  • Month — one row per calendar month.
  • Quarter — one row per quarter.
  • Year — one row per calendar year.
  • Auto-time — automatically switches between Day, Week, and Month based on the dashboard’s date range:
Date breakdowns are supported primarily for ad-channel data sources (Meta Ads, Google Ads, TikTok Ads, etc.). Non-ad data sources — for example, analytics platforms, e-commerce platforms, databases, and file-based sources — don’t always expose the full set of date breakdowns and may not follow the same rules. Check the connector’s reference page for the specific data source when using a date breakdown against a non-ad source.

​
Non-date breakdowns

Non-date breakdowns split by dimensions in the underlying data. The exact list depends on the data source. Common values include Channel, Campaign, Ad set, Ad, Country, Region, Device, Platform, and Placement. In addition to the built-in breakdowns, users can define their own — see Custom breakdowns.

​
How breakdowns apply across widget types

The same underlying concept renders slightly differently depending on the widget type.
  • Table widgets call it a breakdown and support multiple breakdowns stacked as a hierarchy — for example, Channel → Campaign → Ad set → Ad. Each level unfolds when the parent row is clicked.
  • Chart widgets call it Group by and use exactly one at a time. Each unique value of the Group by becomes one bar, line, slice, or dot on the chart.
The underlying data is the same — the naming and behavior reflects how the widget renders the split. Per-widget details for Group by live in each chart widget’s own article.

​
Per-connector date breakdown support

Not every date breakdown is supported by every data source. Two rules apply:
  • Native vs derived — Day, Week (ISO), Week (Sun-Sat), and Month are natively supported for most ad-channel connectors. Quarter, Year, and Auto-time are derived from those by aggregating up.
  • Connector-specific incompatibilities — some connectors declare certain date breakdowns as incompatible with certain widget types. When incompatible, the picker greys out or omits the option.
If a date breakdown is missing from the picker for a specific data source, the connector likely doesn’t support it for that widget type. Pick a different breakdown, or use a widget type that does support it.

​
Adding, removing, and reordering breakdowns

Inside a widget’s settings panel:
  • Add — pick a breakdown from the picker; it appends to the end of the breakdown list.
  • Remove — click the X on a breakdown chip, or unselect the breakdown from the picker list itself.
  • Reorder — drag breakdown chips to change the order. In tables, order determines the row hierarchy.

​
Troubleshooting

The weekly breakdown returns the entire week (Sunday–Saturday or Monday–Sunday) even if the filter selects only some days within it, because some third-party APIs only return weekly-granular data. To match an exact date range, switch to a daily breakdown.Weekly Breakdown (Start: Sun) is also truncated to 90 days because most platform APIs don’t return the daily-granularity data needed to compute Sunday-start weeks over a longer window. For a full year, use Weekly Breakdown (Start: Mon) instead.

Custom breakdowns

Add your own rules to organize how imported data is grouped.

Metrics

The values a widget plots against a breakdown.

Filters

Narrow the data feeding a widget or dashboard.