Integrate with Oracle Responsys

Why Integrate with Oracle Responsys?

The integration with Oracle Responsys lets you insert published assets from an Oracle Content Management asset repository into Responsys Email and Mobile campaigns. Using Oracle Content Management as a single source for all images saves rework because you can find your images easily.

Responsys users can leverage the extensive asset repositories in Oracle Content Management to store content while using Responsys to design campaigns. When you design Email and Mobile campaigns, this integration gives you the option to insert published image assets from Oracle Content Management into your campaigns. You can choose digital assets from an Oracle Content Management publishing channel through the Responsys application.

Prerequisites

These are the prerequisites before you begin the integration process.

Note:

Integrations generally require configurations in both applications that are being integrated. So check the documentation on both sides. In addition to the requirements on the OCM side, you need a subscription for the product that you intend to integrate with OCM. Please also see the Oracle Responsys documentation.

• Create and activate an Oracle Cloud Account before you begin.
• Review Overview of Oracle Content Management, which provides information on interacting with OCM and concepts on access roles for performing certain tasks.
• Compare the starter vs. the premium edition of Oracle Content Management. Only the premium edition has all the features.
• Create an Oracle Content Management instance.
• Take a guided tour of repositories in Oracle Content Management.
• Create an asset repository. To set this up, you need to have the repository administrator (CECRepositoryAdministrator) role in Oracle Content Management.

Integration Process

The process of Responsys integrating with Oracle Content Management consists of the following steps:

1. Choose an Asset Repository and Create Two Publishing Channels
2. Enable the Integration

Then you can create and publish assets in Oracle Content Management and view images in the Responsys Message preview.

Choose an Asset Repository and Create Two Publishing Channels

When you design an Email or Mobile campaign, you will choose assets from the publishing channel for the appropriate campaign type. Responsys will automatically filter content assets in Oracle Content Management according to the campaign you are designing.

After you choose an asset repository in Oracle Content Management, create and share two publishing channels: a mobile channel and an email channel. Oracle suggests creating channels that are specifically for Responsys. See Create and Share Publishing Channels.

In Responsys, you can choose Oracle Content Management assets from these channels.

Enable the Integration

You can enable the integration between Oracle Responsys and the Oracle Content Management account from Responsys.

In Oracle Responsys, choose Oracle Content Management Cloud Integration from the Integrate menu.

This feature is available only if it is enabled for your account.

Configure an Oracle Content Management Cloud account

1. From the side navigation bar in Responsys, select Account.
2. Select Integration settings, and then choose Content Management Cloud settings.
3. Provide the following details about your Oracle Content Management instance to configure your publishing channels:
   • CEC API Version: Your Oracle Content Management version.
   • CEC Domain: The service URL of the OCM instance, for example,

     https://<Your OCM instance-tenancy>.cec.ocp.oraclecloud.com

   • CEC Publish Server URL Prefix: The service URL of the OCM instance, for example,

     https://<Your OCM instance-tenancy>.cec.ocp.oraclecloud.com

   • Email Channel ID: The ID of the Email channel, which is automatically generated when you create the channel.
   • Email Channel Token: The Email channel token, which is automatically generated when you create the channel.
   • Mobile Channel ID: The Mobile channel ID, which is automatically generated when you create the channel.
   • Mobile Channel Token: The Mobile channel token, which is automatically generated when you create the channel.
4. Click Save.

Enable Oracle Content Management Embedded Content

In Oracle Content Management administration security settings, enable embedded content and add the Responsys URL. Then you can embed the Oracle Content Management web UI in Responsys.

See Embed UI API V2 for Oracle Content Management.

Create and Publish Assets in Oracle Content Management

You can create and publish assets in Oracle Content Management to use in Responsys.

1. Create an HTML file.
2. Edit the HTML file in your ResponSys rich text editor.
   1. Open the image browser.

      The browser displays the available image libraries:

      
      
      Description of the illustration image-browser.png
      
   2. Display the Oracle Content Management asset picker.

      The asset picker opens on the Digital Assets page, which displays published assets in the Oracle Content Management account. If you don't see an asset you want, you can use the drop-down menu on the left to navigate different asset collections. Or you can upload and publish an image in Oracle Content Management.

      
      
      Description of the illustration digital-assets-all-oce.png
      
   3. Pick one of the assets, and click OK.

      The Image dialog opens and displays a thumbnail of the image and properties that you can set for it:

      • Title text
      • Alternative text
      • Height
      • Width
      • Link URL, which makes the image clickable.
   4. Set the properties you want.
   5. Click Apply to insert the image into your content.

      To view the URL to the image in Content Management, you can click Source. In a live production environment, this would be an asset pointing directly to the content delivery network, so that the asset is accessible.

View Images in Responsys Message Preview

To preview Oracle Content Management images in Responsys, you can use the Responsys Message Preview.

1. On the Oracle Responsys Manage campaigns page, choose Create campaign from the drop-down menu on the right, and create an Email or Mobile campaign.
   
   Description of the illustration create-campaign.png
   

2. Create a new HTML document.
3. Add a block in the HTML file for an image.
   
   Description of the illustration add-image-html-file.png
   

4. After the image is visible, you can click Preview to preview it in an email message.
   
   Description of the illustration message-preview-image.png