Skip to content

Commit aa57096

Browse files
committed
Add deprecation notice
2 parents 86a0856 + 3b5c0da commit aa57096

File tree

2 files changed

+30
-37
lines changed
  • src/connections/destinations/catalog

2 files changed

+30
-37
lines changed

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

Lines changed: 22 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -8,16 +8,13 @@ id: 65302a514ce4a2f0f14cd426
88
99
Marketo Static Lists (Actions) is a rebuild of the classic destination that provides the following benefits:
1010

11-
- **Simple setup** - Marketo Static Lists (Actions) has a streamlined default setup process making it easier to get started in a way that "just works".
12-
- **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 Marketo.
13-
- **Default property mappings** - Default mappings from the Segment like event, timestamp, and more, allow data to be mapped correctly without any setup required.
11+
- **Streamlined setup process** - Marketo Static Lists (Actions) has a streamlined default setup process, making it faster to get started in a way that "just works".
12+
- **More control** - Actions-based destinations allow you to define the mapping between the data Segment receives from your sources, and the data Segment sends to Marketo.
13+
- **Default property mappings** - Default mappings from the Segment like event, timestamp, and more allows data to be mapped correctly without any setup required.
1414

1515
## Overview
1616

17-
The Marketo Static Lists (Actions) destination lets you sync users into Marketo as a **List**.
18-
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-
17+
The Marketo Static Lists (Actions) destination lets you sync users into Marketo as a **List**, allowing 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.
2118

2219
## Details
2320

@@ -42,21 +39,17 @@ This allows you to run email campaigns in Marketo without having to manually fin
4239
In this step, you'll create an API-Only Marketo user with both Access API and Lead Database access.
4340

4441
1. You can use an existing role with these permissions, or create a new role that has both Access API and Access Lead Database permissions. (Do this in Marketo by going to **Admin****Users & Roles****Roles**).
45-
46-
47-
2. Go to **Admin****Users & Roles****Users****Invite New User** and create a new **API Only user** with the role that has both Access API and Lead Database permissions. **Be sure to check the API Only box.**
48-
42+
2. Go to **Admin****Users & Roles****Users****Invite New User** and create a new **API Only user** with the role that has both Access API and Lead Database permissions. **Be sure to check the API Only box.**
4943

5044
### Step 2: Create a Marketo Launchpoint Service
5145

52-
1. Go to **Admin****Integration****LaunchPoint****New**
46+
1. Go to **Admin****Integration** **LaunchPoint****New**
5347
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.
5448
3. Write down the **Client Id** and **Client Secret** for this service, as you will need it when configuring the destination settings.
5549

56-
5750
### Step 3: Create a Marketo Lead Database folder and get your Marketo Endpoint
5851

59-
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.
52+
1. Go to your Marketo Lead Database, and create a new folder under Group Lists. After connecting, each Engage audience shows up as a list in this folder.
6053

6154
2. Before you continue to the next step, in Marketo, go to **Admin → Web Services**, and copy or write down the REST API Endpoint. **Be sure to copy the REST endpoint and not the SOAP endpoint.** You'll need that in the next step.
6255

@@ -65,48 +58,40 @@ In this step, you'll create an API-Only Marketo user with both Access API and Le
6558
6659
### Using Marketo Static Lists (Actions) destination with Engage
6760

68-
1. From your Segment workspace, go to **Engage → Engage Settings → Destinations→ Add Destination** and then Search for Marketo Static Lists (Actions).
69-
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.
70-
3. Click the toggle to enable the Marketo Static Lists (Actions) destination.
71-
4. Navigate to the **Mappings** tab, click **Add Mapping** and select **Add to List**.
72-
6. Click **Save** and make sure to enable the mapping.
73-
7. On the **Mappings** tab, click **Add Mapping** and select **Remove from List**.
74-
8. Click **Save** and make sure you enable the mapping.
75-
9. Navigate to the Engage Audiences tab and create a new audience.
61+
1. From your Segment workspace, go to **Engage → Engage Settings → Destinations → Add Destination**, and then Search for Marketo Static Lists (Actions).
62+
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 above.
63+
3. Select the toggle to enable the Marketo Static Lists (Actions) destination.
64+
4. Navigate to the **Mappings** tab, click **Add Mapping**, and select **Add to List**.
65+
6. Click **Save**, and make sure to enable the mapping.
66+
7. On the **Mappings** tab, click **Add Mapping**, and select **Remove from List**.
67+
8. Click **Save**, and make sure you enable the mapping.
68+
9. Navigate to the Engage Audiences tab, and create a new audience.
7669
10. Give your audience a name, some event and trait criteria, then click **Preview**.
77-
11. Select Marketo Static Lists as a destination for the Audience.
70+
11. Select **Marketo Static Lists** as a destination for the Audience.
7871
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.
7972
13. Click **Save Settings**.
8073

8174
### Using Marketo Static Lists (Actions) destination with RETL
8275

83-
1. Navigate to your data warehouse and add Marketo Static Lists (Actions) as a destination.
84-
2. From your model, click **Add Mapping** and select your Marketo Marketo Static Lists (Actions) destination and the **Add to List** Action.
76+
1. Navigate to your data warehouse, and add Marketo Static Lists (Actions) as a destination.
77+
2. From your model, click **Add Mapping**, and select your Marketo Marketo Static Lists (Actions) destination, and the **Add to List** Action.
8578
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.
8679
4. Finish setting up the rest of the action.
8780
5. Click **Save Mapping**.
8881

89-
When you save the mapping, a list will be created in Marketo. You can update the list the mapping syncs to at any time.
82+
When you save the mapping, a list is created in Marketo. You can update the list the mapping syncs to at any time.
9083

9184
> info ""
9285
> 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.
9386
9487
You can view the audience in Marketo by going to **Lead Database→ Group Lists→Name of folder you created in Step 3 → Audience name**
9588

96-
9789
## Troubleshooting
9890

99-
#### Not seeing an audience in Marketo
100-
101-
Check that you followed all of the set-up steps.
102-
103-
Wait six or more hours after setup for your audience to start appearing in Marketo.
104-
105-
Check that you didn't create a list in the folder for the audience - Segment creates the list for you, and an existing one can conflict.
91+
#### Not seeing an audience in Marketo?
92+
Check that you followed all of the set up steps. Wait six or more hours after setup for your audience to start appearing in Marketo. Check that you didn't create a list in the folder for the audience - Segment creates the list for you, and an existing one can conflict. Check that the audience members you expect have an email address on their profile.
10693

10794
#### Audience size is smaller than expected
108-
Only users in the audience who also have an email address are uploaded to the list.
109-
110-
You might need to adjust your query to filter out users without an email so you can get a better estimate of how many users will appear on the list.
95+
Only users in the audience who also have an email address are uploaded to the list. You may need to adjust your query to filter out users without an email so you can get a better estimate of how many users will appear on the list. In the example below, we added an AND condition where users have a Custom trait of `email` which `exists`.
11196

11297
If a user has multiple email addresses, each address appears once in the Marketo list.

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,14 @@ hide-boilerplate: true
44
strat: adobe
55
id: 5b73515e6170785a5e62978c
66
---
7+
8+
> warning "Deprecation Notice"
9+
> Segment is deprecating this destination. Segment will create an instance of the [Marketo Static Lists (Actions)](/docs/connections/destinations/catalog/actions-marketo-static-lists/) destination for each properly configured version of the Personas Marketo Static Lists classic destination in your workspace. Settings and configurations will be migrated automatically.
10+
>
11+
> We are disabling all existing Personas Marketo Static List destinations. You can still access your existing configuration, but please refrain from enabling the destination, as it is set to be deprecated. You will no longer be able to create new instances of Personas Marketo Static Lists. Please check out [Marketo Static Lists (Actions)](/docs/connections/destinations/catalog/actions-marketo-static-lists/) to set up a new instance of Marketo Static Lists.
12+
>
13+
> For questions or issues contact [[email protected]](mailto:[email protected]).
14+
715
> info "Marketo vs Marketo Static Lists Destinations"
816
> This page is about the **Marketo Static Lists** destination developed specifically for use with Engage. Marketo has strict API usage limits on the [main Marketo destination](/docs/connections/destinations/catalog/marketo-v2/), so although the main destination can receive events from Engage, use the Marketo *Static Lists* destination with Engage instead.
917

0 commit comments

Comments
 (0)