Notes:
Setting up an Oracle Eloqua integration will allow you to share data between Oracle Eloqua 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 Oracle Eloqua.
You can replace Turtl’s native lead capture form with an Oracle Eloqua form. For this to work, you’ll first need to configure the Oracle Eloqua form so that it’s compatible with Turtl. This article will take you through each step of the process.
1. Create your "thank you" page
First, you need to create a "thank you" page for your form. Your readers will be redirected here once they have completed your form.
Note: Any content you add to this page will only be visible when the form is complete on the Back cover of a Turtl Doc - on Content pages, the reader will simply be directed to the next piece of content without ever seeing this page.
Begin by creating a new Landing Page and choose the "Blank HTML Landing Page" option:
Set your landing page Title, Vanity URL, and other settings as usual.
Include the JavaScript with SITE_ID in <Head> tag of HTML:
<script data-ttl-form-mode="complete" data-ttl-form-eloqua-site-id="ELOQUA_SITE_ID" type="text/javascript" src="https://app-static.turtl.co/forms/turtl.forms.eloqua.v1.js"></script>
You will need to replace ELOQUA_SITE_ID in the above with your Eloqua site ID. If you do not know this, please contact Customer Support who will help you locate it.
Now add any additional wording you want readers to see once they have filled in your form, bearing in mind that this will only be visible on the back cover.
When finished, save this page and remember the URL you assigned.
2. Create your form
Next, create your Oracle Eloqua form as usual via the Oracle Eloqua form creation tools. You can use all the usual hidden fields, templates, and other elements you are familiar with.
When creating your processing steps, make sure you include a Redirect to Web Page step which sends readers to the Thank you page you created in Step 1.
3. Create your form landing page
Next, you need to create a landing page to contain your form. Again, choose the "Blank HTML Landing Page" option:
Then embed the form you created in Step 2 to the page.
This time, paste the following in the <Head> tag of HTML:
<script data-ttl-form-mode="embed" data-ttl-form-eloqua-site-id="ELOQUA_SITE_ID" type="text/javascript" src="https://app-static.turtl.co/forms/turtl.forms.eloqua.v1.js"></script>
You can position the form wherever you like on the page and do not need to worry about styling – Turtl will take care of this for you.
Save your landing page and copy the URL. You can then paste it into the "Forms" tab of the "Doc settings" screen.
4. Embed your form to Turtl
Take the Landing Page URL copied in Step 3 and paste it into the "Forms" tab of your Doc settings.
There are three form URLs you can specify:
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.
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.
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.
You can learn how to enable the form in your Content pages and Back cover here.
5. Styling and Testing
Note: If this is the first time adding a form to a Turtl Doc it will need to be styled by our team to match the rest of your Turtl Doc. Once you've added it, contact your Customer Success Manager or Customer Support and we'll get it styled for you.
If you've previously added an Oracle Eloqua form, the styling should already pull through correctly. If the form is not styled, double-check you've done everything in steps 1-5 and test again.
Submitting test details using the form to see if it is pulling into Oracle Eloqua is advisable as a final step.