Skip to content

Commit 185af94

Browse files
committed
Add section explaining filtering
1 parent 90eba2a commit 185af94

File tree

1 file changed

+17
-2
lines changed

1 file changed

+17
-2
lines changed

src/unify/unify-event-filtering.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,15 @@ Unify Event Filtering lets you control which events reach your Unify space.
77

88
## Overview
99

10-
With Unify Event Filtering, you can use block events that aren’t useful for identity resolution or downstream activation, keeping your space cleaner and more efficient.
10+
With Unify Event Filtering, you can use block events that aren’t useful for [identity resolution](/docs/unify/identity-resolution/) or downstream activation, keeping your space cleaner and more efficient.
1111

1212
Event Filtering is useful when you’re sending a lot of different event types into Segment but only some of them are relevant to Unify. For example, you might want to:
1313

1414
- Drop telemetry or system events that don’t describe user behavior
1515
- Filter out events from certain regions or user groups
1616
- Keep events in Connections, but exclude them from Unify
1717

18-
Unify Event Filtering works differently from Destination Filters in a few important ways:
18+
Unify Event Filtering works differently from [Destination Filters](/docs/connections/destinations/destination-filters/) in a few important ways:
1919

2020
| | Unify Event Filtering | Destination Filters |
2121
| ---------------- | ---------------------------------------- | --------------------------------------- |
@@ -24,3 +24,18 @@ Unify Event Filtering works differently from Destination Filters in a few import
2424
| Filter action | Drops entire events | Can drop or modify events and fields |
2525
| Setup | Created through API, visible in Unify UI | Created in UI or API |
2626
| Timing | Before identity resolution | Before events get sent to a destination |
27+
28+
This helps simplify your setup and reduce noise in profile data without needing repeaters, webhooks, or custom logic.
29+
30+
## How filtering works
31+
32+
Unify Event Filtering evaluates every incoming event before it enters your Unify space. If the event matches any of your filters, it gets dropped.
33+
34+
Keep the following in mind as you work with Unify Event Filtering:
35+
36+
- Filters are configured at the space level. You don’t create filters per source. Instead, one set of filters applies to all sources connected to the space.
37+
- The filtering logic is based on [Filter Query Language](/docs/api/public-api/fql/). If you’ve used Destination Filters before, it works the same way. You can write expressions to match events based on type, name, traits, properties, or values.
38+
- Matching is inclusive: if an event matches any filter, Segment drops it.
39+
- Filtering happens **before** identity resolution; dropped events never reach the profile graph and won’t affect trait updates or [computed traits](/docs/unify/traits/computed-traits/).
40+
41+
As a result, Unify Event Filtering helps you keep profile data clean from the start, without having to preprocess or transform events outside of Segment.

0 commit comments

Comments
 (0)