## 🎯 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

* 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.
  * ****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)
    ```

---

## 🔧 Operators by Integration

### Google Ads

||||
<colgroup><col /><col /><col /></colgroup>|:---|:---|:---|
|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)
```

---

### GA4

Operators behave differently for****metrics vs. dimensions****:

|||||
<colgroup><col /><col /><col /><col /></colgroup>|:---|:---|:---|:---|
|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 (Meta)

||||
<colgroup><col /><col /><col /></colgroup>|:---|:---|:---|
|Operator|Meaning (single value)|Meaning (bracketed values)|
|`\==`|EQUAL|IN|
|`!=`|NOT\_EQUAL|NOT IN|
|`\=~`|CONTAIN|IN\_RANGE|
|`!~`|NOT\_CONTAIN|NOT IN\_RANGE|
|`\=@`|STARTS\_WITH|—|
|`>>`|GREATER\_THAN|—|
|`>=`|GREATER\_THAN\_EQUALS|—|
|`<<`|LESS\_THAN|—|
|`<=`|LESS\_THAN\_EQUALS|—|

****Example:****

```
ad_name=~(Discount|Promo)
```

---

### Google Search Console

Does****not support bracketed values****.

|||
<colgroup><col /><col /></colgroup>|:---|:---|
|Operator|Meaning|
|`\==`|equals|
|`!=`|notEquals|
|`\=~`|contains|
|`!~`|notContains|

****Example:****

```
query=~shoes
```

---

## ⚠️ 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.