+ All Categories
Home > Documents > Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS |...

Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS |...

Date post: 11-May-2018
Category:
Upload: voliem
View: 222 times
Download: 0 times
Share this document with a friend
16
MARKETO OVERVIEW AND SETUP INSTRUCTIONS | TABLE OF CONTENTS Marketo Overview and Setup Instructions *Note: this document assumes you have a Premium or Enterprise subscription of Socedo and admin access to a Standard or higher Marketo Instance Estimated setup time: 15 minutes 1 Table of Contents 1 Table of Contents ........................................................................................................................... 1 2 Overview ....................................................................................................................................... 2 3 Setup Instructions........................................................................................................................... 3 3.1 Create an API Role and User in Marketo ........................................................................................ 3 3.2 Create a Client service in Marketo .................................................................................................5 3.3 Enter the Necessary Credentials into your Socedo Account .......................................................... 6 3.4 One-time Setup in Socedo ........................................................................................................... 8 3.5 Sample Sync and Marketo Configuration ..................................................................................... 9 4 How it Works ................................................................................................................................ 10 4.1 Socedo Lead to Marketo Lead Data Mapping.............................................................................. 10 4.2 Socedo Lead Activity to Marketo Lead Activity ........................................................................... 11 5 FAQ .............................................................................................................................................. 12 5.1 What if I already have a lead with the same email address in my Lead Database? ........................ 12 5.2 How do I get imported leads into an existing program or campaign? ........................................... 13 5.3 How do I change the lead source to something other than “Socedo” for my imported leads? ....... 14 5.4 How do I score Socedo leads based on Social Engagements? ...................................................... 15
Transcript
Page 1: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | TABLE OF CONTENTS

Marketo Overview and Setup Instructions *Note: this document assumes you have a Premium or Enterprise subscription of Socedo and admin access to a Standard or higher Marketo Instance

Estimated setup time: 15 minutes

1 Table of Contents 1 Table of Contents ........................................................................................................................... 1

2 Overview ....................................................................................................................................... 2

3 Setup Instructions ........................................................................................................................... 3

3.1 Create an API Role and User in Marketo ........................................................................................ 3

3.2 Create a Client service in Marketo ................................................................................................. 5

3.3 Enter the Necessary Credentials into your Socedo Account .......................................................... 6

3.4 One-time Setup in Socedo ........................................................................................................... 8

3.5 Sample Sync and Marketo Configuration ..................................................................................... 9

4 How it Works ................................................................................................................................ 10

4.1 Socedo Lead to Marketo Lead Data Mapping .............................................................................. 10

4.2 Socedo Lead Activity to Marketo Lead Activity ........................................................................... 11

5 FAQ .............................................................................................................................................. 12

5.1 What if I already have a lead with the same email address in my Lead Database? ........................ 12

5.2 How do I get imported leads into an existing program or campaign? ........................................... 13

5.3 How do I change the lead source to something other than “Socedo” for my imported leads? ....... 14

5.4 How do I score Socedo leads based on Social Engagements? ...................................................... 15

Page 2: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW

2 Overview The Socedo Marketo integration gives you the ability to build powerful engagement campaigns, nurture programs and/or marketing workflows with your social leads from Socedo. Marketo is an extremely powerful tool for modern marketing and our integration is designed to make it even better. Not only does the Socedo Marketo integration give you the ability to easily follow up with your social leads, Socedo also appends social activity to their lead profiles giving you valuable data points for automated campaigns, sophisticated nurture programs and lead scoring. You can customize which leads are exported on a daily basis and how they integrate into your Marketo instance.

Integration Requirements

In order to integrate Socedo with Marketo you must meet the following requirements:

• A Socedo account (only premium & enterprise will sync nightly by default) • A Standard or higher edition of Marketo

Page 3: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | SETUP INSTRUCTIONS

3 Setup Instructions

3.1 Create an API Role and User in Marketo

a. Navigate to the Marketo Admin Portal

b. Click on Users & Roles on the left panel c. Create a new Role with the following settings

Page 4: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | SETUP INSTRUCTIONS

d. Create a new User with the following Settings

Page 5: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | SETUP INSTRUCTIONS

3.2 Create a Client service in Marketo

a. Click on LaunchPoint in the left panel b. Create a new service with the following settings

Page 6: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | SETUP INSTRUCTIONS

3.3 Enter the Necessary Credentials into your Socedo Account

a. Click “view details” on your new service

b. Copy and store your Client Id and Client Secret

c. Click on Web Services in the left panel and copy & store your REST API Endpoint.

Page 7: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | SETUP INSTRUCTIONS

d. In Socedo, navigate to the Export page (/Home/Export) then click “Connect a Marketo Instance” to display the credential form. Enter the REST API endpoint (from c above) into the Endpoint URL box, enter the Client Id and Client Secret (from part b) into the respective boxes and once again click “Connect a Marketo Instance”. A success notification will appear if we were able to connect to your Marketo instance. If an error notification appears, make sure your credentials are correct and try again.

Page 8: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | SETUP INSTRUCTIONS

3.4 One-time Setup in Socedo

a. After successfully saving your Marketo credentials the page will refresh and the marketo configuration widget will be open. If the widget is not open, click the cog icon in the top right corner. Here you can customize your Marketo integration settings to best fit your business needs (Picture below).

You can configure Socedo to export specific types of leads. The options are:

• Approved leads: This includes all prospects that have been approved in Socedo.

• Followers only: This includes only leads that followed you after being approved.

• Export Organic Leads: These are leads that have naturally engaged with your brand on Twitter. (Feature only available in Premium and Enterprise Plans).

• Export Leads with Email Only: Only export leads that Socedo found an email for.

You can also select how to export your leads:

• Create new or duplicate: Socedo will always create a new lead. If a lead with the same email exists in your Marketo instance, a duplicate will be created.

• Create or update: Will create new leads or overwrite data for leads with matching emails.

b. After reviewing and editing your configurations click “Save” to either initiate a sample sync if you have matching leads or enable the sync for when you generate some.

Page 9: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | SETUP INSTRUCTIONS

3.5 Sample Sync and Marketo Configuration a. Once you have customized your configuration (Section 3.4) Socedo will attempt to upload a

sample of leads to your Marketo instance to ensure lead data is flowing properly. If you have lead data that matches your configuration, Socedo will upload this data within a few hours. If not, it will be uploaded within 24 hours of when you first generate those matching leads. After the first set of leads is uploaded, you will be notified via email so you can review the leads in Marketo. This email will also contain any action items regarding your pricing plan within Socedo and information about taking advantage of historical leads. Socedo will automatically sync on a daily basis from this point on unless you disconnect your Marketo account within the Marketo settings pane.

b. Congrats, you have successfully integrated your Socedo account with Marketo! If you have any questions please contact support from anywhere in the app, or check the FAQ section below.

Page 10: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | HOW IT WORKS

4 How it Works The Marketo Integration for Socedo will sync lead and activity data from Socedo to your Marketo instance on a daily basis. Each night around midnight Pacific Time, Socedo will upload a batch of the days leads according to the configuration you set in the previous section

4.1 Socedo Lead to Marketo Lead Data Mapping Each uploaded lead comes with the following Marketo fields as shown in the table below (fields are omitted if we do not have this information). *Note that Lead Source is always set to “Socedo”

Socedo Label Marketo Friendly Label REST API Name

Email Address Email Address email

Twitter Handle Marketo Social Twitter Id twitterId

First Name First Name firstName

Last Name Last Name lastName

Lead Source Lead Source leadSource

Company Name Company Name company

Job Title Job Title title

City City city

State State state

Country Country country

LinkedIn Url Marketo Social LinkedIn Profile URL linkedInProfileURL

Gender Marketo Social Gender gender

Facebook Url Marketo Social Facebook Profile URL facebookProfileURL

Approx. Employee Count Num Employees numberOfEmployees

Company Website Website website

Company Phone Main Phone mainPhone

Table 1 Socedo Lead to Marketo Lead Mapping

Page 11: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | HOW IT WORKS

4.2 Socedo Lead Activity to Marketo Lead Activity Additionally, Socedo will upload any new conversions on leads in your Marketo instance. Marketo’s API currently only allows activities of the type “Shared Content” to be uploaded, so the specific type of conversion that occurred will be included in the “Share Message” field on these activities. The following text descriptions correspond to how Socedo describes each conversion in Marketo:

Socedo Conversion Type Marketo Share Message Twitter user Followed you back Socedo: Followed back @[Twitter Handle] Twitter Direct Message Response Socedo: Responded to @[Twitter Handle]’s

dm Twitter Direct Message Click Socedo: Clicked on @[Twitter Handle]’s dm Twitter Converted Socedo: Converted to @[Twitter Handle]’s

goal Table 2 Socedo Activity Log Content

The name or handle of the social profile the lead engaged with is included to allow you to plug multiple Socedo accounts into Marketo and attribute leads to their different social profiles.

Page 12: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | FAQ

5 FAQ

5.1 What if I already have a lead with the same email address in my Lead Database? Socedo gives you to option to always create a new lead when importing into your Marketo Instance or to update existing leads if they already exist. Assuming you’ve selected the former, we won’t check your lead database before creating a new. Instead if a lead with the same email address exists in your database a duplication will occur and we recommend using Marketo’s built in smart list for identifying possible duplicates. If you’ve selected “create or update” we’ll simply overwrite our data onto the older lead record.

Once you have a list of possible duplicates select those leads you want to merge and click merge, alternatively you can delete the duplicates.

Page 13: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | FAQ

5.2 How do I get imported leads into an existing program or campaign? Since Socedo will import all leads as new leads any existing rules for your campaign’s smart list will automatically be applied to the new leads. If you have specific rules for how leads become part of campaigns, you can ensure your Socedo leads appear in your triggered smart campaign by adding a Lead is Created trigger to your campaign’s smart list with a constraint Lead Source is “Socedo”.

Now whenever a lead is imported from Socedo, it will automatically be added to your campaign.

Similarly for a batch campaign you can add a Lead Attribute filter on Lead Source is “Socedo” ensuring all Socedo leads will be included in our list.

You can use similar rules to create a smart campaign specifically for Socedo leads or to exclude Socedo leads from any existing campaigns. To work with these leads use the lead source attribute, which will always be “Socedo” for leads we import, to work with these leads.

Page 14: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | FAQ

5.3 How do I change the lead source to something other than “Socedo” for my imported leads? To change the lead source on imported leads you will need to add a flow action to your smart campaign. Once you have Socedo leads in your campaign’s smart list (see question 2 above) you need to add the Change Data Value flow action and specify Attribute: Lead Source and set your desired new value. You can use similar logic to change or add any specific attributes to Socedo leads to ensure cooperation with your existing infrastructure.

Page 15: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | FAQ

5.4 How do I score Socedo leads based on Social Engagements? Scoring leads based on social engagements is a powerful way to qualify leads. Socedo tracks your engagements with leads as they flow through your funnel. When we sync your leads with Marketo we also append their activities (Followed you back, clicked link, responded to your DM) as Shared Content to the lead’s activity log.

Once you have Socedo leads in a smart campaign (see FAQ 2 above) navigate to the Smart List view within the campaign. Add the Shares Content trigger (Triggers > Social > Shares Content), specify Share Message: starts with “Socedo: <engagement>”. Refer to Table 2: Socedo Activty Log Content above for a complete list of activities synced with Marketo, as well as the format of each message.

Page 16: Marketo Overview and Setup Instructions - Socedo · MARKETO OVERVIEW AND SETUP INSTRUCTIONS | OVERVIEW 2 Overview The Socedo Marketo integration gives you the ability to …

MARKETO OVERVIEW AND SETUP INSTRUCTIONS | FAQ

Once you have the trigger set, navigate to the flow tab. Add the Change Score action to the campaign flow, select the desired Score Name and set the Change value to be the amount you want added to the lead each time the action is triggered.


Recommended