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-marketo-static-lists/index.md
+18-22Lines changed: 18 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,38 +14,28 @@ Marketo Static Lists (Actions) is a rebuild of the classic destination that prov
14
14
15
15
## Overview
16
16
17
-
The Marketo Static Lists (Actions) destination lets you sync audiences created using [Engage](/docs/engage)into Marketo as a **List**. Once you create the audience, Segment sends that list of users to Marketo, and keeps it up to date as users enter and exit the audience specification.
17
+
The Marketo Static Lists (Actions) destination lets you sync users into Marketo as a **List**.
18
18
19
19
This allows you to run email campaigns in Marketo without having to manually find and upload a refreshed csv of users. This documentation explains how to set up Marketo in Segment, and what to expect in your Marketo UI.
20
20
21
21
22
22
## Details
23
23
24
24
-**Supports Engage**: Yes
25
+
-**Supports RETL**: Yes
25
26
-**Engage Destination type**: List
26
27
-**Must create audience_name field before Engage can update those values?**: No. You don't need to create the _list_ in Marketo, however you do need to create the folder Segment will create the list in.
27
28
-**Audience appears as**: A list in the folder you created, in the Marketo Lead Database under Group Lists.
28
29
-**Destination rate limit**: 100 calls per 20 seconds, which is shared among all third-party API services
29
30
-**Lookback window allowed**: Yes
30
-
-**Identifiers required**: Email
31
-
-**Identifiers accepted**: Email
32
31
-**Client or Server-Side Connection**: Server-side
33
32
34
-
35
-
## How it works
36
-
37
-
Every time you create an audience in Engage and connect it to Marketo Static Lists, Segment does the following:
38
-
39
-
1. Creates a list with the same name as the Engage audience in the folder designated for Engage.
40
-
2. Adds any users to that list who both fit the audience definition and have an email address.
41
-
3. If a user has multiple email addresses on their identity graph, each email address becomes a unique entry on the list.
42
-
4. After the audience is configured, Segment checks which users still fit the audience definition, and adds or removes users from the audience.
43
33
{% include content/sync-frequency-note.md %}
44
34
45
35
## Configuring Marketo Static Lists
46
36
47
37
> success "Good to know:"
48
-
> To set up Marketo to receive Engage data, you need Marketo administrator access. If you don't have that access, work with the administrator for your organization.
38
+
> To set up Marketo, you need Marketo administrator access. If you don't have that access, work with the administrator for your organization.
49
39
50
40
### Step 1: Create an API-Only Marketo user
51
41
@@ -60,7 +50,7 @@ In this step, you'll create an API-Only Marketo user with both Access API and Le
60
50

61
51
62
52
63
-
### Step 2: Create a Marketo Launchpoint Service for Engage
53
+
### Step 2: Create a Marketo Launchpoint Service
64
54
65
55
1. Go to **Admin** → **Integration**→ **LaunchPoint** → **New**
66
56
2. Create a new service. In the Service field, select `Custom`, and in the **API Only User** field, select the user you created in step 1.
@@ -69,7 +59,6 @@ In this step, you'll create an API-Only Marketo user with both Access API and Le
69
59

70
60
71
61
72
-
73
62
### Step 3: Create a Marketo Lead Database folder and get your Marketo Endpoint
74
63
75
64
1. Go to your Marketo Lead Database and create a new folder under Group Lists. Once connected, each Engage audience shows up as a list in this folder.
@@ -82,7 +71,7 @@ In this step, you'll create an API-Only Marketo user with both Access API and Le
82
71
> warning "Warning:"
83
72
> Do not create a list in the folder for the audience. Segment creates the list for you!
84
73
85
-
### Step 4: Set up the Marketo Static Lists (Actions) destination in Engage
74
+
### Using Marketo Static Lists (Actions) destination with Engage
86
75
87
76
1. From your Segment workspace, go to **Engage → Engage Settings → Destinations→ Add Destination** and then Search for Marketo Static Lists (Actions).
88
77
2. In the destination settings, enter the **Client Id**, **Client Secret**, **Endpoint** and **Folder Name** from the LaunchPoint service and folder you created in Steps 2 and 3. For **Endpoint**, note the Endpoint from Step 3.
@@ -91,14 +80,21 @@ In this step, you'll create an API-Only Marketo user with both Access API and Le
91
80
6. Click **Save** and make sure to enable the mapping.
92
81
7. On the **Mappings** tab, click **Add Mapping** and select **Remove from List**.
93
82
8. Click **Save** and make sure you enable the mapping.
83
+
9. Navigate to the Engage Audiences tab and create a new audience.
84
+
10. Give your audience a name, some event and trait criteria, then click **Preview**.
85
+
11. Select Marketo Static Lists as a destination for the Audience.
86
+
12. 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.
87
+
13. Click **Save Settings**.
88
+
89
+
### Using Marketo Static Lists (Actions) destination with RETL
94
90
95
-
### Step 5: Create Engage audiences and add Marketo Static Lists as a destination
91
+
1. Navigate to your data warehouse and add Marketo Static Lists (Actions) as a destination.
92
+
2. From your model, click **Add Mapping** and select your Marketo Marketo Static Lists (Actions) destination and the **Add to List** Action.
93
+
3. If you already have a list created in Marketo, fill in the List ID field. If you want Segment to create a list in Marketo, fill in the List name field.
94
+
4. Finish setting up the rest of the action.
95
+
5. Click **Save Mapping**.
96
96
97
-
1. Navigate to the Engage Audiences tab and create a new audience.
98
-
2. Give your audience a name, some event and trait criteria, then click **Preview**.
99
-
3. Select Marketo Static Lists as a destination for the Audience.
100
-
4. 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.
101
-
12. Click **Save Settings**.
97
+
When you save the mapping, a list will be created in Marketo. You can update the list the mapping syncs to at any time.
102
98
103
99
> info ""
104
100
> Only users with an email address appear in the list in Marketo. Users with multiple email addresses as external ids appear in the list once for each email address.
0 commit comments