Marketo connector

The Episerver Customer-Centric Digital Experience Platform contains many features to support you in your daily work. Depending on how your solution is set up, some features described in this documentation may not be available to you. Contact your system administrator to find out more. See Episerver World for technical information.

The Marketo® connector add-on automatically exports form data from your website to your Marketo account database by mapping Episerver form fields to Marketo database fields. For information about other database connector add-ons, see Marketing Automation.

Setting up Episerver forms with Marketo

The Forms Marketing Automation Integration (MAI) connector lets you connect Episerver form fields to a Marketo database. See also: Marketing Automation.

A developer must install the Forms Marketing Automation connector and the Marketo connector. See Episerver World for more information.

  1. In the Episerver CMS admin view, select  Config > Tool Settings > Marketo. The Marketo configuration settings screen appears.

    Image: Configuring the Marketo connector

    You can have multiple instances of the same connector example, if you have marketing teams in separate regions, you can have more than one Marketo connector, such as Marketo - Europe, Marketo - US, and Marketo - APAC. Click Add Connector to add another instance.

  2. Enter the Connector Name, Endpoint URL, Client ID, and Client secret associated with your Marketo account.
  3. Optional: Specify a list of Workspaces that filter lists fetched from Marketo and displayed in the Data sources drop-down list on the form Mappings tab. If no value is specified, all the lists are fetched.
  4. For Multiple submissions in same session, select either Create new entity or Update previously created entity.
  5. Click Save.
  6. Create a form on a page.
  7. Click All Properties on the form.
  8. Open the Mappings tab.
  9. Select the database to which you map the form fields from the MA System Database drop-down field. (Each database in the list can have a different set of fields.)
  10. Click Publish.
  11. On the form, select Edit from a form field's context menu.
  12. Open the Extra field mappings tab. The database option that you selected earlier appears.
  13. Enable the database option and open the associated drop-down list to see the fields it has available. For example, if your form has a Text field that was configured to capture an email address:
    1. Edit the email text field.
    2. Select the Extra field mappings tab.
    3. Select Lead from the drop-down list to map the Marketo database field to the Email field on the form.

    Image: Mapping a Marketo database field to a form field

  14. Repeat steps 8 through 10 for as many fields that you want to map.
  15. Click Publish.

To test the mapping, go to your form on a published page, fill in and submit the form, then go to your DXH connector provider to verify that the user is added to the appropriate database (Marketo Leads).

Associating a lead to a campaign

To associate a lead to a campaign:

  1. Add a Hidden Predefined value field to your form and use the campaign ID as the Predefined value.

    Image: Add Hidden predefined value

  2. Map the value to the Marketo-Campaign_Id on the Extra field mappings tab.

    Image: Map value in Extra field mappings tab

Retrieving contact data

When a visitor submits the form, the data is sent to the Marketo database. To see who submitted the form, go to Marketo > Lead Database > All Leads and select the contact list.

Personalizing the form using a block

You can personalize and target messages based on profile information collected through the Marketo integration. You can apply personalization to forms and blocks. Mailings are managed within Marketo.

You can personalize a form to show only to a selected group of people. The following image shows personalizing a form to show only for people in the Swedish profiles visitor group. For more information about creating a visitor group and displaying information based on a visitor group, see Managing visitor groups.

Image: Personalize Marketo form

To create a visitor group for a Marketo form, see Create a visitor group for an MAI connector form.