Getting started on instance governance and documentation
Good documentation can be nearly as important as the actual instance implementation itself. A governance guide is a crucial resource that outlines your Marketo Engage instance setup details, covering topics such as program/folder structures, communication limits, and more. This living document is a reference for your Marketo Engage admin or power users, showcasing specific best practices and governing standards tailored to your Marketo Engage instance and organization.
But it doesn’t stop there. Your team may require supplemental enablement documents or training materials to enhance their proficiency with Marketo Engage. These resources could include interactive exercises, quizzes for access, or guidelines on permissible actions within Marketo Engage, benefiting all Marketo Engage users within your organization. Whether creating a comprehensive governance guide or documenting key setup aspects initially, recording decisions made during onboarding is key to ensuring success with Marketo Engage for your current team and future generations of new hires.
By understanding the importance of documentation and governance, this tutorial delves into the best practices sourced from expert peers and to help you put a process in place and keep the documentation relevant to your internal users.
Why Documenting changes and decisions during instance implementation is essential
Approach your Marketo Engage documentation as if you’re guiding a new employee unfamiliar with the technology to onboard to the instance. It’s easy to overlook fundamental knowledge once you gained experience with Marketo Engage. As an administrator, you should ensure your enablement and governance documents cater to beginners. To facilitate new users’ learning, a practical method is incorporating definitions and best practices directly into your training materials.
Creating instance documentation during instance setup offers several benefits:
- Streamline the training process for new users in a scalable manner.
- Facilitate long-term program development in Marketo Engage by building on a solid documentation foundation.
- Maintain the health and organization of your instance over time.
- Smooth the transition for new Marketo Engage administrators in case of team turnover.
Ultimately, writing down the decisions you make during implementation will help you and your team be successful with Marketo Engage without depending on one or a handful of people to enforce the processes.
How to build your Marketo Engage instance governance and documentation
Step 1 - Outline key topics in your instance documentation
Define a setup of standards of what should be documented and what is not necessary to be documented. This will enable the organization to adopt the process. As you expand the document, it is important to document the why behind the setup. This helps other administrators as much as yourself to avoid wasting time on decisions that did not yield results.
Guide your governance and documentation plan by starting with the sample outline below:
-
The purpose of Marketo Engage for our organization
-
Purpose of this Documentation
-
The Process to Maintain/Make Changes to the Governance Guide
-
Administrative Setup
- Subscription(s)
- Workspaces and Partitions (if apply)
- Technical Setup (DKIM/SPF/Munchkin)
- Roles and Responsibilities*
- Users*
- Smart Campaign/Email/Program Settings
- Communication Limits
- Security
- Channels*
- Tags
-
Data Structure
- Field Structure
- Custom Objects
-
Operational Programs
- Person Scoring
- Person Lifecycle
- Data Management
-
Building In Marketo Engage Instance
- Folder Structure
- Naming Conventions
- Program Organization
- Program Templates*
- Design Studio Assets (email templates, landing page templates, snippets, forms)
- Standardized Processes
- Checklists
- Segmentations
- Archiving policies
- Subscription Center
-
CRM Integration
- How does the sync work
- Campaign Sync
- Data Dictionary
-
Other Integrations
-
GDPR & Compliance
* At minimum, your documentation should include the details of users and roles, program templates, and channels once the setup has been finished.
Step 2 - Create a Changelog
Another critical way of instance governance is to create a Changelog and enforce using it. Any time you change a setting in the ‘Admin’ section or an Operational program, your team should note it in a centralized place such as a shared spreadsheet. This can help you remember why you made a change and what it was like before. Fields you should document in the Changelog include:
- Date
- Program name
- Program link
- Smart Campaign name
- Smart Campaign link
- Change made
- Reason for the change
- Who made the change
What’s next?
- Download the sample documentation and Changelog and adapt them based on your organization’s needs.
- Store the documentation in an accessible platform where your organization prefers to reference and update regularly. For example, some Marketo Engage Champions use Confluence (by Atlassian) or Excel Spreadsheet.
- Ensure every rule you make for governance has an owner to enforce it and adapt the documentation, keeping it up to date over time.
Author
Amy Chiu, Adoption & Retention Marketing Manager, ÃÛ¶¹ÊÓƵ