List Imports
For event or other lead generation campaign list uploads, please use the instructions for self-service uploads.
The following information is for manual list uploads only. If you are unable to use the self-service import for an event/campaign upload, please open an issue with Marketing Operations for assistance.
Import Methods and their SLA
For non-event/campaign list uploads, there are a couple of ways to get leads into our systems.
Import Method | SLA | Submission Instructions | Operations Instructions |
---|---|---|---|
Zoominfo w/in SFDC | self-managed | Instruction video how to do this can be found in the handbook | Not applicable |
csv file | Accepted by OPS - 24 business hours Upload to SFDC - up to 5 business days |
Use MktgOPS general list import request template, format as a Google Sheet (Gsheet) & place link to Gsheet in issue Written Instructions how to use template |
Ad Hoc Upload |
The SLA for each import method has been decided based on the perceived optimal response time. If a list of prospects cannot be considered “warm”, please expect a turnaround time of the listed 5 day SLA and use the appropriate template.
If a last minute request, please indicate the rush request in your issue or ping OPS in #mktgops
slack channel to discuss options
Import Cleaning Template - Info for Pre-MktgOps Hand-off
Please find detailed data cleaning, formatting, and required data instructions on the self-service page, under Data Cleaning Instructions. The process is the same for both types of imports.
If your list load is being completed by MOps, please complete the additional following steps after cleaning your data file.
- Give
edit access
of the spreadsheet to the relevant MktgOps member - Post a link to the spreadsheet in the list upload issue. Provide as Google Sheet in the upload issue. In order to protect data, DO NOT upload the file directly on the issue, always provide a link.
- Apply the ~“List Upload: Ready” label to the issue
MOps instructions for manual uploads
At time of upload, a campaign should already exist in Marketo
. Campaigns are to be created by the campaign owner. For a running list of campaign templates, go here.
Upload Process
Operational uploads
In the event that a manual upload needs to occur for operational or transactional email needs. Note that this process can be variable depending on the purpose of the upload, so please use your discretion when selecting and building programs/smart campaigns.
- Use a current or create a new program or smart list within the Non-Event List Loads folder or the appropriate email program.
- For transactional emails, clone the appropriate program template. For other operational list loads, you can clone this program to get started.
- Some notable
Operational
programs already in place are listed below with links. This section will be updated on a needed basis: - For transactional email list processing for security or other related notifications, be sure to run a campaign that accomplishes the flow steps outlined in the List Processing smart campaign.
- Preferred format for Marketo upload is .csv, but will accept an .xls, or .xlsx.
Campaign uploads
Campaign-related uploads. These should use the self-service import process, but in rare cases where that is not possible, the following instructions apply.
In order to assure proper attribution of MQL Scoring
and Last Interesting Moments
, perform the following checks before any uploads occur:
- If a campaign does not exist, tag the
Campaign Owner
on thecampaign epic
orupload issue
to ask for campaign creation and token completion. - Check that the campaign’s
tokens
are filled in, which are found under theMy Tokens
tab in the main campaign.Tokens
are used viaSmart Campaigns
to applyLast Interesting Moments
to all leads whom appear in the campaign. The minimumtokens
that should be used relate to the campaign’sEvent Name
,Event Date
andLanding Page URL
. Without these filled out,Last Interesting Moments
will fill in permanentlyblank
- Review the components of the campaign. The needed components include:
Static List(s)
in which to load lead list(s). Thestatic list(s)
should be renamed to resemble the program name. Depending on the campaign template, there may be more than onestatic list
available. Some templates have been automated in a way that will fully launch relevantSmart Campaigns
to append all relevant data, includingCampaign Member Statuses
and other important fieldsSmart Campaign
that triggers aflow
when leads are added to the campaign’s static list(s). This flow should set the following fields if the fields are empty ONLY:Acquisition Program
andPerson Source
(same asInitial Source
in SFDC), andChange Program Status: to relevant status
. If updating no shows, you will need to add a flow step forRegistered > No Show
. On most program templates, we have a Manual List Upload Smart Campaign to help with this.- For campaign related uploads only:
Smart Campaign
to add anInteresting Moment
. Check there are enoughtriggers
andflows
to activate for eachCampaign Member Status
that appears on the list. Usually these include, but are not limited to:Attended
,Attended On-Demand
,Visited Booth
andNo Show
. A general rule is to not includeRegistered
,Sales Nominated
orMarketing Nominated
. The previously mentionedtokens
will be used to apply the full event data of theInteresting Moments
to the leads. Depending on the template, sometimes thisSmart Campaign
and the previously mentioned campaign are one and the same
Best Practices and Procedure
- Remove all unecessary data from
Job Title
,Company
,Names
andLocations
columns, such as punctuation,self
, etc, from the Google sheet before uploading. Check for any remaining duplicates and missingRequired Data
, pinging thecampaign owner
to fix, as needed - Only allow
Opt-in=TRUE
if the agreement to be contacted has been recorded in the list upload issue. Leave blank otherwise - Sort list by
Campaign Member Status
and then divide the whole list into separate tabs for the different statuses, eg.Attended
,Registered/No Show
, etc - Download the .csv file of the tabs to desktop
- Load the corresponding .csv file to the corresponding
static list
and match up the fields on upload. These fields should mostly match automatically- If there is only
one static list
for the program, change theCampaign Member Statuses
for each uploaded list before uploading the next. If all leads were uploaded at once and this is not possible, create aSmart List
and filter byEmail Address
as a way to distinguish and change to the correct statuses
- If there is only
- Always load
No Show
leads asRegistered
before setting them toNo Show
. Otherwise, they will not receive MQL scores. Check if aSmart Campaign
changes the status toNo Show
before finalizing and if not, switch status fromRegistered
toNo Show
- Depending on how the template has been set up, the remaining steps of appending data could be automated. If it is not, be sure to append the data listed above to the proper fields
- After all steps of the needed
Smart Campaigns
have ran, including the often automatedProgram Status: Registered -> No Show
, turn off the activatedSmart Campaigns
by “unscheduling” them - Check the
Loading Errors
smart list for any potential lead loading errors.- Check the
Person Details
on any leads that show up on the smart list and correct the error. If Marketo indicates aduplicate
, change the name on the lead by adding random but easily identifiable characters to the last name and manually force the lead to sync with SFDC. Find the lead in SFDC and merge it with the pre-existing duplicate. If there is a differingemail address
between the records, add the newemail address
as a secondary email. Add to SFDC campaign with the appropriateCampaign Member Status
, if necessary
- Check the
- Once the Marketo –> Salesforce sync has completed, use the Upload checking template - do not erase lead view to check data has been applied correctly, scoring has occurred and leads have routed. Plug the
campaign tag
, or Marketo program name, into the lead view’scampaign name
field to view leads as a list - Ensure the number of leads present in the Salesforce campaign matches the total number of leads from the original spreadsheet
- Announce the upload in either the
event_list_upload
orpub-sector-isr
Slack channels, depending on the campaign’s intendedSub-Region
. IncludeRegion
labels for private sector posts - After verified completion of all tasks, remove ~“List Upload: Ready” label and notify in the issue of upload completion. Adjust the “MktgOps” label and apply a milestone
- Close list upload issue
Trusted vs Non-Trusted Imports
In Marketo there is a an option to choose trusted or non-trusted sources. Non-trusted sources are for list uploads that we are not confident in the data points given to us. For example, if we are loading a list with inferred country data from IP, we do not want it to overwrite our current location data that is more accurate. Blocking updates allows for a field to be updated if blank, but will not overwrite a field that already has a value.
Here is the list of fields that are blocked during a non-trusted import. If you would like to add more fields, please file an issue with the mops team.
- First Name
- Last Name
- Job title
- Company
- Country
- City
- State
- Postal Code
eac292a8
)