Configuring an Oracle Responsys connection

Configuring a connection to Oracle Responsys allows Oracle Infinity to connect to your instance of Responsys. When this connection is used in the configuration of an action, it can be used to deliver data from Infinity to the campaigns or programs you’ve configured in Responsys. Infinity data can then be used in your Responsys campaign for personalization, or for triggering your campaign based on behavioral data detected in real-time by Infinity.

In this topic, you'll learn about:

Pre-requisites:

  • Before you can configure a connection to Responsys, you must have a role assigned to you with the Manage Connections user right.
  • Create an Infinity user account in Responsys.
  • To begin receiving retargeting data in your Responsys account from Infinity, you’ll first need to establish a connection between the two systems. This is done by creating a Responsys user account with web services access. The account will be used as the login when creating a connection in Infinity.

  • If you create a Trigger REI Event destination type, you will need to create a service request through My Oracle Support to access the feature.

    To create an Infinity user account in Responsys:

    1. Sign into your Responsys account.
    2. Go to the Account Management page.

    3. Under the User Management section, click Add User.
    4. For Login name, create one using the following naming scheme: infinity_api_<business name>, and replace <business name> with the name of your business, with no spaces or special characters.
    5. For Email address, enter the email address of the user who will be managing this user account.
    6. For User Status, select Active.
    7. For User locale, select the desired language.
    8. For full standard API functionality, select all of the following under the Roles Assignment section. Do not select other roles for the API user. See here to learn more about creating API users in Responsys.
      • Analytics Web Services Manager
      • Campaign Web Services Manager
      • Content Web Services Manager
      • Folder Web Services Manager
      • List Web Services Manager
      • Program Web Services Manager
      • Table Web Services Manager
    9. Click the Organization Assignment tab (if present), and then select Root. Objects created through the API inherit the organizational membership of the API user.
    10. Scroll to the top and click the Create button when complete. You should be redirected to the Account Management page.

      For more details on how to create a user account, see the Responsys Help Center.

To configure a Responsys connection:

  1. From the Connections page, click to create a new connection.

  2. Select the connection type. In this case, click the Responsys card.
  3. Enter the Connection details. 

    An image of the Create Connection screen

    • Connection Name – Enter a name that will help you easily identify this connection.
    • Description – Enter a description for how this connection may be used.
    • Responsys Pod– Select a pod name from the drop-down list if your account uses one of the standard Responsys pod, or select WS End Point to enter an account-specific login URL. When you select WS End Point, the WS End Point Value field is displayed. Enter the Web Services API URL that is specified in your Responsys settings (Account > Global Settings > Account Configuration).
    • User Name – Enter the user name you wish to use to connect to this Responsys pod.
    • Password – Enter the corresponding password.
  4. Click Save and Continue. This will validate whether or not Infinity can successfully connect to Responsys. If successful, you’ll continue to the Destinations screen. Otherwise, the Connection Details will need to be updated, or you can click Cancel.
  5. Click to create a new destination you want to include in this Responsys connection. These destinations relate to the type of campaigns or programs you’ve configured in Responsys.
  6. Select the type of destination you want to create.
    • Supplemental Table: Choose this type when you want to connect to a supplemental table in Responsys. See the Destination Types table below to learn more about supplemental tables.
      1. Select the name of the supplemental table from the drop-down list. The supplemental table names shown in the drop-down list will also show the folder name.
      2. Enter a description.
      3. If you want to allow this destination to be used in Actions, toggle the destination to Enabled.
      4. Click Save.
      5. An image of the Supplemental Table destination type

    • Trigger Custom Event: Enables you to connect to Trigger Custom Events. See the Destination Types table to learn more about custom events.
      1. Select your custom event from the drop-down list.
      2. Enter a description.
      3. Enter the existing Responsys folder name and list name for the custom event.
      4. If you want to allow this destination to be used in Actions, toggle the destination to Enabled.
      5. Click Save.
      6. An image of the Trigger Custom Event destination type

    • Trigger REI Event: Triggers an REI Event for Profile List, Channel List, and Web Push recipients. See the Destination Types table to learn more about REI events.
      1. Select your REI event from the drop-down list.
      2. Enter a description.
      3. Enter the existing Responsys folder name and list name for the REI event.
      4. If you want to allow this destination to be used in Actions, toggle the destination to Enabled.
      5. Click Save.
      6. An image of the Trigger REI Event destination type

  7. Repeat steps 5-8 if you wish to create more destinations.
  8. Click Done.

This connection can now be used when configuring an action to deliver data from Infinity to Responsys for campaign personalization, activating Responsys programs, and more. See An overview of Actions to learn more.

Destination Types in Responsys Connections

Responsys Destination Description
Supplemental

Supplemental Tables in Responsys store relevant information for each record that can be drawn upon for personalization of a campaign message or form document.

To learn more, view Responsys documentation about Supplemental Tables: Creating Supplemental Tables, and Supplemental Table Members REST Endpoints.

Trigger Custom Event

A custom event in Responsys is a signal from an external source (for example, Infinity) that alerts Oracle Responsys when notable customer activity occurs and should be recorded, or alternatively when a notable activity occurs to a customer.

Custom events serve as entries into a published Responsys Program and can be triggered by an API call from Infinity, for example.

To learn more, view the Responsys documentation about Custom Events.

Trigger REI Event

In the Responsys Event Interface (REI), users can manage event variables and edit events, as well as create or delete events. They can also view programs that are using an event, as well as manage the Geofence and Beacon location-based events from REI.

To learn more, view the Responsys documentation about Responsys Event Interface.

Learn more

Creating an action: Oracle Responsys destination

Information about the Responsys Trigger Custom Event

Connections

Responsys connection, supplemental table