Skip to content

Commit 36aa2d6

Browse files
committed
Add RETL
1 parent aca4d4b commit 36aa2d6

File tree

1 file changed

+18
-22
lines changed
  • src/connections/destinations/catalog/actions-marketo-static-lists

1 file changed

+18
-22
lines changed

src/connections/destinations/catalog/actions-marketo-static-lists/index.md

Lines changed: 18 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -14,38 +14,28 @@ Marketo Static Lists (Actions) is a rebuild of the classic destination that prov
1414

1515
## Overview
1616

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**.
1818

1919
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.
2020

2121

2222
## Details
2323

2424
- **Supports Engage**: Yes
25+
- **Supports RETL**: Yes
2526
- **Engage Destination type**: List
2627
- **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.
2728
- **Audience appears as**: A list in the folder you created, in the Marketo Lead Database under Group Lists.
2829
- **Destination rate limit**: 100 calls per 20 seconds, which is shared among all third-party API services
2930
- **Lookback window allowed**: Yes
30-
- **Identifiers required**: Email
31-
- **Identifiers accepted**: Email
3231
- **Client or Server-Side Connection**: Server-side
3332

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.
4333
{% include content/sync-frequency-note.md %}
4434

4535
## Configuring Marketo Static Lists
4636

4737
> 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.
4939
5040
### Step 1: Create an API-Only Marketo user
5141

@@ -60,7 +50,7 @@ In this step, you'll create an API-Only Marketo user with both Access API and Le
6050
![A screenshot of the Marketo Invite New User page, with the roles Marketo Static List and API only selected.](images/marketosl-perms.png)
6151

6252

63-
### Step 2: Create a Marketo Launchpoint Service for Engage
53+
### Step 2: Create a Marketo Launchpoint Service
6454

6555
1. Go to **Admin****Integration****LaunchPoint****New**
6656
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
6959
![A screenshot of the New Service popup in Marketo.](images/marketosl-newservice.png)
7060

7161

72-
7362
### Step 3: Create a Marketo Lead Database folder and get your Marketo Endpoint
7463

7564
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
8271
> warning "Warning:"
8372
> Do not create a list in the folder for the audience. Segment creates the list for you!
8473
85-
### Step 4: Set up the Marketo Static Lists (Actions) destination in Engage
74+
### Using Marketo Static Lists (Actions) destination with Engage
8675

8776
1. From your Segment workspace, go to **Engage → Engage Settings → Destinations→ Add Destination** and then Search for Marketo Static Lists (Actions).
8877
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
9180
6. Click **Save** and make sure to enable the mapping.
9281
7. On the **Mappings** tab, click **Add Mapping** and select **Remove from List**.
9382
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
9490

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**.
9696

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.
10298

10399
> info ""
104100
> 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

Comments
 (0)