Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release 25.11.01 #7495

Merged
merged 17 commits into from
Mar 13, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/_data/catalog/destination_categories.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# destination categories last updated 2025-03-06
# destination categories last updated 2025-03-13
items:
- display_name: A/B Testing
slug: a-b-testing
65 changes: 32 additions & 33 deletions src/_data/catalog/destinations.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# destination data last updated 2025-03-06
# destination data last updated 2025-03-13
items:
- id: 637e8d185e2dec264895ea89
display_name: 1Flow
@@ -24785,9 +24785,8 @@ items:
defaultValue: false
description: >-
To indicate that you trust the Braze dashboard users to write
non-malicious Javascript click actions, set this property to true. If
enableHtmlInAppMessages is true, this option will also be set to true.
[See more
non-malicious Javascript click actions, set this property to true. [See
more
details](https://js.appboycdn.com/web-sdk/latest/doc/modules/appboy.html#initializationoptions)
required: false
label: Allow User Supplied Javascript
@@ -24970,7 +24969,7 @@ items:
label: Safari Website Push ID
- name: sdkVersion
type: select
defaultValue: '4.10'
defaultValue: '5.7'
description: The version of the Braze SDK to use
required: true
label: SDK Version
@@ -25020,7 +25019,7 @@ items:
hidden: false
defaultTrigger: type = "track" and event != "Order Completed"
fields:
- id: 6Q1QaSvy8Uwaj1FXX1nQim
- id: cukzCb87uaU2p4u8ohjME2
sortOrder: 0
fieldKey: eventName
label: Event Name
@@ -25034,7 +25033,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: rCF4hvZL1FfBLZqypECaYN
- id: c9mVckYcn4Wma6GST3dbM8
sortOrder: 1
fieldKey: eventProperties
label: Event Properties
@@ -25056,7 +25055,7 @@ items:
hidden: false
defaultTrigger: type = "identify" or type = "group"
fields:
- id: h7m1HSpMDMMkrwyQ4Y2pwH
- id: oHKabHpBg5j7Ptyw1KochB
sortOrder: 0
fieldKey: external_id
label: External User ID
@@ -25070,7 +25069,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: eeCv1kJYS3BMG3PV6m49tM
- id: mCgX5vrcoWCjhX8ArNd8LM
sortOrder: 1
fieldKey: country
label: Country
@@ -25084,7 +25083,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: maHTDJD6jjaPyGeqAeCAWB
- id: jajZSnCT2VfzdyE35fUY7s
sortOrder: 2
fieldKey: current_location
label: Current Location
@@ -25096,7 +25095,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: qxtRJD9EezUBUpoCrs9T1d
- id: whCL4yMYdUqJPBhY7ckFPo
sortOrder: 3
fieldKey: custom_attributes
label: Custom Attributes
@@ -25112,7 +25111,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: 4ZEyKQrLYop2FmwrhyozB3
- id: 374Eou91wYoPReMsvT133M
sortOrder: 4
fieldKey: dob
label: Date of Birth
@@ -25124,7 +25123,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: ns3C16DRH3Jfjdyw29e9jc
- id: XefuTRKzCXk1WFTSZHMGB
sortOrder: 5
fieldKey: email
label: Email
@@ -25138,7 +25137,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: wbPyLK2tqmGHmtYUQFP8SX
- id: 3VawYKCQaGRPZtVY3iTQU1
sortOrder: 6
fieldKey: email_subscribe
label: Email Subscribe
@@ -25153,7 +25152,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: wPfiYFTdjsWg7FrNhSTzgA
- id: 23miZHHhNEoygvre6nJXT3
sortOrder: 7
fieldKey: first_name
label: First Name
@@ -25167,7 +25166,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: 6fshCvxdyQvM2Vj6thn5sm
- id: qrJRwk1wpF7fzJy3EiGRdP
sortOrder: 8
fieldKey: last_name
label: Last Name
@@ -25181,7 +25180,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: htenqgZoB34c7XTYBUxDE4
- id: ki23d4BnuEobRLxWeVZ8fa
sortOrder: 9
fieldKey: gender
label: Gender
@@ -25197,7 +25196,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: vUvwztZVwVTZ6mf6u7r2ia
- id: vJBEuhf5CH9UbM8c1uQmuw
sortOrder: 10
fieldKey: home_city
label: Home City
@@ -25211,7 +25210,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: d8ogAxX7WgUUFXuHh7wcdR
- id: oa99uH3YvjCkmN4EL5afyw
sortOrder: 11
fieldKey: image_url
label: Image URL
@@ -25225,7 +25224,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: r8WtFganYGATKoW6Dxfc7C
- id: qVZP45KbNKZG95cyai361p
sortOrder: 12
fieldKey: language
label: Language
@@ -25237,7 +25236,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: fEvwmPnSLsg7MSzEKnpLWY
- id: vdHMhfUtGcv4pFu2VEg9qJ
sortOrder: 13
fieldKey: phone
label: Phone Number
@@ -25251,7 +25250,7 @@ items:
choices: null
dynamic: false
allowNull: true
- id: bJEZPpwKnTzTmNrBCafDMr
- id: n6ikM63GPBrhVaShTzgRK3
sortOrder: 14
fieldKey: push_subscribe
label: Push Subscribe
@@ -25266,7 +25265,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: qeprmWFJtkaC27aBhS5tt4
- id: eadWfdFpZMg3JcGrNttSZp
sortOrder: 15
fieldKey: subscription_groups
label: Subscription Groups
@@ -25291,7 +25290,7 @@ items:
hidden: false
defaultTrigger: type = "track" and event = "Order Completed"
fields:
- id: wxZJp2DL8VbeS7QXe8tqv9
- id: a5fFQx9QtGVPT6XuifL3pJ
sortOrder: 0
fieldKey: purchaseProperties
label: Purchase Properties
@@ -25311,7 +25310,7 @@ items:
choices: null
dynamic: false
allowNull: false
- id: 8BkKtPyxuPNYzcWTcokXJc
- id: 3HmbbFCBeyXjYx24Nr3Pfr
sortOrder: 1
fieldKey: products
label: Products
@@ -25326,6 +25325,14 @@ items:
dynamic: false
allowNull: false
presets:
- actionId: uL67YU9rAsuT4cp4dNNmBu
name: Order Completed calls
fields:
purchaseProperties:
'@path': $.properties
products:
'@path': $.properties.products
trigger: type = "track" and event = "Order Completed"
- actionId: fRZrfm4TC5JL3AGeRnLk3W
name: Track Calls
fields:
@@ -25360,14 +25367,6 @@ items:
subscription_groups:
'@path': $.traits.braze_subscription_groups
trigger: type = "identify" or type = "group"
- actionId: uL67YU9rAsuT4cp4dNNmBu
name: Order Completed calls
fields:
purchaseProperties:
'@path': $.properties
products:
'@path': $.properties.products
trigger: type = "track" and event = "Order Completed"
partnerOwned: false
- id: 6241e78214aad278a6322f52
display_name: Breyta CRM
2 changes: 1 addition & 1 deletion src/_data/catalog/destinations_private.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# destination data last updated 2025-03-06
# destination data last updated 2025-03-13
items:
- id: 54521fd925e721e32a72eee1
display_name: Pardot
9 changes: 9 additions & 0 deletions src/_data/catalog/regional-supported.yml
Original file line number Diff line number Diff line change
@@ -285,6 +285,15 @@ sources:
- us
endpoints:
- us
- id: UYaQxaZO3a
display_name: Editable Profile Source Metadata
hidden: true
slug: editable-profile-source-metadata
url: connections/sources/catalog/cloud-apps/editable-profile-source-metadata
regions:
- us
endpoints:
- us
- id: VETiUX9u66
display_name: Elastic Path
hidden: false
4 changes: 3 additions & 1 deletion src/_data/catalog/source_categories.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# source categories last updated 2025-03-06
# source categories last updated 2025-03-13
items:
- display_name: A/B Testing
slug: a-b-testing
@@ -23,6 +23,8 @@ items:
slug: feature-flagging
- display_name: Helpdesk
slug: helpdesk
- display_name: INTERNAL
slug: internal
- display_name: Learning Management System
slug: learning-management-system
- display_name: Livechat
34 changes: 29 additions & 5 deletions src/_data/catalog/sources.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
# sources last updated 2025-03-06
# sources last updated 2025-03-13
items:
- id: 8HWbgPTt3k
display_name: .NET
@@ -14,7 +14,9 @@ items:
- us
- eu
source_type: server
description: ''
description: >-
The hassle-free way to add Segment analytics to your .Net app (Unity,
Xamarin, Net, CSharp, C#)
logo:
url: https://cdn.filepicker.io/api/file/niuGBxqqSQCLvBDIFxpY
categories:
@@ -207,7 +209,7 @@ items:
source_type: mobile
description: >-
The hassle-free way to add Segment analytics to your swift app (iOS,
macOS, tvOS).
macOS, tvOS, ipadOS).
logo:
url: https://cdn.filepicker.io/api/file/qWgSP5cpS7eeW2voq13u
categories:
@@ -644,6 +646,24 @@ items:
- Attribution
status: PUBLIC_BETA
partnerOwned: false
- id: UYaQxaZO3a
display_name: Editable Profile Source Metadata
isCloudEventSource: false
slug: editable-profile-source-metadata
url: connections/sources/catalog/cloud-apps/editable-profile-source-metadata
hidden: false
regions:
- us
endpoints:
- us
source_type: cloud-app
description: this is internal source to track the editable profile feature internally.
logo:
url: https://cdn.filepicker.io/api/file/618XEphQoWXwBKQGOWNw
categories:
- INTERNAL
status: PUBLIC
partnerOwned: false
- id: VETiUX9u66
display_name: Elastic Path
isCloudEventSource: true
@@ -2439,7 +2459,9 @@ items:
endpoints:
- us
source_type: mobile
description: The hassle-free way to add Segment analytics to your Unity app.
description: >-
The hassle-free way to add Segment analytics to your Unity app (Unity,
Xamarin, Net, CSharp, C#)
logo:
url: https://cdn.filepicker.io/api/file/TrFnszJ7Rj6LNZTt4kP5
categories:
@@ -2588,7 +2610,9 @@ items:
- us
- eu
source_type: mobile
description: ''
description: >-
The hassle-free way to add Segment analytics to your Xamarin app (Unity,
Xamarin, Net, CSharp, C#)
logo:
url: https://cdn.filepicker.io/api/file/dx6hyOr7S7qEZkTtzNMj
categories:
2 changes: 1 addition & 1 deletion src/connections/storage/catalog/bigquery/index.md
Original file line number Diff line number Diff line change
@@ -40,7 +40,7 @@ To create a service account for Segment:
2. Click **Create Service Account**.
3. Enter a name for the service account (for example, `segment-warehouses`) and click **Create**.
4. Assign the service account the following roles:
- `BigQuery Data Owner`
- `BigQuery Data Owner` or `BigQuery Data Editor`
- `BigQuery Job User`
5. [Create a JSON key](https://cloud.google.com/iam/docs/creating-managing-service-account-keys){:target="_blank"}.
The downloaded file will be used to create your warehouse in the Segment app.
47 changes: 41 additions & 6 deletions src/privacy/data-retention-policy.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: Data Retention and Deletion Policy
hidden: true
---

Twilio Segment’s Data Retention and Deletion Policy provides clarity, consistency and compliance across all Segment services and brings Segment’s data retention policy in line with industry standards and regulations. By implementing and enforcing this policy, Segment aims to enhance data governance and ensure that Segment customers can manage their data accurately, efficiently and securely within clearly defined retention periods.
@@ -36,9 +35,45 @@ The default data retention period for each of the data types is as follows:
| **Team** | 365 days | Not applicable | 90 days | 365 days | Not applicable |
| **Free** | 180 days | Not applicable | 60 days | 180 days | Not applicable |

Through the self-serve Data Retention configuration in your workspace, you can configure a custom data retention period through the **Workspace Default Archive Retention Period** setting.
Through the self-serve Data Retention configuration in your workspace, you can configure a custom data retention period through the [Workspace Default Archive Retention Period](#workspace-default-archive-retention-period) setting.

Segment recommends keeping your data for at least 30 days to enable [replays](/docs/guides/what-is-replay/) of your data.

To change your data retention settings, open Segment and navigate to **Privacy > Settings > Data Retention**.

### Workspace Default Archive Retention Period

Select the default retention period for the workspace in this setting. This value applies to all sources in the workspace, unless overridden in the [Source-Level Archive Retention Periods](#source-level-archive-retention-periods) setting.

> warning "7 day Retention Periods will be deprecated on March 6, 2025"
> After March 6, you will no longer be able to set your workspace's retention period to 7 days. All workspaces with 7 day retention periods will be updated to have 14 day retention periods.
You can select from the following Archive Retention time periods:

- 14 days
- 30 days
- 90 days
- 180 days
- 365 days
- Unlimited (**default**)

### Source-Level Archive Retention Periods

> warning "Source-Level Archive Retention Periods will be deprecated on April 15, 2025"
> After April 15, you will no longer be able to override your workspace's default retention period on a source-by-source basis.
Override the workspace default retention period on a per-source level.

You can select from the following Archive Retention time periods:

- Default (This is the default value you set in the [Workspace Default Archive Retention Period](#workspace-default-archive-retention-period))
- 14 days
- 30 days
- 90 days
- 180 days
- 365 days
- Unlimited

Segment unrecoverably deletes a [Unify Space](/docs/unify/identity-resolution/space-setup/#step-one-create-a-new-dev-space) 90 days after it was disabled.

### What data is impacted?

@@ -48,7 +83,7 @@ With this data retention policy, all data beyond the retention period is unrecov
* Backfill Data is only available for data within the retention period.
* [Data residency](/docs/guides/regional-segment/) migrations across regions (US and EU) is only available for data within the retention period.
* Additional impacts to Object data:
* Cloud Object Data (using push) updated using the [Object API](/docs/connections/sources/catalog/libraries/server/object-api/#set), [Bulk API](docs/connections/sources/catalog/libraries/server/object-bulk-api/), or webhook cloud sources (for example, [SendGrid](/docs/connections/sources/catalog/cloud-apps/sendgrid/#streaming) or [Mandrill](/docs/connections/sources/catalog/cloud-apps/mandrill/#streaming)): Any data older than 180 days is treated as a new record and may not contain any historic properties. To prevent loss of data properties, Segment recommends that you always send full objects with all properties.
* Cloud Object Data (using push) updated using the [Object API](/docs/connections/sources/catalog/libraries/server/object-api/#set), [Bulk API](/docs/connections/sources/catalog/libraries/server/object-bulk-api/), or webhook cloud sources (for example, [SendGrid](/docs/connections/sources/catalog/cloud-apps/sendgrid/#streaming) or [Mandrill](/docs/connections/sources/catalog/cloud-apps/mandrill/#streaming)): Any data older than 180 days is treated as a new record and may not contain any historic properties. To prevent loss of data properties, Segment recommends that you always send full objects with all properties.
* Users and Accounts: Segment aggregates data from Identify and Group events for entities active within the last 180 days. Any data older than 180 days is treated as a new record and won't have historic properties. To prevent loss of data properties, Segment advises customers to migrate to using Profile Sync.
* [Computed traits](/docs/unify/Traits/computed-traits/) is built using the available data within the retention period. Recreating these traits may result in different values based on the available data.
* [Profiles](/docs/unify/), [Engage](/docs/engage/) [Audiences](/docs/engage/audiences/) and [Journeys](/docs/engage/journeys/) that are built using Events will use available data within the retention period. Recreating these may result in different Profiles based on the available data. Depending on how the conditions are defined, Profiles may or may not exit Computed traits, Engage Audiences, and Journeys due to the data retention policy, and this may result in mismatches in counts when comparing against a preview.
@@ -58,7 +93,7 @@ With this data retention policy, all data beyond the retention period is unrecov
With this policy the following data is not impacted, but may be subject to other policies:

* **Cloud Object Data (using pull)**: This involves Segment fetching object data from third party Cloud Sources. Since Segment always fetches the full objects, the retention policy will have no impact.
* **Profiles**: Unify Profiles created are not subject to this data retention policy.
* **Profiles**: Unify Profiles, Identifiers, and Traits created are not subject to this data retention policy.
* **Third Party Destinations**: Data in your third party destinations shared by Segment in the course of your implementation remains unaffected. Data stored in a third party system may be subject to the data retention policy of that system.
* Anything a user creates in the Segment App, like Audiences, Journeys, Data Graphs, Connections, and more, **are not subject to this data retention policy**.

@@ -114,4 +149,4 @@ Segment unrecoverably deletes the workspace after 30 days of inactivity, unless

### Data deletion delays

When data reaches the end of its retention period, deletion is scheduled in accordance with Segment’s data retention policy. While Segment aims to complete the deletion process promptly, there may be occasional delays due to processing times or technical constraints. Segment is committed to initiating data deletions as soon as possible and strives to complete deletions within 7 days of the scheduled date.
When data reaches the end of its retention period, deletion is scheduled in accordance with Segment’s data retention policy. While Segment aims to complete the deletion process promptly, there may be occasional delays due to processing times or technical constraints. Segment is committed to initiating data deletions as soon as possible and strives to complete deletions within 7 days of the scheduled date.
45 changes: 2 additions & 43 deletions src/privacy/user-deletion-and-suppression.md
Original file line number Diff line number Diff line change
@@ -102,49 +102,8 @@ Segment creates a `SUPPRESS` regulation, and adds the `userId` to your suppressi
> info "SUPPRESS_WITH_DELETE requests"
> The Suppressed Users tab only includes `SUPPRESS_ONLY` regulations. If you created a User Deletion request using the UI, you will need to check the [**Deletion Requests**](#deletion-requests-tab) tab, as those are `SUPPRESS_WITH_DELETE` regulation types.
##### Remove a user from the suppression list {#remove-a-user-from-the-suppression-list}
##### Remove a user from the suppression list

To remove a user from the suppression list, click the ellipses (**...**) icon on the `userId` row, and click **Remove**.

This creates an `UNSUPPRESS` regulation and removes the `userId` from your suppression list. Segment processes most `UNSUPPRESS` regulations within 24 hours.

## Data retention

Segment stores a copy of all event data received in Segment's secure event archives on S3. By default, all workspaces store data for an unlimited period of time, but you can modify the lifecycle policies for the data stored internally. Segment uses this data for [data replays](/docs/guides/what-is-replay/) and for troubleshooting purposes.

Segment recommends keeping your data for at least 30 days to enable [replays](/docs/guides/what-is-replay/) of your data.

To change your data retention settings, open Segment and navigate to **Privacy > Settings > Data Retention**.

### Workspace Default Archive Retention Period

Select the default retention period for the workspace in this setting. This value applies to all sources in the workspace, unless overridden in the [Source-Level Archive Retention Periods](#source-level-archive-retention-periods) setting.

> warning "7 day Retention Periods will be deprecated on March 6, 2025"
> After March 6, you will no longer be able to set your workspace's retention period to 7 days. All workspaces with 7 day retention periods will be updated to have 14 day retention periods.
You can select from the following Archive Retention time periods:

- 14 days
- 30 days
- 90 days
- 180 days
- 365 days
- Unlimited (**default**)

### Source-Level Archive Retention Periods

> warning "Source-Level Archive Retention Periods will be deprecated on April 15, 2025"
> After April 15, you will no longer be able to override your workspace's default retention period on a source-by-source basis.
Override the workspace default retention period on a per-source level.

You can select from the following Archive Retention time periods:

- Default (This is the default value you set in the [Workspace Default Archive Retention Period](#workspace-default-archive-retention-period))
- 14 days
- 30 days
- 90 days
- 180 days
- 365 days
- Unlimited
This creates an `UNSUPPRESS` regulation and removes the `userId` from your suppression list. Segment processes most `UNSUPPRESS` regulations within 24 hours.
2 changes: 1 addition & 1 deletion src/unify/Traits/predictions/index.md
Original file line number Diff line number Diff line change
@@ -88,7 +88,7 @@ This table lists the requirements for a trait to compute successfully:
| Event Types | Track at least 5 different event types in the Feature Window. |
| Historical Data | Ensure these 5 events have data spanning 1.5 times the length of the Target Window. For example, to predict a purchase propensity over the next 60 days, at least 90 days of historical data is required. |
| Subset Audience (if applicable) | Ensure the audience contains more than 1 non-anonymous user. |
| User Limit | Ensure that you are making a prediction for fewer than 100 million users. If you track more than 100 million users in your space, define a smaller audience in the **Make a Prediction For** section of the custom predictions builder. |
| User Limit | Ensure that you are making a prediction for fewer than 20 million users. If you track more than 20 million users in your space, define a smaller audience in the **Make a Prediction For** section of the custom predictions builder. |
| User Activity | At least 100 users performing the Target Event and at least 100 users not performing the Target Event. |

#### Selecting events (optional)