@@ -3,9 +3,9 @@ title: Destination Filters
3
3
rewrite : true
4
4
---
5
5
6
- Destination Filters let you prevent certain data from flowing into a destination.
6
+ Use Destination Filters to prevent certain data from flowing into a destination.
7
7
8
- Using Destination Filters, you can conditionally filter out event properties, traits, and fields, or even filter out the event itself.
8
+ With Destination Filters, you can conditionally filter out event properties, traits, and fields, or even filter out the event itself.
9
9
10
10
Common use cases for Destination Filters include the following:
11
11
@@ -17,10 +17,11 @@ Common use cases for Destination Filters include the following:
17
17
> note ""
18
18
> Destination Filters are available to Business Tier customers only.
19
19
20
- ### Destination Filtering Limitations
20
+ ### Destination filtering limitations
21
21
22
22
Keep the following limitations in mind when you use Destination Filters:
23
23
24
+ - Segment applies Destination Filters one at a time in the order that they appear in your workspace.
24
25
- Destination Filters can only be applied to cloud-mode (server-side) streaming destinations. Device-mode destinations aren't supported.
25
26
- You can't apply Destination Filters to Warehouses or S3 destinations.
26
27
- Each filter can only apply to one source-destination pair.
@@ -59,7 +60,7 @@ To learn more, read Segment's [Destination Filters API docs](https://reference.s
59
60
60
61
The following examples illustrate common Destinations Filters use cases.
61
62
62
- ### PII Management
63
+ ### PII management
63
64
64
65
Example: Remove email addresses from ` context ` and ` properties ` :
65
66
@@ -68,19 +69,19 @@ Property-level allowlisting is available with Segment's API. Using Destination F
68
69
69
70
![ PII management example] ( images/destination-filters/pii_example.png )
70
71
71
- ### Control Event Volume
72
+ ### Control event volume
72
73
73
74
This example shows a filter that controls event volume by only sending ` User Signed Up ` and ` Demo Requested ` events.
74
75
75
76
![ Example of a filter that controls event volume] ( images/destination-filters/drop_example.png )
76
77
77
- ### Cleaner Data
78
+ ### Cleaner data
78
79
79
80
This example shows a rule that only sends track calls to Google Analytics.
80
81
81
82
![ Example of a filter that only sends track calls to Google Analytics] ( images/destination-filters/clean_example.png )
82
83
83
- ### Remove Internal and Test Events From Production Tools
84
+ ### Remove internal and test events from production tools
84
85
85
86
This rule targets email addresses with internal domains to stop test events from reaching Destinations.
86
87
@@ -90,15 +91,15 @@ This rule prevents an event from sending if `Order Completed` and `properties.em
90
91
91
92
![ Internal domain filter example] ( images/destination-filters/internal_example2.png )
92
93
93
- ### Sample a Percentage of Events
94
+ ### Sample a percentage of events
94
95
95
96
Using the [ Destination Filters API] ( https://reference.segmentapis.com/#6c12fbe8-9f84-4a6c-848e-76a2325cb3c5 ) {: target ="_ blank"}, you can create a rule to randomly sample video heartbeat events.
96
97
97
- ### Drop Events
98
+ ### Drop events
98
99
99
100
[ Watch this Destination Filters walkthrough] ( https://www.youtube.com/watch?v=47dhAF1Hoco ) {: target ="_ blank"} to learn how to use event names to filter events sent to destinations.
100
101
101
- ## Important Notes
102
+ ## Important notes
102
103
103
104
** Conflicting settings**
104
105
0 commit comments