Overview

This page includes everything needed to use this feature in the "Beamable SDK for Unity". Or watch this 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.

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.

1. Analytics Events - Historical data regarding a player's user interaction or the system state
2. Stats - Active data entity used for read/write of player state
3. Pipeline Service - The live feed of player data
4. 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 Analytics events or a Custom Analytics Event created specifically by the game maker.

Standard Analytics 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 Analytics events.

Custom Analytics Events

Beamable allows game makers to create custom analytics and stats.

• See the AnalyticsService API
• See the StatsService API

📘

Beamable SDK Examples

• This and all examples are available for download at GitHub.com/Beamable_SDK_Examples

using System.Collections.Generic;
using UnityEngine;
using Beamable.Api.Analytics;

namespace Beamable.Examples.Services.AnalyticsService
{
    /// <summary>
    /// Inspired by <see cref="SampleCustomEvent"/>.
    /// </summary>
    public class MyExampleEvent : CoreEvent 
    {
        public MyExampleEvent(string foo, string bar) : base (
            "example",  
            "my_example_event", 
            new Dictionary<string, object>
            {
                ["foo"] = foo,
                ["bar"] = bar,
                ["hello_world"] = "Hello World."
            })
        {
        }
    }
    
    /// <summary>
    /// Demonstrates <see cref="AnalyticsService"/>.
    /// </summary>
    public class AnalyticsServiceExample : MonoBehaviour
    {
        //  Unity Methods  --------------------------------

        protected void Start()
        {
            Debug.Log("Start()");

            SetupBeamable();
        }
        
        //  Methods  --------------------------------------
        private async void SetupBeamable()
        {
            var beamableAPI = await Beamable.API.Instance;
            Debug.Log($"beamableAPI.User.id = {beamableAPI.User.id}");

            var foo = "lorem ipsum 1";
            var bar = "lorem ipsum 2";
            var myExampleEvent = new MyExampleEvent(foo, bar);
            
            var sendImmediately = true;
            beamableAPI.AnalyticsTracker.TrackEvent(myExampleEvent, sendImmediately);
            
            Debug.Log($"TrackEvent() eventName = {myExampleEvent.eventName}");
        }
    }
}

2. View Analytics

The Portal allows the game maker to view and edit player analytics.

🚧

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 Analytics 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 can back-fill the data.

To learn more about querying Beamable analytics, please contact us.

Analytics Events & Stats

Beamable supports both Analytics events and stats. Each use case is unique.

Source

The source value is set automatically for each Analytics events and stats.

A Hybrid Approach

While the use cases for Analytics events and stats are often different, there are indeed common workflows where both are used in concert. For example. Beamable automatically tracks an Analytics event (deep history) every time a StatStat - Active data entity used for read/write of player state is changed (fast speed). This is the best of both worlds!

Here is more info about each analytics concept.

Analytics Events

Analytics 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 for Stats

1. Data Store - A simple place to read/write info (Ex. How many characters does the player own?)
2. Targeting - StatStat - Active data entity used for read/write of player states are the vector for player segmentation (Ex. A/B testing, targeted offer, focused message campaign, announcement for subset of player-base)

See Adding Stats for more info.

Advanced

Here are a few advanced configuration options and workflows.

Analytics 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.

📘

FAQ

Here are highlights from the Beamable FAQ. See FAQ for more info.

• Analytics