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/guides/filtering-data.md
-19Lines changed: 0 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -68,25 +68,6 @@ The events filtered out of individual destinations using this method still arriv
68
68
69
69
**Integration filters are all-or-nothing for each event.** If you require more detailed control over which events are sent to specific destinations, you can use Destination Filters to inspect the event payload, and conditionally drop the data or forward it to the destination.
70
70
71
-
## Schema Defaults
72
-
73
-
Schema defaults allow you to prevent unexpected or malformed data from a Source from getting into your downstream destinations. When you set your Schema Defaults to **Block**, Segment automatically prevents new Events from being sent to destinations. You can activate this for new events (including `track`, `page`, and `screen` events) or for new `identify` traits and `group` properties.
74
-
75
-
Data blocked using schema defaults is permanently discarded, and cannot be recovered or replayed through Segment. You can forward blocked data to a new Source, but these events count toward your account MTU limits, and may not be worth saving.
76
-
77
-
Schema Defaults are only available to Business Tier customers.
78
-
79
-
You can find the Schema Defaults in the **Settings** tab for each Source, in **Schema Configuration** section.
80
-
81
-

82
-
83
-
**Schema Defaults Blocking Limitations**
84
-
You cannot use Schema defaults if the source is connected to a Tracking Plan. If you're using Protocols and Tracking Plans, use [Protocols Tracking Plan Blocking](#protocols-tracking-plan-blocking-and-property-omission) to perform the same blocking. Learn more in the [Protocols Schema Configuration documentation](/docs/protocols/enforce/schema-configuration/).
85
-
86
-
**Track** events blocked by Schema filters are not delivered to either device-mode or cloud-mode Destinations. That means if you send a blocked event from a client-side library like Analytics.js, it is not delivered to any device-mode Destinations.
87
-
88
-
**Identify** and **Group** call traits blocked by Schema filters are **only** blocked from delivering to cloud-mode Destinations. Since device-mode destinations are connected directly to the user's device and don't pass through the Segment filters first, they still receive all traits regardless of whether they are blocked in the Segment Schema.
89
-
90
71
## Schema Event Filters
91
72
92
73
You can use Schema Event Filters to discard and permanently remove Page, Screen and Track events from event-based sources, preventing them from reaching any destinations or warehouses. Use this if you know that you'll never want to access this data again. This functionality is similar to filtering with the Integrations object, however it can be changed from within the Segment app without touching any code.
Copy file name to clipboardExpand all lines: src/protocols/schema.md
-75Lines changed: 0 additions & 75 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,78 +54,3 @@ Segment Business tier customers can block track calls from delivering to specifi
54
54
55
55
56
56

57
-
58
-
## Schema Defaults
59
-
60
-
Whether you're just about to implement a new spec or you have been tracking the same events for years, Schema Defaults make it easy to protect your data and fix data quality issues.
61
-
62
-
Schema Defaults offers a quick and easy way to prevent unexpected or erroneous events from reaching your destinations. When you set Schema Defaults to **Block**, Segment automatically prevents new calls from being sent downstream. You can activate this for new events—including `track`, `page`, and `screen` calls, or for new `identify` traits and `group` properties.
63
-
64
-
Locking your schema only takes a few seconds and prevents new rogue events from polluting your Destinations. To configure Schema Defaults, go to your source Settings page, and select **Schema Configuration** from the left-hand navigation.
65
-
66
-
### When should I lock my schema?
67
-
68
-
Here are a few signs you may be ready to lock your schema:
69
-
70
-
- You are concerned about developers implementing rogue events
71
-
- You want to actively approve which events are tracked and routed to your downstream Destinations
72
-
- You have created a tracking plan and want to use Segment to enforce it
| New Events | All new events are allowed in Segment and sent to all Destinations.| No new events are allowed in Segment or sent to your cloud and device-mode Destinations. Any event that is already being tracked and part of your Schema is not impacted. |
82
-
| New Group Properties | All new group properties are allowed in Segment and sent to all Destinations. | No new group properties are allowed in Segment or sent to your cloud-mode Destinations. Device-mode destinations **do** receive blocked traits. |
83
-
| New Identify Traits | All new identify traits are allowed in Segment and sent to all Destinations. | No new identify traits are allowed in Segment or sent to your cloud-mode Destinations. Device-mode destinations **do** receive blocked traits.|
84
-
85
-
86
-
### Schema Default Blocking support across connection modes
87
-
88
-
Track events blocked by Schema filters are prevented from delivering to both device-mode and cloud-mode Destinations. That means if you send a blocked event from a client side library like Analytics.js, it is not delivered to any device-mode Destinations.
89
-
90
-
Identify and group call traits blocked by Schema filters **only** blocked from delivering to cloud-mode Destinations. Device-mode destinations receive all traits regardless of whether they are blocked in Schema.
91
-
92
-
93
-
94
-
### What is considered a "new" event?
95
-
96
-
New events refer to events that have not previously been sent to a given Source. Let's say you've only sent the following events from your Javascript source:
97
-
98
-
-`Products Searched`
99
-
100
-
-`Product List Viewed`
101
-
102
-
-`Product List Filtered`
103
-
104
-
Your Schema Default setting does not block these three events because they are not considered new. You can manually block them, but your Schema Default setting does not change the status of these events.
105
-
106
-
Here's what happens the first time a new event, `Promotion Viewed`, is sent to this Source:
107
-
108
-
-**Schema Default Set to Allow:**`Promotion Viewed` is allowed, which means the event is sent to all enabled Destinations.
109
-
110
-
-**Schema Default Set to Block:**`Promotion Viewed` is blocked, which means the event is not sent to any Destinations.
111
-
112
-
113
-
## Blocked Track Event forwarding
114
-
115
-
If you're concerned about permanently discarding blocked track events, you can forward blocked track events to a new Segment Source. To enable, go to Source Settings > Schema Configuration and select which Source you want to forward track events to from the drop down. We recommend [creating a new Source](https://segment.com/docs/guides/general/what-is-a-source/) for forwarded events to avoid contaminating production data.
116
-
117
-

118
-
119
-
**NOTE: Only blocked `.track()` events are forwarded to the source. `.identify()` and `.group()` events are not forwarded.**
120
-
121
-
**BILLING NOTE: Events forwarded to a Segment Source count towards your MTU counts. Blocking and discarding events do not contribute to your MTU counts.**
122
-
123
-
## Blocked event billing
124
-
125
-
Your bill is based on the number of Monthly Tracked Users (MTU). MTUs are the number of identified and anonymous users that you track with Segment. We only count users once per month, even if they perform multiple actions across your site or app. In most cases, blocked events have no impact on your MTU count as they are not stored or sent downstream. If you enable Blocked Event Forwarding, the forwarded events contribute to your MTU count.
126
-
127
-
## Blocked event notifications
128
-
129
-
While protecting the integrity of your data is helpful with event blocking and Schema Defaults, we offer proactive notifications to flag new blocked events so you can make any needed changes in your code or approve a new event.
130
-
131
-
Your workspace notifications alert you when a new event is blocked due to your Schema Defaults. You can enable notifications in the [Notification Settings](https://app.segment.com/goto-my-workspace/settings/notifications) of your workspace.
Copy file name to clipboardExpand all lines: src/protocols/validate/connect-sources.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ With your Tracking Plan is complete, it's time to apply the Tracking Plan to one
13
13
14
14
From this menu, you will be redirected to a workflow to select a Source from your workspace. Note that a Source can only have one tracking plan applied to it. You *can't* select a Source that already has a Tracking Plan connected to it, but you *can* apply a Tracking Plan to multiple sources.
15
15
16
-
After selecting a Source, you will be shown the consequences of connecting your Tracking Plan. In many cases, there will be no consequences. However, if you've enabled Schema Defaults, events previously allowed will now be blocked if they are not included in the Tracking Plan. If you've blocked specific events, those events will now be allowed until you enable Blocking in the Tracking Plan settings.
16
+
After selecting a Source, you will be shown the consequences of connecting your Tracking Plan.
17
17
18
18
**IMPORTANT: Make sure to read through the consequences of connecting a source!**
0 commit comments