Page tree

 

Contents

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 Evergage 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 Evergage and passing behavioral and analytics data from Evergage helps you better target your Eloqua campaigns.

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

  1. Setup authentication
  2. Configure match fields
  3. Configure segment synchronization
  4. Configure field synchronization
  5. Configure campaign detection
  6. Enable or disable synchronization
  7. Common Questions

Setup Authentication

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

  1. Log into Evergage as an administrator
  2. Select SETTINGS > Third Party Products > Eloqua
  3. Select Setup and copy the OAuth Callback URL

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

  5. Paste the OAuth Callback URL you copied from Evergage

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

 

 

Configure Match Fields

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

Configure Segment Synchronization

On the Eloqua Integration Segments tab, you can synchronize Evergage segments to Eloqua and vice versa. You must create any Evergage 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 Evergage 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


Enable or Disable Synchronization

The integration will synchronize nightly, but you can disable automatic synchronization or perform a manual synchronization at any time.

  1. Select Setup 
  2. Select Disabled to disable Nightly Sync
  3. Click SYNCHRONIZE NOW to immediately begin the synchronization. This will not disrupt nightly synchronization, if enabled

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 Evergage 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 Evergage on your site
  • Last Active - The day and time the visitor was last tracked by Evergage on your site
  • Engagement - A scoring metric configured in Evergage 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 Evergage began tracking
  • Total Action Count - A count of the total number of actions a visitor has completed on the site since Evergage began tracking
  • Lifetime Value (retail only) - The total revenue the visitor has generated since Evergage 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. Evergage doesn't support custom data objects. The custom fields Evergage creates are on Contacts.


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

Evergage 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.

This page has no comments.