Overview
This page includes everything needed to use this feature in the "Beamable SDK for Unity". Or watch this 5 minute video.
The purpose of this feature is to allow the game maker to track player behavior in the game.
Why Analytics?
Beamable Analytics provides data about how players are playing. This information is vital to designing the best game experience.
Metrics
Metric information is vital to know as you design, develop, launch, and improve your game. Metrics answer the questions which are central to a game's success.
Here is a partial list.
| Name | Detail |
|---|---|
| D1, D7, D30 Retention | How many players come back after 1, 7, 30 days? |
| Tutorial Completion | How many players make it all the way through the new player experience and get past the tutorial? |
| Ad Engagement | How many players click to watch an ad in the game? |
| Total Conversion Rate | How many players buy something in the game? |
KPI
Some metrics are referred to as KPIKPI - A Key Performance Indicator is a metric that helps determine a game's successs because of their high importance.
KPIs are metrics that;
- Help determine the success of the game
- Give an understanding of core player behavior
- Show advancement towards key monetization goals
Beamable Analytics
Beamable offers a complete Analytics FeatureFeature - An individual aspect of the Beamable product used to create a great user experience to prepare game makers for success.
- Analytics Events - Historical data regarding a player's user interaction or the system state
- Stats - Active data used for read/write of player data
- Pipeline Service - The live feed of player data
- Amazon's Athena- The analytics database with player history
Game Maker User Experience
During development, the game maker's user experience is as follows.
Steps
Follow these steps to get started.
1. Capture Analytics
In the capture phase, a significant moment of the user-experience is noted and captured by Beamable Analytics. This can be one of the built-in standard events or a custom event created specifically by the game maker.
Standard Events
The great news is that Beamable automatically tracks the most common analytics for you. These are enabled simply by integrating the Beamable SDK into the game project.
Here is a partial list of standard events.
| Name | Detail |
|---|---|
| platform_administration_change_email | For player account |
| platform_administration_reset_password | |
| platform_cohort_join | |
| platform_commerce_external_revenue | For game monetization |
| platform_commerce_failed_purchase | |
| platform_commerce_hard_purchase | |
| platform_commerce_virtual_purchase | |
| platform_entitlement_entitlement | |
| platform_group_group_application | For player guilds |
| platform_group_group_create | |
| platform_group_group_invite | |
| platform_group_group_join | |
| platform_group_group_leave | |
| platform_session_daily | For KPI metrics |
| platform_session_install | |
| platform_session_session | |
| platform_session_session_end | |
| platform_stats_stats | |
| platform_ua_attribution | For attribute user acquisition campaigns |
Custom Events
Beamable allows game makers to create custom analytics and stats.
- See the
AnalyticsServiceAPI - See the
StatsServiceAPI
Feature Roadmap
Many Beamable features will be added over time.
- These C# APIs are currently available as WIPWIP - A Work In Progress feature or workflow is in active development, but not fully released . To learn more, please contact us.
2. View Analytics
The Portal allows the game maker to view and edit player analytics.
The Beamable "Portal"
Feature Roadmap
Many Beamable features will be added over time.
- A KPIKPI - A Key Performance Indicator is a metric that helps determine a game's success Dashboard may be offered within the Portal in the future. To learn more, please contact us.
3. Query Analytics
With your events and stats captured and stored, queries may be performed against them to learn more about player behavior and help design new game features and content updates.
Options
- Direct access to Beamable's Athena database
- Forwarding from Beamable's Pipeline Service. Support includes Amazon S3, Amplitude, MixPanel, & Swrve.com.
If you change technology along the way, no problem, Beamable we can back-fill the data.
To learn more about querying Beamable analytics, please contact us.
Analytics Events & Stats
Supports both analytics events and stats. Each use case is unique.
| Type | Database | Detail |
|---|---|---|
| Analytics Event | Analytics Database | ā¢ Relatively slow ā¢ Holds deep history ā¢ Answers queries like "When did player X purchase item Y?" Example: Amazon's Athena |
| Stat | Transactional Database | ā¢ Very fast reads/writes ā¢ Data purged after X days ā¢ Does not keep history Example: Mongo DB |
Source
The source value is set automatically for each analytics events and stats.
| Name | Detail | Secure? | Available? |
|---|---|---|---|
| Client | Event came directly from front-end (game client) | This data is generally more vulnerable to hackers/risks | Yes |
| Platform | Event came from back-end | Yes | Yes |
| Game Server | Event came from the multiplayer server | Yes | Upon Request |
A Hybrid Approach
While the use cases for events and stats are often different, there are indeed common workflows where both are used in concert. For example. Beamable automatically tracks analytics event (deep history) every time a stat is changed (fast speed). This is the best of both worlds!
Here is more info about each analytics concept.
Events
Events names 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 name/value pairs.
Data Structure
Stats
Use Cases
- Data Store - A simple place to read/write info (Ex. How many characters does the player own?)
- Targeting - Stats are the vector for player segmentation (Ex. A/B testing, targeted offer, focused message campaign, announcement for subset of player-base)
Supported Data Types
- String - For common alphanumeric data storage
- Numeric - Supports numeric evaluations on the back-end (<, >, =) and a fast, atomic
incrementAPI
Best Practice
These hints make efficent use of concepts and workflows.
Stats are designed for simple data types; string or numeric
- Do not store C# objects
- Do not store Json blobs
Public vs Private
- Public Stat - Visible to owning player and others (Ex. Player Alias, Player Avatar)
- Private Stat - Visible only to the owning player (Ex. "How many characters do I have?")
Advanced
Here are a few advanced configuration options and workflows.
Event Batching
Generally speaking each analytics call from the C# API will result in one client-server communication.
The API supports batching together multiple analytics calls (default max limit is 100) within ONE client-server communication as an optimization.
Updated 6 days ago