Import conversions from Salesforce (Legacy)

If you track leads and opportunities in Salesforce’s Sales Cloud, you can import your offline conversions from Salesforce's Sales Cloud into Google Ads. This will help you better measure how your online Google Ads investments are generating offline value.

In this article, we'll show you how to set up your accounts to import conversions from Salesforce.

Note: This information applies to the standard integration with Salesforce. If you notice “Salesforce” on the list of import sources while creating a new conversion action from import, you’re using the legacy integration with Salesforce. You’ll have an option to upgrade your Salesforce integration in the future.

Before you begin

Check the minimum permissions requirements for your Salesforce account below before you set up the Salesforce integration

1. To link your Google Ads and Salesforce accounts you need to have administrative access in Google Ads, and access to Salesforce account credentials. You should use a dedicated Salesforce login, instead of your own personal login.
2. For you to query Salesforce, the Salesforce user needs to meet the minimum permissions requirement.
3. Make sure to request minimum data scope during the Salesforce OAuth handshake.
4. The Salesforce integration allows you to have control over what to import via field mappings and conversion definition.
5. You should delete the OAuth tokens upon unlinking.
6. The Salesforce account credentials must contain and retain a minimum of READ-Only permissions specific to the events you wish to import into Google Ads as a conversion. Review the below table for guidance on which permissions are required.
   • For example, if you want to import conversions when the Leads:Status Object in Salesforce changes to Qualified, the permissions in the first column would apply.

     Salesforce Object	Leads-based Conversions	Opportunities-based Conversions
     Lead
     LeadStatus
     LeadHistory
     Opportunity
     OpportunityStage
     OpportunityFieldHistory
     OpportunityContactRole
     Organization
     Contact

3. The following must be enabled within Salesforce:
   • Lead/Opportunity field History
   • API

In addition to enabling the above fields, you need to track old and new values for the fields you used to define event conditions later. This means whatever you choose as your event condition in Google Ads should align in Salesforce to import as offline conversions based on business goals and bidding best practices (for example when Leads: Status changes to 'sales qualified lead'). Then depending on the event conditions, you should enable the tracking of the corresponding field history.

Note: For agency-owned Google Ads accounts, an advertiser must have access to Salesforce credentials or the advertiser must be given temporary access to the Google Ads account in order for the one time authentication.

Learn more about How to set up a Salesforce integration.

Are you using a legacy integration with Salesforce for offline conversion imports?

Enhanced conversions for leads is an upgraded version of offline conversion import that uses user-provided data, such as email addresses, to supplement imported offline conversion data to improve accuracy and bidding performance. When you import your offline conversions, the provided hashed customer data is used to attribute back to the Google Ads campaign by matching to the same data collected on your website (for example, lead form) and to signed-in customers who engaged with your ad.

If you already use offline conversions, you can upgrade to enhanced conversions for leads to import user-provided data in addition to the identifiers you already import (GCLID). Learn more about how Google used enhanced conversions for leads data.

Check the minimum permissions requirements for your Salesforce account below before you set up the legacy integration with Salesforce:

Google Ads Conversion Import for Salesforce requires access to the following fields, organized by object. A user account with System Administrator access may already have access to these fields.

Note: Organization fields referenced below are located in the “Company Settings” under “Company Information”, not under your standard “Object Manager”.

• Organization: ID, Name, OrganizationType
• LeadStatus: ID, MasterLabel, SortOrder
• OpportunityStage: ID, MasterLabel, SortOrder, IsActive
• LeadHistory: CreatedDate, OldValue, NewValue, Field
• Lead: Status, GCLID (a custom field you’ll create in the steps below)
• OpportunityFieldHistory: CreatedDate, OldValue, NewValue, Field
• Opportunity: Amount, Probability, StageName, GCLID (a custom field you’ll create in the steps below)

If you use Group Edition or Professional Edition, field access is granted by simply adding the necessary fields to your Lead and Opportunity page layouts. To do this, select Setup, then Customize, then Lead (or Opportunity), then Page Layout. Then simply drag the required fields onto the page.

If you don’t want to link your Google Ads and Salesforce account, you can follow the instructions to manually import conversions from Salesforce.

Learn more about How to set up a legacy integration with Salesforce.

Related link

• About Google Ads Conversion Import for Salesforce