Operator guideEN

Players / Activity Log

Standalone player activity history page with filters, export, map view, row details, and comment-group context.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this page shows

Players / Activity Log is the standalone history view for player-related activity rows. It is useful when operators need to investigate activity across many players instead of opening one player profile at a time.

The page combines:

  • activity filters and extra player-segmentation filters
  • a paginated, sortable activity table
  • three summary cards for the currently loaded rows
  • CSV export for the filtered activity result set
  • a map dialog for IP-location inspection
  • row-level detail blocks for descriptions, JSON payloads, and user-agent data
  • special website-search row details for search query, result count, and games received
  • comment-group management when the component is opened in COMMENT mode

When to use it

Use this page when you need to:

  • inspect comments or operational history across players
  • filter activity by date range, activity type, device, PID, or country
  • narrow the result set with include/exclude tags or comment groups
  • compare desktop vs mobile activity in the current result set
  • inspect activity rows on a map or open row-level JSON/detail blocks
  • export filtered activity rows

How to read it

This page is history-first. Operators usually set filters first, then read the resulting table, export the result, or open row-level detail for one activity.

The header count shows total records matching the current query. The summary cards below the header are different: they are calculated from the rows currently loaded into the table component.

The summary cards are:

  • Total Activities
  • Desktop
  • Mobile

Key visible columns include:

  • ID
  • Activity
  • Method
  • User
  • Comment Group
  • CRM User
  • CRM Role
  • Device
  • IP Address
  • Time

Filters

The main filter panel includes:

  • Description
  • Activity
  • Device
  • Start
  • End

Extra filters can be revealed when needed:

  • Country
  • PID
  • User ID
  • Include Tags
  • Exclude Tags

Important behavior:

  • Apply Filters reloads the activity table and resets it to page 1.
  • Reset returns the form to its default values and reloads the table.
  • filter summary chips can clear one active filter at a time.
  • PID looks up matching players first, then returns activity rows for those players.
  • Include Tags keeps players with all selected tags.
  • Exclude Tags removes players with any selected excluded tag.
  • date filtering is reliable when both Start and End are set.

Export

Export downloads the filtered activity rows as CSV. The export uses the same filter and sort state as the table, but export is not limited to the currently visible page.

The downloaded filename can appear as transactions.csv. The CSV field order follows the exported activity record shape, not the exact visible table column order.

Map View

Map View helps inspect IP locations for the currently loaded activity rows. It groups rows by IP and shows markers when locations can be resolved.

Map behavior depends on configuration:

  • if the Mapbox API key is missing, the dialog shows Map Not Available
  • if MaxMind is disabled or credentials are missing, uncached IPs may not resolve
  • cached IP locations can still be used when available
  • country-level location can use a country capital coordinate when exact latitude/longitude is missing

The map is a location aid for the loaded table rows. It is not a full geolocation report for every row matching the filter.

Comment mode

When the activity filter is set to COMMENT, the table changes shape:

  • the main text column becomes Comment Data
  • the table exposes Comment Group, CRM User, and CRM Role
  • expanded row detail swaps Description and Additional Data ordering to prioritise comment payloads

In COMMENT mode, Manage Groups opens the comment-group manager. Deleting a group only deactivates it when it is not already used by comment activity rows. Existing comments are not deleted by this action.

Known caveats

  • Summary cards describe the currently loaded rows, while the header count describes the full filtered result count.
  • The verified activity read/export path is authenticated, but no separate Activity Log-specific permission gate was found.
  • The standalone page does not force COMMENT mode by itself; comment-specific columns and group management appear when the component is scoped to COMMENT activity mode.
  • WEBSITE_SEARCH rows use a special detail view when their payload can be parsed; otherwise the generic JSON detail view is used.
  • Map View depends on system settings and IP-location lookup availability.
  • The player profile also has activity/comment tabs; this standalone page is broader and designed for cross-player filtering.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations12 topicsOpen details

Default date range

If the table looks narrower than expected, check the date range before assuming older activity is missing.

Inputs
component mode, current date
Transform
Standalone activity view defaults to a recent activity window; COMMENT-scoped embedded mode uses a much wider date window.

Active filter badge count

The badge indicates how many filter groups are currently narrowing the activity table.

Inputs
Description, Activity, Device, Group, Country, PID, User ID, Include Tags, Exclude Tags, Date range
Transform
Counts non-default filter groups and displays the count on the filter controls and filter summary chips.

Activity stats scope

Summary cards explain the visible page slice, while Total records found reflects the full filtered result count.

Inputs
loaded activity rows, normalized device type
Transform
The three summary cards are calculated from the rows currently loaded into the table component.

Device type normalization

Device counts and badges can still work when activity rows store device information in either supported field.

Inputs
deviceType, userDeviceType
Transform
Device values are trimmed, lower-cased, and classified as desktop, mobile, or empty device bucket.

Date range filtering

A partial date range may not narrow the activity list as expected.

Inputs
Start, End
Transform
Backend activity filtering applies the timestamp range only when both start and end dates are present.

PID resolution

PID filtering finds activity rows through the player records that resolve to the requested affiliate PID.

Inputs
PID filter, player KPI summary, player additional data
Transform
Backend first resolves player ids from KPI summary affiliate PID and then falls back to player additional-data PID.
Caveats
If no player ids resolve for the PID, the table returns zero activity rows.

Include/exclude tag behavior

Include tags narrow to matching tagged players, while Exclude tags remove unwanted player tag groups.

Inputs
Include Tags, Exclude Tags, player tags
Transform
Include Tags require the player's tags JSON to contain all selected tags; Exclude Tags remove players with any selected excluded tag.

Comment group filtering

Group filtering applies to COMMENT-mode activity rows that carry comment group metadata.

Inputs
Group filter, COMMENT activity JSON
Transform
Group filtering matches the selected id against comment activity JSON groupId.

Website search row rendering

Search activity rows are easier to read than raw JSON when the payload has the expected search shape.

Inputs
WEBSITE_SEARCH activity code, activity data JSON
Transform
Website search rows parse activity JSON into search query, result count, and received game list; invalid or unrecognized JSON falls back to the generic JSON detail viewer.

Activity CSV export scope

Export is intended to download the full filtered activity result set, not just the visible page.

Inputs
current filters, current sort, CSV download flag
Transform
CSV export sends the current filter and sort state to the activity-log read flow and the backend removes pagination for export.
Caveats
Browser download naming currently uses `transactions.csv`., CSV field order follows the exported activity record shape rather than the exact visible table layout.

Map location scope

Map View is a location aid for the loaded page rows, not a full-result geolocation report.

Inputs
loaded activity rows, row IP addresses, Mapbox API key, MaxMind settings
Transform
The map groups unique IPs from the currently loaded rows, resolves country-mode locations through the IP location flow, and renders markers only when Mapbox is configured.
Caveats
Missing Mapbox API key prevents the map from rendering., Missing or disabled MaxMind credentials prevent new uncached IP lookups from resolving., Country-mode fallback can place markers near capital coordinates when exact coordinates are unavailable.

Comment group delete rule

Groups already used in comments are protected, so deleting a group does not break existing comment history.

Inputs
selected comment group, COMMENT activity rows
Transform
Delete is allowed only when the active group is not referenced by COMMENT activity JSON group id or group name; successful delete marks the group inactive.
Columns13 topicsOpen details

ID

Internal activity-log row id shown as `#<id>`.

Data Type
integer
Sortable
true

Activity

Human-readable activity or event type.

Data Type
string
Visibility
Hidden when the component is scoped to COMMENT mode.

Method

Trigger or method associated with the activity row.

Data Type
string
Visibility
Hidden when the component is scoped to COMMENT mode.

Description / Comment Data

Main text body for the row. In COMMENT mode the table prioritizes comment payload data and labels this column Comment Data.

Data Type
mixed

User

Player email rendered as a link to the player workspace.

Data Type
string

Comment Group

Visible only in COMMENT mode. Shows the grouped comment bucket attached to the row.

Data Type
string

CRM User

Visible only in COMMENT mode. Shows the CRM actor attached to the comment row when available.

Data Type
string

CRM Role

Visible only in COMMENT mode. Shows the CRM actor role attached to the comment row when available.

Data Type
string

Device

Device-type badge shown as desktop or mobile after frontend normalization.

Data Type
enum

IP Address

IP value for the row. When present, an inline location button can open the map dialog focused on that row.

Data Type
ip

Time

Timestamp of the activity row plus relative-time helper text.

Data Type
datetime
Sortable
true

Detailed Information

Expanded row block that shows description, additional data or JSON, and the recorded user-agent string.

Data Type
structured_block

Website search details

Special expanded detail view for website search activity rows, showing Search Query, Result Count, and Games Received.

Data Type
structured_block
Filters11 topicsOpen details

Description

Free-text search across activity description content.

Type
text

Activity

Restricts the log to one activity code or activity family.

Type
searchable_select
Value Source
active activity codes from activity-log rows

Device

Filters rows by desktop or mobile device type.

Type
select
Visible Values
All Devices, Desktop, Mobile

Group

COMMENT-mode filter that restricts rows to one comment group id.

Type
searchable_select
Visibility
Only rendered when the activity component is scoped to COMMENT activity mode.

Start

Lower bound of the activity date range.

Type
date

End

Upper bound of the activity date range.

Type
date

Country

Additional filter that keeps rows for players with the selected country code.

Type
searchable_select
Value Source
country list

PID

Additional filter for affiliate PID. Backend resolution checks player KPI summary first and then player additional data.

Type
text

User ID

Additional filter that restricts the log to one player id.

Type
text
Caveat
Disabled when the same component is embedded inside an already scoped player profile.

Include Tags

Keeps only rows whose players have all selected tags.

Type
multi_select

Exclude Tags

Removes rows whose players have any selected excluded tag.

Type
multi_select
Summary cards3 topicsOpen details

Total Activities

Number of rows currently loaded in the table page.

Data Type
number

Desktop

Number of currently loaded rows whose normalized device type is desktop.

Data Type
number

Mobile

Number of currently loaded rows whose normalized device type is mobile.

Data Type
number
Metrics3 topicsOpen details

Total Activities

Number of activity rows currently loaded into the table component, not the full backend result count.

Data Type
integer
Formula
Count the activity rows currently loaded into the table component.
Backend Basis
Loaded rows come from the verified user-activities read flow.
Caveats
Use Total records found for the full filtered result count., This card is page-slice based; it is not a total across all matching pages.

Desktop

Count of currently loaded rows resolved to desktop device type.

Data Type
integer
Formula
Normalize each loaded row's deviceType or userDeviceType to lowercase and count rows equal to desktop.
Backend Basis
Loaded rows come from the verified user-activities read flow.
Caveats
The value is computed from the loaded page rows after device-type normalization., Rows without a desktop device value do not contribute to this card.

Mobile

Count of currently loaded rows resolved to mobile device type.

Data Type
integer
Formula
Normalize each loaded row's deviceType or userDeviceType to lowercase and count rows equal to mobile.
Backend Basis
Loaded rows come from the verified user-activities read flow.
Caveats
The value is computed from the loaded page rows after device-type normalization., Rows without a mobile device value do not contribute to this card.
More help

Related pages

Dashboard / Player Statistics

Rank top winners, losers, and depositors for a selected period and row limit.

Players / API Requests

Inspection page for player-related API event logs, with payload search, system and time filters, row-level JSON export, and a three-mode request/response viewer.

Players / Banking

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

Players / Bonus Detail

Read-only detail page for one issued bonus, showing user, bonus, transaction, issuer, game, and lifecycle metadata.

Players / Bonuses

Cross-player issued-bonus inventory with server-side filters, preview popover, CSV export, and navigation into one issued-bonus detail page.

Players / Challenges

Player workspace tab showing challenge wins joined from challenge_wins to challenge definitions, with reward type and reward detail normalization.