How to: Configure an Outbound Activity Integration with Eloqua

Ada Labalan

December 17, 2024 18:03

Follow

The integration with Brandlive APIs described in this article offers full programmatic access to Eloqua APIs to map and sync data to both Contacts and Custom Objects. The scope of the Registration and Activity integrations outlined in this document will utilize the following Eloqua endpoints: 

• Create Contact: to create new contacts as they register for webinars (events) if a contact record does not exist for a given email address 
• Update Contact: to update an existing contact in conjunction with registration for a given webinar (event) if a contact record already exists for a given email address
• Create Custom Object: to create the custom object representing a contact’s registration for a given webinar (event)
• Create Custom Object Data: to update the custom object representing a contact’s registration for a given webinar (event) with webinar specific information like name and URL for reference and use across Eloqua automations

Brandlive registration sync with Eloqua (Contacts and Custom Objects)

To integrate attendee engagement data with Eloqua, you need to first create a registration record for each webinar registrant on the Brandlive Platform. At the point of registration, Brandlive structures and passes a contact record (indexed by email address) and affiliated custom object in Eloqua allowing further engagement data to populate as that registrant takes actions in the platform.

Configuration Steps:

1. In Eloqua, define a Custom Object to receive Brandlive registrant and activity data:

• Define a custom object in Eloqua with the relevant property fields to sync data with Brandlive (checkbox Y/N for each activity type)
• Grab the Custom Object ID from Eloqua once it has been created

2. In the Brandlive Platform, you now create an outbound integration tile for the Registration integration. This will need to be configured at the channel level and can later be altered at the project level if needed on a per project basis.

In the Brandlive Admin Console, navigate to the Settings tab from the top navigation menu, then select "Integrations" from the side navigation.

In the Integrations dashboard, click the +Add button in the top right hand corner, then select “Custom” from the Add Integration modal:

3. Give your integration a name: Eloqua Registration Custom Object. Then, from the "Integration Type" dropdown menu, choose the “Eloqua Custom Object Outbound Registration” option. You will then need to set static mapping fields and use the following key/value pairs.
   1. In Static Mapping, put the object ID: EloquaObjectID on the left hand side, and the Eloqua value on the right hand side.
   2. Click Next, and optionally choose which Project Groups should have access to this integration.

Brandlive’s Eloqua integration requires custom object configuration, so it is listed in the “Custom” area. The integration will be completely configurable and reusable within the Brandlive Admin Console across webinars without a requirement for ongoing maintenance. 

Brandlive attendee activity sync with Eloqua (Custom Object)

The custom object created as part of the registration integration is used to store and manage registrant specific activity in relation to each webinar hosted on the Brandlive Platform. Defining a custom object to house each registrant’s activity in association with a given webinar allows you to tailor our solutions or process automations (like lead scoring or nurture flows) within Eloqua based on specific Brandlive data updated in real time as users take action within Brandlive.

Configuration Steps:

1. In the Brandlive Platform, you will need to create an outbound integration tile for Engagement Activities. This will need to be set up at the channel level and can later be altered at the project level.

In the Brandlive Admin Console, navigate to the Settings tab from the top navigation menu, then select "Integrations" from the side navigation.

In the Integrations dashboard, click the +Add button in the top right hand corner, then select “Custom” from the popup modal:

2. Give your integration a name: Eloqua Custom Object Activity Tracking. Then, from the "Integration Type" dropdown menu, choose the “Activity Tracking” option. You will then need to set activity tracking and add the values 1-7 in the corresponding fields.

• EloquaObjectID (Required) is the ID of the custom object that you would like to fill out with registration information
• Map each activity to the Custom Object field that you would like to fill based on the activity taken. For Example:
  • 1 = “Submitted Survey Y/N” in Eloqua = 541 Eloqua Custom Object Field ID
  • 2 = “Submitted Quiz Y/N” in Eloqua = 542 Eloqua Custom Object Field ID
  • 3 = “Submitted Poll Y/N” in Eloqua = 543 Eloqua Custom Object Field ID
  • 4 = “Submitted Question Y/N” in Eloqua = 544 Eloqua Custom Object Field ID
  • 5 = “Submitted Feedback Survey Y/N” in Eloqua = 545 Eloqua Custom Object Field ID
  • 6 = “Watched Live Y/N” in Eloqua = 546 Eloqua Custom Object Field ID
  • 7 = “Watched On-Demand Y/N” in Eloqua = 547 Eloqua Custom Object Field ID

In the Static Fields section, set the Key and Value to the Custom Object ID you defined as part of your Registration integration configuration:
CustomObjectID : YOUR-CUSTOM-OBJECT-NAME

Static fields can be added to your integration and customized on a per webinar basis to facilitate mapping to campaigns or other relevant Eloqua objects.

3. Once configured, you will be prompted to authenticate your Eloqua account. Authenticate to Eloqua and complete the required fields.

4. In the Integration section of the Settings tab, toggle on both the Registration and Activity integration tiles:

5. Now that you’ve set up both Registration and Activity integrations, navigate to the Project Dashboard and select the project for which you will collect activity. In the Project Details screen, navigate to the "Integrations" tab.

Toggle on the configured Eloqua integration (Registration and Activity Tracking) tiles.

Then, select "Edit Project" to enter the Sitebuilder. Publish your project for the integration to take effect.

6. To test your registration integration, copy the project link (URL), go to the page and submit your registration. After registering, engage in some kind of activity -- we recommend entering a question on the session page. You can also click “Send a test record” from the above Integrations tile. 

Then, return to Eloqua and search for the email address you registered with. You should see a record (Contact and Custom Object) of your test registration.

7. To test your activity integration, just wait 5 minutes — activities sync from Brandlive on 5 minute intervals. Then return to Eloqua and navigate to the “Questions Asked” property; it should show the submitted test question.