Overview

Here is everything needed to use the Analytics 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 robust info about a player's behavior. Understanding player behavior 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.

• See the AnalyticsService 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 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.

Advanced

This section contains any 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.

Analytics Event Structure

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.

Analytics Events vs Stats

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

Source Value

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