Ask the assistant for worked-out numbers

How to word analytics questions so the assistant reads the right data and quotes figures worked out in code, with a library of questions for each screen.

The assistant

The assistant answers a data question by reading the panel's own data as you, then quoting sentences worked out in code: changes over a range, highs and lows, medians, shares. This recipe shows how to word a question so it reads the right thing, and lists questions that work on each screen.

Before you start

  • You are signed in. The assistant reads only what you can already see; a game's feedback, for example, only for its crew and owners.

  • Open the screen your question is about. The assistant always reads what the open page shows, knows its tab, range and filters, and offers the reads that suit that screen first.

Steps

  1. Open the screen

    Go to the screen the question is about: a game's page, a studio game's hub, the Market, Code.

  2. Open the assistant

    Press the round button at the bottom right, or i.

  3. Name the thing, the figure and the range

    "How did Steal An Egg's players change over the last 30 days?" beats "how is it doing?". Name a game by its name; the assistant finds it. Ranges it reads: 6h, 24h, 7d, 30d or all for a game's players; 24h, 7d or 30d for the market; 30d, 90d or 365d for a studio game's Roblox analytics.

  4. Read the answer and its sources

    Every answer ends with its sources, the panel pages it read. A sentence quoting a number that no read, page or question gave is dropped as it streams.

  5. Follow up

    Pick one of the two or three questions offered under the answer, or ask "and last month?": a follow-up keeps the subject of the answer before it.

Figures worked out in code

Each read comes with facts already computed, and the assistant quotes them rather than doing sums:

Over a range

Where a figure started and ended and the change in per cent; its highest and lowest day; with two weeks or more of days, the last seven days against the seven before.

Against the studio

A studio game's figure against the median of the studio's games: in points for a rate such as day-1 retention, in per cent otherwise.

Shares

Each game's or each slice's share of players or revenue, largest first.

When a game is played

The busiest and quietest hour of the week in UTC, and weekends against weekdays.

Releases

Daily users or players on average before and after each release, and the change.

Sorts

A sort's leaders and their rank moves, how long a game stays in it, and how many games are new to it in the last 7 days.

Projections

Where a game's players are heading over up to 30 days, always labelled an estimate.

It judges a game against the studio and its own history, not against outside benchmarks.

Prompts for Home and your own pages

  • "What does this page say?"

  • "Which studio game is growing fastest?"

  • "How did our last updates change players?"

  • "Which of my watched games moved most in 24 hours?"

Prompts for the Market and the Radar

  • "Which genres grew over the last 7 days?"

  • "What is breaking out right now, and why?"

  • "Which games climbed the sorts most this week?"

  • "What are the most played simulators?"

  • "Where do our games rank in the sorts?"

Prompts for a game's page

  • "Chart this game over the last 30 days."

  • "When is this game played most?"

  • "Which sorts is this game in?"

  • "Where is this game heading over the next 14 days?" (an estimate)

  • "Compare this game with Steal An Egg over 7 days."

Prompts for a studio game's hub

  • "How does this game's day-1 retention compare with the studio?"

  • "Where do this game's players come from?" (platform, country, age or acquisition source)

  • "What did this game's last update change?"

  • "What share of its revenue comes from each platform?"

  • "Which store items changed price?"

  • "What new bug reports came in this week?" (its crew and owners only)

Prompts for the Studio pages

  • "How is revenue split across our games over 90 days?"

  • "Which studio game has the best day-7 retention?"

  • "When do my points expire?"

  • "Which projects are waiting on a signature?"

Prompts for Code

  • "Who is waiting on a review?"

  • "What shipped this week?"

  • "Which pull requests did octocat merge in the last 30 days?"

  • "Which repository has the most open pull requests?"

Prompts about the platform and the handbook

  • "Is the collector collecting?" (its state and freshness, without error text)

  • "How is the breakout score calculated?" and "What does D1 mean?" are answered from this handbook, with each section used listed among the sources as Handbook.

What you get

An answer in a few sentences whose figures come from the reads it lists, with charts or highlights on the page when you ask, and two or three follow-ups to go one step further. Each answer reads at most 3 sources besides the page, and lists at most 10 rows from each. All limits are on The assistant.

Updated