Responsys Connector Setup Guide for AudienceStream (SOAP API)

This article describes how to set up the Responsys connector in your Customer 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

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

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 or the path.

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

Was this page helpful?

This page was last updated: January 23, 2020