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.

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.

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 OpenMoves for Salesforce setup. 

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.

Having 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 OpenMoves.

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.

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.

Email account linking

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

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

Enter the QuickLink code and click Next.

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 OpenMoves account. This name is copied from the company name given in OpenMoves but can be edited if required.

If 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.

Next, 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 OpenMoves will be available for this user.

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 OpenMoves 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.

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 OpenMoves and shouldn't be activated without a clear understanding of its use.

Account settings

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

When 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 OpenMoves.

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 OpenMoves 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 OpenMoves 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

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

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

Depending on the number of standard users in OpenMoves, 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.

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 are displayed.

Email Studio Tab	Configuration Tab
Actions Button	Email Account Linking
Addressbook Saving	Addressbook Synchronising
Campaign Sending	Campaign Synchronising
Addressbook / Campaign Linking

Field mapping

This allows the mapping of Salesforce fields to those used in the Marketing Automation Application. Existing Email Datafields can be selected from the dropdown list, new Email Datafields can also be created.

(By default FIRSTNAME, LAST NAME and FULLNAME are mapped.)

Contacts and Leads have their own mapping table selected from the relevant tab.

Using the Show options it is possible to display All, Mapped or Unmapped fields.

Click Close to return to the main configuration window.

To map an Email Datafield that not yet been defined, use the following instructions:

Step 1: Select Create New Text field from the drop down list.

Step 2: A blank Create new email field screen is displayed.

Step 3: Complete the fields on the screen, giving the field l an appropriate and unique name (text is converted to uppercase with no spaces).

1. 'Type' - will have been preselected based on the Salesforce field type and cannot be changed.  Tip: See table on next page
2. 'Default value' - You can enter a default value for the data field in the event that it is not populated as a result of the uploading of your data. For example, if this was a Salutation data label where the First Name would usually be entered you might default the value to "Customer". If some of your records do not have first names held. "Customer" will then be automatically entered rather than leaving a blank field.
3. 'Access' - New labels are always created as 'Private' in Salesforce - you can change this to 'Public' if you wish using Marketing Automation Application.
4. Click Save

Step 4: Click Close to return to the main configuration window.

The interface shows when the Salesforce fields were last refreshed, this may be when the package was installed. Any fields introduced after the data will not normally be shown until the Refresh now is used.

After the screen has refreshed the Salesforce field(s) will be present in the list. Custom fields are show with a tick, they will need to be mapped to a new Email Datafield before use in Email Studio.

Mapping of Field types - Salesforce to Marketing Automation

Salesforce Email Opt Out (Unsubscribed)

These standard fields need to be made visible (by Administrator) on both Leads and Contacts before the data that is displayed in the Email Send Summary of the Campaign Unsubscribed is applied to the Lead/Contact.

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.

Sync audit

Allows the user to specify a date/time range for an audit listing. It is possible to limit the results by selecting the Type and/or the Status.

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 Watch Dog will be shown.

If an Object Id is shown, selecting it will display the information in a pop up window.

Click Close to return to the main configuration window.

Sync options

Synchronisation Schedule

The Synchronisation Schedule interval between Salesforce and the Marketing Automation Application can be configured, from 1 hour up to 1 Month for each of the separate types, it can also be set to Manual or Disabled.

The dialogue shows date/time and status of the Last and Next Synchronisation.

If the synchronisation has not been activated, the Next Sync date/time can be in the past.

The Status column displays notifications if any synchronisation is currently in progress.

Setting the Contact/Lead Maintenance interval quicker than Daily can have a negative impact on general synchronisation.

With a check in the Sync Now field, when the Synchronise Now button is clicked, the selected data types are immediately placed in the queue to be synchronised, the pop up message is displayed.

The synchronisation will start as soon as possible, progress can be viewed in Email Campaigns tab.

Data Options - Email Campaign

Email Campaign 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 Email Campaign that is created.

The default is to synchronise the 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 Schedule option needs to be checked to allow any other data options to be selected.

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 Email Campaigns 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 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.

Data Options - 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

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

This option starts the synchronising of data between Salesforce and the Marketing Automation Application based on the settings in the Options setting. It is acted on immediately, when it is 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.