Opening a report
Reports in the rail opens your brand’s reports on three tabs: Weekly, Quarterly and One-time. The weekly and quarterly tabs show the newest report in a Latest card with Open and, if you can send reports, Share. Earlier reports follow by headline, with the period each covers and how many people it was sent to. Older reports pages back through earlier ones. A report issued for an earlier site names that site. A report opens on its own page with Share and a More actions menu. Download PDF sits in that menu and is ready shortly after the report issues; until then it reads Being prepared. The tables name your delivered work and your competitors, and each opens its panel.What a report holds
- The headline: where your brand stood and what changed during the period. Home’s line also names work that needs your decision.
- Where you stand: your Heralded Score, Mentioned and Recommended in AI answers, your place among your tracked competitors, and the score over the last eight weekly reports. Understood and Praised follow. Your Google search figures sit beside them.
- Your products in AI shopping: for an ecommerce brand, the product-card figures, product changes and any evidence that could not be read, as the report kept them. The page and PDF keep the report’s original meaning: earlier reports count covered topics, while new reports count all answers with organic product cards.
- What moved: changes from the report’s own week, including findings completed just after its answers. Held losses with the same engines and likely cause share one row naming how many questions they affect. Sources are named by site.
- Your focus: the topics, competitors and markets you starred on Strategy, each with where you stood: your Heralded Score on a topic or market with its change, your place on a topic, and a competitor’s score beside yours, each with its own change.
- Work completed: the work delivered during the period, each with its result when the report issued: Delivered, Cited or Paying off. Results explains the labels.
- Pages cited for the first time: your pages that AI answers cited in this report and in no earlier one. The PDF names five and counts the rest.
- Competitors: your tracked competitors by Heralded Score, each with its change.
- Next week: the work that needed your decision when the weekly report issued, with suggested and ongoing customer work beneath. Heralded’s own updates and reports do not count as work in progress or scheduled work here. The newest report also names the next weekly report date and offers Open Work when a decision is waiting. Older reports keep their counts and have no Open Work button. PDFs and shared views have no Open Work button. Quarterly reports call this section Next. A report makes no forecast.
The weekly report
A weekly report covers the time since the previous weekly report. It issues once the report’s answers are read, and the Herald’s conversation posts Your weekly report is ready with its headline. Nothing else about the report is posted in the conversation. Choose Open full Snapshot to open the answers and evidence from that report’s own week. Weekly report takes you back to the report you opened it from. Opening it uses no Snapshot credit and starts no run. The weekly report holds the PDF; its full Snapshot has no separate PDF, share cards or Run again action. A quarterly report has no full Snapshot link. A report too old to open as a Snapshot has no link either.The quarterly report
A quarterly report covers a calendar quarter, in UTC, and issues a day after the quarter ends. It opens with your goal: the revision that was current when the report issued, with Recommended on its questions then, where it stood when the goal was set and your target. A goal changed since keeps its old revision in that report. It then holds the same sections as a weekly report. Its figures pool the weekly reports completed in the quarter, with their change against as many weekly reports before them. What moved and the pages cited for the first time gather those of the quarter’s weekly reports, and Work completed the work delivered during the quarter. It lists the weekly reports it covers. A quarter in which your brand issued no weekly report has no quarterly report.Sharing a report
Everyone who can see your brand’s data can open every report: members of your workspace whose role can see brand data, people with access to your brand, and the agency that manages your account. Members who can start work can send a report to other members of your workspace whose role can see brand data. Choose Share on the report, tick the teammates and choose Send. One send reaches up to 50 people; send again for the rest. A teammate it was already sent to shows the day it last went to them. Each person you choose gets an email with a link to the report. Anyone else cannot be chosen, and the send is refused: a Billing member, someone outside the workspace, someone with access to this brand alone, or a person from the agency that manages your account. Someone who leaves the workspace before the email goes out does not receive it. Viewers can open reports but cannot send them. To share a full Snapshot outside your workspace, open it and choose Share, then set General access to Anyone with the link. Weekly Snapshots start restricted to people who can read your brand’s reports. Members who can start work can change their access. Choose the workspace option to restrict it again, or Turn off link to disable the shared address. You can also download the weekly report’s PDF and send it yourself.When your brand changes
When you change your brand’s site, the reports issued for the earlier site stay listed under your brand, each with the site it measured. When you delete a brand, its reports and their PDFs are deleted with it, those of earlier sites included.Reports in the API
GET /v1/brands/{brand_id}/reports and MCP get_reports list your reports, newest first. Each weekly edition’s scan_id opens its full Snapshot and is null when unavailable. Quarterly editions have no scan_id. GET /v1/brands/{brand_id}/reports/{report_id}/recipients lists who a report was sent to. Figures in the API describes their fields.