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

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. Find your Endpoint and Portal ID

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>

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 

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:

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

There are three form URLs you can specify:

  1. Default Form URL - This URL will be used for both Immerse 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.

If you are an admin you can also set a default form for all docs in your account.

4. Set your "thank you" message (optional)

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!

5. Prevent non-business emails from submitting a form (optional)

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"

Note: If this is the first time your company has added a form to Turtl it will not have styling applied. Please contact support@turtl.co once your form has been added to a Turtl Doc and we will be able to get it styled for you.

Additional Note: With Marketo Integration complete, you will be able to see leads from your embedded Marketo form in your Turtl analytics dashboard. These leads will appear in the Known Readers section. Otherwise, your leads will only be located in Marketo. You can read more about Individual Reader Analytics here.

Did this answer your question?