Dimensions
Dimensions are categorical or descriptive fields by which report rows are grouped. Unlike metrics, dimensions aren't summed — they determine the cut through which you view the data.
What a dimension is
A dimension answers the question "what?", "where?", "when?":
- Campaign — the ad campaign name
- Source — the platform the data came from
- Date — the day, week, or month of the event
- Country — a geographic attribute
- Device type — mobile, desktop, tablet
- Keyword — the search query
Types of dimensions
| Category | Examples | Field type |
|---|---|---|
| Time-based | Date, Month, Year, Day of week | date |
| Hierarchical | Campaign → Ad set → Ad | string |
| Geographic | Country, Region, City | string |
| Technical | Device, Browser, OS | string |
| Attribution | UTM tags (source, medium, campaign) | string |
Grouping by dimensions
If a report has at least one dimension selected, all metrics are aggregated within that cut:
Without dimensions:
Clicks: 10,500
Spend: 52,300 ₽With the "Campaign" dimension:
Campaign | Clicks | Spend
Brand search | 4,200 | 21,000 ₽
Category search | 3,800 | 18,500 ₽
Retargeting | 2,500 | 12,800 ₽Dimension order
Dimensions in a report are ordered: the first column is the first dimension, the second is the second dimension, and so on. Order affects the grouping hierarchy:
Country → City:
Russia
├── Moscow: 5,000 clicks
├── St. Petersburg: 3,200 clicks
└── Novosibirsk: 1,100 clicks
City → Country: (a meaningless grouping, avoid it)Limitations
- A maximum of 7 dimensions in a single report
- Not all dimension combinations are valid (depends on the source)
- You can't mix dimensions from different granularity levels without losing data
Universal dimensions
These dimensions are available across all sources:
| Dimension | Description |
|---|---|
date | The event date |
month | The event month |
year | The event year |
day_of_week | Day of the week (Mon–Sun) |
source | The source name |
account_name | The account name |
campaign_name | The campaign name |