​
Overview

Net Promoter Score (NPS) surveys help measure customer loyalty by asking users how likely they are to recommend your product. Userpilot provides flexible settings to target, trigger, and localize NPS surveys based on user behavior and preferences.

​
Targeting an NPS

​
To control where and to whom the NPS survey appears

  1. Navigate to the Settings tab. Configure the following:
  • Platform
    1. Web app: Select this option to target feedback collection specifically for your web app users.
    2. Mobile app: Select this option to target feedback collection specifically for your mobile app users.
  • Environment
    1. Production: Triggers NPS in the live environment.
    2. Staging: Enables testing before deploying to production.
  • Domain targeting
    1. All Domains (Default): Displays NPS on any site with Userpilot installed.
    2. Specific Domains:
      • Matches: Exact domain match.
      • Doesn’t Match: Exclude certain domains.
      • Matches Regex: Use wildcards (*) for dynamic domains.
  • Page targeting
    1. Any Page (Default): NPS survey appears across all pages.
    2. Specific Pages: Show NPS only on selected pages.
    3. Specific URL Paths: Target NPS based on URL structure.
  • Audience Targeting:
    1. All Users (Default): Any identified user can see the survey.
    2. Only Me: Limits the NPS to your Userpilot account for testing.
    3. Saved Segment: Use pre-configured user segments.
    4. Custom Conditions: Define rules based on user attributes, company data, or product usage.

​
Triggering an NPS Survey

​
Sampling Rate

Control how often users see the NPS survey:
  • 100% Sampling: Every eligible user sees the survey.
  • Lower Percentages: Reduces daily exposure for selective sampling.
Screenshot2025 07 10at10 15 39 Pn

​
Behavioral triggers

Trigger NPS based on user activity:
  • Number of Page Visits before showing the survey.
  • Time Spent on a Page before triggering the survey.
Screenshot2025 07 10at10 16 27 Pn

​
Frequency settings

Adjust how often users encounter the NPS survey:
  • Completed Users: Defaults to 90 days before reappearing (best practice: 60-90 days).
  • “Ask Me Later” Clickers: Defaults to 7 days (best practice: 3-7 days).
Screenshot2025 07 10at10 17 08 Pn

​
Localizing NPS content

Setting Up Localization To accurately localize your NPS content, Userpilot uses a localization parameter:
  • If you are passing user properties, use the locale_code property following the ISO 639-1 standard.
  • If no property is passed, Userpilot defaults to Browser_Language to detect the user’s browser setting.

​
Localization Methods

Switching between Automated and Manual translation will reset any previous translations

​
Automated Translation:

  1. Ensure locales are added in the Localization tab.
  2. Select the desired language and click Auto-Translate.
  3. Edit translations manually if needed.
  4. Toggle Live to activate the translation.
  5. Click Publish or Publish Updates.

​
Manual Translation:

  1. Fully build your content before enabling manual localization.
  2. Export the translation file in CSV or XLIFF format.
  3. Enter translations into the Target column.
  4. Save the file as CSV UTF-8 (Comma delimited).
  5. Import the translated file back into Userpilot.
  6. Toggle Live to activate the translation.
  7. Click Publish or Publish Updates.

​
Previewing and publishing

  1. Click Preview to test how the NPS looks.
  2. Adjust any final settings.
  3. Click Publish to deploy the NPS survey.

​
FAQs

For any questions or concerns please reach out to support@userpilot.com