Responsys Connector Setup Guide for AudienceStream (SOAP API)

Responsys Connector Setup Guide for AudienceStream (SOAP API)

by bryan_woodard on ‎02-23-2016 02:29 PM - edited on ‎01-09-2019 01:05 PM by (921 Views)

Leverage the Tealium and Responsys integration to deploy and manage the Responsys tag, as well as for sending enriched Visitor and Audience profiles for more personalized email campaigns. Responsys is a leading marketing cloud software and services company acquired by Oracle. Our mission is to enable the smartest marketing in the digital world. The most respected brands across the globe use the Responsys Interact Marketing Cloud to manage their digital relationships and deliver the right marketing to their customers across email, mobile, social, display and the web.

In this article:

Table of Contents Placeholder

This article describes how to set up the Responsys connector in your Universal Data Hub account.

Connector Actions

Action Name AudienceStream EventStream
Merge Visitor into Profile Extension Table
Merge Visitor into Supplemental Table
Merge Visitor into List
Send Transactional Campaign Email
Trigger Custom Event

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

  • API Username
  • API Password
  • Server Host
    Contact your Responsys representative to get the appropriate server host.

    When entering the server host, do not include the protocol and/or a path (e.g. https://)

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Merge Visitor into Profile Extension Table

Parameter Description
Table Folder Name Required
Table Object Name Required
Update Strategy
  • Required
  • Controls how the existing record should be updated.
  • NO_UPDATE
    When selected, if an existing record is matched, no update will happen. i.e. to enforce an INSERT only, use this option
  • REPLACE_ALL
    When selected, if an existing record is matched, all the properties configured will be updated.
RIID  
CUSTOMER_ID  
EMAIL_ADDRESS  
Pass Empty Values for Data Columns(s) to Set Optional
Data Column(s) to Set Required, please specify the record data to merge.

Action - Merge Visitor into Supplemental Table

Parameter Description
Table Folder Name Required
Table Object Name Required
Update Strategy
  • Required, controls how the existing record should be updated.
  • NO_UPDATE
    When selected, if an existing record is matched, no update will happen. i.e. to enforce an INSERT only, use this option and check the Insert on No Match checkbox
  • REPLACE_ALL
    When selected, if an existing record is matched, all the properties configured will be updated.
Insert on No Match Optional 
Pass Empty Values for Data Columns(s) to Set  Optional
Data Column(s) to Set
  • Required
  • Ensure you have included primary key columns.
  • To pass a List, use a List Attribute and ensure all the lists have the same index length.

Action - Merge Visitor into List

Parameters

Parameter Description
List Folder Name  
List Object Name  
Update Strategy
  • Required.
  • Controls how the existing record should be updated.
  • NO_UPDATE
    When selected, if an existing record is matched, no update will happen. i.e. to enforce an INSERT only, use this option and check the Insert on No Match checkbox
  • REPLACE_ALL
    When selected, if an existing record is matched, all the properties configured will be updated.
Insert on No Match  
RIID  
CUSTOMER_ID  
EMAIL_ADDRESS  
Pass Empty Values for Data Columns(s) to Set  
Data Column(s) to Set
  • Required
  • Please specify the record data to merge.
optinValue  
optoutValue  

Action - Send Transactional Campaign Email

Parameters

Parameter Description
Campaign Folder Name  
Campaign Object Name  
RIID  
CUSTOMER_ID  
EMAIL_ADDRESS  

Action - Trigger Custom Event

Parameters

Parameter Description
Recipient List Folder Name  
Recipient List Object Name  
RIID  
CUSTOMER_ID  
EMAIL_ADDRESS  
Custom Event ID  
Custom Event Name  
Optional Data Map
  • Optional
  • Custom Event data that the user can set to any value

Vendor Documentation