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
Click the DataFox for Eloqua application installation URL that you received from Oracle Support. You are redirected to the Oracle Eloqua Sign In page.
Enter your company name and Oracle Eloqua credentials, and click Sign In.
On the AppCloud authorization page, click Accept and Install.
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.
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.
|Status of Unmatched Records||Scenario||Action|
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|
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.
|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
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
In Oracle Eloqua, click the Settings icon, and then click Apps.
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.
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.
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.
In Oracle Eloqua, click the Settings icon, and then click Apps.
Select the DataFox for Eloqua app, and click the Uninstall icon.
The DataFox for Eloqua app is now uninstalled.