Install Managed Package
Login to Salesforce and Install package URL:
- Sandbox: https://test.salesforce.com/packaging/installPackage.apexp?p0=04t1N000000Q3Pu
- Production: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t1N000000Q3Pu
Choose “Install for All Users" (access is controlled on the Permission Set level, so installing for all user profiles is the recommended approach)
Set Email Deliverability to "All Email"
In Setup, navigate to "Deliverability", then select "All email" to receive email notifications on sync jobs.
Create Remote Site Settings
Navigate to “Remote Site Settings” and add new Remote Site Settings.
- Enter the application’s tab “Settings”
- Open the browser’s Developer Tools (Mouse “Right Click” [Anywhere in the page] => select “Inspect”)
- Enter the “Console” tab, insert the following text: ”remSite()” and press ENTER
- First Possible Outcome: Successfully Added The Remote Site Settings
The page will show a Confirmation Message that a new Remote Site setting was Added (Named: AutoGenOrgEng)
- Second Possible Outcome: IO Exception - Error While Attempting to Add Remote Site Settings
The page will reload with only a Message instructing to Add The Required Remote Site Setting. Please Copy the URL from the “HTTPS” to the “.com” (included) and create a new remote site setting
- Copy the instance from your salesforce URL
- https://<INSTANCE>.salesforce.com (Instance is what you copied in the last step)
Navigate to the App
Navigate to the "Leadspace Audience Sync" tab in the applications drop-down menu in the top right-hand corner of your Salesforce.
Click on the application, then navigate to the settings tab.
Fill in any empty fields and click "test connection and save".
*EFM Endpoint should be "https://apigw.leadspace.com".
Assign Permissions Sets
Return to Setup in your Salesforce.
On the left search bar, type “Permission Sets”.
Within the Permission Sets section, you’ll be able to see three new permission sets, as shown in this screenshot:
To assign users to a permission set, click on each one, click “Manage assignments”, and go to "Add Assignments" to add Salesforce users to a set.
Configure Input Field Mapping
Click on the Input Field Mapping tab to define your input fields. Leadspace uses certain fields as input in order to best identify and enrich people and companies. Here is where you will tell the Leadspace Sync specifically which fields from each object to use as input for enrichment.
Assign each Leadspace field to one of your existing fields on the Account, Contact, and Lead object. Click "Save" after mapping each object.
Configure Results Field Mapping
Click on the "Results Field Mapping" tab to define which fields you want Leadspace to populate the enriched data into. You either have the option to create a new field to insert the data into, or to map to an existing field in your Salesforce.
To create a new field for Leadspace to populate into, select the option "Create New Field"
To populate your Leadspace enrichment data into an already existing field in your CRM, click on the drop-down menu and select the existing field you would like to map into.
** Important Note **
The Leadspace Salesforce Sync app is required to create three fields:
- Last Leadspace Activity Date: Last date and time the record was sent through the Leadspace Salesforce Sync
- Leadspace Error Code: Identifies if a sync error has occurred
- Leadspace Error message: Indicate the type of error that has occurred (example: server connection error, invalid input, no credits, etc)
These fields are technical validation fields and are required for the Sync app to work properly. Customers may also use these fields to help filter and report on records that have been enriched via the Leadspace Salesforce Sync. For example, Last Leadspace Activity Date "IS" <Empty> will yield all records that have not been sent through the Salesforce sync, and vice versa.
Create Sync Definition
Click on the "Sync Definition" tab to define your subset of leads, contacts, or accounts to run through the Leadspace Sync for enrichment.
Click "New" to create a new definition
Under your desired object (please note: Salesforce only supports the enrichment of one object at a time), create your first definition.
In the first drop-down, select an existing field in your Salesforce.
Then select the appropriate operator.
Type in the value you want to filter your database by.
For example, to enrich accounts in your database, you can create the criteria:
"Created Date" => "greater than" => 01/01/2018
This will create a subset of all accounts created after January 1, 2018 that you can now run through the Leadspace Sync for enrichment.
You may also use multiple enrichment job criteria, using the AND/OR filter logic between them.
To do this, click the "+" icon next to the first criteria. This will add an additional row in which you can define the criteria. Then add the additional Filter Logic below it. To make both criteria required, type "1 AND 2". To make only one of the criteria required, type "1 OR 2".
Click ‘Apply Filters’ to see the size of the audience to be synced - i.e. the number of records that meet your filtering criteria. This is the number of Salesforce objects that your synced audience will include. This is also the number of Leadspace transactions that will be consumed. Once you apply your filters, the enrichment process will begin.
Important note - every calculation of records that meets your filter criteria is consuming a single Salesforce API call.
Now that your Sync has been setup and configured, you can learn more about how to run and track enrichment's through the Leadspace Salesforce Sync here
- During setup, your administrator defines the maximum number of records that a single Sync activity can hold. If the size of your audience exceeds the number of allowed transactions for a single Sync, a message will pop up. In such a case, the filtering criteria need to be updated to ensure fewer records are included in the Sync
- Clicking ’Run now’ in the audience size calculation page will record the audience sync definition and open the Sync Definition details page. Every audience sync definition that is run creates an Activity. An Activity is the executable object of the audience sync definition, consists of all the records that were selected using the filtering criteria. Each Activity is then sent to Leadspace in bulks.
- Once all the bulks were synced with Leadspace data, the activity status is set to ‘Success’, and an email is sent to the Sync definition owner, with detailed status.
- In the event that one or more bulks were not synced successfully, the activity status is set to ‘Partial Success’ and an email is sent to the Sync definition owner.
- The duration of the sync process depends largely on the size of the selected audience. Syncing a very large number of records (top limit for the limited release is 400K records) may take up to 12 hours.
- Each activity bulk that is synced updates the related Salesforce objects immediately, so you don't need to wait for the entire activity to end before your Salesforce objects are refreshed.