Integrate Eloqua and Demandbase

There are two ways of integrating with Eloqua in Demandbase:

• Connect with a Password
• Connect using an Access Token

Demandbase syncs the following types of engagement from Eloqua:

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

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

How Does Demandbase Import Eloqua Activities?

Demandbase uses the asynchronous Bulk API, which is specifically designed for high volume data transfers. 

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 is 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. See Eloqua's 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 is imported into Demandbase.

Prerequisites

• 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
• You must have Admin privileges or be assigned to a permission set with the required Demandbase settings access.

Connect with a Password

1. From the left navigation bar, go to Settings > Integrated Systems > Integrations.
2. Click New Integration 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. 

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.