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

# Understanding your performance

> What reports include, cadence, and stakeholder-ready outputs

## What reports include

Pierview reports summarize your AI visibility performance over a selected period. Typical sections:

* **Visibility**: How often your brand appeared across prompts and models
* **Sentiment**: Breakdown of positive, neutral, negative mentions
* **Citations**: Which sources were cited, including your domain
* **Competitor comparison**: Your share vs. competitors (when tracked)
* **Source breakdown**: Top cited domains and source gaps
* **Prompt-level detail**: Performance by individual prompt

## How periods are compared

Change figures (the +/- badges next to citations and competitor visibility) compare your
selected period against the equal-length period immediately before it.

Two things to keep in mind when reading them:

* **Your first report shows no change figures.** If none of your currently tracked prompts
  ran during the previous period, there is no baseline to compare against, so the report
  lists the period's own numbers instead of presenting them as growth.
* **Recommended actions use their own window, not the report period.** They are detected
  from a rolling 30 to 90 days of citation and prompt data depending on the signal, so they
  stay stable between reports. The report states the window it used.

> [!NOTE]
>
> Editing or deleting a prompt removes its history from future reports. Metrics are always
> scoped to the prompts you currently track, so a reworked prompt set starts a fresh
> baseline.

## Reporting cadence

* **Weekly**: For active campaigns, quick iteration, content teams
* **Monthly**: For stakeholder reviews, trend tracking, exec summaries
* **Ad hoc**: After major content or PR pushes to measure impact

> [!NOTE]
>
> Run scans consistently (e.g., every Monday) so trend data is comparable.

## Stakeholder-ready outputs

Reports can be tailored for different audiences:

| Output | Audience | Content |
| - | - | - |
| **Exec summary** | Leadership | Visibility trend, key wins, top gaps, 3–5 action items |
| **Content backlog** | Content team | Source gaps → content ideas, citeable page opportunities |
| **PR targets** | PR team | Publications AI cites, angles for pitches |
| **Competitive brief** | Product/Marketing | Share of Answer, competitor source strategies |

## Sample report outline (text)

1. **Period**: e.g., Jan 1–31, 2025
2. **Summary**: Visibility up/down X%, citation rate at Y%
3. **Highlights**: Top 3 wins (e.g., new citations from G2, improved sentiment on key prompt)
4. **Gaps**: Source gaps to address, prompts with low visibility
5. **Recommendations**: 3–5 prioritized actions
6. **Appendix**: Prompt list, source table, raw metrics (optional)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.