Skip to content
Console
Browse documentation
Guide

The result viewer

Open an analytics result, a saved definition, an audience or a comparison from your agent's link, in one of four read-only modes.

On this page

When your agent measures something, it keeps the answer as a stored result. The result viewer is the proof page for that answer. It is at /view/result. Your agent gives you the link, and you check the numbers yourself.

The viewer only reads. It shows what was measured. It does not run a new measurement, it has no chart builder and no save button, and it sends no write request.

Ask your agent

Measure how many people who started checkout last week completed it, and give me a link I can open.

Job MCP tool CLI command
Run a measurement and keep the result query_product_analytics anectico analytics query
Read a stored result again get_analytics_result anectico analytics result get
Compare two results of the same question compare_analytics_results anectico analytics remeasurement compare
Read a saved audience get_analytics_audience anectico analytics audiences get
Read a saved insight get_saved_insight anectico analytics insights get

The tool result lists the link in links, as an entry titled "Analytics result" with the address in href. A comparison is titled "Comparison of two results". A result that is still running, or that failed, also has a link, and the viewer shows its status. See Measure product events for what each measurement means.

The four modes

The link's query string decides the mode. Every mode names its project in project_id. A link that mixes the parameters of two modes is refused. It is not guessed.

Mode Query string It shows
Result project_id, result One stored result. The kind comes from the stored result, never from the address.
Definition project_id, insight, revision A saved insight's definition at one exact revision. It measures nothing.
Audience project_id, audience, generation One exact audience at one generation: its size, dates and the original measurement.
Comparison project_id, result, compare Two results side by side. result is the earlier one and compare is the later one.

A revision or a generation in a link is always a positive whole number. A link never says "latest", because a link must show the same thing every time.

Result

The viewer shows one stored result, and above it the question that was asked and when it was measured. A stored result does not change. It is kept until the date the page shows.

There are ten kinds of result. The viewer reads the kind from the stored result, so a link cannot make one kind look like another.

Kind What it measures
Trend An event or measure over time
Funnel How many people complete each step in order
Retention How many people come back
Engagement How active people are
Paths What people do before or after an event
Correlation What goes with converting
Web analytics Visitors, sessions, referrers and channels
Revenue Gross, refunds and net revenue
Survey Answers to an in-product survey
Heatmap Where visitors click on one page, drawn over a masked backdrop of the page

Web analytics, revenue, survey and heatmap results show customer content. To read them you need the event-content permission agents:content:read as well as the analytics permissions. Without it, the page says which permission is missing and shows nothing from the result.

Definition

The viewer shows a saved insight as it was at one revision: its events, measure, restrictions and date window. A definition is not a result. Opening it measures nothing. To get numbers, ask your agent to run that revision. See Manage saved insights.

Scheduled reports link to a definition, so a reader can see what the report measures. See Send a scheduled report.

Audience

The viewer shows one exact generation of a saved audience. Its membership is fixed. When your agent replaces an audience, the old generation keeps its people until it expires. The page shows the generation, when it was saved, when it expires and the measurement it came from. After the generation expires, the people are no longer shown.

Comparison

The viewer shows two results of the same kind, one on each side. The earlier result is on the left or on top. The page also tells you whether the two ask the same question apart from their dates and audiences, and whether their windows, coverage reports and identity observations match.

Matching reports do not prove complete capture or identical people, and the page says so. The comparison does not show that one thing caused another. The page refuses a pair when the two results are of different kinds, when they are the same observation, or when the link names them in the wrong order. It shows neither side in that case.

When a result cannot be shown

What you see Why What to do
Analytics access required Your role lacks analytics and person read permissions Ask an owner or administrator for them
Event content permission required The result shows customer content and you lack agents:content:read Ask an owner or administrator for it
Measurement expired The result is past its retention. The contributor and event details are hidden. Ask your agent to measure it again
Measurement withdrawn The result was withdrawn and can no longer be read Ask your agent to measure it again
Measurement unavailable Your current permissions or the source data could not be checked, so nothing is shown Use Recheck measurement or try again later
Generation expired An audience generation is past its retention Ask your agent for a current audience
Link incomplete or damaged The link does not name exactly one result, definition, audience or pair Ask your agent for a new link

See Proof pages for the project, sign-in and sharing rules that apply to every proof page.