Skip to content

Commit 6982c37

Browse files
Merge pull request #6512 from segmentio/develop
Release 24.19.1
2 parents 687447a + b9d2932 commit 6982c37

File tree

26 files changed

+295
-77
lines changed

26 files changed

+295
-77
lines changed

src/_data/catalog/destination_categories.yml

Lines changed: 1 addition & 1 deletion
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 2024-05-02
2+
# destination categories last updated 2024-05-07
33
items:
44
- display_name: A/B Testing
55
slug: a-b-testing

src/_data/catalog/destinations.yml

Lines changed: 72 additions & 4 deletions
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 2024-05-02
2+
# destination data last updated 2024-05-07
33
items:
44
- id: 637e8d185e2dec264895ea89
55
display_name: 1Flow
@@ -3280,6 +3280,18 @@ items:
32803280
This is currently in Beta Testing and not generally available.
32813281
required: false
32823282
label: 'Merchandising Events '
3283+
- name: oAuthClientId
3284+
type: string
3285+
defaultValue: ''
3286+
description: Client ID for your OAuth Server-to-Server Credential
3287+
required: false
3288+
label: OAuth Client ID
3289+
- name: oAuthClientSecret
3290+
type: password
3291+
defaultValue: ''
3292+
description: Client Secret for your OAuth Server-to-Server Credential
3293+
required: false
3294+
label: OAuth Client Secret
32833295
- name: pageNameFallbackToScreen
32843296
type: boolean
32853297
defaultValue: false
@@ -27371,6 +27383,64 @@ items:
2737127383
actions: []
2737227384
presets: []
2737327385
partnerOwned: false
27386+
- id: 662d3328d029f89724a0c294
27387+
display_name: events.win
27388+
name: events.win
27389+
slug: events-win
27390+
hidden: false
27391+
endpoints:
27392+
- US
27393+
regions:
27394+
- us-west-2
27395+
- eu-west-1
27396+
url: connections/destinations/catalog/events-win
27397+
previous_names:
27398+
- events.win
27399+
website: http://www.events.win
27400+
status: PUBLIC_BETA
27401+
categories:
27402+
- Analytics
27403+
- Customer Success
27404+
logo:
27405+
url: https://cdn-devcenter.segment.com/79396f25-00b5-4364-8f84-3461e63880ca.svg
27406+
mark:
27407+
url: https://cdn-devcenter.segment.com/c2a3d938-1db7-4b72-a9d0-8af638830182.svg
27408+
methods:
27409+
track: false
27410+
identify: false
27411+
group: false
27412+
alias: false
27413+
screen: false
27414+
page: false
27415+
platforms:
27416+
browser: true
27417+
mobile: true
27418+
server: true
27419+
warehouse: false
27420+
cloudAppObject: false
27421+
components: []
27422+
browserUnbundlingSupported: false
27423+
browserUnbundlingPublic: false
27424+
replay: false
27425+
connection_modes:
27426+
device:
27427+
web: false
27428+
mobile: false
27429+
server: false
27430+
cloud:
27431+
web: true
27432+
mobile: true
27433+
server: true
27434+
settings:
27435+
- name: apiKey
27436+
type: string
27437+
defaultValue: ''
27438+
description: Your events.win developer key
27439+
required: true
27440+
label: Developer Key
27441+
actions: []
27442+
presets: []
27443+
partnerOwned: true
2737427444
- id: 5fdce712dc1fbc625ebd13b8
2737527445
display_name: Everflow
2737627446
name: Everflow
@@ -62021,7 +62091,7 @@ items:
6202162091
previous_names:
6202262092
- Listrak (Actions)
6202362093
website: https://www.listrak.com/
62024-
status: PUBLIC_BETA
62094+
status: PUBLIC
6202562095
categories:
6202662096
- Marketing Automation
6202762097
- Email Marketing
@@ -81825,8 +81895,6 @@ items:
8182581895
categories:
8182681896
- CRM
8182781897
- Analytics
81828-
- Marketing Automation
81829-
- Personalization
8183081898
logo:
8183181899
url: https://cdn.filepicker.io/api/file/Gs7h3XjXTAW94s1zQbNJ
8183281900
mark:

src/_data/catalog/destinations_private.yml

Lines changed: 1 addition & 1 deletion
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 2024-05-02
2+
# destination data last updated 2024-05-07
33
items:
44
- id: 54521fd925e721e32a72eee1
55
display_name: Pardot

src/_data/catalog/source_categories.yml

Lines changed: 1 addition & 1 deletion
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 2024-05-02
2+
# source categories last updated 2024-05-07
33
items:
44
- display_name: A/B Testing
55
slug: a-b-testing

src/_data/catalog/sources.yml

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# sources last updated 2024-05-02
2+
# sources last updated 2024-05-07
33
items:
44
- id: 8HWbgPTt3k
55
display_name: .NET
@@ -1776,14 +1776,16 @@ items:
17761776
description: >-
17771777
When you enter your Salesforce credentials and hit save, we will sync
17781778
Salesforce standard objects (and their corresponding properties) to any
1779-
databases you have turned on.
1779+
databases you have turned on. Salesforce data will reflect the state of
1780+
the object at the time of the sync. We will run an update every ~3 hours.
1781+
| Sync Salesforce standard objects and their corresponding properties to
1782+
any of your databases every ~ 3 hours.
17801783
1784+
Salesforce data reflects the state of the obiect at the time of the svnc.
17811785
1782-
Salesforce data will reflect the state of the object at the time of the
1783-
sync.
1784-
1785-
1786-
We will run an update every ~3 hours.
1786+
To create and update Profiles with Salesforce data, use the Segment
1787+
Profiles destination. This destination lets you send your Salesforce data
1788+
to Segment as Identify calls.
17871789
logo:
17881790
url: https://d3hotuclm6if1r.cloudfront.net/logos/salesforce-default.svg
17891791
categories:

src/_data/sidenav/main.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -515,6 +515,8 @@ sections:
515515
title: Configure Consent Management
516516
- path: /privacy/consent-management/consent-in-unify/
517517
title: Consent in Unify
518+
- path: /privacy/consent-management/consent-faq/
519+
title: Consent FAQs
518520
- path: /privacy/account-deletion
519521
title: Account & Data Deletion
520522
- path: /privacy/hipaa-eligible-segment

src/connections/destinations/actions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,7 +181,7 @@ If necessary, click **New Mapping** to create a new, blank action.
181181
4. Set up the data mapping from the Segment format to the destination tool format.
182182
- You can click the Source field, then select the **Enrichments** tab to view and select Enrichments to use.
183183
5. Test the mapping with data from a sample event.
184-
The edit panel shows you the mapping output in the format for the destination tool. You can change your mapping as needed and re-test.
184+
The edit panel shows you the mapping output in the format for the destination tool. The **Select Object** option sends the entire object from the event, while the **Edit Object** option lets you map each individual property. You can change your mapping as needed and re-test.
185185
6. When you're satisfied with the mapping, click **Save**. Segment returns you to the Mappings table.
186186
7. In the Mappings table **Status** column, verify that the **Enabled** toggle is on for the mapping you just customized.
187187

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
title: ChartMogul (Actions) Destination
3+
id: 65f9888628c310646331738a
4+
beta: true
5+
hidden: true
6+
private: true
7+
---
8+
9+
10+
{% include content/plan-grid.md name="actions" %}
11+
12+
[ChartMogul](https://chartmogul.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank"} is a subscription analytics platform and CRM used by thousands of businesses to measure, understand, and grow their recurring revenue businesses.
13+
14+
This destination is maintained by ChartMogul. For any issues with the destination, [contact their Support team](https://help.chartmogul.com/hc/en-us/requests/new){:target="_blank"}.
15+
16+
## Getting started
17+
18+
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank"} search for "ChartMogul".
19+
2. Select ChartMogul and click **Add Destination**.
20+
3. Select an existing Source to connect to ChartMogul (Actions).
21+
4. [Create a source](https://app.chartmogul.com/#/data-platform/sources/add-source){:target="_blank"} in ChartMogul.
22+
5. Make sure the **Account / Contact / Enrichment data** tab is selected and click **Twilio Segment**.
23+
6. Enter the **Name** for your source.
24+
7. Under **Create a company in ChartMogul when** select:
25+
- **the email or UserID is created** — if you recognize any individual who interacts with your organization as a lead and want to create a [customer record](https://help.chartmogul.com/hc/en-us/articles/214085765){:target="_blank"} for them
26+
- **user is added to a company** — if you recognize an individual who interacts with your organization as a lead only if they're part of an organization
27+
8. Copy the **Webhook URL**.
28+
9. Click **SAVE AND CONTINUE CONFIGURATION IN SEGMENT**.
29+
10. Paste the **Webhook URL** in the ChartMogul destination settings in Segment.
30+
31+
{% include components/actions-fields.html %}
32+
33+
## Supported event calls
34+
ChartMogul (Actions) accepts two types of event calls:
35+
- [Track](https://segment.com/docs/connections/spec/track/){:target="_blank"} — used for contact details and custom attributes
36+
- [Group](https://segment.com/docs/connections/spec/group/){:target="_blank"} — used for customer details and custom attributes
37+
38+
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"}.

src/connections/destinations/catalog/actions-google-enhanced-conversions/index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,3 +127,6 @@ This error indicates that the conversion action specified in the upload request
127127

128128
To resolve this, ensure that the ConversionActionType value in Google Ads is correctly configured.
129129

130+
### `The required field was not present., at conversions[0].gclid` Error
131+
132+
Events going to Google for this integration require a `GCLID` field, an `email`, or a `phone_number`. If one of those identifiers isn't being sent properly, then you may see the `The required field was not present., at conversions[0].gclid` error. To fix this, please double check that at least one of those fields is being passed to Google on each payload.

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

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,6 @@ id: 652ea51a327a62b351aa12c0
1010

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

13-
> success ""
14-
> This page is about the [Actions-framework](/docs/connections/destinations/actions/) Kameleoon Segment destination. There's also a page about the [non-Actions Kameleoon destination](/docs/connections/destinations/catalog/kameleoon/). Both of these destinations receive data from Segment.
15-
16-
1713
## Benefits of Kameleoon (Actions) vs Kameleoon Classic
1814

1915
Kameleoon (Actions) provides the following benefits over the classic Kameleoon destination:

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

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ id: 650bdf1a62fb34ef0a8058e1
44
beta: true
55
---
66

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

109
[Klaviyo](https://www.klaviyo.com){:target="_blank"} is a powerful email platform focused on ecommerce that helps companies make more money. It supports segmentation based on category and event triggers like product bought, page viewed, email engagement, or amount spent.
@@ -21,61 +20,66 @@ Klaviyo (Actions) provides the following benefits:
2120
- **More control** - Actions-based destinations enable you to define the mapping between the data Segment receives from your sources, and the data Segment sends to Klaviyo.
2221
- **Default property mappings** - Default mappings from the Segment like event, timestamp, and more, allow data to be mapped correctly without any setup required.
2322

24-
2523
## Getting started
2624

2725
1. From the Segment web app, click **Catalog**.
28-
2. Search for *Klaviyo (Actions)* in the Catalog, select it, and choose which of your sources to connect the destination to.
26+
2. Search for **Klaviyo (Actions)** in the Catalog, select it, and choose which of your sources to connect the destination to.
2927
3. Navigate to [Account > Settings > API Keys](https://www.klaviyo.com/account#api-keys-tab){:target="_blank"} in Klaviyo's UI and copy your API Key into the Segment Settings UI.
3028

3129
> info ""
32-
> Klaviyo requires the Private API Key to use the List API. You can find this by going to Klaviyo's UI and clicking [Account > Settings > API Keys > Create API Key](https://www.klaviyo.com/account#api-keys-tab){:target="_blank"} to generate a Private API Key and copy it into the Segment Settings UI.
33-
30+
> Klaviyo requires the Private API Key to use the List API. You can find this by going to Klaviyo's UI and clicking [Account > Settings > API Keys > Create API Key](https://www.klaviyo.com/account#api-keys-tab){:target="_blank"} to generate a Private API Key and copy it into the Segment Settings UI.
3431
3532
{% include components/actions-fields.html %}
3633

37-
## Using Klaviyo with RETL
34+
## Using Klaviyo with RETL
3835

39-
Klaviyo (Actions) Destination can accept [RETL](/docs/connections/reverse-etl/) data. You can send the models you created in your data warehouse source. Follow [the steps](/docs/connections/reverse-etl/#step-1-add-a-source) to create your data warehouse source and set up models.
36+
Klaviyo (Actions) Destination can accept [RETL](/docs/connections/reverse-etl/) data. You can send the models you created in your data warehouse source. Follow [the steps](/docs/connections/reverse-etl/#step-1-add-a-source) to create your data warehouse source and set up models.
4037

38+
| Action | Added | Updated | Deleted |
39+
| ------------------- | ------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------- |
40+
| Order Completed | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> |
41+
| Track Event | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> |
42+
| Upsert Profile | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> |
43+
| Remove Profile | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> | <img class="inline" src="/docs/images/supported.svg" /> |
44+
| Subscribe Profile | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> | <img class="inline" src="/docs/images/supported.svg" /> **\*** |
45+
| Unsubscribe Profile | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> | <img class="inline" src="/docs/images/supported.svg" /> |
4146

42-
| Action | Added | Updated | Deleted |
43-
| -------------- | --------------- | -------------- | --------------- |
44-
| Order Completed | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> |
45-
| Track Event | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> |
46-
| Upsert Profile | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/supported.svg" /> | <img class="inline" src="/docs/images/unsupported.svg" /> |
47+
> info ""
48+
> **\*** Though technically possible, it may not be the most intuitive approach to using RETL.
49+
>
50+
> **e.g.,** Triggering a **Subscribe Profile** action when a user is **deleted** from a Model that queries unsubscribed users.
4751
4852
In order to add users to a list, use the **Upsert Profile** Action and fill out the **List** field with the Klaviyo list to add the profile to.
4953

50-
Follow these steps to create a list in Klaviyo:
54+
Follow these steps to create a list in Klaviyo:
5155

5256
1. Navigate to **Audience > Lists & Segments**.
5357
2. Click **Create List/Segment**.
5458
3. Choose **List**.
5559
4. Give your list a name and add any applicable tags.
5660
5. Click **Create List**.
5761

58-
5962
## Using Klaviyo with Engage
6063

61-
Klaviyo (Actions) Destination can accept your [Engage](/docs/engage/) data. You **don't** need to create a list in Klaviyo. During the first sync, Segment creates a list with the same name as your audience.
64+
Klaviyo (Actions) Destination can accept your [Engage](/docs/engage/) data. If you wish to add a profile to a list associated with the Engage audienceId, you **don't** need to create a list in Klaviyo. During the first sync with the **Add Profile To List (Engage)** Mapping, Segment creates a list with the same ID as your audience.
65+
66+
To add and remove profiles in Klaviyo with Engage Audience data:
6267

63-
To use Klaviyo with Engage:
6468
1. Create and configure your Engage Audience.
6569
2. Navigate to **Engage > Engage Settings > Destinations** and click **Add Destination**.
6670
3. Select **Klaviyo (Actions) Audiences**.
6771
4. Select your Audience Space as the source, and name your destination.
68-
5. On the **Mappings** tab, click **Add Mapping** and select **Add Profile To List**.
69-
6. Click **Save** and make sure to enable the mapping.
70-
7. On the **Mappings** tab, click **Add Mapping** and select **Remove Profile from list**.
71-
8. Click **Save** and make sure you enable the mapping.
72-
9. Enable the destination.
72+
5. On the **Mappings** tab, click **Add Mapping** and select **Add Profile To List (Engage)**.
73+
6. Click **Save** and make sure to enable the mapping.
74+
7. On the **Mappings** tab, click **Add Mapping** and select **Remove Profile from List (Engage)**.
75+
8. Click **Save** and make sure you enable the mapping.
76+
9. Enable the destination.
7377
10. On the **Engage > Audiences > (your audience)** page, click **Add Destination** and select the destination created.
7478
11. In the settings that appear in the side panel, toggle the **Send Track** option on, and don't change the **Audience Entered/Audience Exited** event names.
7579
12. Click **Save Settings**.
7680

77-
## FAQ
81+
## FAQ
7882

79-
### Dealing with 429 Responses from Klaviyo's API
83+
### Dealing with 429 Responses from Klaviyo's API
8084

8185
If you're encountering rate limiting issues, consider enabling batching for the Action receiving these errors. Ensure that within the mapping configuration, "Batch data to Klaviyo" is set to "Yes". This adjustment can help alleviate the rate limiting problem.

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

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,6 @@ id: 64b6a221baf168a989be641a
55

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

8-
> info ""
9-
> The Listrak Destination is in beta, and Listrak is still developing the destination. To join Listrak's beta program or to give any feedback to help improve the Listrak Destination and its documentation, [let Listrak know](mailto:[email protected]).
10-
118
[Listrak](https://www.listrak.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is the retail industry’s leading customer engagement platform. Listrak delivers results for more than 1,000 retailers by providing best-in-class email, text message marketing, identity resolution marketing and push notifications through seamless cross-channel orchestration. Listrak’s data-first approach delivers 1:1 personalization at scale so you can send messages at precisely the right time across the right combination of channels and devices to maximize customer engagement, revenue, and lifetime value.
129

1310
Listrak maintains this destination. For any issues with the destination, [contact the Listrak Support team](mailto:[email protected]).
Loading

0 commit comments

Comments
 (0)