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 2 weeks ago by (762 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
Update Visitor in Supplemental Table
Insert Visitor into Supplemental Table
Update Visitor in List
Insert 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 - Update Visitor in Supplemental Table

Parameters

Parameter Description
Table Folder Name  
Table Object Name  
Primary Key Column(s)
  • Primary Key field is required.
  • To pass a List, please use a List Attribute, and ensure all the lists have the same index length.
Data Column(s) to Update
  • Required
  • Ensure you have appended your custom column names with the keyword tealium_as.
    To pass a List, please use a List Attribute and ensure all the lists have the same index length.

Action - Insert Visitor into Supplemental Table

Parameters

Parameter Description
Table Folder Name  
Table Object Name  
Data Column(s) to Set
  • Required.
  • Ensure you have included primary key columns.
  • To pass a List, please use a List Attribute, and ensure all the lists have the same index length.

Action - Update Visitor in List

Parameters

Parameter Description
List Folder Name  
List Object Name  
Match List Column Name to Visitor Attribute Match column is required.
Data Column(s) to Update Ensure you have appended your custom column names with the keyword "_tealium_as".

Action - Insert Visitor into List

Parameters

Parameter Description
List Folder Name  
List Object Name  
Data Column(s) to Set Ensure you have included primary key columns.

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