OpenMoves for Salesforce - Configuration

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.

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

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

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

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

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

6-sf_config_sf_data_access.png


Email account linking

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

7-sf_config_email_account_linking.png

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.

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

9-sf_config_wizard_link_to_account_link.png

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.

10-sf_config_linked_account.png

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.

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

12-saved.png

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.

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

Account settings

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

15-sf_configuration_account_settings.png

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

16-sf_configurations_manage_users_select.png

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.

17-sf_configuration_manage_users_user_management.png

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.

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

19-allowuser.png

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

error01.png

Configuration Tab

error02.png

Actions Button

error03.png

 
Email Account Linking

error04.png

 
Addressbook Saving
error05.png
Addressbook Synchronising
error06.png
  
Campaign Sending
error07.png
  
Campaign Synchronising
error08.png
  
Addressbook / Campaign Linking
error09.png
  
 

Field mapping

20-fieldmap.png

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

21-fieldmap2.pngContacts and Leads have their own mapping table selected from the relevant tab.

22-tab.png

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.

23-newemailfiend.png

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.

25-refresh.pngAfter 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.

26-CUSTOMFIELD.png

Mapping of Field types - Salesforce to Marketing Automation

Salesforce Custom Field Type Marketing Automation fieldtype
Text
Textarea
Encyptedstring
Picklist
Multipicklist
Email
Phone
String  
Boolean  Yes/No
Currency
Double
Percent 
 Number
Date
Datetime 
Date  

Salesforce Email Opt Out (Unsubscribed)

27-emailoptout.png

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.

28-sendsummary.png

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

29-refresh.png

Campaigns then need to be synchronised once by using the Suppressions Sync Now option.

30-syncwindow.png

Sync audit

31-sync.png

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.

32-sync2.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 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

33-options.png

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.

34-sync1.png

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.

35-dataoption.png

Clicks   The unique number of users who have clicked a link in the email.
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.
ROI   Purchase data made by a contact linking to your website from a link in your email.
Page Views   Track which pages your contacts go to after clicking a link in your email.
Social Bookmarks  Which contacts shared the email and which networks your campaign was viewed via.

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.

36-allemail.png

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.

37-selectemail.png

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.

38-emailcampaign.png

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

39-confirm.png

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.

40-saveboth.png

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.

41-forms.png

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.

42-allform.png

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.

43-selectform.png

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.

44-forms2.png

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

45-confirm.png

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.

47-saveboth.png

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.

46-resetsync.png

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.

48-allemail.png

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

49-selectemail.png

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

50-selectemail.png

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.

51-resetsyncform.png

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.

52-allform.png

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

53-selectform.png

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

54-resetformbtn.png

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

 

Unlink account

55-unlink.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.

56-unlinkaccount.png

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.

57-nolinkedaccount.png

Synchronise

58-sync.png

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.

59-syncaccount.png

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

0 Comments

Article is closed for comments.