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/connections/destination-data-control.md
+16-17Lines changed: 16 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,16 +2,15 @@
2
2
title: "Using Schema Controls"
3
3
---
4
4
5
-
Once you have enabled Destinations for a given Source, all of the [data](/docs/connections/spec/) you track will be routed to your connected tools and warehouses. If you no longer wish to send all data to a particular Destination, you can disable the Destination from the Source overview page.
5
+
Once you have enabled destinations for a given source, all of the [data](/docs/connections/spec/) you track will be routed to your connected tools and warehouses. If you no longer wish to send all data to a particular destination, you can disable the destination from the Source overview page.
6
6
7
-
But what happens when you want to send all of your data to a warehouse, and only two specific events to an analytics tool? And once you're satisfied with your spec, how do you make sure rogue events are blocked from all of your warehouses and end tools? Segment gives you the power to control exactly what data is allowed into your Destinations, so you can protect the integrity of your data, and the decisions you make with it.
7
+
Segment gives you the power to control exactly what data is allowed into your destinations, so you can protect the integrity of your data, and the decisions you make with it. You can send all of your data to a warehouse and only two specific events to an analytics tool. You can also block rogue events from all of your warehouses and end tools.
8
8
9
+
## Filter specific events from being sent to specific destinations
9
10
10
-
## How do I filter specific events from being sent to specific Destinations?
11
+
An `integrations object` may be passed in the `options` of `group`, `identify`, `page` and `track` methods, allowing selective destination filtering. By default all destinations are enabled.
11
12
12
-
An `integrations object` may be passed in the `options` of `group`, `identify`, `page` and `track` methods, allowing selective Destination filtering. By default all Destinations are enabled.
13
-
14
-
All customers can filter specific events from being sent to specific Destinations (except for warehouses) by updating their tracking code. Here is an example showing how to send a single message only to Intercom and Google Analytics:
13
+
All customers can filter specific events from being sent to specific destinations (except for warehouses) by updating their tracking code. Here is an example showing how to send a single message only to Intercom and Google Analytics:
Destination flags are **case sensitive** and match [the Destination's name in the docs](/docs/connections/destinations/catalog/) (for example, "AdLearn Open Platform", "awe.sm", "MailChimp", etc.).
31
30
32
-
If you're on Segment's Business plan, you can filter track calls right from the Segment UI on your Source Schema page by clicking on the field in the "Integrations" column and then adjusting the toggle for each tool. Segment recommends using the UI if possible since it's a much simpler way of managing your filters and can be updated with no code changes on your side.
31
+
If you're on Segment's Business plan, you can filter track calls right from the Segment UI on your Source Schema page by clicking on the field in the **Integrations** column and then adjusting the toggle for each tool. Segment recommends using the UI if possible since it's a much simpler way of managing your filters and can be updated with no code changes on your side.
33
32
34
33

35
34
36
-
## How do I block or disable specific events and properties from being sent to all Destinations?
35
+
## Block or disable specific events and properties from being sent to all destinations
37
36
38
37
If you no longer want to track an event, you can either remove it from your code or, if you're on the Business plan, you can block track calls right from the Segment UI on your Source Schema page by adjusting the toggle for each event.
39
38
40
39

41
40
42
-
Once you block an event in Segment, Segment stops 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
+
Once you block an event in Segment, Segment stops 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.
43
42
44
-
## What does adding a new event via the 'New Event' button do?
43
+
## Add a new event using the **New Event** button
45
44
46
-
The 'New Event' button in your source schema adds the event to the source schema only. It does not add any events to your tracking code. If you want to track an event, you still need to manually add it to your source code.
45
+
The **New Event** button in your source schema adds the event to the source schema only. It does not add any events to your tracking code. If you want to track an event, you still need to manually add it to your source code.
47
46
48
-
A use case for this feature might be to enable [schema filtering](https://segment.com/docs/guides/filtering-data/#per-source-schema-integrations-filters) for a new event before it arrives in the source to prevent it from reaching specific down stream destinations.
47
+
A use case for this feature might be to enable [schema filtering](/docs/guides/filtering-data/#per-source-schema-integrations-filters) for a new event before it arrives in the source to prevent it from reaching specific downstream destinations.
49
48
50
49
## Export your Source Schema
51
50
@@ -58,22 +57,22 @@ Segment allows users with Source Read-only permissions to download Source Schema
58
57
You can only download one Source Schema CSV schema type (Track, Identify, or Group) per source at the same time.
59
58
60
59
To download a Source Schema CSV file:
61
-
1. Sign into Segment and select a source.
60
+
1. Sign in to Segment and select a source.
62
61
2. Click the **Schema** tab in the source header.
63
62
3. On the Source Schema page, select a schema type (Track, Identify, or Group) and a timeframe (7 days or 30 days).
64
63
4. Click the **Download CSV** button. <br/> A toast pops up on the top of the page, with the message *"Your file is processing. When your file is ready it will be available to download from the Download History page."*
65
64
5. Open the Download History page by clicking the link in the toast or following the instructions in the [view download history](#view-download-history) section.
66
65
6. Once the file status column indicates that the download was successful, click the **Download CSV** link to download your CSV to your computer. If the file status column shows that the download has failed, return to the Source Schema page and try the download again.<br/> The Source Schema CSV name has the following format:<br/>`workspaceSlug-sourceSlug-schemaType--yyyy-mm-dd--hh-mm-utc`
67
66
68
-
> note "All events and properties are now included in the CSV file"
67
+
> info "All events and properties are now included in the CSV file"
69
68
> When you export a Source Schema, all events and properties are included in the CSV file regardless of the filters or search parameters currently applied to the Source Schema view.
70
69
71
70
### View download history
72
71
73
-
You can view the last 14 days' worth of Source Schema exports on the Download History page.
72
+
You can view the Source Schema exports from the last 14 days on the Download History page.
74
73
75
74
To access the Download History page:
76
-
1. Sign into Segment and select a source.
75
+
1. Sign in to Segment and select a source.
77
76
2. Click the **Schema** tab in the source header.
78
77
3. Click the **View Download History** link.
79
78
@@ -89,7 +88,7 @@ The Track event CSV file contains the following columns:
89
88
- Planned (available for Protocols customers with a connected Tracking Plan)
90
89
- Values are "planned" or "unplanned"
91
90
92
-
> note "Labels in your exported CSV"
91
+
> info "Labels in your exported CSV"
93
92
> If you use [labels](/docs/protocols/tracking-plan/create/#add-a-label), they appear as columns in your CSV. The column headers are keys, and the column data contains values.
0 commit comments