Survey Analytics¶

!!! info "TL;DR" Track response rates, completion rates, and a per-question breakdown. There's no export button yet, but you can pull responses through the REST API.

Accessing Analytics¶

Admin Dashboard → Surveys → [Your Survey] → Analytics

Overview Metrics¶

Response Rate¶

Percentage of users who completed the survey after seeing it.

Response Rate = (Completed Responses / Impressions) × 100

Example: 150 completed / 1000 impressions = 15% response rate

Benchmarks:

• Excellent: >20%
• Good: 10-20%
• Poor: <10%

Completion Rate¶

Percentage of users who finished after starting.

Completion Rate = (Completed / Started) × 100

Example: 150 completed / 200 started = 75% completion rate

Benchmarks:

• Excellent: >80%
• Good: 60-80%
• Poor: <60%

Low completion rates indicate:

• Survey is too long
• Questions are confusing or sensitive
• Technical issues (e.g., mobile rendering problems)

Status¶

The survey's current lifecycle state (draft, published, paused, or archived).

Question-Level Analytics¶

Multiple Choice¶

Response distribution:

Visualization: Horizontal bar chart.

Rating Scale¶

Average rating: 4.2 / 5

Distribution:

5 ⭐⭐⭐⭐⭐ ████████████████████ 60 (40%)
4 ⭐⭐⭐⭐   ██████████████       45 (30%)
3 ⭐⭐⭐     ████████             20 (13%)
2 ⭐⭐       ████                 10 (7%)
1 ⭐         ██                   5 (3%)

Visualization: Histogram.

NPS (Net Promoter Score)¶

Score: +42

Segmentation:

• Promoters (9-10): 70 responses (47%)
• Passives (7-8): 55 responses (37%)
• Detractors (0-6): 25 responses (17%)

NPS = % Promoters - % Detractors
    = 47% - 17%
    = +42

Benchmarks:

• Excellent: >50
• Good: 20-50
• Poor: <20
• Negative: <0

Free Text (Long)¶

Response count: 85

Shows the raw text of up to 10 responses, with a "+ N more responses" note if there are more. There's no word cloud or sentiment breakdown on this page.

Sentiment Analysis¶

Free-text responses are analyzed for sentiment (positive, neutral, negative) automatically as part of PMF scoring, but that analysis isn't shown on this per-survey Analytics page. To see it:

• Sentiment trends across your organization: Admin Dashboard → Analytics
• A word-frequency view of a segment's free-text answers: Admin Dashboard → PMF Dashboard → Segment Analysis

Exporting Data¶

There's no export button in the admin UI yet. If you need responses outside Canviq, fetch them via the REST API:

GET /api/surveys/<survey-id>/responses
Authorization: Bearer pk_live_...

Requires an admin session or an API key with the surveys:read scope. Supports ?limit= and ?offset= for pagination. Returns:

{
  "responses": [
    {
      "id": "...",
      "status": "completed",
      "started_at": "2026-02-10T12:00:00Z",
      "completed_at": "2026-02-10T12:03:00Z",
      "survey_answers": [{ "question_id": "...", "value": "..." }]
    }
  ],
  "meta": { "hasMore": false }
}

See API Reference for details.

Live Updates¶

The analytics page reflects the latest responses on each load; refresh the page to see new submissions.

Best Practices¶

Interpreting Response Rates¶

• Low response rates (<10%) → Survey is poorly targeted, too long, or survey fatigue
• Low completion rates (<60%) → Survey is too long or has confusing questions

Next Steps¶

• Create your first survey
• Distribute your survey
• Fetch responses via the API

Tip: Read the per-question breakdown to see where interest drops off across question types, and check the free-text list for direct product feedback.