Marketo is a leading marketing automation platform that lets you identify the right audiences through effective behavioral tracking and deliver automated, personalized marketing campaigns.
Find the open source transformer code for this destination in the GitHub repository.
Setup
Before setting up the Marketo destination in RudderStack, you must create two fields in Marketo with the API names exactly as userId and anonymousId. RudderStack looks up the Marketo Lead objects using these properties.
Without these two fields, all events will fail.
In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for Marketo.
Connect your source and click Continue.
Connection settings
Configure the following settings to set up Marketo as a destination in RudderStack:
Name: Assign a name to uniquely identify the destination.
Munchkin Account ID: Enter your Munchkin account ID. You can find the Munchkin Account ID by logging into your Marketo instance and going to Admin > Integration > Munchkin. Your Munchkin ID is listed on the main screen in the Tracking Code section. For more information, see the Marketo documentation.
Client ID: Enter your Marketo client ID.
Client Secret: Enter your Marketo client secret.
You can find the client ID and client secret by logging into your Marketo instance and going to Admin > Integration > LaunchPoint. Select the API service and click View Details to get the credentials. For more information, see the FAQ section below.
The following settings are associated with the track events and require you to first create a Custom Activity in Marketo before sending an event. You also need to approve the activity in order to get the Custom Activity ID.
Custom events
You can also use the JSON mapper to set up these mappings.
Map events to Marketo Activity ID and Primary Key: Use this setting to map the event name in track call to Marketo’s custom activity ID and the primary key associated with the custom activity. For example, you can map a Product Clicked event to a custom activity with primary field product_id and activity ID 100001.
The primary field for Marketo’s custom activity is marked with an asterisk (*).
Lead trait mapping
Map your traits to Marketo custom fields: RudderStack maps some of the user traits to the custom Marketo fields by default (listed in the Supported mappings section). You can use this setting to override the default mappings or map any other traits to the custom Marketo fields.
For custom Marketo fields, you can use the list of standard Marketo fields (REST API Name column) or any other custom field names existing in your lead records.
Custom activity property map
Map your event properties to Marketo custom activity’s field: Use this setting to map your track event properties to the Marketo fields listed in your custom activity.
For example, you can map Product Clicked event’s product_name property to the Marketo’s productName field for the custom activity Product Wishlisted.
Identify
You can use the identify call to create or update a Lead object in Marketo.
By default, RudderStack maps the following traits to the Marketo fields:
RudderStack trait
Marketo field
address.city
city
company.name
company
address.country
country
email
email
firstName
firstName
company.industry
industry
lastName
lastName
leadSource
leadSource
company.employee_count
numberOfEmployees
phone
phone
address.zip
postalCode
rating
rating
address.state
state
address.street
address
title
title
birthday
dateOfBirth
website
website
For the rest of the fields that you want to sync with Marketo, you can create a mapping of your traits and custom Marketo fields in the RudderStack dashboard, as specified in the Lead Mapping settings section.
Track
You can use the track events to register custom activities in Marketo.
If you are using RudderStack Open Source, make sure to update your transformer version to v1.51.1 or later to send your track events to Marketo correctly.
A sample track call is as shown in the snippet below:
Why are my requests failing with the message “Lookup failed”?
Make sure you have created two fields in Marketo with the names userId and anonymousId, so that RudderStack can look up the Marketo lead database for leadId with the userId that are passed along with the event.
Why are my track events failing?
Make sure you have created two fields in Marketo with the API names exactly as userId and anonymousId. RudderStack looks up the Marketo lead objects using these properties. Without these two fields, all events will fail.
If you’re sending track events without userId, make sure you have turned on the Track Anonymous events setting in the RudderStack dashboard. If this setting is disabled, events that don’t contain the userId field will fail.
How do I obtain the Marketo client ID and secret?
To set up the Marketo API service and obtain the client ID and secret associated with it, follow these steps:
Log into your Marketo instance and click the Admin tab.
Select LaunchPoint.
Here, you will able to see all installed services used for connecting to Marketo.
To create a new service, click New > New Service.
Enter the Display Name. From the Service dropdown, select Custom.
Under Settings, enter the Description and select the API Only User, as shown. Finally, click CREATE.
Make sure the API Only User associated with the API service has the necessary permissions to create or update contacts as wellas the custom activities.
Once the setup is complete, you should have the client ID and client secret for the API service. Use this to configure the Marketo destination in RudderStack.
How do I create a custom activity in Marketo?
For a step-by-step guide on creating a custom activity in Marketo, refer to this Marketo documentation.
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.