What this widget shows
KPI Summary is the Dashboard's broad comparison matrix. Each row is one KPI and each value column is a different date bucket.
Normal mode shows:
- Metric
- Today
- Yesterday
- This month
- Selected date
When Selected Date Only is enabled, only Metric and Selected date remain. The source then uses its live selected-period branch rather than the normal mixed optimized comparison branch.
Filters
- Date option supports Today, Yesterday, Week to date, Month to date, Last 7/30/90 days, Year to date, Previous month, Previous year, and Custom.
- Start date and End date define the selected period when Custom is used.
- Streamer data changes all applicable source rows to the streamer bucket.
- Selected Date Only requests only the selected-period result and reduces the visible columns.
- Export Grouping selects Daily, Weekly, or Monthly CSV periods. It affects export, not the visible comparison-table columns.
Frontend presets are based on browser-local calendar dates, while report helpers and export periods also use UTC-derived boundaries. The source expands report dates to start-of-day through 23:59:59, but this widget does not expose one verified business timezone. Compare boundary-day values cautiously.
Actions
- Apply Dates applies the current date values.
- Refresh force-revalidates the active KPI Summary request. It does not use an artificial 1.5-second timer or submit a persistent form.
- Download CSV exports a grouped timeline matrix using Daily, Weekly, or Monthly periods. It is not a byte-for-byte export of the four visible comparison columns.
Download uses the current form values, including custom dates that may not yet have been applied to the visible table. Review the date controls before exporting.
Data source badge
- Optimized is used by the normal comparison path, which combines live and aggregate inputs depending on period.
- Live Data is used by Selected Date Only.
- Aggregated Data exists in the type contract but is not emitted by the verified service path.
Row inventory
The current KPI response can produce the following operator rows:
- Visits and Affiliate Visits
- Pending Withdrawals: Globally, Kyc Requested, Kyc Approved, and Kyc Pending
- Withdrawals
- Bet Count, Bet Amount, Win Count, and Win Amount
- GGR, NGR, and Total GGR
- Games Adjustment, Correction, Marketing, Cashback, Stream, Referral Rakeback, Rakeback Calendar, Bonus Payout, and User Challenge
- Deposits, Depositors, Active Users, New Registration, New Depositors, and Deposit Conv Rate
- Bonus Count, Bonus Amount, Bonus Win, Bonus Bet, and Bonus GGR
Historical aggregate coverage is not complete for every special row. Yesterday uses aggregate data, and This month combines aggregate history with a live contribution. The aggregate source currently returns zero for Correction, Stream, Bonus Payout, Cashback, Rakeback Calendar, and Referral Rakeback and does not provide User Challenge. Those cells can therefore be zero or absent even when a live period has activity.
There is no separate Total NGR row in this widget. If someone asks for Total NGR, confirm whether they mean the normal NGR row or a value from KPI Reports or Game Reports.
Important metric definitions
GGR
Eligible converted Bet amount minus eligible converted Win amount. The source excludes correction, bonus payout, rakeback calendar, referral rakeback, and marketing rows; some submeasures also exclude adjustment or free-spin entries.
NGR
GGR + Marketing in the response mapping. Marketing is a separate source bucket. Its sign and composition must not be inferred from the names of other visible rows.
Total GGR
A separate combined GGR measure, described in timeline export as Bonus + Real. It is not the widget's sum of visible GGR cells.
Marketing
An independent source bucket used by the NGR mapping. The export label names other marketing-related rows, but that label is not a verified formula that adds those visible rows together.
Correction
A dedicated source correction value. The export label includes Bonus Payout Auto Correction, but the traced calculation does not prove that label as the field's complete business formula.
Referral Rakeback
A dedicated amount. It is not calculated by subtracting Marketing or other displayed rows.
User Challenge
A challenge-related value returned for the live view. It is not the CMS label General - User Challenges, and the historical aggregate view does not currently provide the field. Do not infer individual challenge configuration or participant state from this row.
Deposit Conv Rate
New Depositors divided by New Registration, multiplied by 100 and rounded to two decimals. Zero registrations produce zero.
Pending Withdrawals rows
All four rows are amounts, not withdrawal counts.
- Pending Withdrawals (Globally) is the umbrella pending-withdrawal amount.
- Pending Withdrawals (Kyc Requested) is the pending amount for the requested KYC bucket.
- Pending Withdrawals (Kyc Approved) is the pending amount for the approved KYC bucket.
- Pending Withdrawals (Kyc Pending) is the pending amount for the pending KYC bucket.
The KYC rows are subsets of pending withdrawals. Do not add them on top of Globally as if they were unrelated totals, and do not interpret Kyc Pending as a frontend formula. The source returns that subset directly.
Currency basis
Live transaction branches divide included amounts by stored conversion rates. A missing or zero rate produces no converted contribution to those live sums rather than being replaced with rate 1.
Historical aggregate branches read stored base-summary columns instead of recalculating every historical transaction with that expression. The writer, reporting currency, and exchange-rate basis of those base columns are not established by this widget trace.
The traced path does not establish the production reporting currency, original-currency display, exchange-rate provider, rate timestamp, or opening/closing/average rate basis. Amount rows are formatted to two decimals after mapping; counts are not treated as monetary decimals.
Deposit rows include successful Deposits. Withdrawal totals include Pending, Success, and Approved statuses (0, 1, and 5), while pending/KYC rows use Pending. A broader refund, reversal, and chargeback policy is not established by the visible widget alone.
Trend chips
- Today compares with Yesterday.
- This month compares with Selected date, not Previous month to date.
- A chip is hidden when the baseline is missing or zero, or when absolute change is below
1%. - Trend chips are widget calculations and are not separate source KPI fields.
Common questions
Why do I see only one value column?
Selected Date Only is enabled.
Why does CSV not match the visible column layout?
CSV uses the selected Daily, Weekly, or Monthly timeline grouping and the current form values. The screen remains a Today / Yesterday / This month / Selected date comparison and can still show previously applied dates.
Why is there no description tooltip on a row?
The UI can display a row description, but current KPI responses do not populate descriptions for these rows. Do not assume every row has one.
Why can optimized and live results differ?
Normal mode can combine aggregate and live inputs, while Selected Date Only runs a live selected-period path. Several special categories are unavailable in the historical aggregate source. Compare identical completed periods and source modes before treating a difference as a calculation defect.