Skip to main content
Embedding a Marketo form

Learn how to capture sign-ups directly into Marketo from Turtl

Maruša Barle avatar
Written by Maruša Barle
Updated over a month ago

Notes:

  • Setting up a Marketo integration will allow you to share data between Marketo and Turtl, as well as access individual reader insights via the known reader dashboard. In this dashboard, your leads will appear in the "Known Readers" section.

  • Your embedded form will still work without this integration, however your leads will only be located in Marketo. Find out more about Individual reader analytics.

Turtl supports embedding Marketo forms in place of the Turtl native form. All Turtl needs is a little bit of information about your form and this article will show you how this is done.

Embed the Marketo form

1. Create your form and find the embed code

Create your form as usual then right-click in the tree menu and select "Embed code"

You will see a dialogue box that looks like this:

2. Extract your form URL

Your embed code will look something like this:

<script src="//app-sjqe.marketo.com/js/forms2/js/forms2.js"></script>
<form id="mktoForm_621"></form>
<script>
MktoForms2.loadForm("//app-sjqe.marketo.com", "718-GIV-198", 621);
</script>

Option 1: Input the embed code into our Lead form generator and proceed to Step 3.

Option 2: Look for the line that says MktoForms2.loadForm and find the three values that follow within the brackets. These are called rootUrl, munchkinId and formId respectively.

In the example above these are:

rootUrl //app-sjqe.marketo.com
munchkinId 718-GIV-198
formId 621 

Now paste the following URL into the relevant field for your Doc, replacing rootUrl, munchkinId, and formId with the values you found in the previous step:

/forms/turtl.forms.marketo.v1.embed.html?mktoRootUrl=rootUrl&mktoMunchkinId=munchkinId&mktoFormId=formId

For example, with our example embed code above this would be:

/forms/turtl.forms.marketo.v1.embed.html?mktoRootUrl=//app-sjqe.marketo.com&mktoMunchkinId=718-GIV-198&mktoFormId=621

3. Tell Turtl about your form

Navigate to the main Turtl Docs listing page and choose "Settings" for the Turtl Doc you wish to use the form on:


On the Settings page, choose the "Forms" tab:

Paste the form URL from Step 2.

There are three form URLs you can specify:

  1. Default form URL: This URL will be used for both Content pages and Back cover forms unless the back cover form URL is also set.

  2. Cover form URL: This URL can be used to add a form on the very first Surf page of your content. Readers will not be able to read or navigate past the first page without entering their details.

  3. Back cover form URL: This can be used to set a different form for the back cover. If this is left blank, the form set as Default form URL will be used on the back cover.

Note: If you are an Admin you can also set a default form for all Docs in your account.


Optional steps

Set automatic reader identification

This functionality helps identify leads automatically by adding a hidden field to your Marketo form. If a Turtl Doc reader is a known contact in Marketo, the form will automatically close once the reader is identified.

Furthermore, if the Turtl account has a Marketo integration, the reader will be resolved and displayed in the Known Readers section.

Automatic reader identification can be used instead of Lead-capturing URLs.

Note: This functionality requires setting up a CNAME, enabling cookies to be identified across websites.

Steps:

  1. Open "Form settings"->"Settings", then select "Custom HTML" in the "If Known Visitor, Show" drop-down list:

2. In the custom HTML editor switch to HTML view and add a hidden field:

<input type=”hidden” id=”ttl_known_reader”>.

3. Save the form and all is set up.

Set your "thank you" message

The "Thank you" message will be displayed when a reader has submitted the form on the back page of your doc. By default it will just say "Thank you", but this can be changed to whatever you want. At the end of the URL you just created add the following code:

&mktoCompleteMsg=


After the code, type the message that you would like to be displayed. As an example, I want to change the message to "感谢你注册!" (Thanks for signing up in Mandarin) it would look like this:

&mktoCompleteMsg=感谢你注册!

If you would like to change the message to "Thank you very much!", it would look like this:

&mktoCompleteMsg=Thank you very much!

Set Google reCaptcha

To set up Google reCaptcha on your form please navigate to your configured "Domains" on your Google reCaptcha administrator page.

Add the following domains to Google Captcha:

  • munchkin.marketo.net

  • app-ab22.marketo.com

Prevent non-business emails from submitting a form

Additional query parameters can be added at the end of the URL.

&mktoForceBusinessEmail=yes

With this enabled, emails from the following domains will not be allowed to submit a form as they are non-business emails:

"@aim.com", "@alice.it", "@aliceadsl.fr", "@aol.com", "@arcor.de", "@att.net", "@bellsouth.net", "@bigpond.com", "@bigpond.net.au", "@bluewin.ch", "@blueyonder.co.uk", "@bol.com.br", "@centurytel.net", "@charter.net", "@chello.nl", "@club-internet.fr", "@comcast.net", "@cox.net", "@earthlink.net", "@facebook.com", "@free.fr", "@freenet.de", "@frontiernet.net", "@gmail.com", "@gmx.de", "@gmx.net", "@googlemail.com", "@hetnet.nl", "@home.nl", "@hotmail.co.uk", "@hotmail.com", "@hotmail.de", "@hotmail.es", "@hotmail.fr", "@hotmail.it", "@ig.com.br", "@juno.com", "@laposte.net", "@libero.it", "@live.ca", "@live.co.uk", "@live.com", "@live.com.au", "@live.fr", "@live.it", "@live.nl", "@mac.com", "@mail.com", "@mail.ru", "@me.com", "@msn.com", "@neuf.fr", "@ntlworld.com", "@optonline.net", "@optusnet.com.au", "@orange.fr", "@outlook.com", "@planet.nl", "@qq.com", "@rambler.ru", "@rediffmail.com", "@rocketmail.com", "@sbcglobal.net", "@sfr.fr", "@shaw.ca", "@sky.com", "@skynet.be", "@sympatico.ca", "@t-online.de", "@telenet.be", "@terra.com.br", "@tin.it", "@tiscali.co.uk", "@tiscali.it", "@uol.com.br", "@verizon.net", "@virgilio.it", "@voila.fr", "@wanadoo.fr", "@web.de", "@windstream.net", "@yahoo.ca", "@yahoo.co.id", "@yahoo.co.in", "@yahoo.co.jp", "@yahoo.co.uk", "@yahoo.com", "@yahoo.com.ar", "@yahoo.com.au", "@yahoo.com.br", "@yahoo.com.mx", "@yahoo.com.sg", "@yahoo.de", "@yahoo.es", "@yahoo.fr", "@yahoo.in", "@yahoo.it", "@yandex.ru", "@ymail.com", "@zonnet.nl"

How to add hidden form fields to your Marketo Form

When embedding a Marketo form into a Turtl Doc, Turtl can add information to the form by automatically populating a specific set of fields. You can set up these custom fields when creating your Marketo form by following these steps:

  1. Navigate to the Field Management Tab

  2. Select "New Custom Field"

  3. In the Object dropdown, select "Person"

  4. In the Type dropdown, select "String"

  5. For the remaining Name and API Name fields, please refer to the options listed below:

Name

API Name

Turtl Doc ID

ttl_story_id

Turtl Doc URL

ttl_story_link

Turtl Doc Title

ttl_story_title


*These are described in Adding Hidden Fields to your forms.

How to add the new custom field to your Marketo Form:

  1. Select the "+" button to create a new field

  2. Find your newly created field in the dropdown list

  3. In Properties, navigate to the Field Type and select Hidden from the dropdown

Did this answer your question?