Oracle Eloqua Setup & Usage Guide

This guide shows how to:

• Add SendForensics as a contact/recipient in Oracle Eloqua.
• Confirm the Oracle Eloqua credentials required for the integration.
• Enter the credentials in SendForensics and activate the integration.

1. Introduction
2. Add SendForensics as a contact in Oracle
3. Activate the Oracle integration within SendForensics
4. Enjoy using the new workflow!
5. Troubleshooting

Note: The ESP's API can change unexpectedly from time to time, and there may also be variations within individual ESP accounts. If you are having any trouble connecting or with integration features, please raise a ticket with our friendly Support team who will help you through it.

---

 

1. Introduction

The SendForensics system needs to become another recipient of your emails (in the same way as any other customer) to be able to analyze your deliverability properly:

So when you send a campaign email (one to many), you will need to include your unique SendForensics analysis address (user menu > Addresses) in the list of recipients.

The integration then allows the automated analysis of your Oracle Eloqua engagement data* to complete the deliverability picture:

*Anonymous, aggregated email marketing metrics containing no personally identifiable information (PII). More information »

---

 

2. Add SendForensics as a contact/recipient in Oracle Eloqua

First locate your unique SendForensics analysis address within your SendForensics account (user menu > Addresses):

Now copy this unique analysis address and add it as a new contact in Oracle Eloqua.

We would suggest creating a new list/segment just for this contact, calling it something recognizable such as 'Deliverability Testing' so it can be easily included in all live sends, and also used for pre-send tests.

Now whenever you send an email campaign with Oracle Eloqua, always include this list/segment/contact and the SendForensics system will receive a live copy for analysis.

To additionally run a placement test if required, you will need to add the full seedlist of addresses in the "For Deliverability Analysis + Placement Test" section in the same way.

---

 

3. Activate the Oracle integration within SendForensics

1. In SendForensics, go to Integrations and select Oracle Eloqua.
2. Enter your Oracle Eloqua Username and Password.
3. Click Activate integration.

Once activated, SendForensics validates the credentials and automatically determines the correct Oracle Eloqua instance URL. You do not need to enter the Eloqua Site Name, Pod, or Base URL manually.

On successful activation, the system will pull in the engagement data for all campaigns (after the date of activation) that have a corresponding analysis in the system (by being a recipient as per Step 1. Add SendForensics as a contact in Oracle Eloqua).

---

 

4. Enjoy using the new workflow!

Campaign sends (one to many)

Each time you create a new campaign and are ready to send live, first send a test to your unique SendForensics analysis address for pre-emptive deliverability analysis.

After receiving it, the system will process your email and display the full deliverability analysis results within your (SendForensics) dashboard. It will be marked as a 'Test' send where detected (if it is mistakenly marked as a 'Live' send, use the Test/Live switch to correct it).

Cycle through the tabs (Content, Infrastructure etc) following the advice and recommendations to optimize the deliverability of your email as much as possible, re-testing as necessary. When you have reached a comfortable deliverability score (vs amount of work needed to improve it further), the campaign can be sent live.

The live send will also be processed (as a result of Step 1 above), and will additionally contain an analysis of your engagement data (live results):

Click on any of the bounce/complaint/unsubscribe graph points to click through to the campaign email responsible for those results. Any reported issues with these metrics especially should be acted on and corrected before the next live send.

---

 

Troubleshooting

Invalid credentials / authentication errors

• Re-check the Username and Password for copy/paste errors.
• Confirm the Oracle Eloqua user is enabled.
• Confirm the user has the required API and reporting permissions.
• If the password was recently changed, update the integration credentials and activate again.

Connected, but data is missing

• Confirm you are viewing a date range where there is Oracle Eloqua campaign activity.
• Confirm the campaign was sent from Oracle Eloqua to the SendForensics seedlist contacts/list/segment.
• Confirm link tracking is enabled so the campaign identifier can be detected from the received seed message.
• Confirm the campaign is within the reporting window available from Oracle Eloqua’s Campaign Analysis reporting API.

Wrong campaign or no campaign match

• Open the received seed message source and check that tracked links include elqCampaignId
• If links were not tracked, or were rewritten by another system after leaving Oracle Eloqua, SendForensics may still identify the sending platform but may not be able to associate the message with the exact Oracle Eloqua campaign.