Analytics Events

The THNDR widget emits real-time analytics events to your host application via postMessage. These events tell you exactly what a player is doing inside the game - which tabs they're viewing, when matches start and finish, and how they interact with results and leaderboards.

postMessage event

When a player performs a tracked action, the game emits the following message to the parent window:

{
  "message": "operator_analytics_event",
  "data": {
    "eventName": "MatchStarted"
  }
}

The eventName field contains the name of the event.

Example listener

window.addEventListener("message", (event) => {
  let data;
  try {
    data = JSON.parse(event.data);
  } catch {
    return;
  }

  if (data.message === "operator_analytics_event") {
    const eventName = data.data.eventName;
    console.log("THNDR event:", eventName);

    // Example: track in your own analytics
    analytics.track("thndr_event", { event: eventName });
  }
});

Event reference

Navigation

Event name	Description
GameTabViewed	Player viewed the main game tab
ResultsTabViewed	Player viewed the results tab
LeaderboardTabViewed	Player viewed the leaderboard tab
RulesTabViewed	Player viewed the rules tab

Matches

Event name	Description
MatchStarted	Player started a paid match
MatchFinished	Player finished a paid match
PracticeMatchStarted	Player started a practice match
PracticeMatchFinished	Player finished a practice match

Results

Event name	Description
MyResultsViewed	Player viewed their own results
TournamentResultsViewed	Player viewed tournament results
WorldwideResultsViewed	Player viewed worldwide results
ResultDrawerWinViewed	Player saw the result drawer after a win
ResultDrawerLossViewed	Player saw the result drawer after a loss
ResultDrawerDrawViewed	Player saw the result drawer after a draw
ResultDrawerCancelledViewed	Player saw the result drawer for a cancelled match
ResultDrawerInProgressViewed	Player saw the result drawer for a match still in progress
StatsDrawerViewed	Player viewed the stats drawer

Leaderboards

Event name	Description
MostWinsDailyLeaderboardViewed	Player viewed the daily most-wins leaderboard
MostWinsWeeklyLeaderboardViewed	Player viewed the weekly most-wins leaderboard
MostWinsMonthlyLeaderboardViewed	Player viewed the monthly most-wins leaderboard
MostWinsAllTimeLeaderboardViewed	Player viewed the all-time most-wins leaderboard
TopEarnersDailyLeaderboardViewed	Player viewed the daily top-earners leaderboard
TopEarnersWeeklyLeaderboardViewed	Player viewed the weekly top-earners leaderboard
TopEarnersMonthlyLeaderboardViewed	Player viewed the monthly top-earners leaderboard
TopEarnersAllTimeLeaderboardViewed	Player viewed the all-time top-earners leaderboard

Other

Event name	Description
BalanceUpdated	Player's balance was updated (after a win, loss, or deposit)