{"id":28291,"date":"2026-03-19T10:55:36","date_gmt":"2026-03-19T10:55:36","guid":{"rendered":"https:\/\/refiner.io\/docs\/?post_type=knowledgebase&#038;p=28291"},"modified":"2026-03-19T12:30:45","modified_gmt":"2026-03-19T12:30:45","slug":"quickstart","status":"publish","type":"knowledgebase","link":"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/","title":{"rendered":"In-App Survey Quickstart"},"content":{"rendered":"\n\n\n<p>This guide will help you go from zero to your first live in-app survey in just a few minutes.<\/p>\n\n\n\n<p>By the end of this guide, you will:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Install Refiner in your app<\/li>\n\n\n\n<li>Identify your users<\/li>\n\n\n\n<li>Launch your first survey<\/li>\n\n\n\n<li>Collect and analyze responses<\/li>\n\n\n\n<li>Close the feedback loop<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">What this guide covers<\/h2>\n\n\n\n<p>This Quickstart focuses on <strong>in-app surveys<\/strong>, which are Refiner\u2019s flagship product.<\/p>\n\n\n\n<p>In-app surveys allow you to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Trigger surveys based on user behavior<\/li>\n\n\n\n<li>Target users precisely using traits and events<\/li>\n\n\n\n<li>Collect feedback directly inside your product<\/li>\n<\/ul>\n\n\n\n<p>Refiner also supports <a href=\"https:\/\/refiner.io\/docs\/kb\/pages\/shareable-survey-links\/\">Survey Pages<\/a> (standalone hosted surveys) and <a href=\"https:\/\/refiner.io\/docs\/kb\/email\/send-surveys-by-email\/\">Email Surveys<\/a> (sent via email). For these survey types, steps 1\u20133 (installation, identification, event tracking) are different or not required &#8211; please refer to their respective documentation.<\/p>\n\n\n\n<p>The rest of this guide (creating surveys, collecting responses, and analysis) still applies.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 1: Install Refiner<\/h2>\n\n\n\n<p>Refiner in-app surveys can be launched inside web and mobile applications. Choose your platform and follow the installation guide:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/refiner.io\/docs\/kb\/javascript-client\/client-introduction\/\">JavaScript SDK<\/a> (for web apps)<\/li>\n\n\n\n<li><a href=\"https:\/\/refiner.io\/docs\/kb\/mobile-sdk\/getting-started\/\">Mobile SDKs<\/a> (iOS, Android, React-Native, Flutter)<\/li>\n<\/ul>\n\n\n\n<p>Installing the SDK enables you to send user data (user traits, events) from your app to Refiner and display surveys inside your app.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2: Identify your users<\/h2>\n\n\n\n<p>Identifying your users ensures that every response is linked to a specific individual, making it possible to segment users and control survey delivery with precision. This leads to more relevant feedback while avoiding unnecessary interruptions for users outside your target audience.<\/p>\n\n\n\n<p>To get the most out of Refiner, we recommend sharing user traits that help you target the right users at the right time. These traits provide context about your users, such as their plan, role, or lifecycle stage, and allow you to tailor when and to whom surveys are shown. You are completely free to choose which user traits you want to share with Refiner.<\/p>\n\n\n\n<p>Here is how to identify for web and mobile:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/refiner.io\/docs\/kb\/javascript-client\/client-introduction\/#integrate\">Identify users with JavaScript SDK<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/refiner.io\/docs\/kb\/mobile-sdk\/mobile-sdk-reference\/#identify\">Identify user with Mobile SDK<\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 3: Track events (optional)<\/h2>\n\n\n\n<p>Events allow you to trigger surveys based on user behavior. Events represent actions users take in your product, such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Completing onboarding<\/li>\n\n\n\n<li>Using a feature<\/li>\n\n\n\n<li>Upgrading a plan<\/li>\n<\/ul>\n\n\n\n<p>Here is how to identify for web and mobile:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/refiner.io\/docs\/kb\/javascript-client\/client-introduction\/#track-events\">Track events with JavaScript SDK<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/refiner.io\/docs\/kb\/mobile-sdk\/getting-started\/#track-event\">Track events with Mobile SDK<\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 4: Create your first survey<\/h2>\n\n\n\n<p>Now <a href=\"https:\/\/refiner.io\/docs\/kb\/survey-editor\/create\/\">create your survey<\/a> in the Refiner dashboard, using one of our <a href=\"https:\/\/refiner.io\/docs\/kb\/survey-editor\/survey-templates\/\">survey templates<\/a> or from scratch.<\/p>\n\n\n\n<p>We recommend to start with a ready-to-use <a href=\"https:\/\/refiner.io\/docs\/kb\/survey-editor\/survey-templates\/\">survey templates<\/a> that you can customize (questions and design) later on.<\/p>\n\n\n\n<p>For the Targeting of your survey we also recommend to start simple. For example you can set the T<a href=\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/target-audience-3\/\">arget Audience<\/a> to &#8220;All logged-in users&#8221; and the <a href=\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/launch-trigger\/\">Launch Trigger<\/a> to something like &#8220;After one minute&#8221;. Once you feel more comfortable using Refiner, you can start creating surveys for certain user groups at specific moments in their user journey.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Best practices<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Avoid showing surveys too early<\/li>\n\n\n\n<li>Keep surveys short (start with 1\u20132 questions)<\/li>\n\n\n\n<li>Focus on one clear goal per survey<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 5: Publish and verify<\/h2>\n\n\n\n<p>Once your survey is published, Refiner will automatically display it to eligible users according to your Target Audience and Launch Trigger settings.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How to test<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Log into your app as a test user<\/li>\n\n\n\n<li>Ensure the user is properly identified<\/li>\n\n\n\n<li>Trigger the survey conditions<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Troubleshooting checklist<\/h3>\n\n\n\n<p>If the survey does not appear:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Is the user identified?<\/li>\n\n\n\n<li>Does the user match the targeting rules?<\/li>\n\n\n\n<li>Is the survey published?<\/li>\n\n\n\n<li>Are you in the correct environment (production vs development)?<\/li>\n<\/ul>\n\n\n\n<p>Our JavaScript SDK provides a <a href=\"https:\/\/refiner.io\/docs\/kb\/javascript-client\/test-and-debug\/\">Debug Mode<\/a> which will help you narrow down the issue. Please feel free to contact support for assistance.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 6: Collect responses<\/h2>\n\n\n\n<p>As users interact with your survey:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Responses will appear in real-time in your dashboard<\/li>\n\n\n\n<li>Each response is linked to a specific user<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">What you can do with responses<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>View individual feedback<\/li>\n\n\n\n<li>Filter by score, attributes, or segments<\/li>\n\n\n\n<li>Identify trends<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 7: Filter and tag responses<\/h2>\n\n\n\n<p>Use filters to create <a href=\"https:\/\/refiner.io\/docs\/kb\/responses\/survey-response-lists\/\">response lists<\/a> and analyze your data. <\/p>\n\n\n\n<p><a href=\"https:\/\/refiner.io\/docs\/kb\/responses\/response-tagging\/\">Tags<\/a> help you organize feedback. You can create your own tagging system, for example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>feature request<\/li>\n\n\n\n<li>bug report<\/li>\n\n\n\n<li>pricing feedback<\/li>\n<\/ul>\n\n\n\n<p>Tags can be added manually, or using AI.<\/p>\n\n\n\n<p>Tags can also be used to trigger alerts or integrations.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 8: Create a dashboard<\/h2>\n\n\n\n<p><a href=\"https:\/\/refiner.io\/docs\/kb\/reporting\/reporting-dashboard\/\">Dashboards<\/a> help you track performance over time.<\/p>\n\n\n\n<p>You can:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Monitor NPS or CSAT trends<\/li>\n\n\n\n<li>Break down results by segment<\/li>\n\n\n\n<li>Share insights with your team<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 9: Close the feedback loop<\/h2>\n\n\n\n<p>Refiner becomes most powerful when connected to your tools.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Common integrations<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Slack \u2192 notify your team about new responses<\/li>\n\n\n\n<li>CRM \u2192 enrich customer profiles<\/li>\n\n\n\n<li>Data warehouse \u2192 advanced analysis<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Example workflows<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Send detractors to Slack for follow-up<\/li>\n\n\n\n<li>Sync promoters to your CRM<\/li>\n\n\n\n<li>Trigger actions based on tags<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">What to do next<\/h2>\n\n\n\n<p>Now that you have your first survey running, you can:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Improve targeting using attributes and events<\/li>\n\n\n\n<li>Create additional surveys (onboarding, churn, feature feedback)<\/li>\n\n\n\n<li>Set up integrations and automation<\/li>\n\n\n\n<li>Explore advanced segmentation<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Summary<\/h2>\n\n\n\n<p>You\u2019ve now built a complete feedback loop:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Installed Refiner<\/li>\n\n\n\n<li>Identified users<\/li>\n\n\n\n<li>Launched a survey<\/li>\n\n\n\n<li>Collected responses<\/li>\n\n\n\n<li>Analyzed and acted on feedback<\/li>\n<\/ol>\n\n\n\n<p>\ud83c\udf89 You\u2019re ready to start collecting actionable user insights with Refiner.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This guide will help you go from zero to your first live in-app survey in just a few minutes. By the end of this guide, you will: What this guide covers This Quickstart focuses on in-app surveys, which are Refiner\u2019s flagship product. In-app surveys allow you to: Refiner also supports Survey Pages (standalone hosted surveys) [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","template":"","knowledgebase_tag":[],"class_list":["post-28291","knowledgebase","type-knowledgebase","status-publish","hentry","knowledgebase_cat-in-app-surveys"],"featured_image_urls_v2":{"full":"","thumbnail":"","medium":"","medium_large":"","large":"","1536x1536":"","2048x2048":"","ab-block-post-grid-landscape":"","ab-block-post-grid-square":"","gb-block-post-grid-landscape":"","gb-block-post-grid-square":""},"post_excerpt_stackable_v2":"<p>This guide will help you go from zero to your first live in-app survey in just a few minutes. By the end of this guide, you will: Install Refiner in your app Identify your users Launch your first survey Collect and analyze responses Close the feedback loop What this guide covers This Quickstart focuses on in-app surveys, which are Refiner\u2019s flagship product. In-app surveys allow you to: Trigger surveys based on user behavior Target users precisely using traits and events Collect feedback directly inside your product Refiner also supports Survey Pages (standalone hosted surveys) and Email Surveys (sent via email).&hellip;<\/p>\n","category_list_v2":"","author_info_v2":{"name":"Moritz Dausinger","url":"https:\/\/refiner.io\/docs\/author\/user\/"},"comments_num_v2":"0 comments","acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>In-App Survey Quickstart<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"In-App Survey Quickstart\" \/>\n<meta property=\"og:description\" content=\"This guide will help you go from zero to your first live in-app survey in just a few minutes. By the end of this guide, you will: What this guide covers This Quickstart focuses on in-app surveys, which are Refiner\u2019s flagship product. In-app surveys allow you to: Refiner also supports Survey Pages (standalone hosted surveys) [...]Read More...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/\" \/>\n<meta property=\"og:site_name\" content=\"Refiner Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-19T12:30:45+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/\",\"url\":\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/\",\"name\":\"In-App Survey Quickstart\",\"isPartOf\":{\"@id\":\"https:\/\/refiner.io\/docs\/#website\"},\"datePublished\":\"2026-03-19T10:55:36+00:00\",\"dateModified\":\"2026-03-19T12:30:45+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/refiner.io\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"In-App Survey Quickstart\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/refiner.io\/docs\/#website\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"name\":\"Refiner Documentation\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/refiner.io\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/refiner.io\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/refiner.io\/docs\/#organization\",\"name\":\"Refiner Documentation\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"contentUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"width\":400,\"height\":61,\"caption\":\"Refiner Documentation\"},\"image\":{\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"In-App Survey Quickstart","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/","og_locale":"en_US","og_type":"article","og_title":"In-App Survey Quickstart","og_description":"This guide will help you go from zero to your first live in-app survey in just a few minutes. By the end of this guide, you will: What this guide covers This Quickstart focuses on in-app surveys, which are Refiner\u2019s flagship product. In-app surveys allow you to: Refiner also supports Survey Pages (standalone hosted surveys) [...]Read More...","og_url":"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/","og_site_name":"Refiner Documentation","article_modified_time":"2026-03-19T12:30:45+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/","url":"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/","name":"In-App Survey Quickstart","isPartOf":{"@id":"https:\/\/refiner.io\/docs\/#website"},"datePublished":"2026-03-19T10:55:36+00:00","dateModified":"2026-03-19T12:30:45+00:00","breadcrumb":{"@id":"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/refiner.io\/docs\/kb\/in-app-surveys\/quickstart\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/refiner.io\/docs\/"},{"@type":"ListItem","position":2,"name":"In-App Survey Quickstart"}]},{"@type":"WebSite","@id":"https:\/\/refiner.io\/docs\/#website","url":"https:\/\/refiner.io\/docs\/","name":"Refiner Documentation","description":"","publisher":{"@id":"https:\/\/refiner.io\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/refiner.io\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/refiner.io\/docs\/#organization","name":"Refiner Documentation","url":"https:\/\/refiner.io\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","contentUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","width":400,"height":61,"caption":"Refiner Documentation"},"image":{"@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28291","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/types\/knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/comments?post=28291"}],"version-history":[{"count":4,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28291\/revisions"}],"predecessor-version":[{"id":28340,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/28291\/revisions\/28340"}],"wp:attachment":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/media?parent=28291"}],"wp:term":[{"taxonomy":"knowledgebase_tag","embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase_tag?post=28291"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}