Operator guideENdashboardlivecardsconversion

Dashboard / Live Player Report

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

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

Live Player Report is the fastest commercial snapshot on the Dashboard. It is designed for quick checks, not for deep breakdowns.

The cards are:

  • Today's GGR
  • Total Players
  • Registration Conv.
  • Deposit Conv.
  • Active Players
  • Merchant Balance

How to read it

Most card values come directly from backend services. The frontend mostly handles formatting and trend display.

  • The main values come from get-live-player-report or get-merchant-balance.
  • Every card also renders a small trend badge.
  • Five trend badges come from get-merchant-trend.
  • Merchant Balance currently shows a FE fallback badge of 0 because the traced merchant-trend response does not emit merchantBalTrend.
  • Merchant Balance uses the merchant-balance hook with default startDate=today and endDate=today.
  • There is no visible filter or toggle on this widget. Operators are always looking at the default snapshot returned by the two backend feeds.

Important formulas

Two conversion rates are backend-calculated:

  • Registration Conv. = filtered registered players / affiliate visits * 100
  • Deposit Conv. = deposit count from users registered today / total users registered today * 100

Both are rounded to two decimals and return 0 if the denominator is zero.

The trend cards do not all compare the same windows:

  • Today's GGR trend compares today vs yesterday.
  • Registration Conv. trend compares today's conversion rate vs yesterday's conversion rate.
  • Deposit Conv. trend compares today's conversion rate vs yesterday's conversion rate.
  • Active Players trend compares today's logged-in count vs yesterday's logged-in count.
  • Total Players trend compares today's player count vs the player count from the same UTC day seven days earlier.

Common questions

Why can the main value and trend feel like different data?

Because the card value and the trend are loaded from different backend endpoints.

Why does Total Players not behave like a streamer-only or filtered commercial metric?

Because the live report backend always computes totalPlayers, registrationConvRate, and depositConvRate with isStreamerData=false. The widget does not expose a visible toggle for those cards.

Why is Merchant Balance trend often flat or zero?

The current merchant trend backend response keeps merchantBalTrend disabled. The frontend therefore falls back to 0.

Known caveats

  • Conversion formulas are backend-owned.
  • Merchant balance trend is currently not populated by the merchant trend response.
  • deviceLoggedIn is returned by the backend but is not rendered as a visible card in this widget.
Metric dictionary

Metrics

metric

Today's GGR

Main GGR card for the current-day snapshot in the Live Player Report widget.

Aliases
today ggr, live player today ggr
Verification Sources
GET /api/admin/get-live-player-report
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Total Players

Player count card returned by the live player report endpoint for the current snapshot.

Aliases
live player total players, total players live report
Verification Sources
GET /api/admin/get-live-player-report
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Registration Conv.

Backend-calculated registration conversion percentage shown in the widget card.

Aliases
registration conversion, registration conv
Verification Sources
GET /api/admin/get-live-player-report
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Deposit Conv.

Backend-calculated deposit conversion percentage shown in the widget card.

Aliases
deposit conversion, deposit conv
Verification Sources
GET /api/admin/get-live-player-report
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Active Players

Active or logged-in player count returned by the live player report endpoint for the current snapshot.

Aliases
logged in players, active players live report
Verification Sources
GET /api/admin/get-live-player-report
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Merchant Balance

Merchant balance card returned by the dedicated merchant-balance endpoint, separate from the trend feed.

Aliases
merchant balance, live report merchant balance
Verification Sources
GET /api/admin/get-merchant-balance, GET /api/admin/get-merchant-trend
Comparison Notes
Merchant balance trend often appears flat because the merchant trend response keeps `merchantBalTrend` disabled.
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Today's GGR Trend

Small trend badge beside `Today's GGR`, sourced from the merchant-trend service.

Aliases
ggr trend live report, today ggr trend
Verification Sources
GET /api/admin/get-merchant-trend
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Total Players Trend

Small trend badge beside `Total Players`, sourced from the merchant-trend service rather than from the main live-player payload.

Aliases
total players trend, players trend live report
Verification Sources
GET /api/admin/get-merchant-trend
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Registration Conv. Trend

Small trend badge beside `Registration Conv.`, sourced from the merchant-trend service.

Aliases
registration conversion trend, registration conv trend
Verification Sources
GET /api/admin/get-merchant-trend
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Deposit Conv. Trend

Small trend badge beside `Deposit Conv.`, sourced from the merchant-trend service.

Aliases
deposit conversion trend, deposit conv trend
Verification Sources
GET /api/admin/get-merchant-trend
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Active Players Trend

Small trend badge beside `Active Players`, sourced from the merchant-trend service.

Aliases
active players trend, logged in trend
Verification Sources
GET /api/admin/get-merchant-trend
Verification Status
verified_backend
Last Verified At
2026-04-22
metric

Merchant Balance Trend

Visible trend badge beside `Merchant Balance`.

Aliases
merchant balance trend, merchant trend live report
Verification Sources
GET /api/admin/get-merchant-trend
Verification Status
verified_fe_only
Last Verified At
2026-04-22
Operational notes

Notes

item

The widget has no visible refresh or filter controls; values come from the default hook requests only.

item

`useMerchantTrendData` returns a zero-filled fallback object while loading and when `merchantBalTrend` is absent, which is why the Merchant Balance badge stays at `0`.

Related references

Related pages

pageDashboard / Bonus Payouts

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

pageDashboard / 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.

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 / Performance Overview

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