Game Ops

Remote Configs

Register to events for whenever the Remote Configs is updated with new values:

private static function myOnRemoteConfigsUpdateFunction(event:StatusEvent):void
{
    // add your code here
}

GameAnlytics.addRemoteConfigsListener(myOnRemoteConfigsUpdateFunction);

To manual check if Remote Configs is ready (has been populated with values) you can call this:

if(GameAnalytics.isRemoteConfigsReady())
{
    // the remote configs is ready, add your code here
}

Remember the remote configs can be populated with an empty dictionary if the device is offline and there are no cached remote configs from a previous session.

To get values out of a populated Config use the following methods:

// Without custom default value (using normal default value)
var value:String = GameAnalytics.getRemoteConfigsValueAsString("key");
// With custom default value
var valueWithCustomDefaultValue:String = GameAnalytics.getRemoteConfigsValueAsString("key", "myDefaultValue");

info

If the specified key is not found in the Remote Configs it will return the default value either “normal” or “custom” default value.

A/B Testing

To get the value of A/B testing id or variant id use the following methods:

// A/B testing id
var abTestingId:String = GameAnalytics.getABTestingId();
// A/B testing variant id
var abTestingVariantId:String = GameAnalytics.getABTestingVariantId();

tip

Remember the A/B testing ids are first available when the Remote Configs are ready.

Custom Dimensions

GameAnalytics support the use of 3 custom dimensions.

• Custom01
• Custom02
• Custom03

During the game it is possible to set the active value for each custom dimension dynamically. Once a dimension is set it will be persisted across sessions/game-start and automatically be added to all event categories. Remember you have to set the custom dimensions before initialzing the SDK (but after setting the available custom dimensions) to be able to add the dimensions to the first session start event.

Setting each custom dimension. To reset a set custom dimension simply just set it to empty string.

GameAnalytics.setDimension01("ninja");
GameAnalytics.setDimension02("dolphin");
GameAnalytics.setDimension03("horde");

// reset custom dimention 3
GameAnalytics.setDimension03("");

Field	Type	Description	Example
customDimension	string	One of the available dimension values set in the configuration phase. Will persist cross session. Set to empty string to reset.	ninja

tip

Read more about Custom Dimensions here.