Salesforce Connector Implementation Guide
Salesforce Connector Implementation Guide
Implementation Guide
Salesforce, Summer ’24
names and marks. Other marks appearing herein may be trademarks of their respective owners.
CONTENTS
Setting Up the Salesforce Connector for Business Units Purchased Before February 11,
2019 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Considerations for Using the Salesforce Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Considerations for Accounts That Allow Multiple Prospects with the Same Email Address . . . . . 3
Step 1: Install the Salesforce Connector (v1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Install the AppExchange Application for Account Engagement . . . . . . . . . . . . . . . . . . . . 4
Assign the Connector User Permission Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Assign Object Permissions to the Connector User . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Add the Salesforce Connector in Account Engagement (v1) . . . . . . . . . . . . . . . . . . . . . . 5
Step 2: Configure Salesforce for the Salesforce Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Map Custom Lead Fields to Contact Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Show Account Engagement Data in Salesforce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Add Custom Buttons to Salesforce Page Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Adding Account Engagement Standard Actions to Salesforce . . . . . . . . . . . . . . . . . . . . 8
Add Scoring Category Scores to Page Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Give Users Access to Account Engagement Data in Salesforce . . . . . . . . . . . . . . . . . . . . 9
Step 3: Configure Account Engagement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Map Salesforce and Account Engagement Custom Fields . . . . . . . . . . . . . . . . . . . . . . 10
Test the Salesforce Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Trigger the Initial Prospect Sync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
SETTING UP THE SALESFORCE CONNECTOR FOR BUSINESS
UNITS PURCHASED BEFORE FEBRUARY 11, 2019
The Salesforce connector syncs prospect and opportunity data between Account Engagement and Salesforce. Account Engagement
can sync with Salesforce Professional Edition and higher. If you purchased Account Engagement before February 11, 2019, follow these
steps to install and configure the Salesforce connector.
General
• You can have only one Salesforce connector per business unit.
• To view Account Engagement data in a clickjack-enabled Salesforce org, create a clickjack protection–compatible Visualforce page.
• To enable person account syncing, contact Salesforce Customer Support.
• When you import prospects into Account Engagement, the records sync with Salesforce. Unassigned prospects sync, but records
aren’t created when there’s no matching email address in Salesforce.
• Syncs can occur as often as every 2 minutes. A larger volume of data takes longer to sync. If you‘re seeing slower sync times, contact
Salesforce Customer Support.
1
Setting Up the Salesforce Connector for Business Units Considerations for Using the Salesforce Connector
Purchased Before February 11, 2019
Connector Version 2
The following applies when using Connector version 2.
• When your Account Engagement business unit is provisioned, the connector is created in a paused state. Before unpausing the
connector to begin syncing, review the settings and configure Marketing Data Sharing if you want to use it. Records don’t sync until
the connector is unpaused. Prospects can be manually synced with Sync with CRM on a prospect record, or Send to Pardot on a
lead or contact record.
• The integration user has access to all records that can sync between the two systems. To control which records are shared, set up
Marketing Data Sharing. If you don’t want to use Marketing Data Sharing, you can change the connector user to a user with your
preferred permissions. For details, see Account Engagement Integration User.
• If you link multiple business units to one Salesforce org, you can’t use the integration user unless you’re also using Marketing Data
Sharing
Mapping Users
Map Account Engagement users with assigned prospects to Salesforce users before syncing. If a prospect’s assigned user isn’t mapped
to a Salesforce user, the prospect is assigned to the Salesforce connector user.
Syncing Prospects
• Account Engagement syncs on the individual level, not the company level.
• Records sync based on the CRM ID field. If a prospect doesn’t have a corresponding Salesforce record, Account Engagement creates
a lead to sync with.
• If a prospect record doesn’t have a CRM ID and a record with the same email address exists in Salesforce, Account Engagement syncs
to the record. If there are multiple records in Salesforce with the same email address as the prospect, Account Engagement syncs
with the first record it finds.
Syncing Opportunities
• Opportunity activities are included in the default scoring (+50 points for created opportunity, –100 points for lost opportunity).
When the connector is enabled, prospect scores update accordingly. Score updates can affect automation or lead assignment rules
already in place.
2
Setting Up the Salesforce Connector for Business Units Considerations for Accounts That Allow Multiple Prospects
Purchased Before February 11, 2019 with the Same Email Address
• If you don’t use opportunities in Salesforce, you can request to disable opportunity syncing. Contact Salesforce Customer Support
for help.
• If Salesforce has duplicate records, the activity iframe appears in all the records. However, the Account Engagement data fields appear
only in the synced record.
3
Setting Up the Salesforce Connector for Business Units Install the AppExchange Application for Account Engagement
Purchased Before February 11, 2019
Note: Pardot is now known as Marketing Cloud Account Engagement. We wish we could snap our fingers to update the name
everywhere, but you can expect to see the previous name in a few places until we replace it, including in the app itself.
The Account Engagement connector user needs these permissions for these standard objects. How you apply these permissions is up
to you. For more information about permissions, see the User Permissions documentation.
4
Setting Up the Salesforce Connector for Business Units Add the Salesforce Connector in Account Engagement (v1)
Purchased Before February 11, 2019
Campaigns Create/Edit/Read/View All All standard and custom fields syncing with
Account Engagement
Contacts Create/Edit/Read/View All/Modify All All standard and custom fields syncing with
Account Engagement
Leads Create/Edit/Read/View All/Modify All All standard and custom fields syncing with
Account Engagement
Opportunity View All All standard and custom fields syncing with
Account Engagement
Task Edit Tasks All standard and custom fields syncing with
Account Engagement
Users View All Users All standard and custom fields syncing with
Account Engagement
Note: To streamline future troubleshooting assign the View Setup and Configuration to your connector user.
5
Setting Up the Salesforce Connector for Business Units Step 2: Configure Salesforce for the Salesforce Connector
Purchased Before February 11, 2019
Important: Don’t map the Pardot URL lead field and Pardot URL contact field. Mapping
these fields to each other creates duplicate prospects and breaks Visualforce pages.
1. Navigate to the object management settings for leads.
2. In the Lead Custom Fields & Relationships section, click Map Lead Fields.
3. Click the Contact tab, and map the fields.
4. Save your work.
6
Setting Up the Salesforce Connector for Business Units Show Account Engagement Data in Salesforce
Purchased Before February 11, 2019
Note: Pardot is now known as Marketing Cloud Account Engagement. We wish we could
snap our fingers to update the name everywhere, but you can expect to see the previous
name in a few places until we replace it, including in the app itself.
To use the Send to Pardot button, a user must be SSO-enabled.
1. Open a lead or contact page layout for editing.
2. In the editor, find the button to add.
• In Lightning Experience, open the Mobile & Lightning Actions section.
• In Salesforce Classic, open the Buttons section.
7
Setting Up the Salesforce Connector for Business Units Adding Account Engagement Standard Actions to Salesforce
Purchased Before February 11, 2019
3. Drag the Send to Pardot button and Send Pardot Email button into the corresponding section of the page.
4. Save your work.
Repeat these steps for each lead and contact page layout.
8
Setting Up the Salesforce Connector for Business Units Add Scoring Category Scores to Page Layouts
Purchased Before February 11, 2019
9
Setting Up the Salesforce Connector for Business Units Map Salesforce and Account Engagement Custom Fields
Purchased Before February 11, 2019
2. From the Salesforce Field Name dropdown, choose the field you want to map.
3. To sync field setting changes from Salesforce, select Keep this field’s type and possible values (for dropdowns, radio buttons,
checkboxes) in sync with the CRM.
4. (Optional) Edit sync behavior.
Repeat these steps for each custom field you want to sync.
Note: Mapping an Account Engagement custom field with a Salesforce field doesn’t trigger a sync with the CRM.
Note: Pardot is now known as Marketing Cloud Account Engagement. We wish we could snap our fingers to update the name
everywhere, but you can expect to see the previous name in a few places until we replace it, including in the app itself.
Test Steps
Sync a new prospect with an existing lead or contact record 1. Create a prospect who exists in Salesforce.
2. To test manual sync, open the prospect record and click Sync
with CRM.
3. To test the automatic sync, wait 10–15 minutes to see if the
connector initiates a sync.
Sync a new prospect who doesn’t exist in Salesforce 1. Create a prospect who doesn’t exist in Salesforce.
2. Create a lead or contact record in Salesforce with the same
email address.
10
Setting Up the Salesforce Connector for Business Units Trigger the Initial Prospect Sync
Purchased Before February 11, 2019
Test Steps
3. From the prospect record, click Sync with CRM or wait 10–15
minutes to see if the connector initiates a sync.
Create a prospect from a Salesforce record This test applies only if you have this connector setting enabled:
Automatically create prospects in Pardot if they’re created in
Salesforce.
1. Create a lead or contact record. If your business unit doesn’t
allow multiple prospects with the same email address, use an
email that doesn’t exist in Account Engagement yet.
2. Wait 10–15 minutes to see if a prospect record is created.
Note: If your business unit allows multiple prospects with the same email address, you must import by CRM ID to match leads
and contacts with prospects. If you don’t import by CRM ID, prospects imported by email address create duplicate leads or contacts
in Salesforce. New Account Engagement business units allow multiple prospects with the same email address by default.
11