Skip to main content
The Conversion Activity component shows Conversion activity on Lead, Contact, and Account record pages in Salesforce: emails, page visits, form submissions, campaigns, and custom events. Reps see a lead’s engagement where they already work, without a Conversion seat.
Conversion Activity timeline on a Contact record

Set up the activity timeline

Before you begin

  • The Salesforce sync is connected. See Admin User Setup or Integration User Setup.
  • You’re a Salesforce System Administrator.
  • You’re an administrator in your Conversion workspace, so you can create an API key.
One Conversion API key serves your whole Salesforce org. Salesforce decides who sees activity: a user needs the Conversion Activity Viewer permission set and read access to the record.

Step 1: Install or upgrade the Conversion package

Open the package install link from Install the Salesforce package. If your org already has the package, choose Upgrade.

Step 2: Turn on callouts

Salesforce turns callouts off when it installs or upgrades the package. The component can’t reach Conversion until you turn them back on.
1

Open Named Credentials

In Salesforce, click the gear icon → Setup. In Quick Find, enter “Named Credentials” and click Named Credentials.
Quick Find showing Named Credentials
2

Open Conversion API

Click Conversion API.
Named Credentials list with Conversion API
3

Turn on Enabled for Callouts

  1. Click Edit.
  2. Turn on Enabled for Callouts.
  3. Click Save.
Edit Conversion API dialog with Enabled for Callouts turned on
4

Check the setting

Enabled for Callouts shows as on.
Conversion API named credential with callouts enabled
Check this setting again after every package upgrade.

Step 3: Create a Conversion API key

In Conversion, go to Settings → Integrations → API and click Add API key. Name it “Salesforce” and copy the key. See API.

Step 4: Give yourself the Conversion Admin permission set

The Conversion Admin permission set shows the Conversion Setup tab, where you save the key.
1

Open Permission Sets

In Setup, enter “Permission Sets” in Quick Find and click Permission Sets.
Quick Find showing Permission Sets
2

Open Conversion Admin

Click Conversion Admin. The package adds two permission sets: Conversion Admin and Conversion Activity Viewer.
Permission Sets list
3

Assign it to yourself

  1. Click Manage Assignments → Add Assignment.
  2. Check the box next to your name and click Next.
  3. Leave No expiration date selected and click Assign.
  4. Click Done.
The screenshots in Step 6 show each of these screens.

Step 5: Save the key

1

Open the Conversion Setup tab

Click the App Launcher, search for “Conversion”, and click Conversion Setup.
App Launcher search showing Conversion Setup
Before a key is saved, Connection says Not connected. Save a Conversion API key to connect.
Conversion Setup tab before a key is saved
2

Paste the key

Paste the key from Step 3 into Conversion API key and click Save.
Conversion API key entered
3

Check the connection

Connection shows Connected to the Conversion workspace and your workspace name. Click Test connection to check again later.
Conversion Setup tab connected to a workspace
Salesforce stores the key encrypted, and it can’t be read back. Saving a new key replaces the old one.

Step 6: Give users access

Assign Conversion Activity Viewer to everyone who should see Conversion activity.
1

Open Conversion Activity Viewer

In Setup → Permission Sets, click Conversion Activity Viewer, then Manage Assignments.
Conversion Activity Viewer permission set
2

Add assignments

Click Add Assignment.
Current Assignments with the Add Assignment button
3

Select users

Choose a list view, such as All Users. Check the box next to each user and click Next.
Users selected for assignment
4

Assign

Leave No expiration date selected and click Assign.
Expiration options for the assignment
5

Finish

Salesforce confirms the assignments. Click Done.
Assignment Summary showing success
The users appear under Current Assignments.
Current Assignments listing the assigned user

Step 7: Add the component to your record pages

Do this once each for a Lead, a Contact, and an Account.
1

Open a record

Open any Lead.
Lead record page
2

Edit the page

Click the gear icon → Edit Page. Lightning App Builder opens.
Gear menu with Edit Page
Lightning App Builder
3

Find the component

In Components, search for “Conversion”. Conversion Activity appears under Custom - Managed.
Component search showing Conversion Activity
4

Add it to the page

Drag Conversion Activity onto the page. Click it to set its properties.
Conversion Activity added to the page with its properties
5

Save

Click Save. If Salesforce asks you to activate the page, click Activate. If it doesn’t, the page is already active and you’re done.
Page Saved dialog with Activate
6

Activate the page

Click Assign as Org Default.
Activation dialog
Choose the form factors your users need and click Next.
Assign form factor dialog
Click Save.
Review assignment dialog
7

Repeat for Contacts and Accounts

Click the back arrow to leave App Builder, then repeat this step from a Contact and an Account.

What the timeline shows

Activity is newest first. Click Show more to load older entries, and the refresh icon to reload.
Conversion Activity timeline
Use Show to filter by Emails, Page visits, Form submissions, Campaigns, Custom events, or Lead conversions.
Show filter options
Click Show details on an entry for more about it, such as the pages in a visit or the answers in a form submission.
A page visit with its details expanded
A record appears once the Salesforce sync links it to Conversion. See Contacts and Companies.

Troubleshooting

With callouts off, the Conversion Setup tab says so under Connection:
Conversion Setup tab with callouts turned off
Until setup is finished, or for a user without the Conversion Activity Viewer permission set, the component asks them to contact their admin:
Lead page with the component before setup is finished