Campaigns. Restarts. Campaignevent additions. Will they run? What does really happen?
Let’s reveil the mechanic turk inside of Mautic with some hands on tests and clear results.
This comes up awfully lot in different forums, tutorials, but there is little clearity behind what really happens. I’d like to clear it up everything in this post. If I wouldn’t be 100% clear about something, please drop me a line and I’ll extend this article.
Want to troubleshoot your campaigns?
Case Nr. 1.: Simple Campaign With restarting option
I created a simple campaign with sending out 2 emails sequentially. The source of the campaign is a segment, where contacts qualify based on a tag.
As the last step I created 2 contacts to qualify for the segment by adding a tag.
As you can see, all went well, contacts got into the segment, than into the campaign. Events went to pending state (grey) then executed properly. (yellow). All good.
I removed one of the tags and the contact left the campaign. The funny thing is: the email was already queued for this contact, and once I removed him from the segment, he disqualified to be a member of the campaign, so the email simply failed. This was immediatly represented in the campaign view:
Okay, great, now let’s re-add the contact to the campaign, and see what happens. Will he go to the unfinished step 2? Or he will try to continue the campaign? Or just start from the beginning? (Spoiler: restart means restart.)
This is the complete breakdown of the contact journey with explanations. Please see how he was added, removed and re-added to the campaign.
If your campaign can be restarted, and you disqualify a contact based on segment membership to be the member of a campaign, than the campaign will be started from step 1 once the contact requalifies to be the member of the campaign.
You might ask: okay, but after the last email is sent – is he still a member of this campaign? If yes, can I add further steps to the campaign and will they be executed?
The answer is YES. YES. NO. (Btw my favorite podcast has a yes-yes-no segment…)
The contacts will be member of the campaign:
And YES, you can add campaign steps, and they will show it the campaign action list.
But they won’t be executed, just hand in there 🙂 So if you ever wonder why you see pending actions hanging, this might be the reason:
Okay, great, so what happens if I add new people to this campaign? For them the third step would be there from the first moment.
The answer is: for them it will be business as usual, they will go through all 3 events:
Events are triggered when a contact enters the campaign and executed. If the contact reaches the last step of the campaign, they will be still member of the campaign, but newly added events are not executed for them.
Just for the sake of sanity, let’s see if a contact is re-added to a campaign, where turn off the ‘Contact can restart the campaign’ button.
I created a new contact, a new segment and a new campaign to test it. The campaign had a 2 email sequence.
The contact got the 2 emails.
In order to test the re-adding functionality, as a first step I removed the tag that qualifies the contact to be the segment member, and campaign member. The contact left the campaign as expected.
Once I re-added the tag, the contact was re-added to the segment, but not the campaign. So we got expected results.
Okay, one last thing to test: What happens if we add a new email?
To test this, I added a new contact to my ‘non-restartable’ segment by adding the neccessary tag. He nicely qualified into the campaign, and got the first 2 emails. Than the contact ‘finished’ the campaign as expected (and stayed a member).
I added the new email, and it was added as ‘pending’ to the list of actions. And the email was never sent, since the campaign was over for this person.
See detailed action list:
Regardless of the campaign restartability, you new actions after a campaign was once over for a contact will be not executed.
6 thoughts on “Let’s understand how Mautic Campaigns are triggered (detailed test results explained)”
Great Article and investigation!!
what if I want to plan only the first month, and then keep adding emails to the campaign?
let’s say I want to send an email, and then after 7 day another email and so on. I can’t possibly plan years ahead.
I’d add every now and then a few emails to the campaign, but this won’t work since they won’t get sent to the old users…
found a solution to this?
Hello Ivan, sure, but not pretty one.
I’ll make a video soon, which helps you to understand how to prevent users from finishing a campaign.
But until then:
1. Add the email to the campaign. People will get the email when they are so far in the campaign.
2. People who already at the end of the campaign, need to be sent a segment email.
You can create a new segment for them by using filter:
campaign membership IS the campaign in question
email sent NOT the email in question
This segment will have all contacts who are in the campaign, but didn’t get the email.
Idea to make it possible to continue a campaign, if a new action is added to the end of the campaign, where contacts are already there:
1.) At the end of the campaign put a “Condition based on a contact tags” – it should be “true” if the contact has the tag “Continue”
2.) To the orange “false” side of the Condition, put a “Jump to event” and make it jump back to that Condition after 1 day or 7 days or whatever
3.) When you want to add a new event (like a new email to send) to the campaign, add it to the green “true” side of that Condition
4.) Give your contacts the tag “Continue”
5.) Your contacts waiting at the end of the campaign will continue it on the green “true” side.
6.) After that, you can remove that whole Condition+Jump
It’s easier, than it sounds
Thanks for the idea.
When you add the jump event, and jump back every day – would you create an action every day?
If you set for 7 days, would the condition yes branch fire if you change on day 2?