Skip to content

Commit 1687f2d

Browse files
authored
Merge pull request #4817 from segmentio/ashton-huxtable-patch-2
Add FAQ about 'New Event' button
2 parents 11dffe8 + cc5f48b commit 1687f2d

File tree

1 file changed

+19
-14
lines changed

1 file changed

+19
-14
lines changed

src/connections/destination-data-control.md

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,15 @@
22
title: "Using Schema Controls"
33
---
44

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. 
66

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.
88

9+
## Filter specific events from being sent to specific destinations
910

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.
1112

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:
1514

1615
```js
1716
analytics.identify('user_123', {
@@ -29,17 +28,23 @@ analytics.identify('user_123', {
2928

3029
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.).
3130

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.
3332

3433
![A screenshot of the source schema page. The user is hovered over the integrations column, and a popup showing the three integrations connected to the event appears.](images/destination-control.png)
3534

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
3736

3837
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.
3938

4039
![A screenshot of the source schema page. The toggles in the integrations column are all enabled.](/docs/protocols/images/event-filters.png)
4140

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. 
42+
43+
## Add a new event using the **New Event** button
44+
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.
46+
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.
4348

4449
## Export your Source Schema
4550

@@ -52,22 +57,22 @@ Segment allows users with Source Read-only permissions to download Source Schema
5257
You can only download one Source Schema CSV schema type (Track, Identify, or Group) per source at the same time.
5358

5459
To download a Source Schema CSV file:
55-
1. Sign into Segment and select a source.
60+
1. Sign in to Segment and select a source.
5661
2. Click the **Schema** tab in the source header.
5762
3. On the Source Schema page, select a schema type (Track, Identify, or Group) and a timeframe (7 days or 30 days).
5863
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."*
5964
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.
6065
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`
6166

62-
> 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"
6368
> 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.
6469
6570
### View download history
6671

67-
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.
6873

6974
To access the Download History page:
70-
1. Sign into Segment and select a source.
75+
1. Sign in to Segment and select a source.
7176
2. Click the **Schema** tab in the source header.
7277
3. Click the **View Download History** link.
7378

@@ -83,7 +88,7 @@ The Track event CSV file contains the following columns:
8388
- Planned (available for Protocols customers with a connected Tracking Plan)
8489
- Values are "planned" or "unplanned"
8590

86-
> note "Labels in your exported CSV"
91+
> info "Labels in your exported CSV"
8792
> 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.
8893
8994
### Identity and Group event CSV format

0 commit comments

Comments
 (0)