6Set Up and Administer Oracle Eloqua Integration

Set Up DataFox for Eloqua

Setting up Oracle DataFox for Eloqua is easy. This topic provides details about installing and configuring the application.

Before You Start

  • You must have valid licenses for Oracle Eloqua, Oracle DataFox, and Adaptive Intelligent Apps for CX, B2B Marketing Enterprise Records Cloud Service (also known as DataFox for Eloqua).

  • After you place your order for DataFox for Eloqua, wait for Oracle Support to send you an email with the URL to install the application.

  • Create dedicated Oracle Eloqua and Oracle DataFox accounts to use DataFox for Eloqua.

  • Review the Contact Fields list on the Fields & Views page in Oracle Eloqua. To access the Contact Fields list, go to the Settings page in Oracle Eloqua, click Fields & Views in the Database Setup section, and then click Contact Fields. Ensure you have at least 12 custom contact fields available on the Fields & Views page to display data from Oracle DataFox. Of these 12 custom contact fields, ensure at least one field is a Large Text data type field. At any given time, you can include not more than five Large Text data type fields. For a detailed list of Oracle DataFox fields, see Oracle DataFox Fields in Oracle Eloqua.

  • If you want to use account scoring, it's a good idea to set up your account scoring criteria and tiers in Oracle DataFox before you install the DataFox for Eloqua app. You can then see the account score and tier data for the contacts in Oracle Eloqua immediately after the initial enrichment process. For more information, see Account Scoring.
    Note: The account scoring data isn't displayed for companies that don't have an account score or account tier in Oracle DataFox.

Configure and Install the DataFox For Eloqua application

  1. Click the DataFox for Eloqua application installation URL that you received from Oracle Support. You are redirected to the Oracle Eloqua Sign In page.

  2. Enter your company name and Oracle Eloqua credentials, and click Sign In.

  3. On the AppCloud authorization page, click Accept and Install.

Note: The application needs permission to access Oracle Eloqua and Oracle DataFox. Therefore, you must sign in to Oracle Eloqua and Oracle DataFox to complete the authorization.

The DataFox for Eloqua application is now installed, and you can view the application in your AppCloud Catalog My Apps list.

After the application is installed, the matching process begins. You might want to create an Oracle DataFox view on the Contacts Overview page in Oracle Eloqua to verify if your contacts are being enriched. For more information, see Creating Contact Views.

You should start seeing the additional Oracle DataFox fields with firmographic and account score data for the contacts in Oracle Eloqua within 24 hours. All the subsequent data retrievals occur every 24 hours. About two hours after the app is installed in Oracle Eloqua, go to the Contacts Overview page. You can check which accounts are enriched with firmographic and account score data. For example, the DataFox Company Revenue field displays the estimate of the enriched company’s annual revenue.

This screenshot shows some of the enriched data fields listed in Oracle Eloqua.

Contacts Overview page

Note: Time taken to complete the initial matching and enrichment may vary based on the number of Eloqua contacts.

If you don't see the Oracle DataFox fields, contact Oracle Support.

How DataFox Companies and Eloqua Contacts Are Matched

The matching process uses each contact's email domain, contact ID, and company name in Oracle Eloqua to find the same company in Oracle DataFox. If it finds a matching company, the process enriches the contact record in Oracle Eloqua by populating custom fields with additional data from Oracle DataFox.

The confidence score determines how closely an account in Oracle Eloqua matches a company in Oracle DataFox. When the system returns a matching company, Oracle DataFox records the company only if the match is above a specific confidence level. If a contact is matched with multiple companies, Oracle DataFox only records the company match that has the highest confidence score.

If a contact isn’t matched with a company, Oracle DataFox records the reason it wasn’t matched, and continues to the next contact. The DataFox Company ID field on the Contacts Overview page displays the status of unmatched records. This table illustrates the different scenarios and status where the records are unmatched.
Status of Unmatched Records Scenario Action

InsufficientConfidenceScore

Contacts in Oracle Eloqua match with companies in Oracle DataFox, but the confidence score is less than 50%

Verify that the company name matches the email address domain, as this is the most common cause of low confidence score
NoCompanyMatchFound
  • Contacts in Oracle Eloqua where the company doesn’t exist in Oracle DataFox

  • Contacts in Oracle Eloqua with a typo in the company name or email domain

  • Contacts in Oracle Eloqua with a mismatch between the company name and email domain

  • Check if the matching company exists in Oracle DataFox

  • Check if the spelling of the company name or email domain is correct

  • Check if the company name and email domain match

Empty

Contacts in Oracle Eloqua without an email address

Verify that the contacts have a valid email address

For help on unmatched records, contact Oracle Support.

Oracle DataFox Fields in Oracle Eloqua

Here’s the list of Oracle DataFox fields available for enrichment. This table lists all the Oracle DataFox fields and their mapping to the Oracle Eloqua fields. It also lists custom fields that are created when a corresponding Oracle Eloqua field doesn’t exist. This table includes the Field Type column to ensure that the fields are defined appropriately.

Oracle DataFox Field Custom Field Field Type Data Type for Eloqua Field Description Example Output
id DataFox Company ID ID String ID of the company 51815684e8945ea3240e6a09
name DataFox Company String Text Name of the company Oracle
city DataFox Company City String Text City in which the company is located St. Louis
state DataFox Company State String Text State in which the company is located MO
country DataFox Company Country String Text Country in which the company is located US
top_keywords DataFox Company Keywords String Large Text List of the company’s top keywords Bakery, restaurant, b2c, food and beverage, hospitality, categories, cafes
industry_name DataFox Industry Name String Text The company’s industry name Hospitality
subindustry_name DataFox Subindustry Name String Text The company’s subindustry name Food services and Drinking places
revenue_estimate DataFox Company Revenue Integer Numeric Estimate of the company’s annual revenue
Note: The revenue is represented in U.S. Dollars.
1000000
number_of_employees DataFox Company Employees Integer Numeric Estimate of the number of employees in the company 100000
score DataFox Account Score Float Numeric Account score of the company 340
tier DataFox Account Tier String Text Account tier of the company Tier 1

Reinstall DataFox for Eloqua

You might need to reinstall the DataFox for Eloqua app to reauthenticate and reauthorize the Oracle DataFox and Oracle Eloqua accounts. This list summarizes the scenarios where you may need to reinstall the app:
  • If the initial installation begins but isn’t complete due to installation flow issues

  • If the contacts are no longer enriched due to expired, lost, or invalid tokens

  • If you need to change either of the authorized Oracle Eloqua or Oracle DataFox accounts

Note: After you reinstall the app, you must wait for the next sync to get the most updated data on your contacts. Reinstalling the app doesn't automatically update the contacts that were added since the last enrichment.
Here’s what you can do to reinstall the app:
  1. In Oracle Eloqua, click the Settings icon, and then click Apps.

  2. On to the AppCloud Catalog My Apps page, do one of these actions based on the state of your app.

    • If the app isn’t working and therefore needs to be reinstalled, click the Reinstall button against the app.

    • If the app is in a working state but needs to be reinstalled, select the DataFox for Eloqua app, and click the Reinstall icon. You could come across this scenario if the tokens expire or if the admin who was granted the token initially needs to be changed.

      This image illustrates the Reinstall icon for the DataFox for Eloqua app.

      Reinstall Icon

  3. Sign in to Oracle Eloqua and Oracle DataFox to complete the authorization.

The DataFox for Eloqua application is now reinstalled. You can view the confirmation message after the app is reinstalled.

Note: The app is unavailable for all users during the reinstall.

Uninstall DataFox for Eloqua

You can uninstall the DataFox for Eloqua app if you no longer want to pass data from Oracle DataFox into Oracle Eloqua.

Uninstalling an application removes all the links and authorizations related to the application. Uninstalling stops all scheduled jobs and updates. However, uninstalling the application doesn’t remove the existing Oracle DataFox data or custom contact fields from Oracle Eloqua. You need to delete the fields manually, if required.

To remove the app from your instance:
  1. In Oracle Eloqua, click the Settings icon, and then click Apps.

  2. Select the DataFox for Eloqua app, and click the Uninstall icon.

The DataFox for Eloqua app is now uninstalled.