Operator guideENdashboardgame-reportsproviderscalculated

Dashboard / Game Reports

Deep comparison widget for Games and Providers with separate backend paths, multiple grouping options, search, and a mix of backend and frontend summary logic.

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 widget shows

Game Reports is the most detailed Dashboard widget in this wave. It supports two different report modes:

  • Games
  • Providers

Even though both are shown in one widget, they do not use the same backend path.

When to use it

Use this widget when you need to answer questions like:

  • which games generate the most wagered amount or GGR?
  • which providers are most active?
  • how many active players or bets are tied to a game or provider group?
  • what changes when I switch between live/raw and aggregated logic?

How to read it

Games tab

The Games tab reads from the gaming performance report path and supports:

  • group by game, subcategory, or country
  • order by wagered, won, GGR, NGR, players, or bets
  • optional country filter
  • optional subcategory filter
  • search across title, identifier, provider, country, and grouping key
  • Aggregated Mode and custom-date Apply Filters

The summary chips in this tab are mainly backend-owned and include:

  • distinct games
  • active players
  • bet / win count
  • GGR
  • NGR

Providers tab

The Providers tab reads from the game report provider path and shows:

  • total providers
  • total rounds
  • total GGR
  • average house edge

Those four summary chips are calculated in the frontend from the loaded provider rows.

Avg House Edge is a simple arithmetic average of the visible provider HE % values from the loaded provider response. It is not weighted by rounds, GGR, or player count.

The visible widget actions are:

  • Refresh
  • Export CSV
  • Aggregated Mode
  • Streamer data on the Providers tab only
  • custom-date Apply Filters
  • FE-only search in the current tab

Data source behavior

This widget has the clearest live-vs-aggregated logic on the Dashboard.

  • Games tab:
    • aggregated mode can switch the backend to analytics schema
    • if the selected window includes today, the backend can split the range:
      • historical closed days from analytics
      • current UTC day from raw/live tables
  • Providers tab:
    • uses the game report provider service
    • the source badge comes from the provider report response when available

This is the widget where the source badge is the most meaningful for users comparing current-day versus historical performance.

Common questions

Why do Games and Providers not match exactly?

Because they are not built from the same endpoint or grouping path.

What does Aggregated Mode really do here?

In Game Reports, the backend actually consumes the aggregated/live choice. If the period includes today and analytics mode is enabled, the backend can merge historical analytics rows with current-day raw rows.

The FE also force-disables Aggregated Mode when the selected date option becomes today.

Why do I sometimes see an Unknown provider style bucket?

The backend keeps an unmapped-provider fallback when provider mapping is missing.

Why do search results feel broader on the Games tab?

Because the search checks multiple fields: title, identifier, provider name, game type, country code, country name, and group key.

Why do summary chips not shrink when search narrows the table?

Because search is FE-only. The Games summary comes from the backend summary object, and the Providers summary is calculated from the full loaded provider row set before FE search filtering.

Known caveats

  • Games and Providers are different data products inside one widget.
  • Provider summary cards are frontend-derived from row data.
  • Games summary chips use the backend summary object rather than a frontend recomputation.
  • For windows that include today in analytics mode, the backend uses a UTC split-and-merge strategy.
  • Streamer data is only visible on the Providers tab.
Calculation notes

Frontend calculations

calculation

applied_date_range

For non-custom presets, the frontend derives start and end dates from the selected date option before calling the gaming performance report.

calculation

provider_summary_stats

Applies To
providers_tab
Formulas
Total Providers: count(provider_rows) | Total Rounds: sum(roundCount) | Total Ggr: sum(GGR) | Avg House Edge: average(payout)
Caveats
Provider summary cards are derived from the full loaded provider row set before FE search filtering., `Avg House Edge` is a simple arithmetic average of `payout` values and is not weighted by rounds, GGR, or player count.
calculation

current_data_source_label

Applies To
games_tab, providers_tab
Logic
Games Tab: aggregated when useAggregatedData is true, else live | Providers Tab: read providerDataSource from backend response
calculation

search_matching

Applies To
games_tab
Fields
game_name, game_identifier, provider_name, game_type, country_code, country_name, group_key
Caveats
Search narrows the visible rows only and does not recompute the `Games` backend summary chips.
Filter dictionary

Filters

field

Date option

Type
preset-range
field

Start date

Type
date
field

End date

Type
date
field

Aggregated Mode

Type
boolean
field

Streamer data

Type
boolean
Visibility
providers_only
field

Group by

Type
select
Options
game, gameType, country
Visibility
games_only
field

Order by

Type
select
Options
wagered, won, ggr, ngr, players, bets
Visibility
games_only
field

Country

Type
autocomplete
Visibility
games_only
field

Subcategory

Type
multiselect
Visibility
games_only
field

Search

Type
text
Metric dictionary

Metrics

metric

Distinct Games

Distinct game count shown in the Games tab summary.

Verification Status
verified_backend
metric

Active Players

Active-player count for the selected grouping and date window.

Verification Status
verified_backend
metric

GGR

Gaming revenue summary shown for the selected game-report mode.

Verification Status
verified_backend
metric

NGR

Net gaming revenue summary shown for the selected game-report mode.

Verification Status
verified_backend
metric

Total Providers

Provider-tab summary card showing how many provider rows are currently loaded.

Verification Status
verified_fe_only
metric

Total Rounds

Provider-tab summary card showing the sum of `Rounds` across the loaded provider rows.

Verification Status
verified_fe_only
metric

Total GGR

Provider-tab summary card showing total provider GGR derived from the loaded provider rows.

Verification Status
verified_fe_only
metric

Avg House Edge

Provider-tab summary card showing the arithmetic average of provider `HE %` values from the loaded row set.

Verification Status
verified_fe_only
Operational notes

Notes

item

Game report service accepts and uses useAggregatedData.

item

The service can split historical and current-day windows in UTC when analytics mode is enabled.

item

Provider summary cards are FE reductions over `providerReport`, and `Avg House Edge` is a simple arithmetic mean of `payout`.

Related references

Related pages

pageDashboard / Bonus Payouts

Shared comparison widget rendered for tournament, challenge, and no-deposit bonus payout groups.

pageDashboard / GGR Chart

Revenue trend chart with frontend summary cards derived from the loaded time series.

pageDashboard / KPI Reports

Sortable KPI table for games or providers, used to compare betting and GGR-style metrics by entity rather than by time bucket.

pageDashboard / KPI Summary

Comparison table for high-level KPI rows across today, yesterday, month-to-date, and the selected period, with frontend trend chips and data-source badges.

pageDashboard / Live Player Report

Card-based snapshot of today's GGR, total players, conversion rates, active players, and merchant balance.

pageDashboard / Performance Overview

Container widget for Casino, Banking, and Registrations charts with shared date-range and streamer-data controls.