Eloqua

Eloqua is a marketing automation platform by Oracle. You can use Eloqua as an extension (custom field) that fetches and displays your Eloqua forms into a field of your content type.

Subsequently, while creating the entry, content managers can select a suitable form in the entry. Based on the selection, the form will be rendered on the presentation layer using the form details from the entry.

You can configure the depth details saved for an Eloqua form through the extension config or field-level instance config. We have used AWS Lambda & Eloqua Forms Rest API 2.0 to retrieve the list of forms. You can find the AWS Lambda code (lambda.js) with the extension code.

This step-by-step guide explains how to create an Eloqua extension in Contentstack. The steps to be performed are as follows:

  1. Get your Eloqua account details
  2. Deploy Lambda function
  3. Add the Eloqua custom field extension to your stack
  4. Use your custom field
  1. Get Your Eloqua Account Details

    In order to set up this extension, you will need the following information from your Eloqua account:

    • Your Eloqua Account Base URL
    • Your Eloqua Account Basic Auth Token

    Read more on how to retrieve Eloqua Base URL and Eloqua Basic Auth Token.

    Note: The account from which we use the username and password to generate the basic auth token should have limited permissions for security.

  2. Deploy Lambda Function

    To protect sensitive information, such as Eloqua Basic Auth Token and to avoid Cross-Origin Resource Sharing (CORS) issues, we will use Lambda function for this extension.

    In the Environment variables section of AWS Lambda, enter the credentials against the variables as shown in the following image:

    Eloqua Variables.png
  3. Add the Eloqua Custom Field Extension to Your Stack

    In order to use this extension in Contentstack, follow the steps below:

    1. Go to Settings > Extensions. Click on the + Add Extension button on the top-right corner and select Create new.

      New extension.png
    2. Select Custom Field.

      Custom Field.png
    3. On the configuration page, enter the details in the fields as given below:
      1. Title - Provide a suitable title, for example, Eloqua.
      2. Field data type - Select the data type in which the input data of the field should be saved in Contentstack. Select JSON in this case.
      3. Multiple: Leave this checkbox unchecked.
      4. Hosting method - Select Hosted By Contentstack. As soon as you do this, you will see the Extension Source Code field below.
      5. Extension source code - In this field, you need to enter the extension code. To get the code, contact our support team at support@contentstack.com.
        The support team will provide you with the source code (src file). Copy the code from the index.html file located in the root folder and paste it in the "Extension source code" field.
      6. Config Parameter - To configure this extension, you can either use the extension's 'Config Parameters' field while setting up the extension. Alternatively, you can use the field's instance config. The configuration settings to be used are given below:

        url - URL to trigger AWS lambda function
        x-api-key - Your AWS API Gateway API key (optional)
        depth - Depth of details you want to store for the form (optional, default: minimal)

        Config parameters.png
    4. Click on Save. This creates your custom field.

    Now, let’s understand how you can start using this custom field in your content type.

  4. Use Your Custom Field

    To use your custom field, you need to follow the steps given below:

    1. Create a content type by clicking on the + New Content Type. Enter the relevant details for the content type and click on Create and Add fields.

      New content type.png

      This leads you to the Content Type Builder page where you can add the relevant fields.
    2. Add the Custom field in your content type.

      Add custom field.png
    3. Select Eloqua from the dropdown and set the other properties of your custom field.

      Select Eloqua.png
    4. After adding other relevant fields in your content type, click on Save and Close.

    This will create your content type. Now, go to the content type and create a new entry. Enter the relevant details. In the Eloqua field, select your desired option "Basic Form," "Minimal Form," and "Detailed Form" as shown below:

    Eloqua Entry page.PNG

On This Page

top-arrow