Page tree
Skip to end of metadata
Go to start of metadata

If your company uses Eloqua's marketing automation platform (MAP), you’ve likely invested considerable time and effort in managing lead data and audience segments. The next step is to integrate Eloqua and Interaction Studio so you can leverage data collected in each system and build richer customer and prospect profiles to gain a deeper understanding of each lead. Using data from Eloqua helps you to deliver more meaningful visitor experiences using Interaction Studio and passing behavioral and analytics data from Interaction Studio helps you better target your Eloqua campaigns.

Interaction Studio Classic Only

  • The contents of this article are intended for customers using Interaction Studio (formerly Evergage Classic). Do not adjust your beacon version to downgrade or upgrade.
  • The Visual Editor Chrome Extension will no longer be available starting January 1, 2023. For more information, see this knowledge article.
This Article Explains

This article details how to configure the Interaction Studio out-of-the-box integration with Eloqua so you can synchronize data between both platforms.

Sections in this Article

Setup Authentication

The first step is to set up an OAuth connection to your Eloqua account.

  1. Log into Interaction Studio as an Administrator
  2. Select Third Party > Integrations
  3. Select Eloqua
  4. Select Setup and copy the OAuth Callback URL

  5. Log into Eloqua and create a new app in the AppCloud Devoloper Area 

  6. Paste the OAuth Callback URL you copied from Interaction Studio

    You will need to know the new OAuth Client ID and Client Secret for the following steps
  7. Return to Interaction Studio Third Party > Eloqua
  8. Click
  9. In Configure Connection, enter the the following information (located in Eloqua Cloud Services) in the fields provided:
    1. Client ID
    2. Client Secret
  10. Click AUTHORIZE

Configure Match Fields

On the Eloqua Integration Synchronization tab, Contact Match Fields connects fields in Interaction Studio with fields in Eloqua for user identification. By default, the email address fields in Interaction Studio and Eloqua are linked. If you need to link additional fields, please contact Support

Configure Segment Synchronization

On the Eloqua Integration Segments tab, you can synchronize Interaction Studio segments to Eloqua and vice versa. You must create any Interaction Studio segments or Eloqua lists before you can push to or pull from Eloqua.

  1. Click Push a New Segment or Pull a New Segment
  2. Select the Source Evergage Segment or Source Eloqua Segment
  3. When pushing a new segment the Target Eloqua Segment will be autofilled; when pulling a new segment enter the Target Evergage Segment 
  4. Click OK


Configure Field Synchronization

On the Eloqua Integration Fields tab, you can select which attribute fields should be pulled from or pushed to Eloqua. Fields being pushed to Eloqua must be created in Eloqua before they can be configured on the Fields tab. The destination field name and label are also configurable.

  1. Click Push a New Attribute or Pull a New Attribute
  2. Select the Source Evergage Field
  3. Select the Eloqua Custom Field
  4. Click OK

Configure Campaign Detection

On the Eloqua Integration Campaigns tab, you can configure third party campaign landing URLs to track different information about a campaign. When a matching URL is clicked for the first time, a campaign is created and will appear in Interaction Studio CAMPAIGNS. Any subsequent clicks will register impressions for the campaign.

  1. Click Add Parameter Mapping
  2. Set the Parameter Type
    1. Landing Page URL Query Parameter
    2. Referral URL Query Parameter
  3. Enter the Parameter Name
  4. Set the Target Type (optional)
    1. Campaign ID
    2. Campaign Name
    3. Campaign Source
    4. Campaign Medium
    5. Campaign Attribute
    6. Campaign Experience ID
    7. User Attribute
  5. Enter the Target Field Name (optional)
  6. Click OK

Common Questions

What should I do if I have trouble with the synchronization?

If the synchronization does not work as expected, please click Contact Support above and complete the form.

In the Push Fields section, what do each of the Source Evergage Fields do?

  • ID - The unique Interaction Studio ID - It is an anonymous ID for non logged in users
  • Evergage Link - The link to the user profile screen
  • First Active - The day and time the visitor was first tracked by Interaction Studio on your site
  • Last Active - The day and time the visitor was last tracked by Interaction Studio on your site
  • Engagement - A scoring metric configured in Interaction Studio to show the engagement of a visitor with your site
  • Engagement Trend - An indicator of whether engagement for the visitor has increased or decreased since the last synchronization
  • Segment Names - A list of the segments that the visitor belongs to
  • Total Visit Count - A count of the total number of visits a visitor has made to the site since Interaction Studio began tracking
  • Total Action Count - A count of the total number of actions a visitor has completed on the site since Interaction Studio began tracking
  • Lifetime Value (retail only) - The total revenue the visitor has generated since Interaction Studio started tracking on your site

When you choose one of the push fields, it creates an Eloqua field name and label. Will the system create those automatically, or do we need to create those fields in Eloqua? And can they be fields or Custom Data Objects?

Eloqua will auto-create the Eloqua fields. Interaction Studio doesn't support custom data objects. The custom fields Interaction Studio creates are on Contacts.

Are there any specific naming conventions required for the field names & labels?

Interaction Studio will auto-generate an Eloqua field name for push fields and all fields names will be prefixed with "evg_". You also have the option to change the prefix or the field name that will be passed.