You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-klaviyo/index.md
+27-23Lines changed: 27 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,6 @@ id: 650bdf1a62fb34ef0a8058e1
4
4
beta: true
5
5
---
6
6
7
-
8
7
{% include content/plan-grid.md name="actions" %}
9
8
10
9
[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:
21
20
-**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.
22
21
-**Default property mappings** - Default mappings from the Segment like event, timestamp, and more, allow data to be mapped correctly without any setup required.
23
22
24
-
25
23
## Getting started
26
24
27
25
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.
29
27
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.
30
28
31
29
> 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.
34
31
35
32
{% include components/actions-fields.html %}
36
33
37
-
## Using Klaviyo with RETL
34
+
## Using Klaviyo with RETL
38
35
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.
> **\*** 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.
47
51
48
52
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.
49
53
50
-
Follow these steps to create a list in Klaviyo:
54
+
Follow these steps to create a list in Klaviyo:
51
55
52
56
1. Navigate to **Audience > Lists & Segments**.
53
57
2. Click **Create List/Segment**.
54
58
3. Choose **List**.
55
59
4. Give your list a name and add any applicable tags.
56
60
5. Click **Create List**.
57
61
58
-
59
62
## Using Klaviyo with Engage
60
63
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:
62
67
63
-
To use Klaviyo with Engage:
64
68
1. Create and configure your Engage Audience.
65
69
2. Navigate to **Engage > Engage Settings > Destinations** and click **Add Destination**.
66
70
3. Select **Klaviyo (Actions) Audiences**.
67
71
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.
73
77
10. On the **Engage > Audiences > (your audience)** page, click **Add Destination** and select the destination created.
74
78
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.
75
79
12. Click **Save Settings**.
76
80
77
-
## FAQ
81
+
## FAQ
78
82
79
-
### Dealing with 429 Responses from Klaviyo's API
83
+
### Dealing with 429 Responses from Klaviyo's API
80
84
81
85
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.
0 commit comments