Skip to content

Release 25.19.1 #7610

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

Merged
merged 54 commits into from
May 8, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
54 commits
Select commit Hold shift + click to select a range
b918bc2
reddit audience doc v1
Mar 12, 2025
d477c0a
create reddit audience doc
Mar 24, 2025
41fbab2
reddit doc updates
Apr 17, 2025
4b92bed
add faq about catpref error
forstisabella May 2, 2025
73a302f
Merge pull request #7596 from segmentio/DOC-1099
forstisabella May 2, 2025
c95283d
Merge pull request #7598 from segmentio/master
forstisabella May 2, 2025
3c33167
add workflow + schedule info
forstisabella May 2, 2025
19e1ba5
Add description field to entities/relationships
LLuque-twilio May 2, 2025
e43dd94
[netlify-build]
LLuque-twilio May 2, 2025
b4edef9
uppercase Segment
LLuque-twilio May 2, 2025
2cbe76a
PR suggestions
LLuque-twilio May 5, 2025
77a86c5
Update entity description
LLuque-twilio May 5, 2025
97ef86f
Update ChartMogul destination documentation
ldrobnik May 6, 2025
c25ded7
Merge pull request #7601 from ldrobnik/patch-1
forstisabella May 6, 2025
9c7ebc3
init plus overview
pwseg May 7, 2025
90eba2a
add table explaining differences
pwseg May 7, 2025
185af94
Add section explaining filtering
pwseg May 7, 2025
c495560
add rest of structure
pwseg May 7, 2025
ddfcc4a
add comparison table
pwseg May 7, 2025
c6fd844
let's wrap it up
pwseg May 7, 2025
0c46415
more links
pwseg May 7, 2025
5f22905
add beta callout [netlify-build]
pwseg May 7, 2025
1fb767e
rename file
pwseg May 7, 2025
aa15007
capitalize Identity Resolution [netlify-build]
pwseg May 7, 2025
e7caa79
delete wrong file [netlify-build]
pwseg May 7, 2025
f9517c7
Apply suggestions from code review
stayseesong May 7, 2025
b944e80
Update src/unify/data-graph/index.md
stayseesong May 7, 2025
31786ae
Merge pull request #7600 from segmentio/DG-573/datagraph
stayseesong May 7, 2025
e7a026c
unhide linked audiences braze and iterable
stayseesong May 7, 2025
4f0cd36
updates after PM feedback [netlify-build]
pwseg May 8, 2025
0431490
Merge pull request #7603 from segmentio/DOC-1113
stayseesong May 8, 2025
b17e17e
Tweaked formatting
sade-wusi May 8, 2025
67ab254
Added missing period
sade-wusi May 8, 2025
1dde805
Merge pull request #7605 from segmentio/Whats-next-period
sade-wusi May 8, 2025
cc8b4fb
edits to install page
rchinn1 May 8, 2025
db9bce5
more small fixes
rchinn1 May 8, 2025
f5c979d
Merge pull request #7604 from segmentio/Qualtrics-docs-quick-fix
sade-wusi May 8, 2025
a1d9729
Merge pull request #7606 from segmentio/random-edits
rchinn1 May 8, 2025
9960a6d
add ID
pwseg May 8, 2025
ac1273c
Merge pull request #7519 from akhsueh/reddit-audience-doc
pwseg May 8, 2025
fe9316f
add user alert tab
forstisabella May 8, 2025
c318fcc
add Trubrics destination docs
pwseg May 8, 2025
6c2fbc9
catalog update
pwseg May 8, 2025
3aef337
Update src/unify/event-filtering.md
pwseg May 8, 2025
e517773
Update src/unify/event-filtering.md
pwseg May 8, 2025
18bea72
Update src/unify/event-filtering.md
pwseg May 8, 2025
218b0b0
Update src/unify/event-filtering.md
pwseg May 8, 2025
8c45910
Update src/connections/destinations/catalog/trubrics/index.md
pwseg May 8, 2025
56033e2
Update src/connections/destinations/catalog/trubrics/index.md
pwseg May 8, 2025
9a16424
Merge pull request #7607 from segmentio/users-alerts
forstisabella May 8, 2025
e3ac177
Merge pull request #7608 from segmentio/trubrics-destination-docs
pwseg May 8, 2025
1a22330
Merge pull request #7602 from segmentio/unify-event-filtering-public-…
pwseg May 8, 2025
e9e70dd
Merge pull request #7599 from segmentio/DOC-1106
forstisabella May 8, 2025
b7ee9e8
Merge pull request #7609 from segmentio/catalog-update-8-5-2025
pwseg May 8, 2025
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-05-02
# destination categories last updated 2025-05-08
items:
- display_name: A/B Testing
slug: a-b-testing
Expand Down
2 changes: 1 addition & 1 deletion 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-05-02
# destination data last updated 2025-05-08
items:
- id: 637e8d185e2dec264895ea89
display_name: 1Flow
Expand Down
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-05-02
# destination data last updated 2025-05-08
items:
- id: 54521fd925e721e32a72eee1
display_name: Pardot
Expand Down
2 changes: 1 addition & 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-05-02
# source categories last updated 2025-05-08
items:
- display_name: A/B Testing
slug: a-b-testing
Expand Down
2 changes: 1 addition & 1 deletion 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-05-02
# sources last updated 2025-05-08
items:
- id: 8HWbgPTt3k
display_name: .NET
Expand Down
4 changes: 4 additions & 0 deletions src/_data/sidenav/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -448,6 +448,10 @@ sections:
title: Linked Audiences Overview
- path: '/engage/audiences/linked-audiences-limits'
title: Linked Audiences Limits
- path: '/engage/audiences/linked-audiences-braze'
title: Linked Audiences with Braze
- path : '/engage/audiences/linked-audiences-iterable'
title: Linked Audiences with Iterable
- path: '/engage/audiences/account-audiences'
title: Account-level Audiences
- path: '/engage/audiences/generative-audiences'
Expand Down
4 changes: 2 additions & 2 deletions src/connections/alerting.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ To create a source volume alert:
3. On the Create alert sidesheet, enter a percentage of source volume change that you'd like to be notified for.
4. Select one or more of the following alert channels:
- **Email**: Select this to receive notifications at the provided email address.
- **Slack**: Select this to send alerts to one or more channels in your workspace.
- **Slack**: Select this to send alerts to one or more channels in your workspace. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
- **In-app**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
5. Click **Save**.

Expand All @@ -46,7 +46,7 @@ To create a successful delivery rate alert:
3. On the Create alert sidesheet, enter a percentage. You will receive events if your successful delivery rate falls below this percentage.
4. Select one of the following alert channels:
- **Email**: Select this to receive notifications at either the email address associated with your account or another email address that you enter into this field.
- **Slack**: Select this and enter a Slack webhook URL and channel name to send alerts to a channel in your Slack workspace.
- **Slack**: Select this to send alerts to one or more channels in your workspace. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
- **In-app**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
5. Click **Save**.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ This destination is maintained by ChartMogul. For any issues with the destinatio

## Supported event calls
ChartMogul (Actions) accepts two types of event calls:
- [Track](https://segment.com/docs/connections/spec/track/){:target="_blank"} — used for contact details and custom attributes
- [Group](https://segment.com/docs/connections/spec/group/){:target="_blank"} — used for customer details and custom attributes
- [Identify](https://segment.com/docs/connections/spec/identify/){:target="_blank"} — used for contact details
- [Group](https://segment.com/docs/connections/spec/group/){:target="_blank"} — used for customer details

ChartMogul uses attributes from these calls to create new or update existing [custom attributes](https://help.chartmogul.com/hc/en-us/articles/206120219){:target="_blank"} for contacts or customers, or to update customers' select [standard attributes](https://help.chartmogul.com/hc/en-us/articles/5321255006364#standard-attributes){:target="_blank"}.
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: Reddit Audiences
id: 66f2b0f961bb2128729079bb
---

{% include content/plan-grid.md name="actions" %}

The Reddit Audiences destination allows advertisers to send Engage audiences from Segment to Reddit to use as [Custom Audiences](https://business.reddithelp.com/s/article/custom-audiences?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank"}, which can be used for Reddit Ads features like audience targeting, retargeting, creating lookalike audiences, and engagement retargeting.

This destination is maintained by Reddit. For any issues with the destination, [contact their Support team](mailto:[email protected]).

### Reddit Requirements
* Create a Reddit Ads account. * Find your ad account ID in [Accounts](https://ads.reddit.com/accounts).

### Connect Reddit Ads to your workspace

## Getting started

1. In your Segment workspace, click **Engage** in the left navigation bar, then select your space.
2. Click **Engage Settings** and select the **Destinations** tab.
3. Search for `Reddit Audiences`.
4. Click **Add Destination**.
5. Confirm the source. By default, this is the source connected to the space to which you’re adding the destination.
6. In the **Settings** tab, click **Connect to Reddit Audiences** and authenticate the connection between Segment and Reddit.
7. Provide your ad account ID for **Ad Account ID**.
8. Toggle **Enable Destination** on and click **Save Changes**.
9. Navigate to the engage space that contains the audience, and select it in the **Audiences** tab.
10. Click **Add Destination**.

{% include components/actions-fields.html %}
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ id: 66cc766ef4b1c152177239a0

{% include content/plan-grid.md name="actions" %}

The [Reddit Conversions API](https://business.reddithelp.com/helpcenter/s/article/Conversions-API/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank} allows advertisers to send conversion events from Segment directly to Reddit, without needing website code. By building a sustainable server-side connection more resilient to signal loss, you can gain stronger campaign performance with improved measurement, targeting, and optimization.
The [Reddit Conversions API](https://ads-api.reddit.com/docs/v2/#tag/Conversions-API){:target="_blank"} allows advertisers to send conversion events from Segment directly to Reddit, without needing website code. By building a sustainable server-side connection more resilient to signal loss, you can gain stronger campaign performance with improved measurement, targeting, and optimization.

### Benefits of Reddit Conversions API

Expand Down
26 changes: 26 additions & 0 deletions src/connections/destinations/catalog/trubrics/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: Trubrics (Actions) Destination
id: 664ce847b3e6f19ea96b3611
private: true
hidden: true
---

{% include content/plan-grid.md name="actions" %}

[Trubrics](https://trubrics.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} provides self-serve product analytics for AI product teams. On top of regular product analytics to understand user behavior, Trubrics helps you understand how your AI is performing and how to improve it.

This destination is maintained by Trubrics. For any issues with the destination, [contact their Support team](mailto:[email protected]).

## Getting started

1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”}, search for "Trubrics".
2. Select Trubrics and click **Add Destination**.
3. Select an existing source to connect to Trubrics (Actions).
4. Go to the [Trubrics app](https://app.trubrics.com){:target="_blank"}, and copy the **Project API key** from the settings page.
5. Enter the **Project API Key** in the Trubrics destination settings in Segment, then enable the destination.
6. Add mappings for your AI/user properties.
- To learn more about adding mappings, see [Trubrics <> Segment Mapping Events](https://www.loom.com/share/3bc3a02cf38d47b4b865c50314dbc8fb){:target="_blank”}.

<!--- TODO: write this instead of having it in a video --->

{% include components/actions-fields.html %}
4 changes: 2 additions & 2 deletions src/connections/reverse-etl/manage-retl.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ To subscribe to alerts for a failed or partially successful sync:
- **Reverse ETL sync partial success**: Receive a notification when your Reverse ETL sync is partially successful.
4. Select one or more of the following alert options:
- **Enable email notifications**: Enter an email address or alias that should receive alerts.
- **Enable Slack notifications**: Enter a webhook URL and Slack channel name.
- **Enable Slack notifications**: Enter a webhook URL and Slack channel name. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
- **Enable in-app notifications**: Select this option to see an in-app notification.
5. Click **Create alert**.

Expand Down Expand Up @@ -124,7 +124,7 @@ To subscribe to alerts for successful delivery fluctuations at the mapping level
3. Set an *alert threshold*, or the percentage of successfully delivered events that would prompt an alert.
4. Select one or more of the following notification channels:
- **Email**: Enter an email address or alias that should receive alerts.
- **Slack notification**: Enter a Webhook URL and a Slack channel name to receive alerts in a Slack channel.
- **Slack notification**: Enter a Webhook URL and a Slack channel name to receive alerts in a Slack channel. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
- **In-app notifications**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
5. Toggle the **Enable alert** setting on and click **Create**.

Expand Down
18 changes: 9 additions & 9 deletions src/connections/sources/catalog/cloud-apps/qualtrics/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,43 +8,43 @@ This is an [Event Cloud Source](/docs/sources/#event-cloud-sources) which can no

Qualtrics maintains this source. For any issues with the source, [contact the Qualtrics Support team](mailto:[email protected]).

> info "Beta Source"
> The Qualtrics Source is in beta, which means that they are still actively developing the source. This doc was last updated on February 15, 2023. If you are interested in joining their beta program or have any feedback to help improve the Qualtrics Source and its documentation, [let the Qualtrics team know](mailto:[email protected])!_
> info "Beta source"
> The Qualtrics Source is in beta, which means that they are still actively developing the source. This doc was last updated on February 15, 2023. If you are interested in joining their beta program or have any feedback to help improve the Qualtrics source and its documentation, [let the Qualtrics team know](mailto:[email protected]).

## Getting started

1. From your workspace's [Sources catalog page](https://app.segment.com/goto-my-workspace/sources/catalog){:target="_blank”} click **Add Source**.
2. Search for "Qualtrics" in the Sources Catalog, select Qualtrics, and click **Add Source**.
3. On the next screen, give the Source a nickname configure any other settings.
3. On the next screen, give the source a nickname configure any other settings.
- The nickname is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The nickname can be anything, but Segment recommends using something that reflects the source itself and distinguishes amongst your environments (for example, SourceName_Prod, SourceName_Staging, or SourceName_Dev).
4. Click **Add Source** to save your settings.
5. Log in to your Qualtrics Account. Navigate to workflows, select a workflow to send Segment events from, and add a new Segment task.
5. Log in to your Qualtrics Account. Navigate to Workflows, select a workflow to send Segment events from, and add a new Segment task.
6. From within the Segment task, after connecting with your Segment workspace API token, select your Qualtrics source and continue to set up the task with the event, data mapping, and more.
- Your workspace token will need Source Admin permissions, at a minimum.
7. For more information on the Qualtrics Segment task, view the [Qualtrics support page](https://www.qualtrics.com/support/integrations/twilio-segment/twilio-segment-task/){:target="_blank"}.

## Stream

Qualtrics uses Segment's stream Source component to send Segment event data. It uses a server-side (select from `track` and `identify`) method(s) to send data to Segment. These events are then available in any destination that accepts server-side events and are available in a schema in your data warehouse, so you can query using SQL.
Qualtrics uses Segment's stream source component to send Segment event data. It uses a server-side (select from `track` and `identify`) method(s) to send data to Segment. These events are then available in any destination that accepts server-side events and are available in a schema in your data warehouse, so you can query using SQL.

Qualtrics allows you to configure the userId from various sources from within the Qualtrics platform, for example, data from a survey response or a XM Directory contact's external data reference. The anonymous ID can also be configured from within Qualtrics task setup.

## Events

Use the Qualtrics integration to define the event to be sent to Segment from within the task. This can be customized for a particular use case such as 'Onboarding Survey Completed' which could be the event based on a response to a particular survey. Another example may be 'Contact Updated' based on XM Directory change. These events can be tailored to align with your existing process or particular use case.

## Event Properties
## Event properties

The Qualtrics integration allows you to define event properties within the following constraints:

- Use `Track` events to define the `properties` object
- Use `Identify` events to define the `traits` object

## Adding Destinations
## Adding destinations

Now that your Source is set up, you can connect it with Destinations.
Now that your source is set up, you can connect it with destinations.

Log into your downstream tools and verify that events and properties appear the way you expect. If events and properties don’t appear as you expect them to, check the [Event Delivery](/docs/connections/event-delivery/) tool, and refer to the Destination docs for each tool for troubleshooting.
Log into your downstream tools and verify that events and properties appear the way you expect. If events and properties don’t appear as you expect them to, check the [Event Delivery](/docs/connections/event-delivery/) tool, and refer to the destination docs for each tool for troubleshooting.

If there are any issues with how the events are arriving to Segment, [contact the Qualtrics support team](mailto:[email protected]).

2 changes: 1 addition & 1 deletion src/engage/audiences/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -288,7 +288,7 @@ To create an Activation event health spikes or drops alert:
4. Enter a percentage threshold to trigger activation event health notifications.
5. Select one or more of the following alert channels:
- **Email**: Select this to receive notifications at the provided email address.
- **Slack**: Select this to send alerts to one or more channels in your workspace.
- **Slack**: Select this to send alerts to one or more channels in your workspace. You can post messages to your channel with either a [webhook](https://api.slack.com/messaging/webhooks){:target="_blank”} or a [workflow](https://slack.com/help/articles/360041352714-Build-a-workflow--Create-a-workflow-that-starts-outside-of-Slack){:target="_blank”}.
- **In-app**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app.
6. Click **Save**.

Expand Down
5 changes: 2 additions & 3 deletions src/engage/audiences/linked-audiences-braze.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,16 @@
title: Using Linked Audiences with Braze
plan: engage-foundations
beta: true
hidden: true
hidden: false
---


Linked Audiences allows you [dynamically personalize email messages](https://www.braze.com/docs/user_guide/personalization_and_dynamic_content/liquid){:target="_blank"} in Braze using the predefined traits of any Linked Audience profile and the attributes of any entities used to match the profile into the audience.

The following topic is intended for a Technical Marketer and Data Engineer to complete together while setting up their Linked Audience.

## Supported Braze Engagement Tools

The following engagement tools are available for use with Linked Audiences in Segment:
The following engagement tool is available for use with Linked Audiences in Segment:

| Type | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
Expand Down
3 changes: 1 addition & 2 deletions src/engage/audiences/linked-audiences-iterable.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,11 @@
title: Using Linked Audiences with Iterable
plan: engage-foundations
beta: true
hidden: true
hidden: false
---

Linked Audiences allows you to [dynamically personalize email messages](https://support.iterable.com/hc/en-us/articles/205480365-Personalizing-Templates-with-Handlebars){:target="_blank"} in Iterable using the predefined traits of any Linked Audience profile and the attributes of any entities used to match the profile into the audience.

The following topic is intended for a Technical Marketer and Data Engineer to complete together while setting up their Linked Audience.

## Supported Iterable Engagement Tools

Expand Down
Loading
Loading