dotmailer for Salesforce - Configuration

Contents

Global settings
   » Campaign member values
   » Settings
   » Salesforce data access
Email account linking
Settings for linked accounts
   » Account settings
   » Manage users
   » Field mapping
   » Sync audit
   » Sync options
   » Unlink account
Synchronise

Summary

The 'Configuration' tab can be used for the update, account linking and configuration of the connector. The tab is usually restricted to administrator users and may not be visible to the majority of users.

sf_package_update_notification.png

If and when there's a system notification, it's displayed in a highlighted area.

This includes the availability of a new package. This will need to be installed by a system administrator and is covered in dotmailer for Salesforce installation - Package upgrade.

sf_new_package_notification.png

This article explains how to make full use of the 'Configuration' tab.


Global settings

This area, under 'General settings', can be used to edit settings that will be applied across the whole of your dotmailer for Salesforce setup. 

sf_config_global_settings.png

It has three tabs - 'Campaign Member Values', 'Settings' and 'Salesforce Data Access'.

Campaign member values

This controls if campaign member values get automatically added to linked campaigns, and if they do, what values get added.

sf_campaigns_campaign_members_values.pngHaving Automatically add values to linked campaigns ticked ensures campaign member values are automatically added to Salesforce campaigns which are linked to an email campaign.

This is enabled by default. However, it isn't enabled on individual email campaigns.

The response values are populated with the above values from dotmailer.

If an update isn't required for a particular email response, then uncheck the appropriate box.

The value 'Email sent' gets set when an email has actually been sent, allowing it to be tracked.

Both 'Opened' and 'Clicked' are classified as 'Responded'. This can be altered directly in the campaign, if required.

The 'Protected members status values' are used to protect any existing custom member status values that are already set in a linked campaign. By default, the standard 'Responded' is prefilled to ensure it doesn't get overwritten.

Please note

All existing custom member status values need to be added to the protection list if they're not to be updated by the connector.

Settings

This is used to set your email address books' timeout period. After a set number of days of any email address book not being sent to, its synchronisation won't get included in the scheduled synchronisation. 

The number of days of inactivity can be set from a range between 1 to 180 days. After this period of inactivity, 'Manual Synchronisation Only' will get checked for the email address book.

sf_config_global_settings_settings.png

Salesforce data access

This allows you to check the details for your Salesforce data access. It can also be used to unauthorise the current Salesforce user and then authorise a different one if required.

sf_config_sf_data_access.png


Email account linking

This area, under 'General settings', can be used to link to an existing dotmailer account.

sf_config_email_account_linking.png

When linking to an existing dotmailer account, you should have already been the provided with a QuickLink Code.

Enter the QuickLink code and click Next.

sf_config_email_account_linking_account_details.png

The screen will show the email address of the account that the QuickLink code was created for.

It will also show the account's name which will be used for display purposes when a Salesforce user has been linked to a dotmailer account. This name is copied from the company name given in dotmailer but can be edited if required.

sf_config_wizard_link_to_account_link.pngIf the account is correct, click Link to complete the email account linking process. The modal will close and you'll be returned to the main configuration screen, where the newly linked account will be listed.

sf_config_linked_account.pngNext, select Settings > Manage users to select the Salesforce user that you want to link to the email account user.

Linked users can be deactivated by unticking 'Active'. SSO indicates that single sign-on capability between Salesforce and dotmailer will be available for this user.

sf_configuration_user_management.png

When happy, click Save.

A confirmation message will display, confirming that installation and initial configuration for a single user have been completed.

If more users need to be linked, make use of Settings > Manage users again.


Settings for linked accounts

For each dotmailer account that's linked to the Salesforce org, there are separate account and configuration options available.

Settings

This gives access to various settings and options.

sf_configuration_settings.png

Some of the options change the amount of email data that will be stored within Salesforce.

Warning

Unlink account will break the link between Salesforce and dotmailer and shouldn't be activated without a clear understanding of its use.

Account settings

sf_configuration_account_settings_select.png

The email account name is displayed, along with options to allow sending from Salesforce, enablement of synchronisation and the configuration of suppression options.

sf_configuration_account_settings.pngWhen Allow sending from Salesforce is ticked (default), it's possible to use the Send Campaign Wizard to send email campaigns. When unticked, it's only possible to send directly from dotmailer.

When Enable Synchronisation is ticked (default), then all types of synchronisation (address books, campaigns and suppressions) are possible. When unticked, no form of synchronisation occurs.

When Clear Address Books isn't ticked (default), contacts will only get added to address books. When ticked, Salesforce will be able to alter the email address books in dotmailer by removing contacts as well as adding contacts, as the complete address book will get cleared before it's populated.

The 'Suppression Options' allow contacts and leads to be set up differently if required. These options are enabled by default.

When Update Contact/Lead "Email Opt Out" on unsubscribe is checked, any contacts/leads that unsubscribe from an email campaign via dotmailer will (at the next scheduled suppression synchronisation) have the Salesforce (standard field) 'Email Opt Out' checked. Any contact/lead that has this field checked directly within Salesforce will be updated in the suppression list accordingly.

Click Save after making any changes.

Manage users

sf_configurations_manage_users_select.png

This enables the linking of Salesforce users to dotmailer users and enables the changing of permissions.

This option is only available if the single sign-on details have been provided.

sf_configuration_manage_users_user_management.png

Depending on the number of standard users in dotmailer, the email account user list may contain one or more users.

An email account user can be linked to any of the Salesforce user accounts available from the dropdown list. Each email account user can only be linked to one Salesforce user.

If you wish to change the linking from one email account user to another Salesforce user, use the 'Remove' red cross next to the initial Salesforce user's name before selecting from the dropdown list for an alternative user.

Click Save to create the link. Once the link has been made, the association will be shown on screen.

When accounts have been linked, they're set as 'Active'.

If they're deactivated, the login through Email Studio will need to be re-established.

Permissions

The access and use of a number of tabs, buttons and actions can be controlled for each user by clicking on the Permissions icon alongside them.

sf_configuration_manage_users_permissions.png

By default, they're set according to the permission set applied to the user. The 'Configuration' tab is usually controlled by the administrator.

When the particular permission is unticked and then the area, button or action related to the permission is selected, the following messages will be displayed for the following areas:

  • 'Email Studio' tab: 'Insufficient Privileges - You do not have the required permissions to access the Email Studio Tab'
  • 'Configuration' tab: 'Insufficient Privileges - You do not have access to the Connector Configuration Page'
  • 'Configuration' tab > 'Settings' > 'Account settings('Actions' button): 'You do not have permission to access this feature'
  • 'Add Address Book' button: 'You do not have permission to save address books'
  • 'Synchronise Address Books': 'You do not have permission to synchronise Email Address Books. Please contact an Administrator'
  • 'Send Campaign Wizard': 'You do not have permission to send Email Campaigns. Please contact an Administrator'
  • 'Synchronise Email Campaigns': 'You do not have permission to synchronise Email Campaigns. Please contact an Administrator'
  • 'Configuration' tab > 'Email Account Linking': 'You do not have permission to link Email Accounts.'
  • 'Campaigns' tab > 'Link to Email Address Book': 'Unable to create link(s). You do not have permission to link Campaigns and Email Address Books. Please contact an Administrator'

Field mapping

sf_configuration_field_mapping_select.png

This enables the mapping of Salesforce fields to those used in dotmailer. Existing dotmailer contact data fields can be selected from the dropdown list.

By default FIRSTNAME, FULLNAME and LASTNAME are mapped.

Contacts and leads have their own mapping table, which is accessed by selecting the relevant tab.

sf_configuration_field_mapping_field_table.png

Using the 'Show:' options, it's possible to display all, mapped or unmapped fields.

The date and time the Salesforce fields were last refreshed is displayed in the top right corner. This may be when the package was installed. Any fields introduced after the data will not normally be shown until Refresh now is used.

After the screen has refreshed, the Salesforce field(s) will be present in the list.

Custom fields are indicated by a green tick. They'll need to be mapped to a new contact data field before they can be used in Email Studio.

sf_configuration_field_mappings_custom.png

Mapping of Field types - Salesforce to Marketing Automation

Salesforce custom field type dotmailer contact data field type
Text
Textarea
Encyptedstring
Picklist
Multipicklist
Email
Phone
Reference
Id
String  
Boolean  Yes/No
Currency
Double
Percent 
 Number
Date
Datetime 
Date  

Salesforce Email Opt Out (Unsubscribed)

These standard fields need to be made visible (by an administrator) for both contacts and leads before the unsubscribed data that's displayed in 'Email Send Summaries' is applied to the contact or lead.

sf_configurations_field_mappings_unsubscribed.png

Once the 'Email Opt Out' field is visible, the Salesforce field mapping must be refreshed.

Campaigns then need to be synchronised once by using the suppressions 'Sync Now' option in Settings > Sync options > Synchronisation Schedule

sf_configurations_field_mappings_suppressions_sync_now.png

Sync audit

sf_configuration_sync_audit_select.png

This enables searching of a date/time range for audit listings. It's also possible to limit the results by selecting the type of sync and/or the status of the sync.

sf_configuration_sync_audit_search.png

The start and end time along with the duration of the synchronisation is displayed.

Email address books that failed to synchronise due to being blocked by dotmailer's Data Watchdog will be displayed.

If an object ID is displayed, clicking on it will display further information in a pop-up window.

Sync options

sf_configuration_sync_options_select.png

This provides you with the ability to check the details of scheduled synchronisations, adjust settings, and initiate ad hoc synchronisations.

There are three tabs - 'Synchronisation Schedule', 'Data Options' and 'Reset Synchronisation'.

Remember to click Save after making any changes in the tabs.

Synchronisation Schedule

The synchronisation schedule interval between Salesforce and dotmailer for each synchronisation type can be configured from between an hour up to a month.

It can also be set to manual or disabled.

sf_configuration_synchronisation_schedule.png

The tab shows date/time of the last and next synchronisation, plus its status.

If the synchronisation hasn't been activated, it's possible for the 'Next Sync' date/time to be in the past.

The 'Status' column displays a notification if any synchronisation is currently in progress.

Note that setting the 'Contact/Lead Maintenance' synchronisation interval to be more frequent than 'Daily' can have a negative impact on general synchronisation.

You can force a synchronisation by ticking the appropriate Sync Now box and clicking on Synchronise Now. The selected data types are immediately placed in the queue for synchronisation, which is confirmed by a message.

The synchronisation will start as soon as possible. Progress can be viewed in the 'Email Campaigns' tab.

Data Options

The 'Data Options' tab is split into two tabs - 'Email Campaigns' and 'Forms'. 

Email Campaigns

This allows the level and extent of synchronisation between dotmailer and Salesforce to be set. These options are used to set the default synchronisation level for any new email campaign that's created.

The default is to synchronise email campaigns with all behavioural data. The data associated with the other options is stored against each contact/lead. The collected data volume can be large.

The Synchronise Email Campaigns option needs to be ticked to allow any other data options to be selected.

sf_configuration_sync_options_data_options_email_campaigns.png

Send Summaries The contacts that have been sent the email campaign.
Allow Campaign Membership Updates This is only available when 'Send Summaries' is also enabled.
All changes by recipients will alter Campaign Member status.
Clicks The unique number of users who have clicked a link in the email.
Page Views  Track which pages your contacts go to after clicking a link in your email.
ROI Purchase data made by a contact linking to your website from a link in your email.
Social Bookmarks Which contacts shared the email and which networks your campaign was viewed via.

When activating all of the options, you may wish to contact your system administrator to ensure that any data limits with regards to your Salesforce system aren't impacted.

Changes to email campaigns that have previously been synchronised into Salesforce can have the data options altered. This can be used for setting up the deletion of data that is no longer required in Salesforce.

By altering the options and then clicking the button, options are applied to all existing Campaigns, any changes to data will be made at the next synchronisation.

When changes are required for a select number of Email Campaigns, use this option. It displays a complete list of the Email Campaigns that can have data option altered.

After selecting the Email Campaigns to change, click the Apply to Selected button, after which a confirmation interface is displayed.

Click OK to carry out the change or Cancel as required.

Clicking the Save button will save both of the Options screens. Click Close to return to the Configuration window.

Forms

Forms Data Options allows the level of Synchronisation to be set between the Marketing Automation Application and Salesforce. These options are used to set the default setting for any new Form created.

The default is to synchronise Forms with their Responses. The data associated with each Response is stored against each contact/lead, the collected data volume can be large.

Synchronise Forms - Forms with their questions.

Responses - This will include the answers.

When activating all the options, you may wish to contact you system administrator to ensure that any data limits with your Salesforce system are not impacted.

Changes to Forms that have been previously synchronised into Salesforce can have the data options altered, this can be used for setting up the deletion of data that is no longer required in Salesforce.

By altering the options and then clicking the button, options are applied to all existing Forms, any changes to data will be made at the next synchronisation.

When changes are required for a select number of Forms use this option. It displays a complete list of the Forms that can have data option altered.

After selecting the Forms to change, click the Apply to Selected, a confirmation interface is displayed.

Click OK to carry out the change or Cancel as required.

Clicking the Save button will save both of the Options screens. Click Close to return to the Configuration window.

Reset Synchronisation - Email Campaigns

Resetting Campaign Synchronisation will allow all data, starting from the first send to be retrieved from the emailing system.

This function will need to be used as part of the solution collecting Campaign responses from a historical Email Campaigns or Email Campaigns not sent from Salesforce.

When All Email Campaigns are required to have their dates reset, this button is used. Any changes to the data will be made at the next synchronisation.

When changes are required for a select number of Email Campaigns, use this option. 

It displays a complete list of the Email Campaigns that can have Synchronisation reset. Select one or more, then click the button shown below.

Campaign Synchronisation following resetting may take far longer than usual as it retrieves all the data as requested.

Reset Synchronisation - Forms

Resetting Forms Synchronisation will allow all data, starting from the first use to be retrieved from the emailing system. This function may be needed to be used as part of the solution of collecting historical Form responses.

When All Forms are required to have their dates reset, this button is used. Any changes to the data will be made at the next synchronisation.

When changes are required for a select number of Forms, use this option.

It displays a complete list of the Forms that can have Synchronisation reset. Select one or more, then click the button shown below.

Form Synchronisation following resetting may take far longer than usual as it retrieves all the data as requested.

Unlink account

sf_configuration_unlink_account_select.png

This option can be used to unlink the displayed Salesforce Email account from the selected Marketing Automation Application account. It can be used when transferring from a Sandbox account to Production account.

Selecting the OK option will carry out the unlinking.

Click Close to return to the mail Configuration window.

The link can be re-established by using the Configuration > Link New Account. When there are no linked accounts the Email Studio tab will indicate this.

If all the users accounts are unlinked, the following screen is displayed, indicating that there are no linked accounts.

Synchronise

sf_configuration_synchronise_select.png

This option starts the synchronising of data between Salesforce and dotmailer based on the settings in 'Sync options'. It's acted on immediately, and when it's complete, the dialogue is updated.

The action attempts to synchronises all Address books, Campaign data/ statistics and email Suppressions based on the configuration and options set in Options.

The results of the synchronisation a can be viewed in the Synchronisation Audit.

Click Close to return to the mail Configuration window.

Have more questions? Submit a request

Comments

Powered by Zendesk