HomeDocumentationAPI Reference
Getting StartedAPI ReferenceBug ReportingCrash ReportingAPMHelp Center
These docs are for v8.1. Click to read the latest docs for v12.0.0.

Customizing Survey Behavior

This page covers all the aspects of the behavior of surveys that can be customized as well as related APIs.

Reshowing Dismissed Surveys

Surveys can normally be dismissed by users without them having to answer them. The good news is that you can set these previously dismissed surveys to show again using the following method.

//iOS
IBGSurveys.SetThresholdForReshowingSurveyAfterDismiss(3, 5);

//Android
Surveys.SetThresholdForReshowingSurveyAfterDismiss(3, 5);

For an already dismissed survey to show again, two requirements must be met. These two requirements are days and sessions. For example, If the days field is set to 10 and the sessions field is set to 5, the survey will only show again after 10 days have passed AND 5 separate sessions have been initiated. By default, this is set to 4 and 4.

Setting the days and sessions fields to 0 will allow the survey to be shown again immediately.

🚧

There is a limit to showing the same surveys again

Once a survey is dismissed for the second time, it will not be shown again to the user regardless of whether or not the requirements to show have been passed again. Only surveys that have appeared less than twice can be shown. Surveys that have already been answered cannot be re-shown using this method as well. Manually showing surveys, on the other hand, has no limits.

Showing the Welcome Screen

You can show an initial welcome screen for the survey rather than show the first question immediately. To do this, you can enable it using the following method.

//iOS
IBGSurveys.ShouldShowWelcomeScreen = true;

//Android 
Surveys.SetShouldShowWelcomeScreen(true);

Showing Surveys to Older Versions

When you create and publish a new survey, you will be able to measure the number of times your survey has been shown to your users in the app, and also the number of users who saw the survey and submitted it.

Starting from version 4.8.2 & 7.11.2 (Android & iOS respectively) Instabug captures those events (show, submit, dismiss) seamlessly.

In order to help you avoid any confusing numbers on the survey results page, Instabug shows the newly created survey to your users who have the updated version of your app that has SDK version 4.8.2 & 7.11.2 (Android & iOS respectively) and above.

What is worth mentioning also is that doesn't apply on the old surveys; Which means if you have created a survey with an older version than 4.8.2 & 7.11.2 (Android & iOS respectively), it shall be shown normally to your users.

📘

Showing Surveys to Older Versions

The newly created survey will only be shown to your users who have the updated version of your app that has SDK version 4.8.2 & 7.11.2 (Android & iOS respectively) and above.


What’s Next

Everything is customized and the survey is sure to be a hit. Since you're expecting responses, did you know you can follow up on them with the users?