Dashboard: Data widget - filters
🎯 Overview
Section titled “🎯 Overview”Filters allow advanced customization of Data Widgets by refining what data is shown. They are supported only for:
- Facebook Ads (Meta)
- Google Ads
- GA4
- Google Search Console
Filters must always use original metric and dimension names, not display names. Original names can be found on the widget’s details side (after creation) or in the integration’s native interface.
🔍 General Rules
Section titled “🔍 General Rules”-
A filter consists of one or more expressions.
-
Each expression compares a metric/dimension to a value, or builds from other expressions.
-
Example:
sessions>>15→ Sessions value is larger than 15 -
Separators:
- Expressions must be divided consistently by either
;or,— no mixing. ;= AND logic.,= OR logic.
- Expressions must be divided consistently by either
-
Integration differences:
- GA4 supports both AND and OR.
- Facebook Ads, Google Ads, Google Search Console always use AND.
-
GA4 special rule:
- Metrics and dimensions cannot be combined in a single expression.
- Use
:::to separate metrics-only expressions from dimensions-only expressions. - Example:
sessions>>15;sessions<<100:::country==(Serbia|Croatia)
-
Bracketed lists:
- When using operators that support multiple values, values must be inside parentheses
( )and separated by|. - Example:
campaign==(SummerSale|WinterSale)
- When using operators that support multiple values, values must be inside parentheses
🔧 Operators by Integration
Section titled “🔧 Operators by Integration”Google Ads
Section titled “Google Ads”| Operator | Meaning (single value) | Meaning (bracketed values) |
|---|---|---|
=@ |
LIKE | — |
!=@ |
NOT LIKE | — |
== |
= | IN |
!= |
!= | NOT IN |
=~ |
REGEXP_MATCH | CONTAINS ANY |
!~ |
NOT REGEXP_MATCH | CONTAINS NONE |
>> |
> | — |
>= |
>= | — |
<< |
< | — |
<= |
<= | — |
Example:
campaign.name==(SummerSale|WinterSale)
Operators behave differently for metrics vs. dimensions:
| Operator | Dimension meaning | Metric meaning | Bracketed behavior |
|---|---|---|---|
== |
EXACT | EQUAL | IN_LIST (dims only) |
!= |
EXACT (NOT) | EQUAL (NOT) | NOT IN_LIST (dims only) |
<< |
— | LESS_THAN | — |
>> |
— | GREATER_THAN | — |
=@ |
CONTAINS | — | — |
!@ |
CONTAINS (NOT) | — | — |
=~ |
FULL_REGEXP | — | — |
!~ |
FULL_REGEXP (NOT) | — | — |
Example:
sessions>>15;sessions<<100:::country==(Serbia|Croatia)
Facebook Ads
Section titled “Facebook Ads”| Operator | Meaning (single value) | Meaning (bracketed values) |
|---|---|---|
== |
EXACT | IN_LIST |
!= |
EXACT (NOT) | NOT IN_LIST |
=@ |
CONTAINS | — |
!@ |
CONTAINS (NOT) | — |
=~ |
REGEXP_MATCH | — |
!~ |
NOT REGEXP_MATCH | — |
>> |
GREATER_THAN | — |
<< |
LESS_THAN | — |
>= |
GREATER_OR_EQUAL | — |
<= |
LESS_OR_EQUAL | — |
Example:
ad_name=~(Discount|Promo)
Google Search Console
Section titled “Google Search Console”| Operator | Meaning (single value) | Meaning (bracketed values) |
|---|---|---|
== |
EXACT | IN_LIST |
!= |
EXACT (NOT) | NOT IN_LIST |
=@ |
CONTAINS | — |
!@ |
CONTAINS (NOT) | — |
=~ |
REGEXP_MATCH | — |
!~ |
NOT REGEXP_MATCH | — |
Example:
query==(seo|analytics|reporting)
⚠️ Key Notes
Section titled “⚠️ Key Notes”- Always verify names against the integration’s native interface or widget details.
- Incorrect naming or syntax will result in errors or empty data.
- Filters are an advanced feature — best used when you need precise control over displayed data.
- Metrics/Dimensions from filters field do not have to be selected as regular metrics/dimension.