Classic in-product widget
The classic path is the in-product survey widget for NPS, CSAT, CES, and PMF. Same integrity model as agent-native: server show-tokens, server suppression, issue-time caps.
- Create a survey in the UserVane dashboard (type, question, presentation, trigger, targeting, sample %).
- Allowlist your app origins under project settings.
- Install
@uservane/browseror@uservane/reactwith the publishable key.
See Widget quickstart.
Triggers
Section titled “Triggers”| Mode | Behavior |
|---|---|
auto | After page idle, fixed delay (default 8s server-side config), once per eligible show |
manual | Only when you call UserVane.survey("slug") or React survey("slug") |
Targeting predicates and audience sample % are evaluated client-side from the bootstrap payload. Absolute caps and quiet periods are server-side at token issue.
Identity
Section titled “Identity”Call identify with a stable userId from your auth session when available. That id is the respondent identity for tokens and suppression. Traits support targeting and later segmentation; do not put secrets in traits (they ride on public bootstrap).
Presentations
Section titled “Presentations”corner, inline, and banner as configured on the survey. Free plan may show a small “Powered by UserVane” badge (showBadge).
Respect rules (product)
Section titled “Respect rules (product)”- Never re-prompt after answer or dismiss for the life of that survey (server suppression).
- Cross-survey quiet period so multiple surveys do not chain-interrupt the same person.
- Fail closed if bootstrap fails: no half-drawn widget.