Connect this destination to export audience membership into an Eloqua shared list, or to write warehouse rows onto Eloqua contacts and custom data objects, for use in Eloqua campaigns.

This destination writes to your Eloqua account and is a good fit when you want to:

• Match contacts on email
• Make GrowthLoop audiences available as an Eloqua shared list
• Update Eloqua contact fields, including custom fields, for exported contacts
• Keep Eloqua contact fields up to date from a warehouse table
• Keep Eloqua custom data object records, such as orders or event registrations, up to date from a warehouse table

This maps to GrowthLoop Audiences, Journeys, and Syncs:

Prerequisites

Make sure you have:

• An Eloqua account. If you do not have one, contact Oracle Sales.
• An Eloqua user with Advanced Users – Marketing permissions and API access.
• For custom data object syncs, the custom data object already set up in Eloqua.

Set up Eloqua as a destination

1. In GrowthLoop, click the Destinations tab on the left sidebar.
2. Click New Destination in the upper right corner.
3. Search for Eloqua and click Add Eloqua.

📘

Note

Don't see Eloqua when you try to add a destination? Reach out to [email protected] and we'll enable it.

4. Enter the required information, then click Create.

GrowthLoop validates that it can load audience data to Eloqua. Eloqua then appears in your list of connected destinations.

Export to Eloqua

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for Eloqua. In a journey, add a Destination Node under Ads and select Eloqua.

Map contact identifiers

Map Email Address. Eloqua requires email to match contacts.

You can also map these optional fields:

Send additional fields

Use Additional Fields to update any other Eloqua contact field, including your custom fields. For each field, select the column from your dataset and enter the Eloqua field name:

• Use the field's display name as it appears in Eloqua, such as Lead Status, or its internal name, such as C_Lead_Status1.
• If two Eloqua fields share the same display name, use the internal name.
• Empty values are skipped, so they never clear data already stored in Eloqua.

⚠️

Warning

If an additional field doesn't exist in Eloqua or is read-only, such as Date Created, the export fails and shows which fields to fix. Batches sent before the failure may have already updated some contacts, so correct the field names and rerun the export.

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

Export behavior

This is what GrowthLoop writes when you export an audience.

Create a sync in GrowthLoop

Create a sync from a warehouse table to write rows onto Eloqua contacts or Eloqua custom data object records. See Syncs for information on how to complete those steps.

Select an Object type:

1. In GrowthLoop, click Syncs on the left sidebar, then click New Sync.
2. Under Sync settings, enter a Name, choose a Frequency, and choose an Update rule. Custom data object syncs always insert or update records, whichever rule you choose.
   • Insert: Create new contacts only. Existing contacts are left unchanged.
   • Update: Update existing contacts only. No new contacts are created.
   • Insert or update: Create contacts that do not exist and update contacts that already exist.
3. Under Source, select the Dataset / table that holds the fields you want to sync and the Dataset unique field(s). For Match field, select your email column for contacts, or the column that uniquely identifies each record for a custom data object.
4. Under Destination, select your Eloqua destination as the Connection, and select Contacts or a custom data object as the Object type. Custom data objects are listed by name followed by (Custom Object). For Match field, select Email Address for contacts, or the custom data object field that uniquely identifies each record.
5. Under Field mapping, map at least one field. For each row, select a Source field and the Eloqua Destination field. Click Add field for each additional field.
6. Click Create sync.
7. Open the sync and turn on Enabled.

To change an existing sync, update its settings or field mappings and click Save changes. If GrowthLoop asks how to apply newly mapped fields, choose Updates only to send values when they change, or Back-fill existing customers to send current values for every contact.

Syncs update Eloqua contacts and custom data object records. They do not add or remove contacts from a shared list. To manage shared list membership, export an audience.

Eloqua contact fields

Map Email Address, then map the contact fields you want to write.

Eloqua custom data object fields

Map the field that identifies each record, then map the custom data object fields you want to write. See Oracle's custom objects documentation to set up the object and its fields.

Sync behavior

Confirm the export was successful

When the run finishes, confirm you can use the data in Eloqua.

• Audience export: Go to login.eloqua.com, open Audience → Tools → Shared Lists, and look up the list named after the export.
• Journey Destination Node: Open Audience → Tools → Shared Lists and look up the list named after the export. Confirm a contact who reached the node is in it.
• Contact sync: Open Audience → Contacts, search for the contact, and check the mapped fields.
• Custom data object sync: Open Audience → Tools → Custom Objects, open your custom data object, and view its records. Check the mapped fields, and that records are linked to contacts if you mapped the email address field.

In GrowthLoop, review counts on the audience Exports tab, open the Activity tab on the journey Destination Node, or confirm the sync appears in the Syncs table. See Export an audience, Monitor a journey, or Syncs for more information.

Congrats on successfully exporting to Eloqua!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.