Responsys Connector Setup Guide for AudienceStream (SOAP API)

[#1]

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

In this article:

Table of Contents Placeholder

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

• Oracle Marketing Cloud - Responsys API