Ratings & Feedbacks

Follow

Ratings and Feedbacks is a plugin which helps collect, store, search and track user feedback from web and mobile applications.

Creating your first feedback popup

For the first step, you should create and configure a feedback popup to start to collect user feedbacks. Click Feedback Popups tab in order to access to popups screen.

There is a green button at the top right corner to create a popup dialog.

How can I find this screen?

You should follow Ratings link under Engagements menu to access this screen.

The creation process consists of three steps: Popup appearance, Trigger button appearance and Devices & Targeting.

Popup appearance

This section contains inputs for feedback popup appearance like Title of popup, Labels of checkboxes, Title of submit button and Thank you message values. If you leave inputs empty, those values are set as default.

Trigger button appearance

This section contains inputs for properties of trigger button. You can customize position of trigger button, background & font color, and trigger button text.

For some use cases which requires manual popup call, there is an option called Hide sticker. If you check this option, even you integrate Feedbacks on your site, popup trigger button won't be seen on the page. Instead, you should call feedback popup manually through show_feedback_popup(widget_id) method. There are sample use cases for this at Integration section, below.

Devices & Targeting

You can easily enable or disable feedback popup for some devices (e.g desktop, tablet or phone) during this step. Also, you can define target pages for which feedback popup can be shown.

By default, feedback popups are disabled. If you want to enable them, just click on Set feedback active checkbox. You may also change feedback popup state after you create it as well.

After this step, our feedback popup is ready to be shown to public.

After creating the popup, a helper page for the web integration will appear. You just need to copy highlighted line and paste into your html file, inside Countly SDK. For details, please check Integration step below.

Edit popup

All feedback popups are listed in a table. If you want to change any configuration about feedback popup, you just need to click Edit popup menu item, as seen below.

When you click on Edit popup in menu, a drawer will appear, as shown below.

As you see above all inputs on every step filled with current values of popup. You can easily change those values and update popup as required.

Removing a popup

When you don't need the a feedback popup anymore, you just need to click on Delete popup under menu at the right corner of the corresponding row.

When you delete the popup, all comments will be removed, so proceed with caution.

Integration

When your popup creation process is done, you need to integrate this popup into your application. Ratings plugin can support mobile and web applications, hence we will talk about how to do both integrations, below.

Web Integration

To integrate Ratings to your web application, you first need Countly to integrate web SDK. If Countly web SDK is already initialized on your web application, you just need to integrate one line below (check the line starting with "ATTENTION").



That's all. You're ready to use Ratings plugin. Please make sure you enable the feedback popup status on dashboard.

Multiple popup

In some cases you may want to use multiple popups in one page. In this case your only need is add popup id values into popups array. For example look code below.

/* ATTENTION! */
Countly.q.push(['enable_feedback',{'popups':['5b86772f7965c435319c79ee','5b86772f7965c435319c79fe','4b86772f7965c435319c79ee']}]);
/* THANKS FOR YOUR ATTENTION! :) */

As you see above you can add multiple popup into one page with array type 'popups' parameter of enable feedback function.

Manually calling a popup

You may need to trigger popup manually because of a reason. If you need to trigger popup manually, you should check Hide sticker option on Trigger appearance step of creation process.

After this configuration, you just need to call popup as follows:

var go = confirm("Do you want to continue?");

if (go) {
  // you can get popup id easily throught Copy Popup Id option in popup menu.
	show_feedback_popup("5b890791dfc7d9562b391df8")
}

Mobile integration

When you use Ratings plugin for mobile applications, you have two options:

  1. Using native dialogs: In this case, native dialogs have the ability to show 1-5 star ratings only.
  2. Using web dialogs: In this case, web dialogs called from native iOS/Android apps can show avatars (faces) that help retrieve end user's feelings (e.g from very satisfied to very disappointed). This is same as how web integration works.

The first case won't retrieve comments but only 1-5 star ratings, whereas second option will be able to show an option to retrieve comments and email of end user.

For iOS integration you can take look at iOS SDK documentation. For Android integration, please check Android SDK documentation.

Was this article helpful?
0 out of 0 found this helpful

Looking for help?