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/privacy/user-deletion-and-suppression.md
+49-25Lines changed: 49 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,33 +9,33 @@ Segment offers you the ability to delete and suppress data about your end-users
9
9
10
10
## Regulations
11
11
12
-
All deletion and suppression actions in Segment are asynchronous and categorized as Regulations, or requests to Segment to control your data flow. You can issue Regulations from:
12
+
All deletion and suppression actions in Segment are asynchronous and categorized as regulations, or requests to Segment to control your data flow. You can issue regulations from:
13
13
14
14
- Your Segment Workspace (Settings > End User Privacy)
15
15
-[Segment's Public API](https://docs.segmentapis.com/tag/Deletion-and-Suppression){:target="_blank"}. You can delete up to 5000 `userId`s per call using the Public API.
16
16
17
-
With Regulations, you can issue a single request to delete and suppress data about a user by `userId`. Segment scopes Regulations to all sources in your workspace.
17
+
With regulations, you can issue a single request to delete and suppress data about a user by `userId`. Segment scopes regulations to all sources in your workspace.
18
18
19
19
> warning "Data sent to device-mode destinations cannot be suppressed"
20
20
> Destinations set up in device mode are sent directly to destinations and bypass the point in the pipeline where Segment suppresses events.
21
21
22
-
Segment has 2 types of Regulations:
23
-
-**Segment-only Regulations**: These Regulations*only* delete or suppress data about your user from internal Segment systems.
24
-
-**Segment & Destination Regulations**: These Regulations delete user data from internal Segment systems and then forward a deletion request to any connected destinations that support programmatic deletion. For a list of destination that support programmatic deletion, see [Which destinations can I send deletion requests to?](/docs/privacy/faq/#which-destinations-can-i-send-deletion-requests-to).
22
+
Segment has 2 types of regulations:
23
+
-**Segment-only regulations**: These regulations*only* delete or suppress data about your user from internal Segment systems.
24
+
-**Segment & Destination regulations**: These regulations delete user data from internal Segment systems and then forward a deletion request to any connected destinations that support programmatic deletion. For a list of destination that support programmatic deletion, see [Which destinations can I send deletion requests to?](/docs/privacy/faq/#which-destinations-can-i-send-deletion-requests-to).
25
25
26
-
While both Regulation types are limited to 110,000 users every calendar month, you can temporarily increase your rate limit for Segment-only Regulations. To send more than 110,000 Segment-only Regulations over a 30 day period, [contact Segment Support](https://segment.com/help/contact/){:target="_blank"}.
26
+
While both regulation types are limited to 110,000 users every calendar month, you can temporarily increase your rate limit for Segment-only regulations. To send more than 110,000 Segment-only regulations over a 30 day period, [contact Segment Support](https://segment.com/help/contact/){:target="_blank"}.
27
27
28
-
### Segment-only Regulations
29
-
The following Segment-only Regulation types are available:
28
+
### Segment-only regulations
29
+
The following Segment-only regulation types are available:
30
30
31
31
-**SUPPRESS_WITH_DELETE_INTERNAL*:** Suppress new data and delete from Segment internal systems only
32
32
-**DELETE_INTERNAL*:** Delete data from Segment internal systems only
33
33
-**SUPPRESS_ONLY***: Suppress new data without deleting existing data
34
34
-**UNSUPPRESS*:** Stop an ongoing suppression
35
35
36
-
### Segment & Destination Regulations
36
+
### Segment & Destination regulations
37
37
38
-
The following Segment & Destination Regulations are available:
38
+
The following Segment & Destination regulations are available:
39
39
40
40
-**SUPPRESS_WITH_DELETE:** Suppress new data and delete existing data
41
41
-**DELETE_ONLY:** Delete existing data without suppressing any new data
@@ -59,34 +59,58 @@ Warehouse deletions occur using a DML run against your cluster or instance. Segm
59
59
60
60
### Deletion requests tab
61
61
62
-
The deletion requests tab shows a 30-day overview of your deletions pipeline, including a Regulations usage tracker and a deletion requests status table. The deletion requests summary tab shows the status of all your deletion requests from the last 30 days and might not accurately reflect your current deletion request limits.
62
+
The deletion requests tab shows a 30-day overview of your deletions pipeline, including a regulations usage tracker and a deletion requests status table. The deletion requests summary tab shows the status of all your deletion requests from the last 30 days and might not accurately reflect your current deletion request limits.
63
63
64
64
To navigate to the deletion requests tab, open the Segment app and navigate to **Privacy > Deletion and Suppression > Deletion**.
65
65
66
+
If you need to verify if information about a specific user was deleted or suppressed, you can search for a `userId` to view its status in Segment internal systems and in any connected destinations.
67
+
66
68
#### Regulations usage tracker
67
69
68
-
The usage tracker on the deletion requests tab shows you how many Segment & destination Regulations and how many Segment-only Regulations you have remaining for the calendar month.
70
+
The usage tracker on the deletion requests tab shows you how many Segment & destination regulations and how many Segment-only regulations you have remaining for the calendar month.
69
71
70
72
#### Deletion requests status
71
73
72
-
The deletion requests status table allows you to see the status of each of the Regulations that you've submitted, including if the Regulation was forwarded to your destinations, the deletion type, the date the Regulation was received, and the date the Regulation was completed.
74
+
The deletion requests status table allows you to see the status of each of the regulations that you've submitted, including:
75
+
- User identifier
76
+
- Regulation type
77
+
- Status of actions taken in internal Segment stores
78
+
- If the regulation was forwarded to your destinations, the status of that request
79
+
- The date that Segment received your regulation
80
+
- The date that Segment completed a regulation
81
+
82
+
To view more information about a regulation, select it from the deletion requests tab. On the side sheet for that regulation, you can view the status of your regulation within Segment and in downstream destinations, the ID of the source the regulation was coming from, and, if applicable, the reason a regulation failed.
83
+
84
+
Segment actions can have the following statuses:
85
+
86
+
-**Initialized**: Segment started processing your regulation
87
+
-**In progress**: Segment has started processing your regulation
88
+
-**Success**: Segment processed your regulation
89
+
-**Failed**: Segment was unable to process your regulation
90
+
91
+
Destination regulations can have the following statuses:
92
+
93
+
-**No action**: Segment didn't forward your regulation to a downstream destination
94
+
-**Initialized**: Segment forwarded your regulation to a downstream destination
95
+
-**In progress**: The destination started processing your regulation
96
+
-**Success**: The destination processed your regulation
97
+
-**Failed**: The destination was unable to process your regulation
98
+
73
99
74
-
> info ""
75
-
> The deletion requests status table includes requests from the past 90 days.
100
+
#### Deletion requests made using Segment's API
76
101
77
-
If you need to verify if information about a specific user was deleted or suppressed, you can search for a `userId` to view its status in Segment internal systems and in the connected destinations.
102
+
When checking the status of deletion requests using Segment's API, the deletion will report an overall status of all of the deletion processes. As a result, Segment might return a `FAILED` status because of a failure on an unsupported destination, even if the deletion from the Segment Internal Systems and supported destinations was completed successfully.
78
103
79
-
A deletion request can have one of the following statuses:
104
+
Segment's API returns the following statuses:
80
105
81
-
1.`INITIALIZED`
82
-
2.`INVALID`
83
-
3.`NOT_SUPPORTED`
84
-
4.`RUNNING`
85
-
5.`PARTIAL_SUCCESS`
86
-
6.`FAILED`
87
-
7.`FINISHED`
106
+
-`INVALID`
107
+
-`NOT_SUPPORTED`
108
+
-`RUNNING`
109
+
-`PARTIAL_SUCCESS`
110
+
-`FAILED`
111
+
-`FINISHED`
88
112
89
-
When checking the status of deletion requests using Segment's API, the deletion will report an overall status of all of the deletion processes. As a result, Segment returns a `FAILED` status because of a failure on an unsupported destination, even if the deletion from the Segment Internal Systems and supported destinations were completed successfully.
113
+
For more granular deletion request statuses, see the [Deletion requests tab](#deletion-requests-tab) in the Segment app.
0 commit comments