BrightTALK Connector for Eloqua- Getting Started

In this support article, we will review how to connect your BrightTALK Channel to Eloqua.   

Here are the 5 easy steps required to set up the connection:

Step 1: Create an App in Eloqua

Step 2: Create Custom Object(s) in Eloqua

Step 3: Authenticate with BrightTALK

Step 4: Choose the fields to sync

Step 5: Choose the schedule for your data sync

STEP 1 - Create an App in Eloqua

In order for BrightTALK to connect to Eloqua, you must first create an App.  This can be done by following these steps (in Eloqua)

1. Go to Settings
2. Select "AppCloud Developer"
3. Click Create App
4. Create the App using these settings:

Icon Link:  https://www.brighttalk.com/resources/images/logo_b.png?v=103181

OAuth Callback URL Link: https://www.brighttalk.com/central

Once you've created the app, copy down the "Client ID" and "Client Secret."  You'll need those in step three of the setup.

STEP 2 - Create Custom Object(s) in Eloqua

BrightTALK uses Eloqua "Custom Objects" to track webinar activity (i.e. who registered/attended your webinar) and attachment activity (who downloaded or clicked attachments on your webinar).  

Creating a Custom Object for Webinar Activity (Required):

1. From the Custom Objects area of Eloqua, click the "Custom Object" drop-down then select "New Custom Object"
   
2. Name your Custom Object "BrightTALK Webinar Activity" and click "Next."
   
3. Add your activity fields.  BrightTALK requires that at least two fields exist on this object:
   
   1. Email Address (you can map this from your existing Contact fields)
      
   2. BrightTALK Activity ID- this is a custom "number" field that will be used as the "Unique Code" field.
      
      You may also want to add additional custom fields depending on your use case.  A full list of available fields can be found here
      
4. Save and make sure on the next screen that Unique Code Field is set to "BrightTALK Activity ID" and the Email Address Field is set to your default Email Address field.

Creating a Custom Object for Attachment Activity (Optional):

**Note: This section is optional.  If you wish to skip to the next section, click here

1. From the Custom Objects area of Eloqua, click the "Custom Object" drop-down then select "New Custom Object"
   
2. Name your Custom Object "BrightTALK Attachment Activity" and click "Next."
   
3. Add your activity fields.  BrightTALK requires that at least two fields exist on this object:
   
   1. Email Address (you can map this from your existing Contact fields)
      
   2. BrightTALK Attachment Activity ID- this is a custom "numeric" field that will be used as the "Unique Code" field.
      
      You may also want to add additional custom fields depending on your use case.  A full list of available fields can be found here
4. Save and make sure on the next screen that Unique Code Field is set to "BrightTALK Attachment Activity ID" and the Email Address Field is set to your default Email Address field.

STEP 3 - Authenticate with BrightTALK

From the home page of your BrightTALK Demand Central Account, click "Connect Now", select your Channel, then click Connect under "Advanced Eloqua Connector."  On this screen, enter the Client ID and Client Secret from Step 1:

 Click "Authenticate" which will briefly take you to Eloqua to approve the Connection.   Once approved, you'll be sent back to BrightTALK and can continue with the setup.

STEP 4 - Choose the fields to sync

To receive leads from BrightTALK, you will need to define the fields that should be mapped to corresponding fields in Eloqua.  This is done using three distinct sections:

Contact and Campaign Fields

These are fields that exist on your Eloqua Contact Record.  Each of these fields can only ever have one value (i.e. a lead can only ever have one "first name").  BrightTALK requires that two fields be mapped in this section:

-Email Address- this should be your default email field in Eloqua.
-BrightTALK User ID- This is a custom "numeric" field that is used by the Connector to find and identify BrightTALK leads.

Once you've mapped those fields (and any additional fields you wish to use), click "Save."

Webinar Activity Fields

These fields correspond to the "BrightTALK Webinar Activity" Custom Object we created in Step 2.  To map these fields, first select your Custom Object from the drop-down menu:

Then map your Email Address field, your Webcast Activity ID field, and any additional fields you added to this Custom Object and click "Save."

Attachment Activity Fields (optional)

If you created the Attachment Activity Custom Object in Step 2, complete this section by selecting your Custom Object and mapping your Email Address field, your Attachment Activity ID field, and any additional fields you added to this Custom Object.

STEP 5 - Choose the schedule for your data sync

Once your field mappings are saved, you will be able to choose the preferred cadence of your sync (hourly, daily, or weekly).

You’ll then be prompted to sync your data for the first time.  

BrightTALK recommends an hourly cadence for optimal performance and timely follow up on your best leads.  Additionally, if you plan to leverage custom reporting fields we suggest initially pushing all data from your channel.