Skip navigation
All Places > Products > Blog > 2019 > January
2019

Products

January 2019 Previous month Next month

By now, you've probably heard the exciting news: Marketing Nation Summit is taking place at Adobe Summit, March 24-28, 2019 in Las Vegas!

 

Why? Because, now that you’re part of the Adobe family, Adobe and Marketo couldn’t wait to engage with you and connect you with an even larger community of passionate marketers. Integrating Marketing Nation Summit into Adobe’s event allows you to not only enjoy all of the usual Marketing Nation activities, but gives you the opportunity to connect with the broader Adobe ecosystem and benefit from multiple days of additional breakout content covering every area of interest to modern marketers in 2019.

Together with 15,000+ marketers, advertisers, data scientists, and other experience marketers, join us for four inspiring and action-packed days. Learn more about how Marketo integrates with Adobe Sensei, Adobe Experience Cloud, Adobe Analytics, and much more. Marketo will be integrated throughout the entire event, including the community pavilion (exhibit hall), general sessions, and networking events—plus, we have added a dedicated day on Thursday, March 28, specifically focused on bringing together the entire Marketing Nation for compelling content breakouts sessions, and most importantly, opportunities to celebrate our achievements together.

 

Tickets are on sale now and all Marketo customers will be offered a discounted ticket price of $1,195 (originally $1,895). To purchase tickets, register here and enter promo code S19MN.
 

Stay tuned for more information in the coming weeks, including:

  • A full list of Marketo sessions
  • Marketo’s University Day and opportunities to get your Marketo certification
  • Plus, regional events for the Marketing Nation community happening around the globe throughout 2019, such as Adobe Summit EMEA in London (May 13-16, 2019)


Questions? Please don’t hesitate to reach out to summitsupport@adobe-summit.com.


Best,
 

The Marketo Team

“Imagine you win the lottery today and quit your job tomorrow. Would someone be able to step right in and take over your Marketo instance?” This is the mindset Tori Forte, Marketo consultant extraordinaire, recommends as you’re thinking about documenting your Marketo instance. In fact, good documentation can be nearly as important as the actual implementation itself. Keeping track of changes and decisions you’ve made during your instance setup can help you:

  • More easily train additional users in a scalable way
  • Build more efficiently in Marketo long-term
  • Maintain the health and hygiene of your instance moving forward
  • Make the transition process much smoother for a new Marketo admin if your team experiences any turnover


There are a couple different types of documentation you can produce. A governance guide outlines your instance setup in detail with topics such as program/folder structures, communication limits, and more. This would be a living document that users would turn to in order to identify your specific best practices and governing standards for your Marketo instance, and would mainly be for your Marketo admin or main user. In addition to a governance guide, your team may need supplemental enablement documents or training materials to help them get up to speed with Marketo. These could include exercises to practice working with the platform, quizzes to pass before being granted access, or a list of what your users are allowed to do in Marketo. These would be aimed at all Marketo users in your organization.
Whether you’re putting together a full blown governance guide or are simply documenting the key aspects of your setup to start, writing down the decisions you make during onboarding will help you and your team be successful with Marketo.

Getting Started on Your Documentation

Having trouble getting started on your guide? Tori suggests first focusing on the most important aspect of your Marketo documentation: your Admin Setup. “Make sure you’re writing down all of your behind-the-scenes decisions so if anyone needs to take over your Marketo instance, they’ll be able to understand how and why your instance was set up the way it is.” It’s crucial, Tori points out, that you “don’t just document what was built, but why it was built that way.” This helps a future admin (or even future you) avoid repeating decisions that didn’t work out or wasting time going down dead ends.

 

Another recommendation from Tori to establish the success of your documentation is to “ensure every rule you make has an owner to enforce it down the line. Lack of enforcement makes writing those rules moot.” Check in with your team and put a process in place to make sure this documentation will continue to adapt and stay relevant, as well as stay top of mind for your users.

Tips and Tricks

Whether you’re documenting a new/existing instance or creating training resources for your organization’s Marketo users, consider these tips from one of our resident Marketo experts, Kylie Peters:

  • Over-document, over-communicate, over-test! If it feels like you’re doing enough, you might not be doing enough.” You never know what might be useful to you or your team in the future, so be sure to add in details and keep other teams in the loop!
  • Be ‘new-hire-minded’. Write the documentation for someone who’s never used this technology before.” Once you become familiar with Marketo it can be easy to take a lot of background knowledge for granted. Make sure you’re creating your enablement and governance documentation with the most basic user in mind. Consider including some definitions and best practices directly into your training documentation if they’ll help new users get up to speed.
  • People have different ways of processing and understanding information so it helps to use a combination of written points, pictures, videos, and hands-on exercises in your trainings.” Instead of just writing a block of text to send out to your team, include some interactive content or a couple different formats within your enablement documentation and training.
  • Run the documentation by someone who’s never seen Marketo before and ask them if they have any questions.” Not sure if your governance and enablement documentation is clear? Ask someone who’s never used Marketo to take a look and see if they can follow your trainings. This will give you a good fresh perspective on what you’ve put together and how you can improve it.
  • “It’s important to remember that training documents are very different based on your needs and your instance.” Unlike governance guides, which should be as comprehensive as possible, enablement documents should be produced based on your organization’s need. Keep in mind that what might be important to document in detail for one instance or one user could be less relevant for others. You should know your instance and users best, so create your training documentation accordingly.



Marketo Documentation Sample Topics

Use these topics to guide your initial Marketo governance documentation plan. It may help to take it slow and start with a few topics that are important to your particular instance, then expand from there.

 

  • What is Marketo and what are its purposes for our organization
  • Purpose of this Documentation
  • Process to Maintain/Make Changes to Governance Guide
  • Administrative Set Up
    • Instance(s)
    • Workspaces and Partitions
    • User Roles and Responsibilities
    • Smart Campaign/Email/Program Settings
    • Communication Limits
    • Security
    • Channels
    • Tags
  • Data Structure
    • Field Structure
  • Operational Programs
  • Building In Marketo Instance
    • Center of Excellence (COE)
    • Folder Structure
    • Naming Conventions
    • Program Organization
    • Templates
    • Standardized Processes
    • Checklists
    • Segmentations
    • Archiving
    • Subscription Center
  • CRM Integration
    • How does the sync work
    • Campaign Sync
    • Data Dictionary
  • Other Integrations
  • GDPR & Compliance

 

Check out an example of Channel Documentation here.

 

Start documenting your instance today! Be sure to involve your whole team - whether that’s just you or a team of 10 - and revisit these docs every month to keep it up to date as your use of your Marketo instance grows.

Or not so much “beware” as ignore an Email Bounced Soft that doesn't have an associated Category.

 

Far too many posts and practices imply that grouping Email Bounced Soft-s together with a simple filter is harmless. The thought is that you may want to separate Category 3, Category 4, and Category 9 but you don't have to.

 

The approach is implicitly encouraged by the official docs:

 

 

But this doc is misleading, because there's one type unlisted: call it the No-Category (NC) Soft Bounce.

 

Guess what falls into NC? If you read my posts avidly, you might suspect it's something code-related. Yep: a Velocity token parsing error results in an NC Soft Bounce.

 

Here's one I triggered at a client just now by accidentally deleting the close parenthesis ) from a #set directive:

 

 

I quickly fixed the error before sending again in this case.

 

But imagine if it took more troubleshooting, and each send triggered an operational campaign (or qualified for the equivalent daily batch) that counted Email Bounced Soft activities without a Category constraint, setting Marketing Suspended = true when people exceeded a threshold. There are well-known recipes for Marketo database cleaning out there that do just that!

 

Don't make that mistake. Constrain Email Bounced Soft by Category [is not empty] to catch only the bounce types which may call the lead's info into question. Velocity coding errors must not be held against the lead, as they're completely in your court.

 

You can view just the Velocity parsing errors like this:

 

 

 

P.S. and N.B.: the Velocity errors that are surfaced as NC Soft Bounces are Velocity Template Language (VTL) parsing errors. That is, forgetting the #end of an #if, missing parentheses or brackets, or other broken syntax. That doesn't include Java language errors thrown by syntactically valid VTL, like trying to get() a nonexistent index in an ArrayList of Custom Objects. The latter type of error shows up verbosely in the Preview UI, but if it makes it to send time, it's swallowed by the system. You will only see the Sent Email without a corresponding Delivered Email in this case. Obviously that's pretty ambiguous. So test, test, test your Velocity!

Filter Blog

By date: By tag: