Integrate Eloqua and Demandbase

Context

Demandbase imports the following types of engagement from Eloqua:

• Page Views
• Form Submits
• Email Opens
• Email Clicks

Assign Engagement Minutes to these actions once you have set up your integration. 

We support two ways to connect with Eloqua:

• Connect with a Password
• Connect using an Access Token

How Does Demandbase Import Eloqua Activities?

Demandbase uses the asynchronous Bulk API, which is specifically designed for high volume data transfers. The Oracle Eloqua documentation for the Bulk API begins by stating: The Bulk API is a RESTful API designed to support high volume data transfers. It can be used for CRM and data warehousing integrations. 

Unlike the Application API (which Demandbase does not use), the Bulk API is set up to operate in an asynchronous fashion. First, the Demandbase integration issues an export request describing the data to be transferred. Then, the Eloqua system prepares the data to be exported in a staging area. This occurs asynchronously. Later, after the export file has been prepared, the Demandbase integration retrieves the exported records in increments of 50,000 rows.

The Demandbase integration only makes use of a small number of export requests per day (typically 7). This is well below the soft limit of 2,000 syncs per day, as documented here. 

The Demandbase integration is written following the Eloqua recommended best practices for retrieving large volumes of data, as documented here. 

Data will be processed after the sync and available in the customer database according to the schedules described in Understanding Demandbase Data Availability. 

Can I Limit the Contacts and Activities Imported into Demandbase?

By default, Demandbase imports all contacts and their associated activities from Eloqua. If you need to limit the contacts and activities imported, you can use Eloqua's Security Groups feature. For more information about Security Groups, see the Eloqua documentation. 

To limit the contacts and activities imported, do the following:

1. Set up an Eloqua user for syncing with Demandbase.
2. Use Security Groups to configure the access permissions for the Eloqua user. The user should only have access to the contacts you want imported into Demandbase. 
3. Set up the Demandbase integration using the Eloqua user. After you set up the integration, only the activities of the contacts the Eloqua user can access will be imported into Demandbase.

Prerequisites/Preparation

You must have Admin privileges in Demandbase.

If your organization restricts network access to third-party applications, ask your Eloqua administrator to add the following IP address range to allow updates from Demandbase.

• 52.4.63.192 to 52.4.63.223

Steps: Connect with a Password

1. From the left navigation bar, go to Settings > Integrated Systems > Integrations.
2. Click Create Data Source and select Eloqua.
3. Select Password for the OAuth Type.
4. Enter your OAuth Type, Company Name, Username, and Password.
   
   
5. Click Save.
   After successful authentication, Eloqua is listed on the Integrations page. 

Steps: Connect using an Access Token

1. From the left navigation bar, go to Settings > Integrated Systems > Integrations.
2. Click Create Data Source and select Eloqua.
3. Select Access Token for the OAuth Type.
   
4. Click Save. 
5. In the Eloqua sign in window, login to the Eloqua instance you want Demandbase to connect to. After successful authentication, Eloqua is listed on the Integrations page. 
   
   
   
   

Outcome

You can now add Eloqua as a Destination for your Audiences.