PathFactory-Eloqua Integration

Summary

There are 2 ways to integrate PathFactory with your Eloqua Account:

  1. Eloqua API
    • Send page view data
    • Can help with visitor identification in certain scenarios
  2. Webhooks
    • Send data triggered by specific events, like meeting an engagement score threshold or viewing a particular content asset.
Note
If you want to export all available PathFactory data to a data warehouse PathFactory offers the ability to create Public API keys.

Set up Eloqua API

This article outlines the steps needed to set up the Eloqua API connection between PathFactory and Eloqua:

  1. IP address configuration
  2. Security groups configuration
  3. Add Eloqua credentials to PathFactory

Step 1: IP address configuration

Note
If you have IP address restrictions on your Eloqua account, you will need to add the IP addresses below. You can confirm whether you have IP restrictions by going through the next steps.
  1. In your Eloqua account, navigate to Settings > Setup > Security.
    Security set up

    Security set up

  2. Under IP Whitelist Configuration a button will indicate whether your Eloqua account has IP restrictions.
    • If the button text is Enable IP Address Restriction, skip the next step and go to Security Groups Configuration below.
      imageEnable IP Address Restriction button
  3. If you have IP Whitelisting enabled, select Create IP Address Range and enter each following IP address separately as a Specific IP Block and make sure to save.

    52.204.127.93

    76.9.217.70

    image

    Create IP Address Range

Step 2: Security groups configuration

  1. In Eloqua, browse to the User Management area of the application.
  2. Select the user account that will be used for the PathFactory-Eloqua integration.
  3. The selected user must be added to the Security Groups:
    • API Users
    • Advanced Users – Marketing
  4. Save the new Security Group settings.

    imageSecurity Group settings

Notes

  • If your organization is using Eloqua Contact-Level Security ensure that the PathFactory-Eloqua integration user has all of the security groups related to Contact-Level Security labels.
  • If your organization has created its own Eloqua custom security groups, ensure that the PathFactory-Eloqua integration user has the same level of access that the “Advanced Users – Marketing” and “API Users” groups provide to:
    • Run API commands
    • Create and edit contacts, CDOs, and Shared Content
  • Consider selecting or creating a dedicated user for this purpose not associated with a personal Eloqua account.
    • If you create a dedicated user remember to activate the new account and check the password by logging into Eloqua with the new user’s credentials.

Step 3: Add Eloqua credentials to PathFactory

To complete this procedure, you must have administrative privileges in PathFactory.

  1. Log in to the Eloqua user from the previous step.
  2. In a new tab within the same browser, sign in to PathFactory.
  3. In the top right, select your user name and select Organization Settings.
  4. In the on-page navigation, select Eloqua Account.
  5. Select Authenticate Eloqua User. The Eloqua log in screen appears.
  6. Confirm the username matches the account you want to authenticate and select Sign In. You will be given one more chance to confirm the account.
  7. Select Accept. You should see a confirmation message when the credentials are authenticated successfully.

You’ll be redirected to PathFactory and if everything has worked correctly, you’ll see a confirmation message in PathFactory.

Confirmation message

You can now enter or update the First Party Cookie Tracking domain for your Eloqua instance, and disable or enable the Eloqua tracking script from running inside of PathFactory. You may do this is if you wish to run a customized version of the Eloqua tracking script using our external code configuration.

Updated on April 4, 2023

Was this article helpful?

Need Support?
Can't find the answer you're looking for? Don't worry we're here to help!
CONTACT SUPPORT