Overview
In this article we will take you through how to set up the Integrate with Eloqua job. This job allows direct integration into the Eloqua system using both a Basic method and an OAuth Method. The below article and video will walk you through the setup of both and how to map fields within the integrations.
If you are requiring Custom Fields or Custom Objects please use the below articles to help:
This article is one of five that will walk you through all the different components that may be used within our Eloqua integrations, the other articles can be found as below:
- Introduction To Eloqua And How To Create Your Custom Application In Eloqua
- The Integrate To Eloqua Job - This Article
- The Create/Update Eloqua Integration Job
- Integrating To Eloqua Custom Fields
- Eloqua Custom Objects And Fields
Video Walkthrough
Setup
1. Navigate to your chosen campaign, and go to Processr > Integration. Click Add Job, then select Integrate with Eloqua.
2. The configuration window will now open.
a) Configuring the Basic Authentication Type
As standard the Basic Authentication is pre-selected. To continue with the Basic Authentication method simple leave the field 'authentication_type' as 'basic' and fill out the rest of the fields:
- Username
- Password
- Site (Company Name on Eloqua login page)
- apiURL
b) Configuring the OAuth Authentication Type
To complete the setup of the OAuth Authentication Type, there are a few more steps to complete.
Next to the field 'authentication_type' select the field and remove the word 'basic' and a dropdown will appear. From the dropdown select 'oauth'
Once selected, click out of the fields to allow the settings to update.
Note: you will notice that the field 'site' is removed and the button 'Get Eloqua Token' button appears
Enter the following details:
- Client ID
- Client Secret
- API URL
To get these details you will need to ensure that you have created a Custom Application within Eloqua. Details on how to do this can be found here.
You will also notice that as you add the Eloqua details, the 'Get Eloqua Token' button will become available. This button will generate the Eloqua OAuth Token.
After selecting the Get Eloqua Token button, you will be taken through to the Eloqua instance. Here you will need to login with the details provided to you by the client to confirm the connection.
Once you have logged in you will get a message asking you to confirm the connection. Select Accept.
Finally, you will be shown the Eloqua OAUTH Token screen which confirms that the connection is successful.
5. The next step is to enter the clients' field names. The core data field names are entered into the mapping section, as below.
Please note: The clients' field names should be entered on the left and the matching Convertr field names are entered on the right.
You can find the names of the core data fields on the Eloqua documentation, and select the ones you need.
6. Once you have completed the mapping, the integration is complete and ready to test. It will look like the below:
