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

# Analytics

> Define every dashboard and get_analytics metric.

export const LastVerified = ({date, source}) => <div className="totem-verified">
    <span>Last verified: {date}</span>
    {source ? <span>Source: {source}</span> : null}
  </div>;

export const StatusBadge = ({state = "available", children}) => {
  const labels = {
    available: "Available",
    "early-access": "Early access",
    planned: "Planned",
    internal: "Internal draft"
  };
  return <span className={`totem-status totem-status--${state}`}>
      {children || labels[state] || state}
    </span>;
};

<StatusBadge state="available" />

<LastVerified date="2026-08-14" source="Totem V1 contract" />

All calendar dates use UTC.

## Metrics

| Metric            | Definition                                                                                                   |
| ----------------- | ------------------------------------------------------------------------------------------------------------ |
| Plays             | Sessions started.                                                                                            |
| Unique players    | Distinct players in the selected window.                                                                     |
| Median session    | Median session length in seconds. Null when there is no duration data.                                       |
| D1 returns        | Count of players who returned the day after their first-ever session on this game.                           |
| D1 return         | Share of that eligible first-session cohort that returned the next day. Null when no eligible cohort exists. |
| Score submissions | Accepted score submissions recorded for the game.                                                            |

## Daily values

Each `daily` item contains `date`, `plays`, `uniques`, `median_session_s`, `d1_returns`, and `score_submissions`.

## Total values

`totals` contains `plays`, `uniques`, `median_session_s`, `d1_return`, and `score_submissions`.

A creator can request 1–90 days. `get_analytics` defaults to 14 days.

## Reading small samples

A null median or D1 rate means there is not enough eligible data. It does not mean zero seconds or a zero return rate.