Overview

The Adobe Marketo connector streamlines lead synchronization from Lead Liaison to Marketo through Automations, Fulfillment Actions, and Bulk Actions. Access the Captello Universal Lead Capture Connector on the Adobe Exchange.

Connecting to Adobe Marketo

To link your account to Marketo, first, create a Custom Service for our system. For assistance, contact Marketo Support at support.marketo.com. Then, follow these steps:

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

  • Leads - Full access - We need read access to pull the list of fields & custom fields that you use. We need write to create new leads.

  • Custom Objects - Full Access - We need read access to pull the list of custom objects you have, We need write to create new entries into your object.

  • Campaign - Execute Access - Allows our actions to assign someone to one of your campaigns

image-20240401-101337.png

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:

image-20240401-101353.png

Mapping Diagram

Mapping process:

  1. WebApp User (through WebApp):

  1. Configure capture forms + FA > Captello servers + Captello database

  2. Captello Mobile App + Captello Web View > Captello API > Captello servers + Captello database

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

Logs

Sending Leads to Marketo

Video Tutorial

The video below explains how to:

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

Step-by-Step Guide

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.

note

Updating existing Marketo fields will cause Captello to override the field values in Marketo. If the value going from Captello is cleared, the correspondent field on Marketo will be cleared.

If there is a possibility of submitting the same lead twice and sending them to Marketo, it’s recommended to sync submissions so you do not lose data that will get overridden in the process (since some field types do not have the merge options).

Updating existing Marketo fields will cause Captello to override the field values in Marketo. If the value going from Captello is cleared, the correspondent field on Marketo will be cleared.

If there is a possibility of submitting the same lead twice and sending them to Marketo, it’s recommended to sync submissions so you do not lose data that will get overridden in the process (since some field types do not have the merge options).

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.

image-20240401-101725.png

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.

image-20240224-104223.png

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:

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.

image-20240220-121650.png

Setting up the Custom Object on Marketo

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

Setting up the Sync Action

note

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.

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.

Acquiring Custom Object API Name and Unique ID from Marketo

-

image-20240220-123058.png

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

note

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

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

The action should look like the following:

Setting Up the Capture Form

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

image-20240413-145236.png

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.

image-20240220-112807.png

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.

image-20240220-112908.png

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 a 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:

image-20240220-125257.png