How to Use Eloqua Form as a Lead Gate

This guide provides examples on how to create an Eloqua form and Landing Page in Eloqua and details how to generate or retrieve API keys. These keys are used to communicate from Consensus to Eloqua.

How to Use an Eloqua Form as a Lead Gate

1. To create a form, go to asset then Forms.
2. Click Create a Form then Blank Responsive Form.
3. Drag the fields Email Address, First Name, Last Name, Title, Business Phone, Company and Country from the Contact Fields on the left-hand side of the form.
4. Drag two Single Line Text fields from the Form elements section.
5. Click on the first Single Line Text field.
   1. On the left-hand side, set the Label to State / Province
   2. Set the HTML-Name to state
6. Click on the second Single Line Text field.
   1. Set the Label to Comments
   2. Set the HTML-Name to comments
7. Click on the body of the form, and drag two Hidden Fields from From Elements.
8. Click on the first Hidden Field:
   1. Set the HTML-Name to redirectUrl
   2. Select a static value from the list and past it into the URL field:
      1. https://eloqua-test.goconsensus.com/public/redirect-url
   3. Change the maximum number of characters to 255.
   4. Uncheck "Must not contain any URL"
9. This next step uses the Consensus Integration Service. First, in Eloqua, click the wheel icon (Settings) in the upper right-hand corner, then Apps under Platform Extensions, then Consensus Integration Service. Second, click the configure icon. Eloqua requires additional authentication for this next part and will request for your Eloqua username and password. After authentication, follow the instructions in the picture below to get the Demo Hash for the demoId field.
10. After copying the Demo Hash from the Consensus Integration Service, click the second Hidden Field.
    1. Set the HTML-Name to demoId
    2. Select a static value from the list and paste the Demo Hash from Consensus into the field.
       
11. Save your form (1) and click Processing (2).
12. Click Save (1) to add the required items to Processing steps (2,3,4) by double clicking the field.
    
13. Step Update Contacts - With Form Data does not require any changes.
14. Redirect to Web Page follow these steps:
    1. Select Send to External URL
    2. Select "Use the value of a form field to select the URL"
    3. Select Hidden Field (This is the field in which the redirect URL value)
15. At step Post Data to Server, set Constant Value as "https://eloqua-test.goconsensus.com/public/form"
    
16. In the upper right-hand corner, click Save.

How to a Create Landing Page with the Eloqua Form for Consensus

1. Before creation of a new Landing Page, open the Eloqua Form from the previous step and click Actions then View Form HTML.
   
2. Copy the entire script from the Form HTML section.
3. To create a landing page, go to asset then Landing Pages
4. Create a Landing Page then choose Blank HTML Landing Page
5. Paste the copied script into the landing page
6. Find the code function handleFormSubmit in the editor and paste this script before the function and after the <script> tag.
   function EloquaRedirect() {
   var uniqueId = Math.random().toString(36).substring(2, 15) + (new Date()).getTime();
   var x = document.createElement("INPUT");
   x.setAttribute("type", "hidden");
   x.setAttribute("name", "uniqueId");
   x.setAttribute("value", uniqueId);
   document.getElementsByTagName('form')[0].append(x);
   document.getElementsByName('redirectUrl')[0].value += '?email=' + document.getElementsByName('emailAddress')[0].value + '&demo_id=' + document.getElementsByName('demoId')[0].value + '&elq_site_id=' + document.getElementsByName('elqSiteId')[0].value + "&uniqueId=" + uniqueId;}
   Add EloquaRedirect(); as the first line in the function handleFormSubmit
7. Choose your microsites (1), click Save and click URLs to test the result