Unlinked CO Mapper Cloud App Documentation
Purpose
The Unlinked CO Mapper cloud app locates orphaned custom object records, searches for matching contact records using the email address field, and then maps the CO to the contact record. Below are instructions for using the Cloud Action inside either the Campaign or Program Canvas.
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.
![Unlinked CO Mapper Cloud App Documentation 18 Unlinked CO Mapper Cloud App Documentation 15](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-15-768x187.png.webp)
- In the next screen, click “Sign In” and then “Accept”
![Unlinked CO Mapper Cloud App Documentation 19 Unlinked CO Mapper Cloud App Documentation 16](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-11.png.webp)
- You’re all set. The Eloqua ‘Unlinked CO Mapper’ Cloud App is ready to be used.
![Unlinked CO Mapper Cloud App Documentation 20 Unlinked CO Mapper Cloud App Documentation 17](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-12.png-1024x163.webp)
How to use
The following instructions show a basic/simple usage. You can incorporate this Cloud Action into any existing program or campaign.
- Create or open a program
- Click on “Actions” on the top left side then “Program Steps” and then locate the “Unlinked CO Mapper” Cloud Action under the Actions options (colored in purple).
![Unlinked CO Mapper Cloud App Documentation 21 Unlinked CO Mapper Cloud App Documentation 18](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-16.png.webp)
- Drag and drop the cloud action to the canvas area. Connect the corresponding elements to the dropped cloud action
![Unlinked CO Mapper Cloud App Documentation 22 Unlinked CO Mapper Cloud App Documentation 19](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-13.png.webp)
- Double click the Unlinked CO Mapper step, and you will see some options for this element.
![Unlinked CO Mapper Cloud App Documentation 23 Unlinked CO Mapper Cloud App Documentation 20](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-17-768x399.png.webp)
Click the pencil icon to open the settings for this step.
You will need a user ID to log in and configure this Cloud Action. If you don’t have one, you can create one.
Under the configuration tab users can select the Custom Object sets where the app will search for custom object records mapped to the contacts in the step. The App will show all Custom Objects with a field for ‘Email Address’. This will be used to do the mapping to contacts in the program.
![Unlinked CO Mapper Cloud App Documentation 24 Unlinked CO Mapper Cloud App Documentation 21](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-18-768x329.png.webp)
The app will only display custom objects sets where the Email address field is configured as shown below. It then uses the Eloqua REST API to search for unmapped contacts.
![Unlinked CO Mapper Cloud App Documentation 25 Unlinked CO Mapper Cloud App Documentation 22](https://4thoughtmarketing.com/wp-content/uploads/2023/02/image-8-2.webp)
License Information
You need a license to configure and execute this Cloud App. Otherwise, in the configuration page, you will see the following error:
![Unlinked CO Mapper Cloud App Documentation 26 Unlinked CO Mapper Cloud App Documentation 23](https://4thoughtmarketing.com/wp-content/uploads/2023/01/image-8.png)
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.