Documentation Index
Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
Use this file to discover all available pages before exploring further.
Mavera Surfaces Used
| Surface | Role |
|---|---|
Personas (POST /personas, GET /personas) | Create 3 persona segments: customers, prospects, and churned users |
Focus Groups (POST /focus-groups) | Run NPS + Open-Ended questions per segment for quantitative and qualitative data |
Chat + response_format | Compare segment results and synthesize a 360-degree brand perception report |
A real brand perception audit interviews existing customers, potential customers, and people who left. This playbook simulates all three segments with Mavera personas, producing quantitative NPS scores and qualitative perception data — side-by-side — in a single session.
What Value Does Mavera Add?
| Value | How |
|---|---|
| Insurance | Catch brand perception gaps before they become retention problems. Compare how customers, prospects, and churned users see you. |
| Opening new doors | Run perception audits quarterly instead of annually. Track perception trends over time with consistent methodology. |
| Saving time | A traditional 3-segment perception study takes 4-6 weeks and $20K+. This runs in under an hour. |
When to Use This
- You suspect a gap between how you see your brand and how the market sees it.
- You’re losing deals or customers and want to understand whether brand perception is a factor.
- You’re preparing for a rebrand and need a baseline measurement.
- You want to compare perception across segments (customers love you but prospects don’t know you).
- You’re presenting brand health metrics to leadership and need structured data.
What You Need
| Requirement | Details |
|---|---|
| Mavera API key | Starts with mvra_live_. Get one at Developer Settings. |
| Workspace ID | From your dashboard URL (ws_...). |
| Brand context | Your brand name, category, value proposition, and key competitors. |
| Segment definitions | Characteristics of your customers, prospects, and churned users. |
| Credits | ~300–700 total. See Credits Estimate. |
| Python 3.8+ or Node.js 18+ | requests / openai for Python; native fetch for Node. |
The Audit Framework
Three focus groups run in parallel — one per segment. Each uses the same questions for comparability.Question Battery
Every segment answers the same 6 questions:| # | Question | Type | What It Measures |
|---|---|---|---|
| 1 | ”How likely are you to recommend {brand} to a colleague?” | NPS | Overall brand advocacy |
| 2 | ”What 3 words come to mind when you think of {brand}?” | Open-Ended | Brand associations |
| 3 | ”Rate {brand} on: Untrustworthy ←→ Trustworthy” | Semantic Differential | Trust perception |
| 4 | ”Rate {brand} on: Outdated ←→ Innovative” | Semantic Differential | Innovation perception |
| 5 | ”How well does {brand} deliver on its promise of {value prop}?” | Likert (1-10) | Promise-delivery gap |
| 6 | ”What is the biggest risk of choosing {brand} over alternatives?” | Open-Ended | Perceived weaknesses |
The Flow
Define brand context
Set your brand name, category, value proposition, and key competitors. This context is included in every focus group.
Create 3 persona segments
Build 2-3 personas per segment: satisfied customers, evaluating prospects, and recently churned users. Each persona has unique motivations and context.
Run 3 Focus Groups in parallel
Launch one focus group per segment. All use the same 6-question battery for cross-segment comparability.
Poll for completion
Monitor all three groups. They run independently and may complete at different times.
Cross-segment comparison
Compare NPS, semantic differentials, and open-ended themes across all three segments.
Code: Full Brand Perception Audit
Setup and Configuration
Stage 1 — Create Segment Personas
Stage 2 — Run 3 Focus Groups
Each segment gets its own focus group with the same 6-question battery.Stage 3 — Cross-Segment Comparison
Stage 4 — Generate 360-Degree Report
Running the Full Audit
Example Output
Variations
Track perception over time
Track perception over time
Run the same audit quarterly. Store results and diff:
Add competitor perception
Add competitor perception
Run the same battery for a competitor’s brand using your personas:
Segment by industry vertical
Segment by industry vertical
Instead of customer/prospect/churned, segment by industry:
Include employee perception
Include employee perception
Add an internal segment to see if employees and customers are aligned:
Credits Estimate
| Stage | Typical Cost | Notes |
|---|---|---|
| Create 7 personas | 0 | Persona creation is free |
| Focus Group — Customers (N=25, 6 Qs) | 100–200 credits | |
| Focus Group — Prospects (N=25, 6 Qs) | 100–200 credits | |
| Focus Group — Churned (N=25, 6 Qs) | 100–200 credits | |
| Perception report (1 chat call) | 5–15 credits | Single structured output |
| Total | ~305–615 credits |
See Also
Focus Groups
NPS, Semantic Differential, and all question types
Positioning Workshop
Validate positioning after measuring current perception
Pricing Research
Test pricing alongside perception
News-Triggered Research
Monitor how external events shift brand perception
Generational Content Testing
Test perception across age cohorts
Annual Planning Kickoff
Feed perception data into annual planning