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

Attributes	Variable Name
Contact Mobile	contact_mobile
Contact Email	contact_email
Contact Unique Id	contact_uniqueid
Contact Name	contact_name

You can create more such attributes in Survey > Build > Variables.

// Some code

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.

_zf('variables', {  
contact_email: "[e-mail]",  // Replace with User Email 
contact_name: "Robert Hopkins",  // Replace with User Name
subscription_plan: "Professional", 
subscribed_date: "August 1, 2022",
country: "United States", 
gender: "Male" 
})

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.

<a onclick = "_zf('startForm','SURVEY CODE');">
Click Me</a>

You can place the manual trigger in the on Hover event.

<a onhover="-zf('startForm','SURVEY CODE';">
Button</a>

You can add this manual trigger in the onload event as well.

<a onload="_zf('startForm','SURVEY CODE');">
PageURL</a>

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:

Function
onClose()	Gets called when the user dismissed a survey by clicking on the “x” in the top right corner.
onOpen()	Gets called when a survey widget becomes visible to your user.
onSubmit()	Gets called when the user completed (submitted) the entire survey.

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.

_zf("pageTracking",
    {
    "title":"This is custom page title", 
    "path":"/product/detail"
    }
   ); 

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.

_zf(“disableTracking”,true);

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.

_zf(‘resetUser’);

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.