Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

S4S List Builder creates new Contact Lists in Sitecore. These are not real lists, but list id references in each Contact record that the contact belongs to.

When creating Sitecore contacts using S4SLB the following config settings decide what to use as Sitecore Contact IdentifierSource and Identifier.IdentifierSourceimporting through S4S List Builder the process tries to find xDB contacts that match the configured identifier for the Salesforce object. If an xDB contact exists it is added to the list otherwise a new xDB contact is created, with the appropriate identifier, and added to the list.

Ideally an xDB contact that is linked to a Salesforce contact or lead should be the same one regardless of whether it is created through S4S List Builder or through the S4S form submit action. By default the identifiers in Sitecore are case sensitive but the S4S.Analytics.ConvertIdentifierValueToLowerCase setting in /App_Config/Modules/S4S/S4SAnalytics.config can be configured to save all identifiers as lower case so they are consistent across S4S. The identifier source and field containing the identifier need to be configured so that the xDB contacts can be matched.

Identifier Source

By default, S4SLB uses “S4S“ as the IdentifierSource. This value can be changed from the following config setting in /App_Config/Modules/S4S/S4SAnalytics.config. Keep in mind that changing this value will affect the S4S form submit action as well.

Code Block
<!-- The source to use for identifiers -->
<setting name="S4S.Analytics.IdentifierSource" value="S4S" />

Identifier

In /App_Config/Modules/S4S/S4SLB.config, there are two config settings to set the Salesforce fields to use as the identifier of the Sitecore contact. By default those config setting values are set to “Email“ so the Email field in the Salesforce Contact contact or the Lead lead will use be used as the Sitecore Contact xDB contact identifier.

Code Block
<!--Salesforce contact field which use to identify Sitecore contact created by S4SLB-->
<setting name="FuseIT.S4SLB.SFContact.IdentifierField" value="Email" />

<!--Salesforce lead field which use to identify Sitecore contact created by S4SLB-->
<setting name="FuseIT.S4SLB.SFLead.IdentifierField" value="Email" />

Ideally, having the same Salesforce fields configured in the above settings and in “S4SS4S.Analytics.Identifier“ Identifiersetting in /App_Config/Modules/S4S/S4SAnalytics.config (Refer Select Options in S4S Sitecore Form Mapping Wizard for more details) will give more robust Sitecore contacts in the XDB. It will prevent redundant Sitecore Contacts creating being created for the same Salesforce entity when using the S4S submit action and S4S List Builder.

...