Swap Email Address Cloud App Documentation

Purpose

This Eloqua ‘Swap Email Address’ Custom Cloud App is designed to take an email address from a user-specified contact field and move the value in that field to the Email Address field.  The app will give the ability to easily send communication to an email address that is different than a contact’s primary email address.

Set-up in Oracle Eloqua

Please follow these instructions to set up this cloud app in your Oracle Eloqua instance.

  • Log in to Oracle Eloqua.
  • Click on Get App below to install.

        NOTE: If prompted to log again, please do so.

  •  In the next screen, click “Sign In” and then “Accept”
Swap Email Address Cloud App Documentation 12
  • You’re all set. The Eloqua ‘Swap Email Address’ Custom Cloud App is ready to be used.

How to use

To configure the Eloqua ‘Swap Email Address’ Custom Cloud App, follow these steps:

  • After installing the App, first drag a ‘ Email Address’ campaign step onto your campaign canvas and connect it to your segment:
Swap Email Address Cloud App Documentation 13
  • Finally, for the email to be replaced back to the original Email Address value, a second app step will need to be added after the last wait step:
Swap Email Address Cloud App Documentation 14
  • Click the pencil icon to open the settings for this step. This is needed to select the custom contact field that will be used to replace the Email Address field value. i.e. ‘Preferred Email Address’:
Swap Email Address Cloud App Documentation 15
  • You will need a user to log in to configure this Cloud Action. If you don’t have one, you can create one. If you do, use your user to Log In in the page shown in the following screenshot:
Swap Email Address Cloud App Documentation 16
  • After logging in, you will be taken to the app in a pop-up window. Choose the custom field (for example: Preferred Email Address) from the dropdown that contains the email address that will be replacing the Email Address field and hit ‘Save Settings’:
Swap Email Address Cloud App Documentation 17
  • After selecting the custom field and saving, you will need to repeat the app configuration process for the second app instance but selecting the other custom field (for example: Primary Email Address) instead:
Swap Email Address Cloud App Documentation 18

License Information

You need a license to configure and execute this Cloud App. Otherwise in the configuration page you will see the following error:

Swap Email Address Cloud App Documentation 19

Additionally, if you happen to see records stuck in the Cloud Action step, it may be due to a missing or expired License which you can get with your corresponding Account Manager.