S4S Web Forms for Marketers (Optional)


IMPORTANT: As of Sitecore 9.1 Web Form For Marketers has been deprecated and Sitecore Experience Forms should be used instead. 

Audience

The audience for this document is developers and implementers with experience in installing and configuring the appropriate Sitecore and Salesforce areas.

IMPORTANT: This information assumes that you have experience in managing the technology.

Scope

This wiki describes the FuseIT S4S WFFM Mapping Package and form save actions to push analytics to Salesforce.

Prerequisites

Sitecore

  • Sitecore Web Forms for Marketers for Sitecore 9

Salesforce

IMPORTANT: Changes in Salesforce are only required if you want to push Sitecore Analytics to Salesforce

S4S Web Forms for Marketers Mapping Package

Use the S4S Web Forms for Marketers functionality to push Sitecore WFFM form data to Salesforce leads, contacts or other objects. The functionality includes the S4S Mapping Wizard to map Sitecore WFFM forms to Salesforce objects and fields. The process to achieve this is:

  • Use standard Sitecore Web Forms for Marketers functionality to create a web form with form fields that match the equivalent fields in the Salesforce object. 
  • Choose an S4S Save Action for the WFFM form - see Save Actions below. 
  • Click on the Sitecore Start button and select the S4S Mapping selection. Choose the WFFM created in the previous step. 
  • Select the Salesforce object and map the individual WFFM fields to the object fields. 

IMPORTANT: WFFM forms are being retired and replaced by Sitecore Experience Forms. Using WFFM is no longer recommended.

This functionality is included in the standard connector.

Save Actions

The installed Save Actions are:

  • S4S Generic Mapping: This Save Action maps WFFM fields to any object in Salesforce. For Salesforce lead or contact objects you can use the wizard to automatically add the visitor to a Salesforce campaign. No S4S Salesforce packages are required for this functionality. 
  • S4S Identify and Push Visitor: This Save Action maps WFFM fields to Salesforce Contacts or Leads only. It pushes the form data to Salesforce, and the Sitecore xDB data associated with the visitor's activities on the website. This Save Action uses the field data in the nominated identifier field with the Sitecore IdentifyAs() method to determine if the current visitor has visited previously on another device. The visitors Sitecore Contact record will then reference all the other devices (and cookies) used on previous visits. If the visitor is authenticating into Sitecore it is useful to add the IdentifyAs() method to the login control and nominate the username (or email address) as the identifier. This increases the chance that Sitecore will match previous visits and push the visit analytics to Salesforce. This requires several receiver fields in Salesforce that are installed with a Salesforce package

IMPORTANT: Save Actions with “Push Visitor” in the action name require an Analytics Package to be installed in Salesforce. The package adds the required receiver fields to store the Sitecore analytics data.


IMPORTANT: If your website has multiple WFFM forms that require Push Visitor save actions, ensure all forms use the same save action e.g. all forms should use S4S Identify and Push Visitor save actions.


In the Sitecore tree, Save Actions are installed at

/sitecore/system/Modules/Web Forms for Marketers/Settings/Actions/Save Actions

If one of these Save Actions is selected, the published WFFM form will appear in the S4S Mapping Wizard which is accessible from the Sitecore Start menu. Developers can build custom Save Actions to improve WFFM validation and functionality when connecting to Salesforce.

Next Step

Sitecore Configuration for WFFM

Steps