Operator guideENplayersreportgamingggr

Players / Game Report

Per-player game or provider report inside the player workspace, filtered by date option and grouped either by game or by provider.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this page shows

Player Game Report breaks one player's gaming activity down either by game or by provider for the selected date range.

When to use it

Use this tab when you need to answer:

  • which games or providers drive the player's betting activity
  • how many rounds the player completed
  • how real-money and bonus-money play compare
  • which rows produce the highest GGR

How to read it

The report is controlled by two choices:

  • Date Option
  • Game or Provider tab

The table then shows one row per game or provider with backend id, display name, rounds, real-money totals, bonus-money totals, GGR, and HE %.

Known caveats

  • HE % is rendered from the backend field named payout, but the traced backend helper calculates it as (1 - totalWin / totalBet) * 100.
  • GGR is not fully identical across groupings:
    • game mode includes correction and bonus-payout rows in the aggregated SQL result
    • provider mode excludes correction and bonus_payout rows from the main GGR aggregation
  • The component supports only visible table rendering; CSV support exists in the FE hook but is not exposed as a visible button in this tab today.

Verification status

  • status: verified_backend
  • last verified: 2026-04-18
  • note: FE request contract and gs-admin-backend report controller/service path are traced.
Calculation notes

Calculations

calculation

GGR

Formula Text
In game mode the SQL returns `GGR` alongside separate `correction` and `bonus_payout` columns; in provider mode `GGR` is calculated only from non-`correction` and non-`bonus_payout` real-money bets and wins.
Operator Note
Treat `GGR` as authoritative for the selected grouping, but do not assume game-mode and provider-mode rows are mathematically identical.
Verification Status
verified_backend
calculation

HE %

Formula Text
Backend helper formula `HE % = (1 - totalWin / totalBet) * 100`, returned as the `payout` field and rendered by the FE.
Operator Note
The FE does not calculate this metric; it formats the backend helper output.
Verification Status
verified_backend
Grid columns

Columns

field

ID

Backend row identifier. In provider mode this is the provider id; in game mode it is the resolved game id when available.

Visual Type
identity
field

Name

Game identifier or provider name, depending on the active tab.

Visual Type
grid-column
field

Number of Rounds

Number of rounds included for that row in the selected period.

Visual Type
number
field

Real bets

Real-money bet amount for the row.

Visual Type
amount
field

Real wins

Real-money win amount for the row.

Visual Type
amount
field

Bonus bets

Bonus-money bet amount for the row.

Visual Type
amount
field

Bonus wins

Bonus-money win amount for the row.

Visual Type
amount
field

GGR

Gross gaming revenue value for the row returned by the backend report. Game and provider groupings do not use an identical SQL definition.

Visual Type
amount
field

HE %

House-edge percentage derived by backend helpers from total wins relative to total bets for the row.

Visual Type
ratio
Filter dictionary

Filters

field

Date Option

Chooses the reporting period. `Custom` unlocks manual start and end dates.

Type
preset-range
field

Start date

Lower bound for custom date mode.

Type
date
field

End date

Upper bound for custom date mode.

Type
date
field

Game / Provider

Switches the grouping level between game rows and provider rows.

Type
tab
Metric dictionary

Metrics

metric

Number of Rounds

Count of rounds included for the selected player and grouping row.

Verification Status
verified_backend
metric

Real bets

Real-money wager total for the row.

Verification Status
verified_backend
metric

Real wins

Real-money win total for the row.

Verification Status
verified_backend
metric

GGR

Backend-owned row-level gaming revenue for the selected grouping.

Verification Status
verified_backend
Operational notes

Notes

item

The FE can request the report grouped by `game` or `provider`.

item

The backend service loads SQL files depending on grouping and analytics-schema mode.

Related references

Related pages

pagePlayers / Banking

Banking tab inside the player workspace with transaction filters, a paginated banking grid, analytics cards, CSV export, and automatic-withdrawal availability.

pagePlayers / Detail Workspace

Main player workbench at `/player/[playerId]` with tabbed sections, player-level actions, and modal-based operator workflows.

pagePlayers / Fraud Detection

Fraud-detection tab inside the player workspace with fraud risk assessment, related fraud reports, IP analysis, and identity-graph filtering.

pagePlayers / Inbox

Inbox tab inside the player workspace for reviewing sent notifications, filtering by read state or notification type, and resending or deleting messages.

pagePlayers / KPI Summary

Grouped player-level KPI snapshot inside the player workspace, covering player info, deposits, withdrawals, casino totals, bonus cost, and predictive metrics.

pagePlayers / KYC Status

KYC tab inside the player workspace for browsing user documents, checking third-party verification state, and approving, rejecting, or re-requesting documents.