Analytics - Overview


Why Analytics?

Beamable's Analytics solution provides the most control and access to your data. There are important reports that are needed in order to measure the success of your game and, as a game maker, you want to know:

  • How many unique total players you have per month (MAU)
  • How many active players you have per day (DAU)
  • How many of those users are returning users that have played previously (Retention)

These examples are among a select few necessities to measure the success of your game, and Beamable empowers you as a game maker by giving you full control over your data so you can gain the most value from writing Telemetry.


To get setup to query Analytic Events, you will need to Contact Us.

With your Analytics events captured and stored, queries may be performed against them, but you will need to get setup by the Beamable team to do so. There are two options on acquiring your data.


  • Direct access to Beamable's Athena database.
  • Forwarding from Beamable's Pipeline Service. Support includes Amazon S3, Amplitude, MixPanel, &

If you change technology along the way, Beamable will be able to back-fill the data.

To get set up for querying Beamable analytics, please contact us.

System Telemetry

Beamable also writes some default telemetry data just from using features of the service. There are several KPI's (Key points of interest) that Beamable already knows that you will need.

These KPI's, defined below, are meant to help you in the following ways:

  • Help determine the success of the game
  • Give an understanding of core player behavior
  • Show advancement towards key monetization goals
platform_session_installdetect when a player is first created
platform_session_dailydetect daily activity of the player, good for measuring retention
platform_session_sessionprovides you with session data
platform_session_session_endprovides you with end of session data
platform_ua_attributionprovides you with user acquisition data related to campaigns
platform_cohort_joindata to identify when a player joins a cohort (segment)
platform_commerce_external_revenuedata to identify when a player makes real money purchases from an external source
platform_commerce_hard_purchasedata to identify when a player makes real money purchases (Hard Currency)
platform_commerce_virtual_purchasedata to identify when a player spends virtual currency
platform_commerce_failed_purchasedata to identify when purchases have failed
platform_entitlement_entitlementPlayer has been granted an entitlement
platform_stats_statsplayer stat has been modified
platform_group_group_creategroup has been created
platform_group_group_inviteplayer has been invited to a group
platform_group_group_joinplayer has joined a group
platform_group_group_leaveplayer has left a group
platform_group_group_applicationplayer has applied to join a group
platform_administration_change_emailplayer has changed their email
platform_administration_reset_passwordplayer has reset their password

Game Maker User Experience

The Portal allows the game maker to view and download player analytics. Individual player analytics can be found within the player profile page.

During development, the game maker's user experience is as follows:



Analytics events are namespaced by the source to limit name collision (Ex: Client.GAME_START vs Platform.GAME_START).

The payload may include custom data set by the game maker. This is a flat set of key/value pairs.

The source value is set automatically for each Analytics event and Stats.

ClientAnalytics event came directly from front-end (game client)Custom Telemetry written by the client is generally less secure and has no server authorityYes
PlatformAnalytics event came from back-endYesYes
Game ServerAnalytics event came from the multiplayer serverYesUpon Request

Analytics Events vs Stats

Beamable supports both analytics events and Stats. Each use case is unique.

Analytics EventAnalytics Databaseβ€’ Events take some time to appear
β€’ Holds deep history
β€’ Answers queries like "When did player X purchase item Y?"

Example: Amazon's Athena
StatTransactional Databaseβ€’ Very fast reads/writes
β€’ Does not keep history

Example: Mongo DB