In this article, we will focus on manual triggers. We will talk about what they are, how you can use them and give an example of a manual trigger.
In this guide we’ll go over:
Manual triggers: what are they?
As you might already know, Usabilla uses different processes to make sure a campaign is shown/triggered. Sometimes, a campaign is shown because of a timer. In that case, the timer coming to an end is what causes the campaign to be shown. Other times, a campaign is shown because your visitor has reached the bottom of a web page. In that case, the number of pixels from the bottom of the page is what causes the campaign to be shown. But sometimes, you want to decide for yourself when a campaign is shown.
This is where the manual trigger comes in. Using a piece of code you can create in your Usabilla account, you can make sure a campaign is triggered when you want to. Hence, a manual trigger.
You can manually trigger a campaign with almost anything. Common use cases are triggering a campaign by clicking on a hyperlink or a button on your website. It’s also possible to implement the same manual trigger multiple times on a webpage to trigger the same campaign. Common use case: multiple buttons triggering the same (or different) campaign.
How can I implement them?
It’s important to know that the process of using a manual trigger itself consists of 2 parts:
- Creating the manual trigger itself in your Usabilla account (see 2.1).
- Implementing this piece of code on your website as part of the event you want to use (see 2.2).
2.1. Creating the manual trigger
Please follow the following steps to create a manual trigger:
- Go to your Usabilla account and go to the campaign overview under Websites.
- Select your campaign and click on ‘Edit’
- Under ‘User targeting’ click on ‘Show your survey to certain visitors’
Please see below:
- Enable the option by clicking on ‘off’ and you’ll be presented with the manual trigger.
- Give the manual trigger a name. Make sure to use a unique name!
- Don’t forget to save.
2.2 Implementing the manual trigger on your website.
Now that you’ve created a manual trigger, we can begin with the second part: implementing the manual trigger into the event you want to use. It’s important to note that the manual trigger itself will be part of the code you’re planning to execute on your website. The manual trigger will be used to communicate with Usabilla to notify us that a specific campaign needs to be shown.
Avoiding common pitfalls
Make sure you use unique manual trigger names.
Make sure you don’t trigger multiple campaigns at once.
Make sure that you don't use events that trigger too often or trigger the same user.