Game Ops

Remote Configs

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

if (ga_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 Remote Config use the following methods:

// Without custom default value (using normal default value)
var value = ga_getRemoteConfigsValueAsString("key");
// With custom default value
var valueWithCustomDefaultValue = ga_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.

Custom Dimensions

GameAnalytics supports the use of up to 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.

ga_setCustomDimension01("ninja");
ga_setCustomDimension02("dolphin");
ga_setCustomDimension03("horde");

// reset custom dimention 3
ga_setCustomDimension03("");

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