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
Schema Defaults was a beta feature that was partiall rolled out and
is slated to be EOL-ed soon. We are removing the docs now so that
we no longer get requests from customers to activate this feature.
PROT-2959
Copy file name to clipboardExpand all lines: src/connections/destination-data-control.md
-106Lines changed: 0 additions & 106 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,109 +38,3 @@ If you no longer want to track an event, you can either remove it from your code
38
38

39
39
40
40
Once you block an event in Segment, we'll stop forwarding it to all of your Destinations, including your warehouses. You can remove it from your code at your leisure. In addition to blocking track calls, Business plan customers can block all Page and Screen calls, as well as Identify traits and Group properties.
41
-
42
-
---
43
-
44
-
45
-
46
-
## How do I prevent new data from being allowed by default?
47
-
48
-
If you've solidified your tracking plan and don't want any rogue events finding their way to your warehouses and end tools, we recommend activating our new feature, **Schema Defaults**. When you lock your schema, or set your Schema Defaults to "Block," Segment will automatically prevent these 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.
49
-
50
-
Locking your schema only takes a few seconds and will protect your data from un-spec'd events or tracking errors. To configure your Schema Defaults, go to your Schema page, and then select "General" from the left-hand navigation.
51
-
52
-

53
-
54
-
55
-
**Overview of Schema Default Settings**
56
-
57
-
**Default**
58
-
59
-
**Allow**
60
-
61
-
**Block**
62
-
63
-
**New Events**
64
-
65
-
All new events will be allowed in Segment and sent to all Destinations.
66
-
67
-
No new events will be allowed in Segment or sent to your Destinations. Any event that is already being tracked and part of your Schema will not be impacted.
68
-
69
-
**New Group Properties**
70
-
71
-
All new group properties will be allowed in Segment and sent to all Destinations.
72
-
73
-
No new group properties will be allowed in Segment or sent to your Destinations.
74
-
75
-
**New Identify Traits**
76
-
77
-
All new identify traits will be allowed in Segment and sent to all Destinations.
78
-
79
-
No new identify traits will be allowed in Segment or sent to your Destinations.
80
-
81
-
**Example: Order Completed**
82
-
83
-
For example, if you set your Schema Defaults for New Events to "Block," and a new event, `Order Completed`, is tracked, Segment will automatically block the event and it will not be sent to your warehouse or downstream tools. The event will continue to be blocked until you actively choose to allow it.
84
-
85
-
You will need to upgrade to the latest [iOS](/docs/connections/sources/catalog/libraries/mobile/ios/#install-the-sdk) and/or [Android](/docs/connections/sources/catalog/libraries/mobile/android/#step-1-install-the-library) SDKs for Schema Defaults to apply to events sent from mobile sources.
86
-
87
-
## **What is considered a "new" event?**
88
-
89
-
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:
90
-
91
-
*`Products Searched`
92
-
93
-
*`Product List Viewed`
94
-
95
-
*`Product List Filtered`
96
-
97
-
98
-
Your Schema Default setting will not have any impact on these three events because they are not considered new. You can manually block them, but your Schema Default setting will not change the status of these events.
99
-
100
-
Here's what will happen the first time a new event, `Promotion Viewed`, is sent to this Source:
101
-
102
-
***Schema Default Set to Allow:**`Promotion Viewed` will be "allowed," which means the event will be sent to all enabled Destinations.
103
-
104
-
***Schema Default Set to Block:**`Promotion Viewed` will be "blocked," which means the event will not be sent to any Destinations.
105
-
106
-
107
-
## **What happens to blocked events and properties? **
108
-
109
-
When an event or property is blocked, the name of the event or property will be added to your Schema page, but no data will be tracked. By default, data from blocked events and properties is not recoverable. You can always re-enable the event or property if you want to begin tracking it going forward.
110
-
111
-
If you're concerned about permanently discarding data from blocked events, you can use advanced settings to forward these events to a designated Source. From there, you can send your data to a separate S3 bucket or warehouse for further analysis. That way if you decide you _do_ want the data in your downstream tools, you can ask Segment to Replay the data into your server-side Destinations. If you choose to route blocked events, this will contribute to your MTU count.
112
-
113
-
**How do I forward blocked events?**
114
-
115
-
First, you will want to create a new Source to receive data from blocked Events and Traits. This Source should only be configured to received blocked data, so make sure it isn't receiving data from anywhere else. We recommend creating a new "Javascript" source and naming it "Blocked Data from \[Source Name\]."
116
-
117
-
After you have created a new source, go to the Schema page for your primary Source and then select "General" from the left-hand navigation. Under "Advanced Settings," you will see two options:
118
-
119
-
* Block and discard: select this option if you want to permanently discard data from blocked Events and Traits.
120
-
121
-
* Forward: select this option if you would like to forward data from blocked Events and Traits to a separate source.
122
-
123
-
124
-
Select "Forward," and then select the new Source you created to receive blocked data. **As a reminder, if you choose to route blocked events, this will contribute to your MTU count. **
125
-
126
-
## **How am I charged for blocked events? **
127
-
128
-
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 will have no impact on your MTU count. If you choose to route blocked events, this will contribute to your MTU count.
129
-
130
-
## **How do I configure notifications?**
131
-
132
-
While protecting the integrity of your data is helpful, we also want to flag any blocked events for you, so you can make any needed changes in your code or approve a new event. Source notifications will alert you when a new event is blocked due to your Schema Defaults. You can view these notifications in the Activity Feed in the app or subscribe to email notifications.
133
-
134
-
You can view these notifications in the Activity Feed in the app or subscribe to email notifications. To subscribe to email notifications, go to your workspace settings, then click "Notification Settings," and subscribe to notifications for Sources by entering your email address and clicking "Save Changes." You can enter multiple email addresses separated by a comma.
135
-
136
-
## **When should I lock my schema? **
137
-
138
-
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.
139
-
140
-
Here are a few signs you may be ready to lock your schema:
141
-
142
-
* You are concerned about developers implementing rogue events
143
-
144
-
* You want to actively approve which events are tracked and routed to your downstream Destinations
145
-
146
-
* You have created a tracking plan and want to use Segment to enforce it
0 commit comments