Integrate with Salesforce
B2B SaaS brands can use Salesforce and impact.com together to monitor and track conversion events, like sales leads and business opportunities. With flexible mapping abilities, performance marketers can easily identify specific conditions and trigger a conversion event, enabling them to use the contracting & commissioning features of the impact.com platform to payout partners for these events.
Salesforce and impact.com works in both directions, meaning you can use impact.com to set up a hosted widget that captures B2B SaaS Leads, Opportunities, Contacts and Accounts from your partners and automatically send them to Salesforce via an API integration. If those leads and opportunities turn into potential deals or completed sales, or if contacts go through meaningful milestones or stages, you can use our Salesforce integration to capture those changes as conversion events and send them to impact.com via this integration.
How it works
-
With a few clicks, verify that your impact.com account is ready to go for the Salesforce integration, making adjustments to a few account settings as necessary.
-
Then, you'll install the impact.com package in Salesforce and configure a few settings.
-
Once configured, you can customize the data parameter mapping to establish which events from Salesforce you want impact.com to track and report on.
Currently this is a integration that supports the following Salesforce objects:
- Leads
- Opportunities
- Contacts
- Accounts
Integration Prerequisites
Lead submission tracking via impact.com or Salesforce
Track leads via impact.com
Lead submissions can be tracked using the Impact Universal Tracking Tag (UTT), which is a small piece of JavaScript code that can be loaded using a Tag Manager solution, or placed manually on your website. Using the UTT offers richer user-level reporting in Impact, supports Optimize, Direct Tracking features, and more. If you're planning to track lead events using the UTT, the Customer ID value sent via the TrackConversion
function must also be available to the Salesforce objects that are being monitored and reported on. In other words, Salesforce needs to receive a Customer ID value in order for the integration to accurately correlate events.
Refer to the account setup steps below to ensure your account is configured correctly.
Track leads via Salesforce
Lead submission can also be tracked through Salesforce. Impact appends an irclickId
parameter + dynamic value (per click) on your landing page URLs. Example link: yourdomain.com?irclickid=clickid123
. The clickId
value (clickid123
) must be captured and stored. When the user submits the lead form, the clickId
value must be sent in a hidden field to Salesforce. There must be a consistent ID available in Salesforce objects that are being monitored and reported on to send in the CustomerId parameter.
Account setup
Follow the prerequisite steps below to ensure their account is ready for the integration. At a high level, these include:
- Verify that a couple key account settings are properly configured.
- Confirm that your account is ready for the Salesforce integration, and make adjusts if needed.
- Establish a unique customer identifier (e.g., `customerId`) that persists across all entities that need to be tracked — from when a new lead is tracked, to when it becomes an opportunity, etc.
Check before integrating
impact.com will complete several integration steps on your behalf. Check with your implementation engineer to ensure that the following configuration steps have been completed: Event Type, Gateway Tracking, General Tracking.
Establish a Customer Identifier
As part of your tracking integration, you'll need to generate a unique customer ID value across each event type to be tracked.
-
If you're using the impact.com UTT tracking integration, learn more about the
identify
function — your lead form site will need to generate a unique Customer ID value that's passed when a potential lead submits the form, and this value needs to be passed across each event type as the lead progresses towards a "Signed Contract" final state in order to ensure that it's the same customer and the partner that referred them receives credit. -
If you're tracking via API, refer to the Conversion object reference documentation — your lead form site will need to generate a unique Customer ID value that's passed when a potential lead submits the form, and this value needs to be passed across each event type as the lead progresses towards a "Signed Contract" final state in order to ensure that it's the same customer and the partner that referred them receives credit.
Installation
Step 1: Install the impact.com package to Salesforce
Only Salesforce System Administrators should install and configure the impact.com package.
Install impact.com
- Visit the impact.com Partner Manager Salesforce AppExchange page.
- Select Get It Now.
- Follow the on-screen instructions to get the impact.com app installed.
- If you experience any issues installing from the AppExchange, please use this direct link instead.
Step 2: Configure your impact.com credentials in Salesforce
You'll need your impact.com Account SID, Auth Token, and Program ID.
Add impact.com account credentials
- In your Salesforce account, navigate to the Impact Setup tab.
In the tab, input the required fields:
Account Data Description Impact Account SID* Navigate to
→ Settings → API to find your Account SID. Copy the full case-sensitive value.Auth Token* Navigate to
→ Settings → API to find your Auth Token. Copy the full case-sensitive value.Program ID* Enter your Program ID value (a.k.a Campaign ID value). To find this value, select your brand name in the top left corner of Impact. Your Program ID is shown in gray type under your Program name in the Program column. Select Save.
Step 3: Establish Impact Monitoring
In this step, you'll identify which conditions in Salesforce need to occur for impact.com to track it as a conversion event.
Set up impact.com monitoring conditions
- In the Impact Integration app in Salesforce, select the Impact Event Triggers tab.
Under the Enable sending events when records are created section, use the toggles to choose which events will trigger a conversion event in Impact when a record is created in Salesforce for that object.
Under the Enable sending events when records are updated section, use the toggles to choose which events will trigger a conversion event in Impact when an object's record is updated in Salesforce.
Under the Record multiple field changed section, select the fields that you want a conversion event to occur for when they're updated.
The multiple field selections act as an
OR
statement — for example, ifLead Status
andLead Source
are selected for an object, a conversion event is created whenever either field is modified.
Step 4: Configure Salesforce & impact.com data mappings
This step is where you'll configure a map of which Salesforce data parameters map to their equivalent impact.com data parameters. This step is key in ensuring the data you send from Salesforce is accurate for conversion reporting.
When a Salesforce field is mapped to an impact.com field, the data in that field will be reported to impact.com in the conversion data.
The instructions below apply to Lead, Opportunity, and Contact objects.
Add a mapping
- In the Impact Integration app in Salesforce, select the Impact Field Mapping tab.
- Refer to the data mappings reference tables below for details.
- Under Salesforce Field, use the dropdown menu to select a Salesforce object field.
- Under the Impact Field, use the dropdown menu to select an impact.com data field.
- Select Add.
Remove a mapping
- In the Impact Integration app in Salesforce, select the Impact Field Mapping tab.
- Select the section (e.g., Leads, Opportunities, etc.) that you want to remove a data mapping from.
- In the list of existing data mappings, find the one you wish to delete and select Remove.
Removing a data mapping will no longer report that field to impact.com — be careful, as this can alter your conversion reporting.
Data Mapping Reference
Salesforce Lead
Replace $STATUS
with the actual status value for the lead.
Object Field | impact.com data field |
---|---|
Lead_$STATUS | EventTypeCode |
ID | CustomerId |
Lead_$STATUS_ID | OrderId |
LastModifiedDate | EventDate |
Company | Text3 |
City | CustomerCity |
Country | CustomerCountry |
PostalCode | CustomerPostCode |
Salesforce Opportunity
Replace $STAGE
with the actual stage value for the opportunity.
Object Field | impact.com data field |
---|---|
Opportunity_$STAGE | EventTypeCode |
ID | CustomerId |
Opportunity_$STAGE_ID | OrderId |
LastModifiedDate | EventDate |
CloseDate | Date3 |
Probability | Text2 |
Amount | OrderSubTotalPostDiscount |
Salesforce Products
Object Field | impact.com data field |
---|---|
Product_Name | ItemName1 |
Product_ProductCode | ItemSku1 |
Product_Quantity | ItemQuantity1 |
Product_UnitPrice | ItemPrice1 |
Product_Description | ItemCategory1 |
Product_TotalPrice | ItemSubTotal1 |
Salesforce Contact
Note
Contact object mapping is customizable and impact.com recommends that you map according to your use case. The table below is neither suggested nor required, but an example.
Object Field | impact.com data field |
---|---|
LeadSource | EventTypeCode |
Contact ID | CustomerId |
Contact_[Contact ID] | OrderId |
LastModifiedDate | EventDate |
Salesforce Account
Object Field | impact.com data field |
---|---|
Id | OrderId |
CreatedDate | EventDate |
Updated 5 months ago