Apptentive Surveys enable you to collect structured feedback, in-app, from your customers. Surveys can be targeted to specific groups of customers, and using the latest versions of our SDK, can be shown as part of the Ratings Prompt flow instead of the Feedback Form. Surveys are rendered natively on a device to ensure a robust, performant experience for your customers whether they’re offline or online.

NOTE: These instructions were written for version 1.5.0 or above of the Apptentive iOS and Android SDKs, which were released on May 27, 2014. If you’re not using version 1.5.0 or above, we highly recommend you upgrade so that you’ll be able to take advantage of all of the latest functionality. Please contact us for more details or for assistance upgrading.

Instrumenting for Surveys

Displaying Surveys in your app only requires that you’ve completed a standard Apptentive integration, and have added the appropriate calls to Apptentive.engage for the Events where you at some point might like to show a Survey.

For more details on integrating Apptentive, please see the iOS Integration Documentation and the Android Integration Documentation.

Creating a Survey

Surveys are created from within the Interactions section of the Apptentive dashboard. When creating a new Survey, you’ll first be asked to provide a title and description, which will be shown to your customers.

Adding Questions

After you set your title and description, you can then add your questions to the Survey. There are four questions types you can ask:

  • FreeForm questions provide the customer with an area for an open-ended response. You can elect for this area to be either a single line or multiple lines to encourage longer answers.
  • Single Select questions provide the customer with multiple choices, only one of which can be selected. You can elect to randomize the choice order to reduce presentation biases.
  • Multiple Select questions provide the customer with multiple choices and allows them to select between a minimum and maximum number based on your settings.
  • Net Promoter Score (NPS) questions provide the customer with a scale from zero to ten and ask how likely they would be to recommend a product to their colleague or friend.

As you’re adding questions, you can decide whether each is required or optional. If a question is required, the customer will not be able to submit the Survey without answering that question.


When the customer completes your Survey, you can optionally display a “Thank You Message” of your choosing. If you do not display this message, the Survey screen will be dismissed without further UI when the Survey is completed.

Apptentive provides robust targeting and lifecycle management options for Surveys to ensure that your Surveys are shown to the right people at the right time.

Under the Target Audience section of the Publishing page, you can use the data automatically collected by Apptentive, such as Device model, OS Version, etc., as well as Custom Data you’ve provided to target the Survey to a specific group of customers. More information about using Custom Data is available in the iOS Integration Documentation and the Android Integration Documentation.

Starting with the 1.5.0 versions of the Apptentive SDKs, Surveys are displayed at a specific event that’s been instrumented via the Apptentive.engage method. Older versions of the Apptentive SDK use a targeting mechanism based on tags.

If you do not want your Survey displayed for customers using the Apptentive SDK before version 1.5.0, you may select the “Do not display this Survey to older clients” option on the Survey publishing page. Otherwise, the Survey will be available for display on pre-1.5.0 SDK versions, and will use the tags– when present– for targeting.

As part of publishing, you can also optionally set a start time and an end time for your Survey, and/or end the Survey once a certain number of responses has been received. You can further limit the frequency that an individual person will see the Survey, and/or whether to allow the same person to submit multiple responses to the Survey.

Our Grow and Enterprise plans permit unlimited concurrent Surveys. For more information, please see our plans, or contact us for more details.

Once you publish the Survey, it will begin being distributed to your customers. Surveys are cached on customer devices for several hours, so customers that have recently fetched Surveys may not see the updated Survey until the cache period expires. During testing, you can uninstall and reinstall the app to force the cache to flush.

❗️NEW: Survey Skip Logic

Survey Skip Logic is now available for both the iOS SDK (version 6.1 and later) and Web SDK (Android coming soon) via an Early Access Program. You can sign up for the program by setting up a quick call with our product team here

This new feature allows survey creators to skip over certain questions in their mobile or web surveys. This feature is designed to help creators gather more relevant data by only asking questions that are applicable to the respondent. With Skip Logic, creators can create a more personalized and efficient survey experience for their respondents.

Key Features:

  1. Skip Questions: With Skip Logic, survey creators can choose to skip over certain questions based on the respondent’s answer to a previous question. For example, if a respondent answers “no” to a question, the survey can automatically skip over the next question that only pertains to those who answered “yes.”
  2. Customizable Logic: Skip Logic allows creators to customize the logic for skipping questions based on the specific needs of their survey. Creators can choose to skip questions based on multiple criteria, such as answer choices or response types.
  3. Mobile and Web Compatibility: Skip Logic is available for both iOS (version 6.1 and above) and Web SDKs. Support for Android will be available later this year.
  4. Easy to Use: Skip Logic is simple to use and can be added to a survey with just a few clicks. Creators can easily set up the logic for skipping questions within the dashboard, without the need for complex programming or technical knowledge.
  5. Improved Survey Experience: Skip Logic helps to improve the overall survey experience for respondents by reducing the number of irrelevant or unnecessary questions they are asked. This can result in higher response rates and more accurate data collection — you know, reducing that whole “survey fatigue” thing we talk so much about.

Modifying Surveys

To help ensure the statistical integrity of your results, you cannot modify a Survey once published. Instead, if you wish to make changes, the existing Survey will be cloned, and the new Survey will replace the existing one.

Using a Survey with the Ratings Prompt

Starting with version 1.5.0 of the Apptentive SDKs, you can use a Survey to collect structured feedback from your customers following the initial “Do you love…” Ratings prompt. This replaces the Feedback Form that is shown by default.

To use a Survey with the Ratings Prompt, you should first create the Survey as described above. Note that when using a Survey with the Ratings Prompt, any lifecycle or targeting options you specify will not be applied.

Once the Survey has been published, you can include it in the Ratings Prompt. These settings are also available under the Interactions section of the Apptentive dashboard. To use the Survey, under the “The Prompt” section, change the target of the “No” button on the initial prompt to “taken to a Survey…”. You can then select the Survey you just created.

If you have customers using a version of the Apptentive SDK prior to 1.5.0, they will continue to see the Feedback Form instead of the Survey.

Updated on April 13, 2023

Was this article helpful?

Related Articles