Skip to content

Commit d8665ff

Browse files
authored
Merge pull request #7610 from segmentio/develop
Release 25.19.1
2 parents 983f8d6 + b7ee9e8 commit d8665ff

File tree

23 files changed

+308
-130
lines changed

23 files changed

+308
-130
lines changed

src/_data/catalog/destination_categories.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# destination categories last updated 2025-05-02
2+
# destination categories last updated 2025-05-08
33
items:
44
- display_name: A/B Testing
55
slug: a-b-testing

src/_data/catalog/destinations.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# destination data last updated 2025-05-02
2+
# destination data last updated 2025-05-08
33
items:
44
- id: 637e8d185e2dec264895ea89
55
display_name: 1Flow

src/_data/catalog/destinations_private.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# destination data last updated 2025-05-02
2+
# destination data last updated 2025-05-08
33
items:
44
- id: 54521fd925e721e32a72eee1
55
display_name: Pardot

src/_data/catalog/source_categories.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# source categories last updated 2025-05-02
2+
# source categories last updated 2025-05-08
33
items:
44
- display_name: A/B Testing
55
slug: a-b-testing

src/_data/catalog/sources.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# sources last updated 2025-05-02
2+
# sources last updated 2025-05-08
33
items:
44
- id: 8HWbgPTt3k
55
display_name: .NET

src/_data/sidenav/main.yml

+4
Original file line numberDiff line numberDiff line change
@@ -448,6 +448,10 @@ sections:
448448
title: Linked Audiences Overview
449449
- path: '/engage/audiences/linked-audiences-limits'
450450
title: Linked Audiences Limits
451+
- path: '/engage/audiences/linked-audiences-braze'
452+
title: Linked Audiences with Braze
453+
- path : '/engage/audiences/linked-audiences-iterable'
454+
title: Linked Audiences with Iterable
451455
- path: '/engage/audiences/account-audiences'
452456
title: Account-level Audiences
453457
- path: '/engage/audiences/generative-audiences'

src/connections/alerting.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ To create a source volume alert:
2424
3. On the Create alert sidesheet, enter a percentage of source volume change that you'd like to be notified for.
2525
4. Select one or more of the following alert channels:
2626
- **Email**: Select this to receive notifications at the provided email address.
27-
- **Slack**: Select this to send alerts to one or more channels in your workspace.
27+
- **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”}.
2828
- **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.
2929
5. Click **Save**.
3030

@@ -46,7 +46,7 @@ To create a successful delivery rate alert:
4646
3. On the Create alert sidesheet, enter a percentage. You will receive events if your successful delivery rate falls below this percentage.
4747
4. Select one of the following alert channels:
4848
- **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.
49-
- **Slack**: Select this and enter a Slack webhook URL and channel name to send alerts to a channel in your Slack workspace.
49+
- **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”}.
5050
- **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.
5151
5. Click **Save**.
5252

src/connections/destinations/catalog/actions-chartmogul/index.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ This destination is maintained by ChartMogul. For any issues with the destinatio
2929

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

3535
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 numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: Reddit Audiences
3+
id: 66f2b0f961bb2128729079bb
4+
---
5+
6+
{% include content/plan-grid.md name="actions" %}
7+
8+
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.
9+
10+
This destination is maintained by Reddit. For any issues with the destination, [contact their Support team](mailto:[email protected]).
11+
12+
### Reddit Requirements
13+
* Create a Reddit Ads account. * Find your ad account ID in [Accounts](https://ads.reddit.com/accounts).
14+
15+
### Connect Reddit Ads to your workspace
16+
17+
## Getting started
18+
19+
1. In your Segment workspace, click **Engage** in the left navigation bar, then select your space.
20+
2. Click **Engage Settings** and select the **Destinations** tab.
21+
3. Search for `Reddit Audiences`.
22+
4. Click **Add Destination**.
23+
5. Confirm the source. By default, this is the source connected to the space to which you’re adding the destination.
24+
6. In the **Settings** tab, click **Connect to Reddit Audiences** and authenticate the connection between Segment and Reddit.
25+
7. Provide your ad account ID for **Ad Account ID**.
26+
8. Toggle **Enable Destination** on and click **Save Changes**.
27+
9. Navigate to the engage space that contains the audience, and select it in the **Audiences** tab.
28+
10. Click **Add Destination**.
29+
30+
{% include components/actions-fields.html %}

src/connections/destinations/catalog/actions-reddit-conversions-api/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ id: 66cc766ef4b1c152177239a0
55

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

8-
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.
8+
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.
99

1010
### Benefits of Reddit Conversions API
1111

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: Trubrics (Actions) Destination
3+
id: 664ce847b3e6f19ea96b3611
4+
private: true
5+
hidden: true
6+
---
7+
8+
{% include content/plan-grid.md name="actions" %}
9+
10+
[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.
11+
12+
This destination is maintained by Trubrics. For any issues with the destination, [contact their Support team](mailto:[email protected]).
13+
14+
## Getting started
15+
16+
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank”}, search for "Trubrics".
17+
2. Select Trubrics and click **Add Destination**.
18+
3. Select an existing source to connect to Trubrics (Actions).
19+
4. Go to the [Trubrics app](https://app.trubrics.com){:target="_blank"}, and copy the **Project API key** from the settings page.
20+
5. Enter the **Project API Key** in the Trubrics destination settings in Segment, then enable the destination.
21+
6. Add mappings for your AI/user properties.
22+
- To learn more about adding mappings, see [Trubrics <> Segment Mapping Events](https://www.loom.com/share/3bc3a02cf38d47b4b865c50314dbc8fb){:target="_blank”}.
23+
24+
<!--- TODO: write this instead of having it in a video --->
25+
26+
{% include components/actions-fields.html %}

src/connections/reverse-etl/manage-retl.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ To subscribe to alerts for a failed or partially successful sync:
8484
- **Reverse ETL sync partial success**: Receive a notification when your Reverse ETL sync is partially successful.
8585
4. Select one or more of the following alert options:
8686
- **Enable email notifications**: Enter an email address or alias that should receive alerts.
87-
- **Enable Slack notifications**: Enter a webhook URL and Slack channel name.
87+
- **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”}.
8888
- **Enable in-app notifications**: Select this option to see an in-app notification.
8989
5. Click **Create alert**.
9090

@@ -124,7 +124,7 @@ To subscribe to alerts for successful delivery fluctuations at the mapping level
124124
3. Set an *alert threshold*, or the percentage of successfully delivered events that would prompt an alert.
125125
4. Select one or more of the following notification channels:
126126
- **Email**: Enter an email address or alias that should receive alerts.
127-
- **Slack notification**: Enter a Webhook URL and a Slack channel name to receive alerts in a Slack channel.
127+
- **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”}.
128128
- **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.
129129
5. Toggle the **Enable alert** setting on and click **Create**.
130130

src/connections/sources/catalog/cloud-apps/qualtrics/index.md

+9-9
Original file line numberDiff line numberDiff line change
@@ -8,43 +8,43 @@ This is an [Event Cloud Source](/docs/sources/#event-cloud-sources) which can no
88

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

11-
> info "Beta Source"
12-
> 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])!_
11+
> info "Beta source"
12+
> 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]).
1313
1414
## Getting started
1515

1616
1. From your workspace's [Sources catalog page](https://app.segment.com/goto-my-workspace/sources/catalog){:target="_blank”} click **Add Source**.
1717
2. Search for "Qualtrics" in the Sources Catalog, select Qualtrics, and click **Add Source**.
18-
3. On the next screen, give the Source a nickname configure any other settings.
18+
3. On the next screen, give the source a nickname configure any other settings.
1919
- 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).
2020
4. Click **Add Source** to save your settings.
21-
5. Log in to your Qualtrics Account. Navigate to workflows, select a workflow to send Segment events from, and add a new Segment task.
21+
5. Log in to your Qualtrics Account. Navigate to Workflows, select a workflow to send Segment events from, and add a new Segment task.
2222
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.
2323
- Your workspace token will need Source Admin permissions, at a minimum.
2424
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"}.
2525

2626
## Stream
2727

28-
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.
28+
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.
2929

3030
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.
3131

3232
## Events
3333

3434
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.
3535

36-
## Event Properties
36+
## Event properties
3737

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

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

43-
## Adding Destinations
43+
## Adding destinations
4444

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

47-
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.
47+
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.
4848

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

src/engage/audiences/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -288,7 +288,7 @@ To create an Activation event health spikes or drops alert:
288288
4. Enter a percentage threshold to trigger activation event health notifications.
289289
5. Select one or more of the following alert channels:
290290
- **Email**: Select this to receive notifications at the provided email address.
291-
- **Slack**: Select this to send alerts to one or more channels in your workspace.
291+
- **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”}.
292292
- **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.
293293
6. Click **Save**.
294294

src/engage/audiences/linked-audiences-braze.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,16 @@
22
title: Using Linked Audiences with Braze
33
plan: engage-foundations
44
beta: true
5-
hidden: true
5+
hidden: false
66
---
77

88

99
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.
1010

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

1312
## Supported Braze Engagement Tools
1413

15-
The following engagement tools are available for use with Linked Audiences in Segment:
14+
The following engagement tool is available for use with Linked Audiences in Segment:
1615

1716
| Type | Description |
1817
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |

src/engage/audiences/linked-audiences-iterable.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,11 @@
22
title: Using Linked Audiences with Iterable
33
plan: engage-foundations
44
beta: true
5-
hidden: true
5+
hidden: false
66
---
77

88
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.
99

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

1211
## Supported Iterable Engagement Tools
1312

0 commit comments

Comments
 (0)