Fides Documentation – Ethyca
Segment
This Integration requires Fides Cloud or Fides Enterprise. For more information, talk to our solutions team.
Segment is a customer data platform (CDP) that helps businesses collect and manage customer data. Currently we support two types of integrations for Segment: the basic Segment, which allows for delete requests, and Segment Unify, which requires a Unify subscription but allows for access and delete requests.
Prerequisites
Segment
An owned database must be configured to store Segment data for privacy request processing. To learn how to integrate with a database, please see our guide for integrating with databases.
In order to integrate with Segment, you'll need to collect the following information:
| Name | Description |
|---|---|
| Workspace* | Your Segment workspace ID. See Segment's guide on workspaces. |
| Public API token* | Your Segment access token. Follow Segment's guide for creating access tokens. |
| segment_user_id* | The dataset reference to the user ID set up when calling the identify endpoint. |
Unify
This integration requires the Business plan for Segment, and Segment Unify set up correctly. In order to integrate with Segment, you'll need to collect the following information:
| Name | Description |
|---|---|
| Profiles domain* | The Segment profiles API URL, recommended to use the default (default: profiles.segment.com) |
| Public API token* | Your Segment access token. Follow Segment's guide for creating access tokens. |
| Space ID* | Your Segment space ID. See Segment's guide on spaces. |
| Unify token* | Your access secret for your profiles domain. Follow Segment's docs to retrieve this info. |
| Regulation type | The Segment Regulation to use for the data protection request. Options: DELETE_INTERNAL, DELETE_ONLY, SUPPRESS_ONLY, SUPPRESS_WITH_DELETE, SUPPRESS_WITH_DELETE_INTERNAL |
Integrating with Segment
To integrate an existing system with Segment:
- Navigate to Data map → View Systems and choose the system that you want to connect.
- Click on the Integrations tab.
- Pick the vendor or system type that you want to integrate with from the Connection type drop-down menu.
- Complete the required fields for the integration and click Save.
You may confirm your connection is working using the Test connection button, if desired.
To learn more, please see our guide for Managing Integrations.
Technical detail
Fides utilizes API endpoints to access the API service for a SaaS application. An API service is the programmatic interface through which Fides can query and update data within an application to access, rectify, or delete personal information. Each SaaS tool will have a unique set of endpoints to enable privacy functions.
Segment endpoints
In the table below, you can find which endpoints are used for each type of privacy function. Clicking on the endpoint will take you to the documentation for that endpoint.
| Privacy function | Endpoint | Description |
|---|---|---|
| Access Requests | Segment user | Used to retrieve profile metadata. |
| Access Requests | Track events | Used to retrieve a profile's historical events |
| Access Requests | Traits | Used to retrieve a profile's traits |
| Access Requests | External IDs | Used to retrieve a profile's external IDs |
| Delete Requests | Data protection request | Used to suppress a user or delete all their information. |