Skip to main content
Build the future with Agentforce at TDX in San Francisco or on Salesforce+ on March 5–6. Register now.

Install and Set Up in Salesforce CRM

Learning Objectives

After completing this unit, you’ll be able to:

  • Install the managed package in your Salesforce CRM org.
  • Modify page layouts for email.
  • Set up the CRM API User.
  • Update admin permissions to use Marketing Cloud Connect.

Before You Begin

As we mentioned in the beginning of this module, we assume you are a Marketing Cloud Engagement and Salesforce CRM admin with the proper permissions to access and configure both accounts. If you are an admin for one but not the other, be sure to work with someone who has the appropriate permissions to complete the installation steps. Also, confirm that you are using the Salesforce Classic UI and that you have Custom Platform Events enabled in your Salesforce CRM. It must be enabled for the managed package to install successfully.

Follow Along with Trail Together

Learn more about the following steps and processes with Trailhead Academy instructor, Brian Richardson. 

2: Install the Managed Package

Progress chart with Step 2: Install managed package highlighted.It’s time to install the managed package. A managed package is a collection of components and applications that makes the connection between your Salesforce CRM and Marketing Cloud Engagement accounts work. Follow along with these steps to download the latest version of the managed package.

  1. Confirm you are using the most recent version of a supported web browser, then click one of these URLs.

  1. Log in to your Salesforce CRM account using your admin credentials, and then select Install for Admins Only.
  2. Click Install. (If prompted, grant access to these third-party websites).
  3. Click Continue.

Be sure to wait until the managed package installation is complete before moving on to the next step.

3: Configure CRM Settings

Progress chart with Step 3: Configure CRM settings highlighted.

Now that you’ve installed the managed package, there are a few initial configuration updates that need to happen in your Salesforce CRM account. So go ahead and log in to your Salesforce CRM account with your admin credentials, if you haven’t already.

Learn more about the following steps and processes with your instructor.

Modify Page Layouts

In order for users to see email activity from within a Salesforce CRM account, we need to make some modifications to page layouts.

  1. In the Salesforce CRM org, click Setup.
  2. Enter Users in the Quick Find box and select Users under Build > Customize.
  3. Under Users, click Page Layouts.
  4. Under User Page Layouts, click Edit next to User Layout. User page layout screen with the cursor placed on the Edit link for the User Page Layout.
  5. Scroll down to view the Additional Information section of the user page layout.
  6. Drag Marketing Cloud Engagement for AppExchange Admin from the palette to the Additional Information section of the user page layout.
  7. Drag Marketing Cloud Engagement for AppExchange User (1) to the same section. User layout screen with fields Marketing Cloud Engagement for AppExchange User and AppExchange Admin added to the Additional Information section.
  8. Click Save.

Modify Lead Page Layout

Now let’s configure the lead page to ensure Marketing Cloud Connect users can see the relevant Marketing Cloud Connect fields.

Note

Since you aren’t ready for other users to view these fields, for now, it’s best to select a page layout that only admins can see.

  1. Still in CRM Setup under Build > Customize, click the arrow icon to expand the Leads menu.
  2. Click Page Layouts.
  3. Identify a page layout to work with and click EditLead Page Layout with Edit selected next to Lead Layout.
  4. In the layout you selected, from the tool palette options select Related Lists.
  5. Drag Email Sends from the palette to the bottom of the Lead page layout (1) to create a new related list. The Email Sends object is highlighted, showing it dragged to the related list section on the Lead page layout editor.
  6. Then drag Individual Email Results from the palette to the bottom of the Lead page layout to create another new related list.
  7. Next, select Visualforce Pages from the palette options.
  8. Drag LeadActions from the palette to the Description Information section of the Lead page (1). The Visualforce page LeadActions is highlighted, showing it dragged to the Lead page under Description Information.
  9. Click Save.
  10. Click Yes to Overwrite Users’ Related List Customizations?

Modify Contact Page Layout

Now let’s repeat similar steps to modify your contact layout from the Setup screen.

  1. Still in CRM Setup under Build > Customize, click the arrow icon to expand the Contacts menu.
  2. Click Page Layouts.
  3. Once again, select a layout to update that only admins see. Once selected, click Edit next to the name.
  4. In the tool palette, select Related Lists.
  5. Drag Email Sends from the palette to the bottom of the Contact page layout to create a new related list.
  6. Drag Individual Email Results from the palette to the bottom of the Contact page layout, following Email Sends, to create another new related list.
  7. Click Visualforce Pages in the palette.
  8. Drag ContactActions from the palette to the Additional Information section of the Contact page.
  9. Click Save.
  10. Click Yes to Overwrite Users’ Related List Customizations?

You now have visibility into the email sends for both leads and contacts. Nice work!

Note

It’s important to note that when you’ve completed all configuration steps and are ready to deploy Marketing Cloud Connect to your users, you need to repeat these steps for all of the Lead and Contact page layouts that are assigned to users who will use Marketing Cloud Connect.

Grant Access to Your Marketing Cloud Connect Admin

Let’s move on to user permissions. It’s time to grant some permissions to your Marketing Cloud Connect admin (this can be you or another user). Follow these steps to assign the permissions to that user from the Setup menu.

  1. Under Administer in the Setup menu, click the arrow icon to expand the Manage Users menu.
  2. Click Users.
  3. Click Edit next to the name of the admin user you’ve identified.
  4. Under Additional Information, select Marketing Cloud Engagement for AppExchange Admin and Marketing Cloud Engagement for AppExchange User. Marketing Cloud Engagement for AppExchange Admin and User Fields checked on the user detail page.
  5. Click Save.

Perfect, permissions granted to the admin!

Set Up the CRM API User

Next up, you create the CRM API user (also called the Salesforce System user), which connects Marketing Cloud Engagement to your CRM org.

  1. Under Administer in the Setup menu, click the arrow icon to expand the Manage Users menu.
  2. Click Users.
  3. Click New User. Create a new user with the following settings:
    • First Name: MC
    • Last Name: Connect-CRM
    • Email: Use an email address that you have access to.
    • Username: Must be unique and in the format of an email address. We suggest: mc-connect-crm@youremail.com.
    • User License: Salesforce
    • Profile: System Administrator
    • Role: <None Specified>

  1. Under General Information, click the Marketing User checkbox.
  2. Under Additional Information, select the Marketing Cloud Engagement for AppExchange Admin and Marketing Cloud Engagement for AppExchange User checkboxes.
  3. Select the checkbox for Generate new password and notify user immediatelyNew User screen with Marketing Cloud Engagement permissions selected and the generate new password selected.
  4. Click Save.

Important: An email will be sent to the address you specified. Follow the instructions in that email to verify the identity of the new user record and specify the password for this new user account.

Create Permission Set in Salesforce CRM

For the two systems to communicate properly, we need to create a generic permission set in Salesforce CRM and update Marketing Cloud Connected app settings. This is necessary to grant access to users connecting to Salesforce CRM from Marketing Cloud Engagement.

  1. Under Administer in the Setup menu, click the arrow icon to expand Manage Users.
  2. Click Permission Sets and click New.
  3. Give the permission set a memorable label and description. We suggest Marketing Cloud Connected App and a description of Gives access from CRM to Marketing Cloud Engagement.
  4. Click Save.
  5. Click Manage Assignments and then click Add Assignments.
  6. Select the CRM API User account you created in the last section.
  7. Click Assign and then Done.

A permission set without a permission? Don't worry- you are doing this correctly! This permission set's purpose is for connection and authentication.

Note

All end-users who plan to use Marketing Cloud Connect to send emails, need this permission set assigned to their user record in the Salesforce CRM org.

Update Field-Level Security

Email Opt Out is a standard field on the Contact and Lead objects. For Marketing Cloud Connect to work properly, you need to ensure that all Marketing Cloud Connect users have view access to this field.

  1. Under Build in the Setup menu, click Arrow Icon to expand Customize.
  2. Next expand Leads.
  3. Click Fields.
  4. In the list of standard fields, click Email Opt Out.
  5. Click Set Field-Level SecurityEmail opt out lead field with set field-level security button selected.
  6. Select the Visible checkbox for all user profiles that need access to Marketing Cloud Connect including the System Administrator profile. Add read-only restrictions based on your business requirements to any user profiles that should not be able to edit this value, such as the Partner Community User.
  7. Click Save.
  8. Back on the Setup menu, under Build > Customize, click Arrow Iconto expand Contacts.
  9. Click Fields.
  10. In the list of standard fields, click Email Opt Out.
  11. Click Set Field-Level Security.
  12. Select the Visible checkbox for all user profiles that need access to Marketing Cloud Connect, including the System Administrator profile. Add read-only restrictions based on your business requirements to any user profiles that should not be able to edit this value.
  13. Click Save.

Great job getting those CRM settings configured! Grab a snack and then head to the next unit to begin setup in Marketing Cloud Engagement and finalize configuration.

Resources

Share your Trailhead feedback over on Salesforce Help.

We'd love to hear about your experience with Trailhead - you can now access the new feedback form anytime from the Salesforce Help site.

Learn More Continue to Share Feedback