Skip to main content

Scrunch Metrics Guide

This guide explains how each metric in your Scrunch brand is calculated, helping you understand what the numbers mean and how they're derived from your AI monitoring data.

Dashboard Metrics

These metrics summarize the scope of your monitoring and appear on the Home page. Full metric definitions are also available wherever you build views in Explorer.

Looking for the exact Explorer name or API field for a metric? The Scrunch Metrics Reference lists every metric, breakdown and filter with the API field it maps to.

Prompts

What it measures

The total number of active prompts being monitored. In Explorer, this corresponds to the Unique Prompts metric.

How it’s calculated

Counts active custom prompt variants (not Seed Prompts) that have at least one response matching your selected filters (persona, tags, topics, date range, etc.). Prompts with no matching responses in the selected period aren't counted.


Responses

What it measures

The total number of AI responses collected during the selected time period. In Explorer, this corresponds to the Total Responses metric.

How it’s calculated

Counts distinct observations that:

  • Are linked to an active custom prompt variant

  • Fall within the selected date range

  • Come from a supported AI platform

  • Match applied filters (persona, tags, platform, etc.)


Platforms

What it shows

Which AI platforms produced responses during the selected period.

How it’s determined

Identifies all unique AI assistants present in observations matching your filters. Note: Grok no longer contributes citation data, though it still contributes to presence, ranking, and sentiment metrics.


Time Series Metrics

These metrics are shown over time and automatically aggregated based on the selected date range. Rate and average charts in Explorer also show the underlying sample size in the tooltip, for example "43% (37 of 86 responses)".

Brand Presence

What it measures

In Explorer, this metric is labeled Mentions Rate (API field: brand_presence_percentage). It's the percentage of AI responses whose text mentions your brand by name. Citations of your brand's domain don't count here, see Citations Rate below for that.

How it’s calculated

  1. For each time period:

    • Total observations = all responses

    • Present observations = responses where your brand is detected

  2. Formula:

    (Present / Total) × 100

Time aggregation

  • 0 to 14 days: Daily

  • 15 to 90 days: Weekly

  • 90+ days: Monthly


Competitive Presence

What it measures

How often your brand and competitors appear in AI responses over time. See Understanding Competitive Presence in Scrunch for a deeper look.

How it’s calculated

Brand presence uses the Mentions Rate metric (API field: brand_presence_percentage); competitor presence uses the same detection scoped to each competitor (API field: competitor_presence_percentage).

  • Brand presence: observations where your brand is detected

  • Competitor presence: observations where each competitor is detected

  • Denominator for both is total observations for your prompts

Each brand or competitor is shown as its own time series of raw counts.

Time aggregation

Same as Brand Presence.


Position

What it measures

Where your brand appears in AI responses. In Explorer, this is the Position Average metric (API field: brand_position_score).

Positions

  • Top: mentioned in the top 25% of the response

  • Middle: mentioned in the middle 50% of the response

  • Bottom: mentioned in the bottom 25% of the response

  • Missing: position not detected

How it’s calculated

Percentages are calculated using only observations where your brand is present:

  • Top % = Top / Total excluding missing

  • Middle % = Middle / Total excluding missing

  • Bottom % = Bottom / Total excluding missing

Position metrics only include responses where your brand is present.


Sentiment

What it measures

How AI describes your brand. In Explorer, this is the Sentiment Average metric (API field: brand_sentiment_score). See Understanding Sentiment in Scrunch for more detail.

Sentiment types

  • Positive

  • Mixed

  • Negative

  • Missing

How it’s calculated

Percentages are calculated using only observations where sentiment is available:

  • Positive % = Positive / Total excluding missing

  • Mixed % = Mixed / Total excluding missing

  • Negative % = Negative / Total excluding missing

Sentiment metrics only include responses where your brand is present.


Citations

What it measures

How often your brand is cited as a source, compared to competitors and other sources. In Explorer, this is the Citations Rate metric (API field: brand_citation_rate). This metric measures source attribution, showing how often your website contributes to a response. See Understanding Citation Metrics in Scrunch for the full breakdown of citation metrics.

Citation types

  • Brand: your registered domains from the Context tab

  • Competitor: competitor domains

  • Other: sources not owned by your brand or competitors

How it’s calculated

  1. Each citation URL is classified by owner

  2. Counts are aggregated by time period

  3. Brand citation % =

    (Brand citation observations / Total observations) × 100

Time aggregation

Daily, weekly, monthly, quarterly, or yearly, depending on the selected date range.


Time Ranges and Aggregation

Default range

Last 90 days.

Automatic aggregation

  • 0 to 14 days: Daily

  • 15 to 90 days: Weekly

  • 91+ days: Monthly

This keeps charts readable while preserving trend accuracy.


Filter Behavior

All metrics respect applied filters, including:

  • Persona

  • Tags

  • Topics

  • Platform

  • Category

  • Branded vs non-branded

  • Favorites

  • Date range

  • Brand presence

  • Competitor presence

In Explorer, you can combine up to 5 metrics, 3 breakdowns, and 8 filters in a single view.


Notes and Caveats

  • Metrics are calculated in real time when the dashboard loads or filters change

  • "Missing" values appear when position or sentiment cannot be determined

  • Only AI platforms marked as visible for your brand are included

  • Grok no longer contributes citation data; brand presence, position, and sentiment metrics from Grok are unaffected


Troubleshooting Metrics Discrepancies

Sometimes, you may notice discrepancies in the Citations Rate metric (API field: brand_citation_rate), such as a 0% citation rate at the dashboard level, even when prompt-level citations show percentages. This issue often arises due to the configuration of the primary website in the AI Context tab.

Common Issue: Path-Specific URLs

  • If the primary website is set to a path-specific URL (e.g., example.com/en), only that exact path will be counted as a brand citation.

  • This can lead to incomplete or inaccurate citation metrics.

Solution: Update the Primary Domain

To ensure all valid paths are recognized and citation metrics align across the dashboard and prompt level:

  1. Navigate to the AI Context tab in Scrunch.

  2. Set the primary domain to the full base domain (e.g., example.com).

  3. Save your changes. Once updated, the citation metrics should reflect accurately across all levels.


Citation Metrics (Explorer)

These metrics explain how sources are cited by AI assistants and how citation influence is calculated across URLs and domains. The legacy Citations dashboard has been retired; these metrics and breakdowns now live in Explorer.


Citation Breakdowns

In the legacy Citations dashboard, the citations table could be grouped by Domain or URL. In Explorer, the equivalent views are the Citation Domain and Citation URL breakdowns. Each row represents a single source and includes the following metrics.


Prompts (legacy metric)

What it measured

The number of unique prompts that had cited this source at least once during the selected time period, as shown in the legacy Citations dashboard.

Available today

This distinct-prompt count isn't a standalone pickable metric in Explorer's citation catalog, which offers Citations Rate, Citations Share of Voice, Citations Total, Citations Unique Responses, and Citations Unique Domains.


Citations Unique Responses

What it measures

The total number of AI responses that cited this source during the selected time period.

How it’s calculated

Count of distinct observations that include a citation to the source. API field: citation_unique_responses (or brand_citation_unique_responses / competitor_citation_unique_responses when scoped to an owner).

Formula:

COUNT(DISTINCT observation_id)


Citations Share of Voice

What it measures

In the legacy Citations dashboard, this was called Citation Consistency: the percentage of responses that cited a source, out of all responses that cited any source. In Explorer, the equivalent metric is Citations Share of Voice (API field: brand_citation_share_of_voice for your brand, competitor_citation_share_of_voice for competitors).

How it’s calculated

(Responses citing a source owned by this owner ÷ Responses citing any source) × 100


Influence Score

What it measures

A composite score that reflects both how often a source is cited and how broadly it appears across prompts. This is the Influence Score metric in Explorer (API field: weighted_index, entity-agnostic).

How it’s calculated

(Citations of the source ÷ Total citations in the group) × Distinct prompts citing it

This favors sources that are cited frequently and across many different prompts. Influence Score is only meaningful alongside a domain or source URL breakdown.


Owner Type Classification

Each source is classified into one of three ownership categories, using the owner field.


Owner Types

Brand

Sources owned by your brand, matched against configured brand websites.

Competitor

Sources owned by configured competitors.

Other

Sources not owned by your brand or competitors.


Domain Ownership Logic

Ownership is determined using a hierarchical matching process:

  1. URL-level match for brand websites

  2. URL-level match for competitor websites

  3. Domain match for primary brand website

  4. Domain match for alternative brand websites

  5. Domain match for competitor websites

  6. Default to Other if no match is found


Conservative Domain Classification

When grouping by domain, all URLs within a domain must match the same owner type.

Logic:

If all URLs in a domain have the same owner type, the domain is assigned that owner.

If URLs map to multiple owners, the domain is classified as Other.

This prevents over-attribution on shared platforms like social networks or publishing sites.


Domain-Level Visualizations

Top Domains Cited

What it shows

In the legacy Citations dashboard, this widget showed the top five cited domains by total response count, with all remaining domains grouped into an "Other" category. This view now lives in Explorer's Citation Domain breakdown, which supports more than five domains at once.

How it’s calculated

Domains are ranked by total citation volume using the Citations Total metric (API field: citation_count), or by the distinct (response, domain) count (API field: citation_unique_response_domains) when reconciling with the legacy dashboard's grain.

Formula:

COUNT(DISTINCT observation_id, domain) grouped by domain, or SUM(citation_count) grouped by domain.


Citations by Owner

What it shows

The percentage breakdown of citations by owner type (brand, competitor, other).

How it’s calculated

For each owner type:

(Responses citing a source owned by this owner ÷ Responses citing any source) × 100

Percentages are rounded so the final values sum to 100%.


Owner Time Series

What it shows

How brand, competitor, and other citation percentages change over time.

How it’s calculated

For each time period:

(Responses citing this owner's source ÷ Responses citing any source, for that period) × 100


Additional Metadata

Brand and Competitor Mentions

Indicates whether the cited source's page content explicitly mentions your brand or competitors. In Explorer, this is the Citation Mention Rate metric (API field: brand_citation_mention_rate / competitor_citation_mention_rate).


Domain Topics

Displays the topic tag associated with the cited source's domain (API field: source_topic). Domains without a tag are shown as "Untagged".


Content Delivery Status

Shows whether AXP is currently serving optimized content for the cited page (API field: content_delivery_status). Values are checked in this order:

  • na_third_party: the cited page isn't the brand's own site

  • control_group: manually excluded as a deliberate baseline. Technically not optimized, but tracked separately, and wins over "optimized" if both apply

  • optimized: AXP-deployed content is being served for this page

  • not_optimized: the brand's own page, but neither of the above applies

See Understanding the Content Delivery (AXP) tab for more on how AXP optimizes cited pages.


Mixed Ownership Indicators

For domains containing brand, competitor, and other-owned URLs, multiple owner labels are shown with explanatory tooltips.


Notes

  • All citation metrics respect applied filters (date range, persona, topic, tags, platform, etc.)

  • Citations support both Citation Domain and Citation URL breakdowns with drill-down

  • Time aggregation adjusts automatically based on the selected date range: daily, weekly, monthly, quarterly, or yearly

  • Summary metadata (top domains and owner breakdowns) is calculated independently to remain consistent across pagination

  • Grok no longer contributes citation data to any of the metrics above

Did this answer your question?