Eloqua Integration Testing Guide

In this topic you will learn how to verify an integration between Video Cloud and Eloqua.

When setting up a new Eloqua integration, it can be challenging to test and confirm that video viewing data is indeed being delivered to Eloqua. In this topic, you will learn how to systematically test and confirm that the integration works and that viewing data and leads are being sent to Eloqua.

Before you get started

Before validating the integration it is assumed you have:

Configuring a test lead form and publishing a video

For testing purposes, you will need to create and configure a custom lead form in Campaign. This is an Eloqua form whose embed code you have pasted into Campaign. Even if you will not be using lead forms in your production environment, this lead form is used to be sure that you are known in your database and on the page. To create a Eloqua form and configure Campaign to use it, follow these steps.

  1. Login to your Eloqua account.
  2. Create and style an Eloqua form. For information on creating a Eloqua form, see Creating Custom Lead Forms for Oracle Eloqua.
  3. Click Actions > View Form HTML at the top of the page.
  4. Copy the form embed code to the clipboard.
  5. Return to the Campaign module.
  6. Create a new lead form using the Eloqua form embed code.
  7. Set your custom form to display the form at the 5 second mark. This way you will know exactly when it should appear.
  8. Check the box to Always show the lead form even if the lead is already known. This will ensure the form continues to display after filling it out during testing.
  9. Save the form.
  10. Configure the Brightcove Player with the Eloqua connection to use the Eloqua lead form that was just created.

Generating a preview link to view the video

To generate a preview link to the video, follow these steps.

  1. Open the Media module.
  2. Select a video and publish it to a web player. Make sure to select the Campaign-enabled player with the lead form.
  3. Click the preview link to open the video in a new browser window. Testing this way eliminates any potential variables that could be introduced by players embedded on a HTML pages.
  4. Confirm that the video plays and that the lead form displays at the 5 second mark.
  5. Fill out the lead form using unique contact info and email address (i.e. a celebrity name or a name containing the words “bctest”) so that it can be easily found later in Eloqua. This eliminates any browser, player or database level variables. By filling out the form as a new user, we can be sure you are now a known user in Eloqua.

Confirming that Campaign is successfully capturing the data

Before looking for video viewing data in Eloqua, first confirm that Campaign has indeed captured the video view. Note that viewing data may take up to 3 hours to display in the Campaign UI. To confirm that Campaign is successfully capturing the data, follow these steps.

  1. Open the Campaign module.
  2. Click All Recent Activity in the left navigation.
  3. Confirm that there is an event with a recent timestamp showing the name of the video that was just watched. The event status should be unprocessed. This indicates that Campaign has captured the view but has not yet attempted to sync it to Eloqua.
  4. To manually trigger a sync between Campaign and Eloqua, click Synchronization Activity in the left navigation.
  5. From the Select Connection dropdown list, select your Eloqua integration. A Test Sync button should appear.
  6. Click Test Sync to trigger a manual sync. Note that you are limited to how often you can trigger a manual sync. By default, Campaign will sync views to Eloqua once an hour.
  7. Click All Recent Activity in the left navigation.
  8. The status of your view event will be queued. It may take 15 minutes or so for the data to actually sync to Eloqua. Once the data does sync, the status will change to one of two statuses:
    • synced - Indicates the user was a known user and data was successfully delivered to their activity log. The data should also be viewable in Eloqua within a few minutes.
    • unknown_contact - Indicates the user was considered unknown and Eloqua was unable to accept the data. If you get an unknown_contact status, check that you published the video using the correct player, have a Eloqua form in place and are testing using the preview link, not embedded in a page.

Confirming that the video view data is in Eloqua

Once Campaign has displayed a synced status, follow these steps to verify that the data is in Eloqua.

  1. Login to your Eloqua account.
  2. Navigate to the Custom Objects.
  3. Locate the BrightcoveVideoView custom object.
  4. Click on the dropdown arrow next to it and then click Custom Objects Records Mapped to Contacts Breakdown. A list of contacts who have video viewing data in this custom object will be displayed.
  5. Locate the unique name or email address you used when filling out the lead form.
  6. Click on the contact to open up the details page. A list of all video view records for the contact will be displayed. This is the video view data delivered from Campaign to Eloqua. Fields such as Video Name, Video ID, Player ID, Time Watched, Percent Viewed and more are included.

Eloqua requires data being delivered into a Custom Data Object be assigned to a known contact. Eloqua will only accept data of known contacts. Data of unknown contacts will not be synced. If you don't use lead forms, there is no way for an unknown user to convert to a known user and thus no data will be synced.