> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Competitor Metrics

> Detailed competitor-level metrics for benchmarking analysis in Looker Studio.

Detailed competitor-level metrics for benchmarking analysis.

<Tabs>
  <Tab title="Dimensions">
    | Field          | Type | Description                         |
    | -------------- | ---- | ----------------------------------- |
    | `date`         | Date | Analysis date (YYYY-MM-DD)          |
    | `provider`     | Text | Always `All Providers`              |
    | `model`        | Text | Always `All Models`                 |
    | `competitorId` | Text | Stable competitor domain identifier |
    | `competitor`   | Text | Competitor brand name               |
    | `relationship` | Text | SELF or DIRECT                      |
  </Tab>

  <Tab title="Metrics">
    | Field                     | Type    | Aggregation | Description                                                                           |
    | ------------------------- | ------- | ----------- | ------------------------------------------------------------------------------------- |
    | `totalMentions`           | Number  | SUM         | Total mentions count                                                                  |
    | `answersWithMentions`     | Number  | SUM         | Responses with mentions                                                               |
    | `visibilityScore`         | Percent | AVG         | % of responses with this competitor                                                   |
    | `positionSum`             | Number  | SUM         | Sum of mention positions (component field)                                            |
    | `positionCount`           | Number  | SUM         | Count of positioned mentions (component field)                                        |
    | `sentimentSum`            | Number  | SUM         | Sum of mention sentiment scores (component field)                                     |
    | `sentimentCount`          | Number  | SUM         | Count of scored mentions (component field)                                            |
    | `avgPosition`             | Number  | Calculated  | `SUM(positionSum) / SUM(positionCount)`                                               |
    | `avgSentiment`            | Percent | AVG         | Average sentiment per competitor row                                                  |
    | `shareOfVoice`            | Percent | AVG         | % of total mentions                                                                   |
    | `totalTrackedCompetitors` | Number  | MAX         | Total competitors tracked on this brand (registered SELF + DIRECT, excluding ignored) |
  </Tab>
</Tabs>

<Note>
  `totalTrackedCompetitors` is a brand-level constant (registered count, ignores
  filters). Distinct `competitor` values only cover those mentioned in the
  selected period. Pair as
  `COUNT_DISTINCT(competitor) / MAX(totalTrackedCompetitors)` for a coverage
  ratio.
</Note>

<Note>
  Competitor rows are grouped by `competitorId`, not by display name. This
  prevents duplicate rows when names vary and aligns the connector with the
  Qwairy interface.
</Note>

<Note>
  This source is aggregated across all providers and models. Provider and model
  dimensions remain present for report compatibility, but their values are
  `All Providers` and `All Models`.
</Note>

## Best For

* Competitive analysis
* Market share tracking
* Sentiment comparison vs competitors
* Position benchmarking
* Coverage ratio: mentioned competitors vs total tracked