Consent in Segment Connections
Consent Management is available to customers on Business tier plans.
See the available plans, or contact Support.
Segment Connections users can add the consent object to their sources to stamp events with the end user consent preferences captured by your consent management platform (CMP) and send them downstream to destinations in categories that an end user consented to share data with. Events without the consent object continue to flow to destinations without consent enforcement.
With the Destination Actions framework, you can send current end user consent preferences to flow to your destination alongside customer interactions so your destinations know when an end user revokes their consent.
For more information about sharing current end user consent preferences with your downstream destinations, see the Sharing consent with Actions destinations documentation.
For more information about configuring consent categories, see the Configure Consent Management documentation.
If your sources also contain the integrations object, Segment will look at the consent object first, and then take into account the integrations object according to the table in the Reconcile consent object and integrations object documentation.
Unify users must send an additional event to add consent preferences to Profiles
If you use Unify, see the Consent in Unify documentation for more information about the Segment Consent Preference Updated event, which Segment uses with the consent object to add consent preference to Profiles.
Consent object
Segment requires every event from all of your sources to include the end user consent preferences, captured by your CMP or your application logic, in the form of the consent object. The consent object is a JSON object nestled inside of the context object with the following format:
The JSON keys in the consent object should represent the categoryId for each consent category.
{
"context": {
"consent": {
"categoryPreferences": {
"Advertising": true,
"Analytics": false,
"Functional": true,
"DataSharing": false
}
}
}
}
Events without the consent object will continue to flow to destinations without consent enforcement.
Reconcile consent conflicts
Segment resolves conflicts between your consent object and your integration object and between your CMP and the consent categories you configured in the Segment app.
Reconcile consent object and integrations object conflicts
You can add both the integrations object and the consent object to your Segment payloads for greater control over how Segment routes data to your downstream destinations.
For more information about the Integrations object, please see Filtering your Segment Data.
If an event includes both an integrations and consent object, Segment will look at the consent object first, and then take into account the integrations object according to the following table:
| Consent Object | Integration Object | Result |
|---|---|---|
Not provided or empty consent object "context": { } OR "context": { "consent": { }} |
Not provided or empty object | Data flows to all destinations. |
Empty categoryPreference object "context": { "consent": { "categoryPreference": { } } } |
Not provided or empty object | Data does NOT flow to any mapped destinations - consent is considered to be false for all categories. Data flows to all destinations NOT mapped to a consent category. |
Not provided "context": { } |
{facebook: true,amplitude: false} |
Data flows to the destinations that are true in the integrations object (Facebook). Any metadata provided in the integrations object also flows to your downstream destinations. |
Empty consent object "context": { "consent": { }} OR "context": { "consent": { "categoryPreference": { } } } |
{facebook: true,amplitude: false} |
Data does NOT flow to any mapped destinations - consent is considered to be false for all categories. Data flows to all destinations NOT mapped to a consent category, destinations set to true in the integrations object, and destinations not included in the integrations object. |
{ad: true, analytics: false}Segment has no category-to-destination mapping for ad and analytics |
Provided, not provided, or empty object | Data flows to all destinations, as all destinations are unmapped. If the integrations object is present, data flow may be impacted. |
{ad: true, analytics: false}ad = facebook, google-ads |
Not provided or empty object | Data flows to destinations that map to a consented purpose. In this case, data flows to all ad destinations (Facebook and Google Ads). No data flows to analytics destinations. |
{ad: true, analytics: false}ad = facebook, google-ads analytics = amplitude |
{facebook: true,amplitude: false} |
Data flows to all ad destinations, even though Google Ads is not present in the integrations object. Data does NOT flow to analytics destinations. |
{ad: true, analytics: false}ad = facebook, google-ads analytics = amplitude |
{facebook: false,amplitude: false} |
Data only flows to Google Ads and not to Facebook, which is false in the integrations object. Data does NOT flow to analytics destinations. |
{ad: true, analytics: false}ad = facebook, google-ads analytics = facebook, amplitude |
{facebook: true,amplitude: false} |
When destinations are mapped to multiple categories, data only flows if consent is true for all categories. In this case, data only flows to Google Ads and not to Facebook. Data does NOT flow to analytics destinations. |
{ad: true, analytics: true}ad = facebook, google-ads analytics = facebook, amplitude |
{facebook: true,amplitude: false} |
When destinations are mapped to multiple categories, data only flows if consent is true for all categories. In this case, data flows to Google Ads and Facebook. No data flows to Amplitude because it is false in the integrations object. |
{ad: false, analytics: true} ad = facebook, google-ads analytics = facebook, amplitude |
{facebook: true,amplitude: false} |
When destinations are mapped to multiple categories, data only flows if consent is true for all categories. In this example, data does NOT flow to any destination because of the interaction between the integrations and consent objects. |
Reconcile CMP and Segment consent category conflicts
If you have a category configured in your consent management tool (for example, advertising) and there is no category with the same ID in Segment, the data will flow to unmapped destinations. If destinations are mapped to a different category in the Segment app, data flow will honor end user consent for that category.
If there is a category configured in Segment (functional) that is not mapped in your CMP, data will not flow to destinations mapped to the functional category.
Content observability
Events discarded due to consent preferences appear in Delivery Overview at the “Filtered at destination” step with the discard reason Filtered by end user consent.
This page was last modified: 13 Jun 2024
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!