Setting Up Target for Marketo

  • Updated

This article outlines the procedure to complete your installation after your Target account is authorized by an InsideView Customer Success Manager (CSM).

Only Account Administrators can configure the Target for Marketo application.

Note: If your organization restricts network access to third party applications, please ask your IT administrator to add the following IP address ranges to allow updates from Demandbase:

  • 52.4.63.192 to 52.4.63.223
  • 64.56.203.0 to 64.56.203.255

Configuring Target for Marketo consists of the following tasks:

Signing up for Target

Please reach out to your CSM to sign up for a Target account. Also, for any credit allocation and authorization of your account please reach out to your CSM.

Creating an InsideviewId Custom Field

If you are setting up Marketo integration for Target, it is mandatory for you to create an InsideviewId custom field in your Marketo application with string datatype. Target will auto-map this field to sync leads into your Marketo application. 

Step Description Details
1 Login to Marketo Login to your Marketo application 
2 Navigate to Administration Panel In the upper-right corner of the page, click Admin.
3 Go to Field Management On the left panel of the Admin page, click Field Management.
3 Select New Custom Field link On the Field Management page, click New Custom Field.
4 Select a datatype In the New Custom Field window, select type as String.
5 Enter a Name and API Name

Enter Name and API Name values as InsideviewId as shown below:

6 Create an InsideviewId custom field. Click Create.

Setting Up a REST API Role and User

Refer to the Marketo Custom Service guide: http://developers.marketo.com/documentation/rest/custom-service/

Target uses the REST APIs to connect with Marketo application. You must have admin access for setting up Rest API role and user.

Step Description Details
1 Login to Marketo Login to your Marketo application.
2 Navigate to Admin Panel In the upper-right corner of the page, click Admin.
3 Launch User & Roles page

On the left panel, click the Users & Roles node.

4 Launch New Role page

In the Users and Roles pane, click New Role.

5 Enter API Role name In the Create New Role page, enter the API Role Name.
6 Select Permissions Select the following permissions from the Access API menu:
  • Read-Write Activity
  • Read-Write Lead
  • Read-only Lead
  • Read-only Activity
7 Create API Role Click Create.
8 Create an API Only 

The next step is to create an API only user and associate it with the API role that you just created. You can do so by checking the API-Only user check box at the time of user creation, and check API user in “roles and workspaces”.  Although an email invite will not be sent out, you should use an email address that is accessible.

9 Create a custom application

A Custom service is required to uniquely identify your client application.

To create a custom service, go to the Admin>LaunchPoint page and create a new service as illustrated below:

10 Pick a web service name
  • Pick a display name that makes the service easy to identify and remember.
  • Choose "Custom" as the service type. 
  • From the API Only User drop-down list, select the API only user that you just created earlier.

 

11 Create Service

Click Create. Once the service is created, you will see a new line item in the installed services.  There are two items that are required to validate the Marketo instance: Client Id and Client Secret.

12 View Client Id and Secret

Click the View Details link on the grid to get the Client Id and Client Secret.

13 Copy Client ID and Secret

Copy the Client ID and Client Secret in a notepad or a text document.

Retrieving REST API URLs

Copy the Endpoint and Identity REST API URLs from Admin Navigation Pane. These URLs are found in the web services section of the Admin Navigation pane (Admin->Web Services).  The URLs which are required are found in the REST API region as illustrated below:

Copy each URL and store in the same notepad or text document where Client Id, and Client Secret are saved.

Configuring Target for Marketo

Step Description Details
 1 Log into Target Once you have four Authentication details, log into Target.
 2 Go to Demandbase Sales standalone Go to https://my.insideview.com, or if you are on the Demandbase homepage, click Login.
 2 Enter login credentials Enter the Login Name (user ID) and Password for your Demandbase user account and click Sign In..

   

Note: Only Demandbase Account Administrators can set up the Salesforce CRM integration, so ensure you have logged in with the correct User ID. 

 3 Go to Settings Once you log in to Demandbase Sales, click Build a List in the top menu and click Settings icon to expose the Authentication tab.

   

Note:Only when you log in with an Account Administrator user credentials, then Settings icon is displayed.

 4 Configure Marketo application authentication

On the Integrations tab, click the Authentication subtab.

Enter the following Marketo authentication credentials that you have saved in a notepad earlier:

  • Client ID – A randomly generated ID that is associated with the Marketo account.
  • Client Secret – A randomly generated secret string that is associated with the client ID.
  • Endpoint URL  A REST API Endpoint URL for your Marketo application.
  • Identity URL  A REST API identity URL for your Marketo application.

Note: The Save button at the bottom is grayed out, and sometimes requires the user to cycle through each field using the Tab key.

 5 Save  Once configured, the Marketo logo gets updated with a green Configured badge, and Field Mapping becomes available to set up.
 6 Check custom field mapping

Custom Field Mapping is mostly automated. You can review the custom field mapping to see how Demandbase matches Target fields to standard fields in Marketo. 

For example, Phone Number automatically picks up the Marketo field phone. If you wish to edit the default mappings, select the pencil icon, which appears when you hover a field name.

Note: By default, InsideviewId field is auto-mapped. If the InsideviewId field is not mapped you must create this custom field with the string datatype in your Marketo application. Otherwise, you cannot perform a Sync to Marketo.

 7 Map InsideviewId

Use the Field Management from the left hand navigation pane to map the InsideviewId field to a new custom field.

 8 Refresh Marketo  Refresh the Target instance in order to see this field in the drop-down list as illustrated below:

 

 9 Save changes Click Save to make sure all changes are saved.

Verifying a Successful Set Up 

After your authentication credentials are configured and field mapping is complete, the last step is to verify that a list can be successfully exported. 

Because Target is a credit-based system, and you do not want junk data in the system, it is best to create a list size of 1 for testing purposes.

De-duplication depends on email in order to be effective, and since most marketers want leads with email address, add the Contact Info field from in + Add Search Criteria options and select email.

Build a sample list with Job Levels selected to further refine the People list as illustrated below:

Click Search and select the Export to Marketo.

 

Exporting a People List from Target to Marketo

Target allows you to sync People lists directly into your Marketo automation system.

Step Description Details
1 Log into Target

Log into Target with your credentials.

2 Sync search results into Marketo

Once the Marketo account credential and field mapping is complete, click Export to Marketo.

 

3 Accept sync messages

When you click Export to Marketo, a series of messages will appear as illustrated below: 

Click Sync.

5 Receive an email notification

Once the People list is synced into Marketo, you will receive an email notification confirmation with number of people that were moved to your Marketo application as illustrated below:

Once People list is imported, you can be confident that the set-up is complete and successful!

Note: You can export a maximum of 50,000 records in an .xlsx file and sync upto 10,000 records in your Marketo marketing automation system.