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/protocols/enforce/schema-configuration.md
+13-3Lines changed: 13 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,6 +21,19 @@ To enable blocking, go to the **Settings** tab for your source and click on **Sc
21
21
>
22
22
> To view all archived events, go to your **Source Schema** page, click **Filter** next to the search bar, and select **Archived**. To unarchive events that have been archived, click **Unarchive** in the event column.
23
23
24
+
## Order of Priority in Blocking Options
25
+
26
+
When setting up Schema Configuration, please note the following prioritization of blocking controls:
27
+
28
+
1.**Standard Schema Controls:** Initially, the system evaluates incoming events against these controls, along with your Tracking Plan. Events, properties, or traits not blocked or omitted in this phase then proceed to the next level of controls:
2.**Advanced Blocking Controls/Common JSON Schema:** These controls are assessed after the Standard Schema Controls. They act as an essential secondary layer, evaluating incoming events against the Common JSON schema included in your Tracking Plan:
> info "Using only the Common JSON Schema to block events"
35
+
> If a tracking plan is empty of events, but has Common JSON Schema rules, you do not need to use the standard schema controls. You would only need to use the Advanced Blocking Controls in your source. If you use the standard schema controls and omit properties or traits that do not exist, the Tracking Plan may not generate violations for the Common JSON Schema, as the entire Tracking Plan has nothing and everything will be considered unplanned.
36
+
24
37
## Track Calls - Unplanned Events
25
38
When you set this dropdown to Block Event, Segment drops any events that are not defined in your Tracking Plan. Only allowlisted `track` calls in your Tracking Plan flow through Segment to your Destinations.
26
39
@@ -64,9 +77,6 @@ This is an advanced feature that requires extensive testing and a squeaky clean
64
77
65
78
**IMPORTANT: JSON schema violation event blocking is ONLY supported in cloud-mode Destinations. Events with invalid properties will not be blocked from sending to device-mode Destinations.**
66
79
67
-
> info "Using only the Common JSON Schema to block events"
68
-
> If a tracking plan is empty of events, but has Common JSON Schema rules, you do not need to use the standard schema controls. You would only need to use the Advanced Blocking Controls in your source. If you use the standard schema controls and omit properties or traits that do not exist, the Tracking Plan may not generate violations for the Common JSON Schema, as the entire Tracking Plan has nothing and everything will be considered unplanned.
69
-
70
80
## Identify Calls - Unplanned Traits
71
81
Setting this dropdown to Omit Traits will ensure that traits not defined in your Tracking Plan are removed from the identify call. For example, if you specify three traits in your Tracking Plan (`name`, `email`, `join_date`), the below identify call would have the `first_name` property omitted by Protocols.
0 commit comments