Summary: Summary: This article provides a comprehensive guide to planning, launching, and managing Gainsight Journey Orchestrator (JO) programs, emphasizing thorough planning, testing, and communication. It should take approximately 10-15 minutes to read thoroughly. Missed the previous posts in this JO-focused series? This article follows these previous posts: Understanding Journey Orchestrator: Yes, it’s important enough to have its OWN admin! Diving Deep: My Role as a Gainsight JO Admin Main text: Getting started: a good plan is essential As you plan your first few JOs, it’s best to start simple. The fewer steps and the less complex the source, the greater the likelihood of a successful launch, and the lower the risk of errors. Look for the low-hanging fruit, especially where automations can result in a big win for you and your team. Speaking of your team, include your stakeholders from the beginning — all of them. Ask questions. Skipping this crucial step is a surefire way to experience unpleasant surprises, and will likely end in failures or messy rebuilds when a stakeholder changes their mind (either before or AFTER the program launches). Some questions you might ask include: Will this email need a tokenized field in the content? Who will this communication be sent from? How frequently will the content need updates? During your kickoff conversations with stakeholders, establish a project doc — EVERY project needs a doc so nothing gets missed. Nothing complicated, and you’ll likely develop your own template over time, but it’s a good way to ensure you have all the information when you start building your JO. A good project doc will also help with the golden rule for builders (across industries): measure twice, build once . Rebuilds are messy, and there’s nothing worse than spending hours creating the source and logic for a program, only to realize that the foundation won’t meet the needs of the project. Cleanliness is next to… well, cleanliness is critical. Just like labeling code, labeling and documenting every step in your program with a clean, transparent naming convention that describes what each step does is crucial , as it allows your teammates to look at a program and understand at first glance what is happening. As your programs get more complicated, it’s easy to forget what happened three merges ago, or what’s being looked at in a conditional evaluation step. The more steps and branches your program has, the greater the necessity. This community post (see the comment from @matthew_lind ) offers some fantastic examples of best practices when it comes to naming conventions. Advanced JO query labels for easier reading Being able to quickly ascertain which step does what is especially helpful when it comes time to test and/or troubleshoot a program, both when you’re working with one of your teammates, and when you have to open a support ticket. If you want your Gainsight support agent to be able to help you quickly, helping them to have a clear understanding of what’s happening in your program allows them to diagnose what may be causing an issue. As you build your way through your program, always be testing — both as you build and prior to launch. Getting to the “ready to launch” phase and realizing you have to scrap your build can be a major blow to your ego. Sometimes it just happens, but if it’s preventable, it’s best to figure it out as early as possible. Key considerations – explore every angle As you plan a new JO, explore every angle. This is a key part of the kickoff conversations you should have with program stakeholders as you develop your project doc. Do you know your audience, or do you need to adjust your targeting? Is there a chance you might need to reuse the source (with updates) frequently, and in other areas, or is the source only applicable for single-run JOs? Consider whether a query, data design, or event might be the best source for your goals. Can you reuse part of the source? Consider building a data design template so you don’t have to keep rebuilding the same datasets and merges. (see this post for an example) Data Design (DD) Template building block to map string text to an email DD Template building block incorporating another building block with user info Dynamic JO design with clear labels for easy, at-a-glance understanding of journey flow Have you (and your stakeholders) fully explored the journey length (and logic)? How many emails do you want to send? How many versions (based on what criteria)? What evaluation logic will be used if there are multiple emails and versions? How long do you want the email recipients to wait between each email? Are there any actions they need to take, or should they progress through the journey automatically? What will the content look like (and who will be building it)? Will you need to use calculated fields, or does it matter if a field changes while the recipient is in the program? If you’re using calculated fields, make sure you’re tying them to the recipient/company appropriately! How long is the lifespan for the content? “Permalinks aren’t permanent” — thanks for that nugget of wisdom in Episode 96 of your Digital CX Podcast , @TurkOfAges ! Should participants be able to re-enter the program? If yes, how often? What is your uniqueness criteria? (Hint: recipient email address and company identifier is a good combination.) How frequently do you want your audience query to run? How will you be tracking program engagement? Simple tracking can be done within Gainsight, whether through reports and dashboards, or through a quick glance at the program analytics. If your stakeholders utilize UTMs, adding those to your links is a great way to gauge your overall JO contributions to their campaigns. If stakeholders are outside of Gainsight, systems such as DOMO allow data to be visualized in even more comprehensive dashboards. Program launch countdown When you’re getting ready to launch your program, there are several items to keep in mind (developing a checklist may help while you’re establishing your process): Confirm all necessary aspects are toggled/filled out correctly. A lot of important checkboxes, toggles, and options are scattered across a multitude of different screens and menus within JOs. (ex: Map to Timeline, participant uniqueness & re-entry criteria …) Double-check email envelope settings, CCs/copies, etc. — correct name and email addresses, spellings. Make sure email versions are mapped correctly (including logic)! Prep for analysis — make sure link(s) are tracked to allow click tracking, and UTM parameters are added if used. Test, test, and test again. Prevent unpleasant surprises AFTER launch by testing EVERYTHING. Consider: source, journey logic (evaluation steps, branching paths), email content (including templates with multiple versions, tokenized fields), subject lines, etc. Cloning your JO and creating a test version filtered to include participants meeting specific logic criteria to allow previewing every version can be very useful — if you launch a test JO, make sure to use YOUR email as the recipient! Looking for tips on testing your program? This post by @sarahmiracle is priceless (and timeless). Plan your launch date. Consider the best time and day of the week to launch your program — depending on the schedule, Fridays can be good to avoid sending an email to too many people. Be prepared to hit “pause” or take the program offline if needed. Communicate the launch timeline (and what will be launched). Communication is key. Use all appropriate internal channels to limit surprises. Consider whether other teams besides stakeholders might appreciate a heads up prior to launch. (ex: You’ve been working with the CSM team, but the support team might not know anything about it and could be taken by surprise.) Share the doc — make sure everyone knows what will be sent (not just the overview). Sharing the subject line and sender name is very helpful — especially if CSMs/AOs/support reps are getting customer responses. Ensure the JO participant sync schedule is set up to coordinate appropriately with the JO entry schedule. Depending on your source (ex: query that only runs once for a 1x program), you may need to sync the query prior to launch. Programs that run with multiple queries (typically Advanced JO) or are scheduled to query a data design should NOT be launched with participants in the program, unless you want emails to send as soon as the program is active. HOWEVER , the program needs to be fully active (and takes time to become active) prior to the time the source syncs. The program launch time and source sync time CANNOT be scheduled at the same time — I suggest at least a 30 minute buffer time. Post-launch followup Give yourself a hand — your program is live! After launch, it’s time to follow up to make sure things are running smoothly. First things first, check the activity to make sure participants are flowing as expected. As you monitor your metrics, it’s best to keep a relaxed frame of mind — and circulate this bit of knowledge with program stakeholders (noted in this Community post by @ajprince: engagement metrics and timeline/activity feed appearance can be delayed by up to 24 hours after program launch. After the first 24 hours (and subsequent reporting back to project stakeholders), if your program is scheduled to continue running on a recurring basis, it’s a good idea to add it to a recurring program log to check back on a regular timeframe to make sure nothing abnormal is happening. This is also a great place to record any program changes (query updates, reasons a program is paused/archived, etc.). Conclusion Successful program launches require careful planning, clear communication, and thorough testing. Start simple, involve everyone, and write out all the details. Label each step clearly, and test throughout the process. Pay attention to your audience, content, and how people move through the program. Before launching, double-check the settings, test again, and clearly socialize the planned launch date at least a full business day prior to activation. After launch, monitor the program and keep a log of ongoing programs for future reference. To my fellow admins, is there anything I’ve missed here that you’d recommend as a key thing to keep in mind for anyone new to JO? After three years, so much of this is just ingrained. 😆