The Salesforce Integration Options page is where you manage the integration between your Higher Logic Thrive Marketing Enterprise (Thrive Marketing Enterprise) account and your Salesforce account.

IMPORTANT: The integration-options page is accessible only if the login that has been provisioned for the integration is a standard Salesforce license.

NOTE: This article references Real Magnet and RM. Real Magnet is a previous name of Thrive Marketing Enterprise, which continues to use legacy settings under that name.

Access the Salesforce Integration Options page

1. Access the Admin interface.
2. Navigate to Campaigns > Salesforce Integration.

Before using this page...

• Changes on this page immediately go into effect.
• If you apply any changes, all of your Thrive Marketing Enterprise campaigns will automatically use these new options.
• Review your Salesforce data structure before making changes here; this will help you choose which options are best, based on how your Salesforce account is set up.

Configuration options

The configuration options on this page are grouped into five sections, each discussed in its associated section below.

1 - Map Thrive Marketing Enterprise Fields to Salesforce Fields

In this section, you can assign a one-to-one relationship between recipient fields in Thrive Marketing Enterprise and Salesforce.

There are two separate mappings: One for Leads and one for Contacts. Switch between them by using the Lead and Contact buttons at the top-right of this page.

To map a field:

1. Click the + add another field link at the bottom of the page.
2. Click the Select Field link to choose a Thrive Marketing Enterprise field.
3. Click the Select Integration link to choose the corresponding Salesforce field.
4. Check the Key Field box to use this for record matching. More information about this is available below.
5. Click Apply Mappings at the bottom of the page to save your changes.

Thrive Marketing Enterprise fields

• All standard fields (Email, First Name, Last Name, etc.) are available
• Any custom fields you have created are available
• A user can only map Enhanced Personalized Fields if they are shared with that user. Private fields can only be mapped by the user with access to them

Salesforce fields

• All Salesforce fields are available

Current mappings

• To change either the Thrive Marketing Enterprise or Salesforce field in a mapping, click the field link and select a different field.
• To delete a mapping, click the X next to it.

Key fields

Key fields are used to determine, before a record is added to Salesforce, whether it already exists. Thrive Marketing Enterprise will search Salesforce using for records which match the key fields. If a record is found, then a new one is not created. Instead, Thrive Marketing Enterprise will get the Salesforce ID for the existing record and store it in Thrive Marketing Enterprise.

NOTE: This is required for this page. At a minimum, email address should be selected for both Leads and Contacts.

Which fields should I map?

If you’re not sure which fields to map, you should consider what information you will need to match in both systems to effectively run your marketing campaigns. Thrive Marketing Enterprise's recommendations are:

• You will almost always want to map the Thrive Marketing Enterprise Email field to the Salesforce Email field. Thrive Marketing Enterprise is an email-based system, after all!
• First Name and Last Name are extremely useful fields, as well.
• Map any other fields which are important to your sales efforts. These might include fields such as address, title, or client level.

NOTE: Remember, this key field page controls the information created in Salesforce, but also controls what information is updated in Thrive Marketing Enterprise should you email from Salesforce to Thrive Marketing Enterprise.

2 - Map Thrive Marketing Enterprise Messages to Salesforce Logins

One of the features you get when you integrate Marketing Automation with Salesforce is the ability to send Thrive Marketing Enterprise messages from inside Salesforce. Use this section to customize which Salesforce users can send which messages.

To map messages:

1. Click the + add another mapping link at the bottom of the section.
2. Click the Select Message link to choose a Thrive Marketing Enterprise message.

1. Only email messages are available.
2. Only one message can be selected for each row.

3. The default is to make the message available to all Salesforce users. To limit availability, click the All Logins link, and select one or more logins.
4. Click the Apply Mappings button at the bottom of the page to save your changes.

Once a mapping is assigned to a login, that user can go to a Contact or Lead Detail page in Salesforce and send that Contact/Lead a Thrive Marketing Enterprise email. They will have a dropdown available for all emails mapped to their login.

Mapping messages and logins

• You can map any Thrive Marketing Enterprise message which you have permission to view.
• You can map any logins associated with the integrated Salesforce account.

Current mappings

• To change the message selected for a mapping, click the message name and select a different message.
• To change the logins who can send the message, click the logins link and select one or more different logins.
• To delete a mapping, click the X next to it.

3 - Map Thrive Marketing Enterprise Templates to Salesforce Logins

One of the features you get when you integrate Thrive Marketing Enterprise with Salesforce is the ability to send Thrive Marketing Enterprise messages from inside Salesforce using a Contact or Lead View. Use this section to customize which Salesforce users can send which message templates.

Mapping templates

To map messages:

1. Click the + add another mapping link at the bottom of the section.
2. Click the Select Template link to choose a Thrive Marketing Enterprise template.

1. Only published templates are available.
2. Only one template can be selected for each row.

3. The default is to make the message available to all Salesforce users. To limit availability, click the All Logins link, and select one or more logins.
4. Click the Apply Mappings button at the bottom of the page to save your changes.

Once a mapping is assigned to a login, that user can go to a Contact or Lead View in Salesforce and send those Contacts/Leads a Thrive Marketing Enterprise email. They will have a dropdown available for all templates mapped to their login.

Mapping templates and logins

• You can map any Thrive Marketing Enterprise template which you have permission to view.
• You can map any logins associated with the integrated Salesforce account.

Current mappings

• To change the template selected for a mapping, click the template name and select a different message.
• To change the logins who can send the template, click the logins link and select one or more different logins.
• To delete a mapping, click the X next to it.

4 - Set Default Values

NOTE: You must configure any and all required fields for record creation from Salesforce in this section.

You can set default values for your Salesforce fields. If Thrive Marketing Enterprise tries to upload a recipient to Salesforce, and the recipient is missing information for a field, Thrive Marketing Enterprise will send the default value.

This section allows you to set what the default values are. You will need to set defaults for Leads and Contacts separately. Switch between them by using the Lead and Contact buttons at the top-right of this page.

Your Salesforce account may have one or more fields required for Leads and Contacts. These fields require default values to prevent recipient uploads from failing.

You can also choose to set defaults for fields which are not required.

Setting default values

To set the default values:

1. Click Leads or Contacts to switch between the required fields for each type of record.
2. Enter your chosen default value in the text box for each required field.
3. If you would like, click add another field to add a field which is not required.

1. Click Select Field to choose a non-required field from the list.
2. To change a field selection, click the name of the field and select a new one.
3. To delete a default, click the X icon at the right side of the row.

4. Click the Apply Mappings button at the bottom of the page to save your changes.

Thrive Marketing Enterprise will allow only certain values to be entered for each field type. The field type is determined by Salesforce.

Field type	Valid input
picklist	String
string	String
textarea	String
phone	String
url	String
email	String
anyType	String
boolean	Select ‘true’ or ‘false’
int	Only digits or minus sign (no commas)
double	Only digits, minus sign, or decimal point (no commas or symbols)
currency	Only digits, minus sign, or decimal point (no commas or symbols)
percent	Only digits, minus sign, or decimal point (no commas or symbols)
date, time, datetime	Select time and date

NOTE: Make sure that your entry matches the format required for the field by Salesforce. This ensures that uploads will work correctly.

Recommendations

Thrive Marketing Enterprise recommends that you set up a “catch-all” account in Salesforce for all incoming Contacts, and set this as the default account. That way, you will have one place where you can see all the Contacts recently added by Thrive Marketing Enterprise. Then you can assign them to whichever account makes most sense for your business needs.

5 - Update Salesforce Field on Unsubscribe

You can update one field in Salesforce based on whether a recipient unsubscribes. If a recipient unsubscribes in a message via a Marketing Automation campaigns and the recipient is in Salesforce, Thrive Marketing Enterprise will set the field value.

You will need to set the unsubscribe field for Leads and Contacts separately. Switch between them by using the Lead and Contact buttons at the top-right of this section.

NOTE: This is a one-way stream of data; Thrive Marketing Enterprise will update the flag in Salesforce, but it is still up to your list creation method to exclude recipients who have unsubscribed outside of Thrive Marketing Enterprise.

Updating Salesforce fields on unsubscribe

1. Click Leads or Contacts to switch between the required fields for each type of record.
2. Check to update the Lead/Contact field.
3. Click Select Field to choose the field you want to update.

• To change a field selection, click the name of the field and select a new one.

4. Click the Apply Mappings button at the bottom of the page to save your changes.