Relevant to: Demand Acceleration Platform
When routing leads from the Demand Acceleration Platform, you can choose to add each lead as a member of a Static List in Marketo; this guide will outline the steps to do so.
You should be familiar with Static Lists and their use cases in Marketo. You will also find it useful to be logged in to both Marketo and the Demand Acceleration Platform at the same time.
| You need to have 1) connected your Marketo account with the Demand Acceleration Platform, and 2) have set up the integration on your Campaign/Source - before defining lead routing. |
|
| Connecting to Marketo | Setting up an Integration to Marketo |
In this article
Adding leads to a Static List
After connecting Marketo with the Demand Acceleration Platform and adding the integration to a Campaign/Source, you are ready to use the Add to List functionality.
| The 'Add to Static List' function makes two API calls to your Marketo instance for each lead (unlike Adding to a Program, which only makes one API call). This is important to note because these two API calls will contribute to your Marketo limits. |
|
| The first API call uses Marketo’s Leads endpoint to create or update the lead object. Once this has completed, the associated Marketo Lead ID is used to add the lead to the specified Static List via a second API call using the Lists endpoint. |
1. In a Campaign/Source, go to the Integrations tab.
2. Hover of the Marketo tile and click the Settings icon.
3. In the integration settings, select the List drop down menu. This will display any Marketo Static Lists that exist in your instance of Marketo.
Select the list that you want to send leads into from the Demand Acceleration Platform.
- Use the Search list option to load and locate available lists quickly.
| In order to select and post leads to a Marketo List, the list must already exist in Marketo. |
Testing a Marketo Static List
Be sure to test your integration before launching your Campaign/Source to allow live lead flow. Work with your Marketing Ops team to confirm your tests are routing properly to your Static List.
Thorough testing will help ensure your leads will be correctly received and routed once they reach your Marketo instance.
Monitoring Static Lists
As two API calls are used for each lead, it is important to closely monitor post out logs in the Demand Acceleration Platform for any errors. These will look slightly different when you are posting leads to Marketo Static Lists, as each lead will show up as two separate entries in your post out logs.
To check that leads are being posted to Static Lists, create a post out log report in the Demand Acceleration Platform and assess the corresponding data.
- For one lead, you should see two entries.
- They both have the same (Integrate) LeadID value, but present different LogIDs.
- The first entry indicates the use of the Leads endpoint, while the second entry indicates the use of the Lists endpoint - you can see this in RequestContent column.
What success looks like in a post out log report
| Column | Description | The two entries per lead should: |
| LeadID | A unique value for each lead, generated by the Demand Acceleration Platform. | Both display the same value. |
| LogID | A unique value for each post out attempt, generated by the Demand Acceleration Platform. | Each display different values. |
| RequestContent | The information sent to Marketo from the Demand Acceleration Platform. |
The first begins with {Action and represents the API call to create or update the lead object. The second begins with {Input and represents the API call to add the lead to the specified Static List. |
| ResponseStatusCode | The Response Code received from Marketo, indicating success or failure. See Marketo’s list of error codes. | Both display Marketo's success code: 200. |
| ResponseReason | The Response Code description received from Marketo. | Both display as Accepted. |
If your response doesn't look like the above, see Interpreting Marketo Post Outs & Common Errors to help with troubleshooting. The full message received from Marketo with more detail about possible errors is available in the ResponseContent column.
Recommended Reading
- Connecting to Marketo
- Setting up an Integration to Marketo
- Testing a Marketo Integration
- Interpreting Marketo Post Out Responses & Common Errors
- Post Out Lead Management in the Demand Acceleration Platform