Skip to main content

Open in AthenaHQ

app.athenahq.ai/glossary

​
Purpose

The Glossary page serves as AthenaHQ’s built-in educational reference library. It provides customers with clear, authoritative definitions and explanations for key proprietary metrics, formulas, and features found throughout the platform. Because AthenaHQ introduces unique concepts (like Query Volume Estimation and Share of Voice specific to AI models), customers often need a quick way to understand exactly how a metric is calculated or how a background feature works. The Glossary solves this by offering an easy-to-navigate, expandable list of concepts, complete with diagrams and mathematical examples.

​
What’s on the page

Page Header
  • Displays the simple title “Glossary” at the top of the page.
Glossary Accordion List A vertically stacked list of collapsible cards. Each card represents a specific topic or metric:
  • How does AthenaHQ’s volume estimation work?: Explains the proprietary Query Volume Estimation Model (QVEM) and its data sources. Includes a QVEM Flowchart diagram (a static image illustrating the data pipeline).
  • Stream Data: Explains how prompts are streamed against models, the concept of fan-out, scheduling basics, and how credit usage is calculated.
  • Brand Mention Rate: Explains brand visibility. Displays the Relative Mention Rate formula and the Absolute Mention Rate formula (both rendered cleanly as math equations) alongside practical text examples.
  • Share of Voice (SOV): Defines SOV. Displays the Share of Voice formula alongside a step-by-step mathematical example with competitors.
  • Priority Score: Explains how topics are prioritized for action. Displays the Priority Score Raw Score formula and the Priority Score final formula.
  • Model-Based Filtering: A short section explaining how filtering by specific AI platforms changes the context of the metrics.
  • Traffic Source Metrics: A brief explanation of the traffic distribution from different AI platforms.

​
What you can do here

  • Expand / Collapse glossary section: Click anywhere on a card’s header row to toggle it open (revealing the detailed explanation, formulas, and diagrams) or closed.

​
Data shown

This page displays static, globally defined educational content. It does not pull in or display any live analytics, data, or workspace configurations specific to the customer.

​
Common workflows

1. Browse all glossary terms
  1. The customer navigates to the Glossary page from the sidebar.
  2. The first section (“How does AthenaHQ’s volume estimation work?”) automatically expands on load.
  3. The customer scrolls through the list of topics, clicking any card header to expand it and read the definition or formula.
2. Jump to a specific term via URL link
  1. A customer clicks a deep-link (e.g., provided by a support agent or found elsewhere in the app) containing a URL hash like #share-of-voice.
  2. The page loads, automatically scrolls down to the matching section, and expands it so the customer can read it immediately.
3. Read a formula with a worked example
  1. The customer expands a formula-based section, such as “Brand Mention Rate” or “Share of Voice”.
  2. They read the mathematical formula (rendered cleanly in LaTeX math formatting).
  3. They read the worked numeric example provided directly below the formula to understand how the math applies to real response numbers.

​
Empty, loading, and error states

  • Empty / Loading: Because the glossary text and formulas are built statically into the application, there are no loading spinners. The content appears immediately when the page mounts.
  • Error / Missing Subscription: If a user attempts to visit the Glossary but does not have an active subscription plan, the page will render completely blank. It does not show a traditional error message or paywall.
  • Linked from:
    • The main application sidebar.
    • Other areas of the application where glossary sections are embedded directly (e.g., inside metric detail panels or tooltips). These embedded views contain an inline link reading: “Understand additional features in the glossary →”.
  • Links to: The inline “Understand additional features…” link points to /glossary (though this link hides itself if the customer is already viewing the full Glossary page).

​
Common support questions

  • “Where can I find exactly how Share of Voice is calculated?”
    • Direct the customer to the Glossary page, specifically the “Share of Voice (SOV)” section. It contains the exact mathematical formula and a step-by-step calculation example.
  • “Why is the Glossary page completely blank when I try to open it?”
    • The Glossary requires an active subscription plan to view. If a customer’s subscription has lapsed or is inactive, the page will appear entirely blank.
  • “How are credits calculated for scheduled streams?”
    • Direct them to the “Stream Data” section of the glossary. It breaks down the math: Prompts × Fan-out × Model Credits × Days per week × 4.33 weeks.
  • “What does QVEM mean?”
    • It stands for Query Volume Estimation Model. The first section of the Glossary provides a detailed flowchart and explanation of how this pipeline works.