Client Reference
Let us dive deeper in what can you achieve with Zonka Feedback web widgets.
Web Surveys and Workspaces
Our web client for web surveys is workspace specific and each workspace may contain multiple surveys. The web client will expose at max ONE type of each widget - Pop over, Pop Up and Side bar. There could be multiple surveys with enabled pop overs or pop ups and side bars, the one which was enabled or updated last, will be visible through the workspace web client.
You don't need to re-install the code if you build a new widget or survey within a workspace and you already have it installed on your website.
Identify logged-in visitors
Identifying your Users allows you to link your Survey Responses to your customers, visitors or users of your product or app. For example, if you're running an eCommerce Website and are taking feedback after a purchase is completed, identifying a respondent can help you connect and link the survey response and satisfaction to the shopper on your website and the items they purchased.
Identifying Users also allows you to better segment and target the user and sync the responses to other tools and systems you use.
Once you have successfully installed our client, you should probably start by identifying your users. Although the client can be used in anonymous mode, identifying your users will provide you access to many useful features like segmenting your users and building target audiences, among others.
We can identify users with these variables
You can create more such attributes in Survey > Build > Variables.
Passing additional variables
When you're copying the code from the Install JS Client Code section, you can choose from Anonymous Mode or Logged In Mode. The following code block is responsible for identifying your users. When using the Logged In mode code, make sure that you replace the static code values with dynamic user data.
In addition to identifying the users, you can also pass other variables (Contact Variables, Survey Variables or Hidden Variables) in the code like country, subscription plan, user ID and more.
Passing variables in Web Surveys enriches your responses and reports, and these variables are available as filters in the platform.
Manually trigger surveys
Use the following JS code to manually open the widget when a button or link is clicked.
You can place the manual trigger in the on Click event in your webpage in the following way.
You can place the manual trigger in the on Hover event.
You can add this manual trigger in the onload event as well.
You can get the manual trigger code under the JS Client Code Tab in the widget configuration page.
Register Callbacks functions
These events allow you to execute any JavaScript code at specific moments in the lifecycle of a survey. For example, redirect a user to a new page once they complete a survey.
Zonka Feedback offers the following functions:
Page overwriting
There are instances when the page titles are difficult to understand and filter, hence you can rename these pages with a user-friendly names. Here is how you can do it.
Disable client
Next to importing user characteristics, Zonka Feedback also lets you track user event data. You can use event tracking to launch in-app surveys for users that performed – or didn’t perform.
You can turn off the customer tracking by simply manipulating the following variable - disableTracking is enabled/disabled
and publishing it within your Javascript client code.
If you wish to turn it back on, you can simply remove it.
Reset on Logout
Zonka Feedback allows you to delete individual logged-in users' browser data by using the resetUser
method. The method resets all visitor/logged-in user data stored in their localStorage, or sessionStorage. This information includes attributes, session history, survey responses stored in the browser, etc.
We recommend using this when the user logs out of your web app.
Getting Help
To get help with the JS client troubleshooting, please contact ZF Support. Our team will help you diagnose the issue you must be facing while setting up your web surveys.
Last updated