Even the best of technology is bound to break…and if you haven’t run into an error yet, don’t worry, you will!
Marketo Engage is no exception. Perhaps it’s a red rickrack underlining a misspelled campaign name in a flow step. Maybe it’s a pop-up notification message, or simply an unexpected or unintended result. The trick to solving these unwelcome cases is to use Marketo Engage “forensics” to understand the perpetrator and weapon, then disarm them quickly.
In this blog post, I’ll walk you through the steps you need to become your own Marketo Engage CSI detective (Cue CSI Miami music intro) through:
Sometimes, identifying the problem is just as difficult as solving it! Use notifications and the campaign queue to help isolate your problem.
Need answers or a helping hand? Our Marketo consulting can help in many ways!
Most of you should be able to see the Notifications button at the top of the screen.
If you click on it, you will see a list of alerts and errors Marketo encountered. Administrators should monitor this weekly or even daily (if a large system) for major issues. Marketo tells you what is wrong, but you often have to go to the campaign or lead detail to find out more. Key issues include:
This brings me to our second tool: The campaign queue. The campaign queue lets us know what is happening right now, or what is about to happen for all smart campaigns. This can really help answer the question: "Why is my campaign running slow?“ or “why has my camping not yet run?”
As we dive into this one; It’s important to understand how Marketo Engage executes campaigns:
Priority Level | Priority Criteria |
High | Send email (triggered)Send alert |
Medium | Request Campaign Interesting Moment Create Task Convert / Delete Lead Add to / Remove from List Change Sales Owner / Progression Status / Revenue Stage / Field in Program Change Member of / Add to / Remove from Sync to SFDC Change Status in SFDC Campaign |
Low | Change data valueChange scoreWait steps with a wait time > 5 minutesWeb hooks |
Marketo Engage then executes campaigns based on priorities. High priority campaigns run first in the order they were added to the queue. Once those are finished, the next highest priority campaigns are executed in time order and so on down until all have completed. If the queue contains only low priority campaigns and a new high priority campaign comes in, the high priority campaign will jump to the head of the line and run next. Batch campaigns and trigger campaigns are run and processed in separate queues.
Several factors determine how fast and when your campaign will run. In general, campaign execution time depends on:
Even though Marketo Engage can execute many campaigns simultaneously, campaign execution resources are shared among all customers on the same server. If several customers trigger high priority campaigns at the same time, lower priority campaigns in the queue will have to wait for the high priority campaigns to complete. Also, certain campaign flow steps are slow.
The flow steps below take longer than most, and you may notice that difference when executing your campaigns:
Speeding up your campaigns
Here are some tips to speed up how and when your campaigns are executed:
Once you have identified the problem, use the campaign inspector, activity log, audit trail and smart lists and views to investigate and solve your problems.
Have you ever wondered which campaigns are using a specific flow action, such as Change Score or Request Campaign? Or where a certain filter is being used? The new Campaign Inspector (available from the Treasure Chest in your admin section) enables you to identify these campaigns, as well as active campaigns and campaigns with errors. Here are a few use cases you can solve with Campaign Inspector:
This is arguably the most important tool for testing and troubleshooting. The activity log is the area on a person in Marketo that shows you all the things a person has done, and what the system did or how the system reacted to your activity. You can use the Activity Log to answer such questions as:
Since there are hundreds of data points to review in an Activity Log, Marketo added filters to let you narrow down the types of behaviors or changes to work with this faster.
In addition to filters, you can use the Quick Find feature in the Activity Log to look for specific activities or key words to help you untangle the data presented to you.
A few key reminders:
Audit Trail captures, in real-time, a comprehensive list of actions and events occurring within a Marketo subscription. It includes a self-serve way to access a six-month history of data to help answer questions such as:
Marketo will audit the create, edit and delete actions for:
The Audit Trail is categorized in 3 components:
In Audit Trail, you may see a user’s name and email listed as “Unknown.” This happens when you make a change to your picklist values in your CRM. These values appear in Marketo forms and landing pages. Doing this update on the CRM side will auto-draft your landing pages referencing the form. In Audit Trail, we will capture that the landing page was drafted, but the user’s name and email will show as “Unknown,” as we are not able to capture the user info from the CRM side.
Another tool you have is the Smart Lists. In addition to creating your dynamic lists for campaigns, you can use Smart LIsts to pull groups of leads and then use Custom Views to look at certain fields.
The best use case is when you want to see Email Deliverability fields (and I always have a View with these fields). This View exposes the Email Bounced Reason in a clear way. You can sort it or even build a new smart list to narrow down these issues.
Example 1: Smart campaign may fail because campaign limits are set at the admin level. You can set the cap higher on individual smart campaigns to bypass the smart campaign limit:
Example 2: Adjusting wait steps to inflight campaign
When a lead hits the wait step, Marketo stores the date/time and the number of the next step. If you add steps before or after the wait step while the lead is in the wait step, this can cause unintended consequences. If you deactivate the smart campaign while leads are still in the wait step, they will complete their flow through the smart campaign. Be careful how you change flow steps in an active campaign with wait steps. Finally, when deactivating a smart campaign with a wait step, make sure you remove any leads from the campaign flow
Example 3: Marketo smart campaigns fire in different orders at different times, and can cause some havoc. Here are a few common issues I have seen.
Issues:
Causes:
When order is important, leverage Request Campaign flow steps. Add wait steps to give concurrent flows time to “catch up”.
Example 4: Trigger Campaign Failure
Think back to when we discussed the Activity Log…
When a new lead is created, every data value update for that new lead is NOT counted as a Data Value Change in the Activity Log, therefore it does not trigger a Data Value Changed trigger in a Smart Campaign.
Therefore, when wanting to include net new persons who’s data values are updated to match your criteria, you’ll also want to include a Person is Created trigger and a filter for that field data value.
Smart campaign triggers for executing on data value change and net new people not being executed on – the difference between an upsert and insert with the database.
A robust tool like Marketo Engage has a lot of features and functionality, but errors do occur. I hope this quick review gives you some guidance as to how you can track down the source of your errors and fix them.
So, what can you do now?