Page tree
Skip to end of metadata
Go to start of metadata

Prerequisites

Your Salesforce instance must have access to Salesforce API's to sync data between Marketo and Salesforce.

Marketo uses a set of fields to capture certain kinds of marketing related information. If you would like this data in Salesforce, please follow the instructions below. 

  1. Create three custom fields in Salesforce on the lead and contact objects: Score, Acquisition Program, and Acquisition Date. 
  2. Map these custom fields between leads and contacts so that on conversion in Salesforce, the values carry over.
  3. You can create other additional fields, if necessary (see the table below).

All of these custom fields are optional and are not required to sync Marketo and Salesforce. As a best practice, we recommend that you do create fields for Score, Acquisition Program, and Acquisition Date.

 

Add Marketo Fields to Salesforce

Add three custom fields on the lead and contact objects in Salesforce listed above. If you want to add more, see the table of available fields at the end of this section.

Perform the following steps for each of the three custom fields to add them. Start with Score.

1. Log into Salesforce and click Setup.

 

2. In the Build menu on the left, click Customize and select Leads. Click Fields.

3. Click New in the Custom Fields & Relationships section at the bottom of the page.

4. Choose the appropriate field type (for Score — number; Acquisition Program — text; Acquisition Date — Date/Time).

5. Click Next.

6. Enter the Field Label, Length, and Field Name for the field, as shown in the table below.
Field Label
Field Name
Data Type
Field Attributes
Scoremkto71_Lead_ScoreNumberLength 10
Decimal Places 0 
Acquisition Datemkto71_Acquisition_DateDate/Time 
Acquisition Programmkto71_Acquisition_ProgramTextLength 255


Note

Salesforce appends __c to Field Names when it uses them to create API Names.


Note

Text and number fields require a length, but Date/Time fields don't. A description is optional.

7. Click Next.

8. Specify the access settings and click Next:
  • Set all roles to Visible and Read-Only
  • Clear the Read-Only checkbox for the profile of your sync user:
    • If you have a user with the profile of a System Administrator as the sync user, clear the Read-Only checkbox for the System Administrator profile (as shown below)
    • If you created a custom profile for the sync user, clear the Read-Only checkbox for that custom profile 

9. Choose the page layouts that should display the field.

10. Click Save & New to go back and create each of the other two custom fields. Click Save with you're done with all three.

11. In the Build menu on the left, click Customize and select Contacts. Click Fields.
12. Perform steps 3 through 10 for the Score, Acquisition Date, and Acquisition Program fields on the contact object, just as you did for the lead object.
13. Optionally, use the above procedure for any additional custom fields from this table.
Field LabelField NameData TypeField Attributes
Acquisition Program Idmkto71_Acquisition_Program_IdNumberLength 18
Decimal Places 0 
Original Referrermkto71_Original_ReferrerTextLength 255
Original Search Enginemkto71_Original_Search_EngineTextLength 255
Original Search Phrasemkto71_Original_Search_PhraseTextLength 255
Original Source Infomkto71_Original_Source_InfoTextLength 255
Original Source Typemkto71_Original_Source_TypeTextLength 255
Inferred Citymkto71_Inferred_CityTextLength 255
Inferred Companymkto71_Inferred_CompanyTextLength 255
Inferred Countrymkto71_Inferred_CountryTextLength 255
Inferred Metropolitan Areamkto71_Inferred_Metropolitan_AreaTextLength 255
Inferred Phone Area Codemkto71_Inferred_Phone_Area_CodeTextLength 255
Inferred Postal Codemkto71_Inferred_Postal_CodeTextLength 255
Inferred State Regionmkto71_Inferred_State_RegionTextLength 255

Map Custom Fields for Conversions 

A custom field on the lead object in Salesforce should be mapped to a contact field on the contact object so that data is carried over when a conversion occurs. 

1. In the top right corner, click Setup.

2. Type "fields" into the Nav Search without pressing enter. Fields appears under different objects; Click Fields under Leads.

3. Go to the Lead Custom Fields & Relationships section and click Map Lead Fields.

4. Click the drop-down next to the field you want to map.

5. Select the corresponding contact custom field.

                                                                                                                                                                                 

6. Repeat the above steps for any other fields you've created. 
7. Click Save when you're done.

Easy enough, right? 

Deep Dive

Here's a video of the entire process that should make it crystal clear!