Swap Email Address Cloud App Documentation

image_pdfimage_print

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 1
  • 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 2
  • Add a wait step to your canvas and connect it to the app, you can then add the email you’ll be sending and connect it to the wait step:
Swap Email Address Cloud App Documentation 3
  • 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 4
  • 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 5
  • 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 6
  • 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 7
  • 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 4
  • After you make sure all of your campaign steps are properly configured and the segment is in place, you are now ready to activate the campaign and see the ‘ Email Address’ app in action!

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 9

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.