1 Overview
2 Connecting to Adobe Marketo
- 2.1 Field Mapping
  - 2.1.1 Mapping Diagram
- 2.2 Revoke Access
- 2.3 Sync
- 2.4 Settings (Record Update Preference)
- 2.5 Submission Metadata Field Mapping
- 2.6 Logs
3 Sending Leads to Marketo
- 3.1 Video Demo
- 3.2 Step-by-Step Guide
- 3.3 Captello to CRM Detailed Sync Flow
- 3.4 Capture Form Marketo Lookup
- 3.5 Duplicate Management
  - 3.5.1 If a Lead Exists Once in Marketo
  - 3.5.2 If a Lead Exists More than Once in Marketo
  - 3.5.3 Creating and Syncing Marketo Campaigns
4 Sending Submissions to Marketo Using Custom Objects

Overview

The Adobe Marketo connector streamlines lead synchronization from Captello to Marketo through Automations, Fulfillment Actions, and Bulk Actions. Access the Captello Universal Lead Capture Connector on the Adobe Exchange. View Captello’s Partner Listing with Adobe.

The Marketo connector allows you to sync both prospects and submissions (using custom objects) to Marketo.

Connecting to Adobe Marketo

In Captello, Navigate to Setup > Integrations > Connectors.
On Marketo Find “Integrations" and enter your Client ID and Client secret (from a custom launch point), and your Identity URL & REST endpoint URL (from Integration > Web Services > REST API).
Click Save.
Confirm successful connection with the message: “You’re successfully connected to Marketo.”

The API user being used to connect requires the following permissions:

Read Only Person: This is for Captello to retrieve metadata for lead fields.
Read Only Campaign: This is for Captello to retrieve the campaigns in Marketo.
Execute Campaign: This is for Captello to use the API to trigger a campaign with a specified campaign ID.
Read-Write Person: This is used to create and update leads inside Marketo.
Read-Write Custom Objects: This is used to update custom objects in Marketo.

Click here to learn more on how to create a custom service for use with ReST API.

The Client ID and Client Secret are found in the Admin > Integration > LaunchPoint menu by selecting the custom service, and clicking View Details.

The Identity URL and Endpoint URL is found in the Admin > Integration > Web Services menu in the REST API section.

Field Mapping

When transferring data from Captello to Marketo, note that Marketo fields won't update if the corresponding Captello fields are empty. However, a value of '0' is treated as non-empty and triggers an update in Marketo.

Follow these steps:

Map Lead Liaison Prospect fields to Marketo Lead fields.
Access Field Mapping via the Marketo connector.

Use the mapping menu to assign fields.
On the mapping menu, select the Lead Liaison field on the right and the corresponding Marketo field on the left.
Utilize the (+) and (-) buttons to add or remove fields and click Save.

Mapping Diagram

Mapping process:

WebApp User (through WebApp):

Connect Marketo Credentials
Setup Field Mapping
Configure Capture Forms
Setup Custom Field Mapping
Setup Automations + Fulfillment Actions

Configure capture forms + FA > Captello servers + Captello database
Captello Mobile App + Captello Web View > Captello API > Captello servers + Captello database
Captello servers + Captello database > Send to Marketo + Send Capture Submissions to Marketo > Marketo.

Here is a diagram illustrating the field mapping between Captello and Marketo:

Revoke Access

Disconnect Lead Liaison and Marketo by clicking the Revoke button on the Marketo Connector.

Sync

Use the Sync button to run a force sync operation with Marketo.

Campaigns and programs are synced on a daily basis automatically, so you do not need to use the sync button unless you need to do an immediate update.

Settings (Record Update Preference)

The settings button allows you to choose what happens when you sync a record that exists more than once inside Marketo (with the same email address). You can choose one of the following options:
- Update all duplicates: Update all records in Marketo.
- Update most recently modified duplicate: Check which record has the latest modified date in Marketo and update it.

Submission Metadata Field Mapping

Used to map field data for syncing submissions, for more info, refer to Sending Submissions to Marketo Using Custom Objects below.

Logs

Access Marketo logs at Reports > Standard > Marketo Logs.
Filter by sync status i.e. success or error and hover over errors for details.

Sending Leads to Marketo

Video Demo

The video below shows:

Send leads to Marketo.
Send leads to different campaigns based on capture form answers.
Send submissions to Marketo.

https://vimeo.com/914607396/0d8dce2840

Step-by-Step Guide

Utilize the Send to Marketo action in Automations, Fulfillment Actions, and Bulk Actions.
The ‘Update records' checkbox allows Captello to sync records that already exist in Marketo, updating them.
(Optional) Select a Marketo partition (If nothing is selected, records will be sent to the default global parition).

Ensure the Prospects have email addresses for syncing, since the email address field is the unique identifier.

Captello to CRM Detailed Sync Flow

The following article goes into details about data flow from capturing leads to arriving at CRMs, including the effects of Captello duplicate management settings.Capture form to CRM Integrations Flow.

Adding Leads to Marketo Campaigns

If you are using Marketo partitions, make sure that the campaign you are sending leads to is in the same parition that you are selecting, otherwise, it will cause an error stating that the campaign cannot find the lead.

To add the Lead to a Smart Campaign, use the Campaign drop-down field on the fulfillment or automation action.

For a campaign to be synced to Captello, it must be:

A trigger campaign (which also means it cannot be executable).
Has the trigger ‘Campaign Requested’ through the source 'Web Service API'

Activated.

When connecting your Marketo account for the first time, your Marketo campaigns will take some time to sync, up to hours if you have thousands of campaigns.

Newly created campaigns after the connection is initiated are automatically synced once a day, however, you can force a manual sync using the ‘Sync’ button on the connector.

Adding Leads to Marketo Partitions

If you are sending leads to campaigns, make sure they are on the same partition you are selecting, otherwise it will cause an error stating that the campaign cannot find the lead.

To add leads to a specific partition, first, use the sync button to retrieve your partitions, then select the desired partition from the drop-down.

Note: If duplicates are detected inside Marketo while the ‘Update records’ flag is checked, they will be moved to the selected parition.

Adding Leads to Marketo Lists

This does not apply to Smart Lists.

To add the lead to a smart list by adding the Marketo List ID, or by clicking the magnifier icon to search by the list’s name.

If you do not have the ID, you can click the magnifier icon to search by the list’s name.

The full list name must be entered to retrieve the desired list.

Example: Setting up a Fulfillment Action on Capture Form Submission

In this example, a fulfillment action is used with a capture form to send leads to Marketo upon submission.

Click on the settings gear on the top right of your capture form.
Click on Actions (Submissions).

Select the ‘Send to Marketo’ action from the drop-down.

Capture Form Marketo Lookup

Captello capture forms can be set up to lookup records in Marketo and pre-fill the form with their information. To learn more, refer to Lead Capture Management | Marketo Lookup .

Duplicate Management

To sync a lead that already exists in Marketo, the option ‘Update records’ must be turned on. This option will allow Captello to update the person’s field inside Marketo.

Updating existing Marketo fields will cause Captello to override the field values in Marketo. However, fields synced from Captello with empty fields will not clear existing Marketo values.

If a Lead Exists Once in Marketo

If a lead exists once in Marketo (with the same email address), it will be updated normally.

If a Lead Exists More than Once in Marketo

If a lead exists more than once in Marketo (with the same email address), depending on the action you chose in Settings, it will either update all duplicates or update the most recently modified/created duplicate.

Creating and Syncing Marketo Campaigns

Create a campaign in Marketo by navigating to Marketing Activities > New > New Smart Campaign.

Depending on the campaign’s type, its icon will differ.

A batch campaign will have a lamp icon.
A trigger campaign will have a lightning bolt icon.

All of the active Campaigns and programs are synced automatically on a daily basis , if you need to sync a campaign immediately, use the sync button on the Marketo connector.

For a campaign to be synced to Captello, it must be:

A trigger campaign (which also means it cannot be executable).
Has the trigger ‘Campaign Requested’.
Activated.

Sending Submissions to Marketo Using Custom Objects

Submissions from Captello can be synced to custom objects in Marketo. An object must contain fields that correspond to the capture from questions you want to sync.

Each custom object field is mapped to its counterpart capture form question through the Marketo Custom Field API Name field.

Setting up the Custom Object on Marketo

To sync submissions to a custom object, it must have the following features:

It must be approved.
It must have a link field (recommended to be the email field, since that is the default unique identifier on Captello).
It must have a dedupe field, which acts as a unique ID generator for each submission.
The dedupe field must not be the same as the link field.

Setting up the Sync Action

From a fulfillment action, a bulk action, or an automation, use the Send to Marketo action, followed by the Send Capture Submissions to Marketo action.

It is required to always run the Send to Marketo action before syncing the submission, as a submission is added to a person’s page, and cannot be created if the person does not exist on Marketo.

In the Send Capture Submissions to Marketo action, it will ask for a Custom Object and Unique ID.
For Custom Object: enter the API name of the Custom Object.
For Unique ID: enter the API name of the dedupe field.

Acquiring Custom Object API Name and Unique ID from Marketo

Navigate to Admin > Marketo Custom Objects.

-

Navigate to your custom object.
API Name is your custom object API Name, use it to fill the Custom Object field in the sync action.

The Dedupe Fields are identified in the same page, get their API names from the Fields tab.

It is okay if there are more than one dedupe fields, the sync action will work with any of them.

Navigate to the Fields tab. Once you get the API name of the dedupe field, use it to fill the Unique ID field in the sync action.

The action should look like the following:

Sending the Event Metadata (Optional)

The submission metadata field button allows you to send the submission metadata of the capture form such as the event’s name, date, owner, etc along with the submission to the intended custom object.

The Submission metadata fields are: [Event] Archive Date, [Event] Name, [Event] Owner, [Event] Campaign, [Event] Campaign Cost, [Event] Export Date, [Event] City, [Event] Full Address, [Event] Country, [Event] City, [Event] State, [Event] Street Address, [Event] Zip Code, [Event] Start Date, [Event] End Date, [Event] ID, [Event] Labels, [Submission] Stations, [Submission] Initial Station, [Submission] Capture Date, [Submission] Captured By, [Submission] Capture Method, [Submission] Date, [Submission] Device, [Submission] ID, [Submission] Rating, [Submission] Location Longitude, [Submission] Location Latitude.

Note: The type of the ‘[Event] Start Date’ and the ‘[Event] End Date’ must be ‘Date' when creating a field inside Marketo Custom Object while the data type of the'[Submission] Date’ is 'Date time'.

To send the event’s metadata follow these steps:

Create custom fields inside the custom object.
From Captello, navigate to Setup > Connectors > Marketo > Submission Metadata Fields
Map Captello’s field to the corresponding Marketo field using the field’s API name.

The metadata will be sent over along with the submission to the custom object as shown:

Setting Up the Capture Form

The next step is to map the capture form questions to the custom object fields.

From the Fields tab in Marketo, copy the API Names of fields that correspond to your capture form questions.

Add API Names to the Marketo Custom Field API Name of each field in the capture form.

Now you are ready to run the sync action on the capture form!

Results in Captello Logs

After using The Send to Marketo & The Send Capture Submissions to Marketo actions, the Marketo logs in Captello will show the synced submission statuses.

You can click on Submissions Result to see the status of a submission.

The submission status will either be ‘Skipped’ (failed) or ‘Created’ (successful).

When a submission is skipped, you can hover over the “skipped” text, and it will display the skip reason.

The most common reason for skipping a submission sync is that a lead was not synced before syncing the submission. Make sure to always add the Send to Marketo action to your fulfillment actions or automation before the Send Capture Submissions to Marketo action.

Results in Marketo

When a submission is successfully synced, it will appear under the Custom Objects tab inside the person’s profile.

To view a submission, select your custom object from the Select Object dropdown.

Showing Your Custom Object in Person Profiles

If your custom object does not appear in the Select Object dropdown, it has to be set to ‘Show’ inside a person’s profile. To do that, follow the steps below:

Navigate to your custom object.
Click on Custom Object Actions > Edit Object.
Turn on the Show in Person’s Details Toggle