Events
glitchless_eventsThe game's own metrics, from the custom events it sends with track() and the streams it counts with count() (marked counted: summed on the device per window, so their numbers have sums and averages but no spread): each event's count in the window, the sessions and players that sent it, how its attribute values break down (for example plays by mode, paywall views by placement, purchases started vs done; a list attribute such as a deck by element, each event counted once under each), the sums of its numeric attributes per currency (revenue: the amount of purchase events) and their p50, p90 and p99, and hours, the hours played in the window, to turn any count into a rate per hour. Give funnel to count the sessions that went from one event to the next, in that order. With name and rate (a flag such as "won", or a word outcome "result=win") or avg (a numeric attribute), it measures that event: overall, or with by per value (win rate by hero, with a 95% interval for each, next to the overall rate). With name and of (a numeric attribute), it gives that attribute's distribution: percentiles and a histogram, optionally by a split. properties lists what the game set for its sessions with setProperties (rank, class, region, a preset), each with its values and their sessions and players; identifier_like marks one with more than 200 values a day, which is an ID rather than a property. Every read tool filters by them (props) and splits by them (by "$rank").
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | With rate, avg or of: split by an attribute (a list splits by element), $version, $level, $zone, $platform, $browser, $device_tier, $link (the kind of connection), or a session property ("$rank") | |
| of | No | A numeric attribute whose distribution to give, e.g. "duration_s" (match length) or "placement" | |
| avg | No | A numeric attribute's mean per event, e.g. "duration_s" | |
| env | No | Only include sessions from this environment, e.g. "prod" (what the game passes to init; builds a developer runs usually send "dev") | |
| min | No | With rate or avg and by: the fewest events a row needs (default 30 for a rate, 10 for an average); smaller rows are counted in small | |
| game | No | The game, by name or id, when signed in to a workspace (glitchless_list_games lists them); later calls keep it. Ignored with a key for one game. | |
| name | No | Only this event, e.g. "paywall". With rate, avg or of, the event to measure; it can carry a filter like a panel's event: "match_end:mode=ranked", or "battle_end:deck=hog_rider+ice_spirit" for decks with both | |
| rate | No | The share of the event's events where a flag holds ("won": true or false, or 1 or 0) or a word outcome holds ("result=win") | |
| hours | No | Look-back window in hours (default 24), as far back as the workspace keeps data on Glitchless Cloud (the answer says when it starts later than asked). Past 744 (31 days) answers are by day. | |
| props | No | Only sessions with these session properties (what the game set with setProperties): { rank: "diamond" }, or a list of values for any of them, { rank: ["diamond", "master"] }; "(none)" keeps the sessions without one. glitchless_events lists the properties and their values. Read from the sessions, so over 31 days or less | |
| funnel | No | Steps in order, comma-separated: "open,paywall,buy". A step can require a value: "buy=done" (any attribute) or "buy:step=done"; a list matches when it has the value | |
| service | No | Game service name (defaults to the most recently active game) | |
| version | No | Only include sessions from this game version | |
| session_type | No | "user": players only; "tester": people on TestFlight and other test builds only; "synthetic": bots, playtests and store test devices only; "all" or unset: every session. Findings (glitchless_triage, and the overview's) read the production sessions of players unless env or session_type is given | |
| steam_branch | No | Only include sessions that ran this Steam branch ("public", or a beta's name); games that use Steamworks send it |