Qia for Shopify

The Art of the Question: A Quick Start

Qia is a high-precision logic engine. While it can handle simple queries, you unlock its true power when you provide Context, Constraints, and Comparison. Think of yourself as a CEO giving a brief to a senior analyst: the clearer the brief, the sharper the strategy.

The Three Pillars of a Power Prompt

1. Context (The 'Who' and 'What'): Don't just ask for "sales." Ask for "sales from repeat customers" or "sales attributed to Instagram."

2. Constraints (The 'When'): Qia is a historian. Always define your window—"last 30 days," "Q4 2025," or "since the Spring Sale started."

3. Comparison (The 'So What?'): Data is silent in isolation. Ask Qia to compare results against the "previous month" or "same period last year" to reveal the trend.

The Evolution of a Prompt

• Good: "Show me my AOV."

Result: A single number.

• Better: "Calculate AOV broken down by utm_medium so I can see which channel brings the big spenders."

Result: A segmented table revealing channel quality.

• Best: "Calculate AOV by utm_medium for last month, compare it with the month prior, and explain which channel is losing steam."

Result: A full strategic audit with a direct diagnosis of your marketing health.

Pro-Tip: Use Your Persona

Remember, Qia knows your Persona Handbook. You don’t need to explain what a "VIP" is every time. If you’ve defined it in your Persona Editor, you can simply ask: "How many VIPs bought or Type A items this week?"

The "One-Breath" Rule

If you can say your question in one breath, it's usually a great prompt. If it takes three breaths, try breaking it into a Follow-up Question. Qia remembers the conversation, so you can always say: "Now filter that just for orders over $100."

The Architecture of Insight

Qia doesn't just display data; it listens to your store. The interaction follows a two-stage "Logic & Narrative" cycle designed to move you from raw numbers to strategic action.

Stage 1: The Tactical Report

When you ask a question, Qia’s engine performs a surgical strike on your database. It translates your English request into code, retrieving the specific rows and columns that hold your answer. The result is a Report—a clean, tabular view of your store’s reality. At this stage, the data is "silent," waiting for interpretation.

Stage 2: The Strategic Narrative

Once the report is generated, you invoke the "Whisperer" by asking Qia to Explain the Numbers. This is where the heavy lifting happens. Qia ingests the report data and provides a narrative diagnosis—identifying trends, spotting anomalies, and suggesting your next move. This two-step process ensures that the math is always validated before the strategy is formed.

Understanding Our Narrative Limits

You will notice that different plans have different Row Limits for narratives (ranging from 1,000 to 10,000 rows). While Qia can process vast amounts of data to create a report, we intentionally cap the amount of data passed to the "Narrative Engine" for one fundamental reason: Cognitive Precision.

The "Signal-to-Noise" Law

AI models, like human consultants, can suffer from "data fatigue." When a model is fed too many data points at once, its ability to find the "signal" within the "noise" diminishes. By focusing the Narrative Engine on the most relevant rows—whether it’s the top 1,000 for a Basic store or the top 10,000 for a Super Qia enterprise—we ensure the analysis remains sharp, accurate, and free from the "hallucinations" or vagueness that occur when models are overwhelmed by raw numbers.

We don’t just give you a wall of data; we give you a high-resolution interpretation of what matters most.

The Persona Editor: Defining Your Shop’s DNA

What is the Persona?

If the Logic Engine is the "brain," the Persona is the "memory." It is a centralized configuration file that houses your shop’s unique vocabulary, business rules, and strategic priorities. Instead of explaining your business model every time you ask a question, the Persona ensures Qia already knows your "VIP" customer thresholds, your fiscal year start, and your specific definition of "Gross Margin."

The Initial Handshake

To get you started, Qia performs an Initial Compilation. Upon installation, the engine scans your public storefront and metadata to build a "Draft Persona." It identifies your brand voice, your primary currency, and your public-facing product categories.

Your Strategic Handbook

While the initial draft is a strong starting point, the true power of the Persona lies in your edits. You are invited to refine this handbook to include internal jargon that no outsider would know:

• Custom Segments: Define exactly what "High Churn" means for your specific niche.

• Key Milestones: Save your specific sale dates (e.g., "The 2025 Spring Refresh") so you can simply ask, "How did the Refresh compare to last year?"

• Logic Guardrails: Set your preferred calculation methods for metrics like Net Revenue or Marketing Contribution.

Why Persona Matters

• Eliminate Ambiguity: Prevents the AI from guessing. When you say "Profit," Qia uses your formula, not a generic one.

• Conversational Velocity: You can use shorthand. "Show me my Heroes" works because you’ve already defined what a "Hero" product is in the Persona.

• Universal Consistency: Every report and every narrative explanation will align with the rules set in the Handbook, ensuring a single version of the truth for your entire team.

Frequently Asked Questions