Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This document explains the steps required to connect Lead Liaison with your Salesforce.com Professional, Enterprise or Unlimited Edition account.

Table of Contents

Installation Overview

Lead Liaison is installed into Salesforce.com in a few easy steps. Here's an overview of the installation process:

  1. Setup a CRM sync user by adding your CRM credentials into Lead Liaison.
  2. Install Lead Liaison's Salesforce.com package through Salesforce.com's AppExchange.
  3. Add fields into your Salesforce.com Lead and Contact Layouts. 
  4. Setup Lead <> Contact field mappings in Salesforce.com.
  5. Use Lead Liaison's CRM configuration wizard and sync your Salesforce.com data to Lead Liaison.

Lead Liaison's Salesforce.com package will make the following changes to your Salesforce.com account:

  1. Add two new sections to your Leads and Contacts page layouts
    1. Lead Liaison (Native force.com module) to display activities, nurturing, scoring, grading, etc.
    2. Lead Liaison Marketing Data to display important marketing information such as total website visits, last website visit, lead score, and more.
  2. Create a new layout for the Leads and Contacts pages (optional to use).

Connect Salesforce.com to Lead Liaison

Follow these step by step instructions to connect your Salesforce.com account to Lead Liaison. 

Step 1: Add CRM Sync User

Lead Liaison requires one Salesforce.com user account be used as a master sync account. The sync account is the account used to send data bidirectionally, from Salesforce.com to Lead Liaison and from Lead Liaison to Salesforce.com. The sync account is required for operation and has no material impact on leads, contacts, opportunities or any other event.

Note

Salesforce.com suggests updating passwords every 90 days. If credentials for the sync account expire then syncing between Lead Liaison and Salesforce.com will fail. We suggest using a Salesforce.com Admin user as the sync account to use with Lead Liaison. See the section below called "Salesforce.com Password Profiles" for tips on how to set the password to never expire on your Salesforce.com user account. 

Follow the steps below to enter your CRM sync user:

...

Once you've connected your Lead Liaison account to your Salesforce.com account successfully you'll see a success prompt similar to the one below:

Step 2: Install Lead Liaison's Plugin into Salesforce.com

Install URL

Lead Liaison's Salesforce.com plugin is live on Salesforce's AppExchange portal. Access the plugin here: http://appexchange.salesforce.com/listingDetail?listingId=a0N30000009vFlTEAU

...

Follow the instructions below:

  • After install, and to view the package contents at a later point show all installed package contents under 'Setup' > 'Installed Packages'.
  • Proceed to Step 3 to integrate Lead Liaison into your layout.

Step 3: Add Lead Liaison's Custom Fields/Sections to your Salesforce.com Layout

Info
titleOptional Installation

If you have the Enterprise or Unlimited Edition of Salesforce.com then it is optional to add these two sections. If you have the Professional Edition or Group Edition then you must add the Lead Liaison Marketing Data section to your Lead/Contact layout; however, the Lead Liaison section is optional. 

During this step you will add two sections, "Lead Liaison Marketing Data" and "Lead Liaison", to the Lead and Contact layouts. 

  • Open the Leads page layout by going to 'Setup' > 'Customize' > 'Leads' > 'Page Layouts'.
  • Click the 'Edit' link next to the Salesforce.com layout you'd like to add Lead Liaison's custom fields/sections to.
  • You will see a page similar to the one below.

...

Info
titleCan't See the Content?

If your users cannot see the Lead Liaison Nurturing section in their Lead or Contact layout and they see an error like the one below then access permissions for the users profile needs to be modified. 

Content cannot be displayed: You do not have sufficient privileges to access the page: /apex/leadliaison__leadliaison_contact_custom_section

You can set permissions by going to Under 'Setup' > 'Develop' > 'Pages' make sure you set the proper security settings for the Salesforce.com profiles which should see this section. 

Step 4: Make Company Field on Lead Object not Required

  • Navigate to Setup > Leads > Page Layouts
  • Click the wrench on the Company field
  • Uncheck the "Required" box. 

This allows Lead Liaison to convert Leads to Person Accounts from an Automation action.

Step 5: Map Lead Custom Fields to Contact Custom Fields

Next, map the custom fields added by the Lead Liaison plug-in. Mapping custom fields ensures information added to a Lead is transferred to a Contact when the lead is converted in Salesforce.com. To map fields do the following:

  1. Go to 'Setup' > 'Customize' > 'Leads' > 'Fields'.
  2. Scroll to the bottom and click the "Map Lead Fields" button in the "Lead Custom Fields & Relationships" section.
  3. Map each custom Lead field to the related Contact field. Your results should look similar to the image below:
Info
titleNote

Make sure to map all the custom fields added by Lead Liaison package (Lead Liaison Score, Total Activity, Total Web Visits, Total time spent on last visit, Last Sync to Lead Liaison Web App, Last Web Visit, Last Search Engine, Last Search Phrase, Original Referral Source, Bounced and Profile Identifier)

Info
titleMap Profile Identifier

Map only the "Profile Identifier" field. Do not map the "Profile ID" field. Lead Liaison adds the Profile Identifier field automatically. This field is a formula that builds the hyperlink for the Profile ID. By mapping the Profile Identifier Salesforce.com will automatically map the Profile ID value for you.

 

Step 6: Change Field Accessibility to Allow Syncing

Note
titleOnly for Enterprise & Unlimited Editions

This section is not required for Group or Professional Editions of Salesforce.com.

To allow Lead Liaison's software to view and interact with certain Salesforce.com fields visibility permissions must be changed for each field listed below under the respective object. Five (5) objects contain fields that need updated visibility permissions. The 5 objects are:

  1. Leads
  2. Contacts
  3. Accounts
  4. Tasks
  5. Opportunities
  6. Campaigns (if you're using them)
Note

These settings must be applied only to the profile of the CRM user whose account is used for automatic syncing (see 'Step 1: Add CRM Sync User' section above).

How to Change Visibility Permissions

  1. Go to 'Setup' > 'Manage Users' > 'Profiles'
  2. Click on the profile of the CRM sync account
  3. Click "Object Settings". Alternatively, look under "Field-Level Security" find the "Lead" object and click "View"
  4. Make sure to check all the checkboxes under "Visible" (or "Read" and "Edit" columns) then save. 
  5. Repeat the same process for the Contact, Account, Opportunity and Task objects

Step 7: Create Custom Fields in Lead Liaison

Note
titleAll Custom Fields are Not Necessary

It's not necessary to create an equivalent custom field in Lead Liaison for each and every custom field in Salesforce.com. Create custom fields in Lead Liaison only for the fields you need to use in your business processes, such as segmentation, nurturing, scoring, etc.

...

Note, custom fields can automatically be created for you as shown in the steps below.

Step 8: Configure Lead Liaison and Sync your Salesforce.com Data

You're now done with setup inside Salesforce.com. Next, go to Lead Liaison and finalize setup from Lead Liaison's web application.

Complete Lead Liaison's CRM Configuration Wizard:

Lead Liaison synchronizes data between Lead Liaison's local database and Salesforce.com in real-time. To configure your CRM settings for Lead Liaison:

  1. Login to Lead Liaison at https://app.leadliaison.com/login.php
  2. Click the SettingsIntegrations > CRM
  3. Follow the wizard step by step to get your CRM account configurations complete
Info

Step 1: Select Edition and Default Sync Options

...

Once you are done, then your CRM configurations are complete and the bi-directional sync process between Salesforce.com and Lead Liaison will work automatically.

Salesforce.com Password Profiles

We recommend using your Administrator User for the sync account. Disable resetting of your password for your sync account by doing one of the following:

...

In the end, the user will have the same profile as before except with the password expiration set to never expire.

Enable Automatic Lead Creation (optional)

Lead Liaison offers the ability to automatically create a lead in Salesforce.com from visitors to your website that come from Connector (E-mail Marketing solution) or Send & Track (Microsoft Outlook Plug-in).

  1. Login to Lead Liaison at https://app.leadliaison.com/login.php
  2. Click SettingsSetup on the top of the page.
  3. Under "Admin Settings" section, click 'Account settings'.
  4. Check the check boxes next to "Auto-create CRM lead from email campaigns" and "Auto-create CRM lead from Send & Track emails" to enable automatic lead creation.

Setup Additional Users

Reference this page

Tip

Congratulations, you're done!

SFDC Custom Objects

The integration can include pushing Salesforce.com custom fields into Lead Liaison; however, does not include pushing Salesforce.com custom objects into Lead Liaison. As a workaround, the data from the Salesforce.com custom objects can be configured into a custom report and that report extract can then be imported into Lead Liaison.

Removing Fields 

Removing Custom SFDC Fields

Warning
titleSteps to Take When Removing Custom Fields

Removing a custom field in SFDC will disrupt the synchronization process between Lead Liaison and SFDC.

...

1. Delete custom field in SFDC and remove from SFDC lead/contact layout
2. Run Step 3 of the CRM Configuration Wizard (Import Metadata) immediately after deleting/remove custom field

Removing Lead Liaison Fields Under "Lead Liaison Marketing Data"

Any field in the Lead Liaison Marketing Data section can be renamed or removed. When removing a field in this section make sure to follow the same steps as mentioned above in the Removing Custom SFDC Fields section. Basically, run Step 3 of the CRM Configuration Wizard right away to avoid breaking the synchronization process. 

Removing the Lead Liaison Package

  • First, remove all dependencies. Dependencies must be removed first before uninstalling. For example, assigning the Lead Liaison Lead Layout to a profile is a dependency. Change the layout profile to another profile or the standard profile first.
  • Inside Salesforce.com go to 'Setup' > 'View Installed Packages'. If there are any dependencies removal will fail.

 

Alternative Ways to Add Lead Liaison's Sections to Lead/Contact Layouts

There are two additional ways to add Lead Liaison's sections to your Salesforce.com layout. 

  1. Assign Lead Liaison's layout to your profiles
  2. Automatically during the "Install Package" step of Lead Liaison's Configure CRM wizard (recommended for people using a standard Salesforce.com layout)

#1 Assigning Lead Liaison's layout to your profiles

 

To view the newly created Lead Liaison fields and sections assign the 'Lead Liaison Layout' to each profile which needs to see the data.

 

  • Open the profiles page by going to 'Setup> 'Administration Setup' > 'Manage Users' > 'Profiles'. In this example, we'll assign the Lead Liaison Layout to the Salesforce.com 'Standard Profile'.
  • Click on the 'Standard User' link.
  • Under the 'Page Layouts' section under 'Lead' click the 'View Assignment' link.
  • Click the 'Edit Assignment' button.
  • Next to "Page Layout To Use:" select 'Lead Liaison Lead Layout' and click 'Save'.
  • Now you have successfully assigned the Lead Liaison layout to your profile.
  • Repeat the same procedure for the Contacts section and assign the 'Lead Liaison Contact Layout' layout to the appropriate profiles.

 

#2 Automatically during the "Install Package" step of Lead Liaison's Configure CRM wizard

 

Go to the CRM configuration wizard:

 

  • Click Settings > Integrations > CRM

 

Begin by selecting your CRM version. You can find your CRM version by hovering your mouse over your browser's tab.

 

In Step 2 of the CRM Wizard, simply check the box in the "Install Plug-in" section at the bottom of your screen.

 

Note

This step will add only the Lead Liaison Marketing Data section to your layout. You must manually add the Lead Liaison section (visual force page) to your layout.