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/event-filtering.md
+9-11Lines changed: 9 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -45,11 +45,9 @@ As a result, Unify Event Filtering helps you keep profile data clean from the st
45
45
46
46
## Creating and managing filters
47
47
48
-
During public beta, managing filters requires a mix of API and Segment UI actions. You'll define and create filters using the [Space Filter API](https://docs.segmentapis.com/tag/Space-Filters/){:target="_blank"}, then manage their status and visibility in the Segment app.
48
+
During public beta, you'll use the [Space Filter API](https://docs.segmentapis.com/tag/Space-Filters/){:target="_blank"} to create and manage all Unify event filters. The API lets you define filters using FQL, name them, enable or disable them, and delete them. Each Unify space can have up to 10 filters. Any event that matches one of those filters gets dropped before it reaches Unify.
49
49
50
-
To create a filter, use the Space Filter API to write a filtering rule using FQL. The API lets you name the filter, enable or disable it, and delete it. You can create up to 10 filters per space, and any event that matches a filter gets dropped before it reaches Unify.
51
-
52
-
After you create a filter, it shows up in your Segment workspace in **Unify > Unify settings > Filters**. From there, you can view existing filters, turn them on or off, rename them, or delete them. However, you can’t edit the filtering logic from within Segment. If you want to edit filtering logic, you'll need to managed it through the API.
50
+
After you create a filter through the API, it shows up in your Segment workspace in **Unify > Unify settings > Filters**. From there, you can view existing filters, turn them on or off, rename them, or delete them. However, you can’t edit the filtering logic from within your workspace. If you want to edit filtering logic, you'll need to managed it through the API.
53
51
54
52
The following table compares what you can do with Event Filtering with the API compared your Segment workspace:
55
53
@@ -60,7 +58,7 @@ The following table compares what you can do with Event Filtering with the API c
60
58
| Enable or disable filters | API or workspace |
61
59
| Rename a filter | API or workspace |
62
60
| Delete a filter | API or workspace |
63
-
| View filters |Workspace only |
61
+
| View filters |API or workspace|
64
62
| Edit filter logic | Replace in API only |
65
63
66
64
> info "Updating filter logic"
@@ -70,12 +68,12 @@ The following table compares what you can do with Event Filtering with the API c
70
68
71
69
Unify Event Filtering is most useful when you want to keep noisy, irrelevant, or duplicate data out of your Unify space. The following table lists best practices to help you get the most value out of filtering:
| Filter early |Prevents irrelevant events from affecting profile data or identity resolution.|
74
+
| Drop obvious noise | Start with telemetry, test data, or internal events. |
75
+
| Keep it simple | A few targeted filters are easier to manage than multiple, complex filters. |
76
+
| Think at the space level | Filters apply to all sources. Write conditions accordingly. |
79
77
| Test before enabling | Use the [preview endpoint](https://docs.segmentapis.com/tag/Destination-Filters#operation/previewDestinationFilter){:target="_blank"} to check filter behavior before turning it on. |
0 commit comments