You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/unify/unify-event-filtering.md
+17-2Lines changed: 17 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,15 @@ Unify Event Filtering lets you control which events reach your Unify space.
7
7
8
8
## Overview
9
9
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.
11
11
12
12
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:
13
13
14
14
- Drop telemetry or system events that don’t describe user behavior
15
15
- Filter out events from certain regions or user groups
16
16
- Keep events in Connections, but exclude them from Unify
17
17
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:
@@ -24,3 +24,18 @@ Unify Event Filtering works differently from Destination Filters in a few import
24
24
| Filter action | Drops entire events | Can drop or modify events and fields |
25
25
| Setup | Created through API, visible in Unify UI | Created in UI or API |
26
26
| 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