Skip to main content
in-app research

​
Set up in-app research

To set up your in-app research widget, go to In-app research settings Copy the widget script and add it to your page. Pass your current user’s info in the user object in the init call. If you do not have a current user, you should pass a stable anonymous ID.

​
Show research opportunities

When you want to show a research opportunity to a user, call the appropriate method:
  • ReforgeResearch("any.show") - Show any available research opportunity
  • ReforgeResearch("surveys.show", {token: "SHARE_TOKEN"}) - Show a specific survey
  • ReforgeResearch("interviews.show", {token: "SHARE_TOKEN"}) - Show a specific interview
You can get the share token for a survey or interview from its individual settings tab.

​
Notes

Bring your own targeting: The widget doesn’t include built-in targeting logic yet. You control when to show research opportunities based on your user segmentation and business rules. An advanced targeting rule builder is planned. Availability rules: Available research opportunities are determined by the widget at first available research opportunity that is:
  • Active (launched/live)
  • Not already answered by the user
  • Not dismissed by the user within the last 30 days
For testing purposes, you can pass { force: true } when showing any research opportunity to bypass availability rules. Example: ReforgeResearch("interviews.show", { token: "SHARE_TOKEN", force: true }) Lazy loading: The widget uses a minimal initial bundle and lazy-loads survey or interview components on demand, keeping your page load times fast.