Docs > Knowledge base > Features > Remote Configs

Remote Configs

Product Update – November 2019

We are excited to announce the release of Remote Configs – our new tool that has replaced Configs.

Please update to the latest SDKs here.

If you are a user of the old Configs tool you can still access the UI until March 1st 2020, however configs created within the old tool will not propogate to your games with the latest SDK. For more information please see our migration guide for detailed steps on how to access the old tool and migrate to Remote Configs.

If you have any questions, please don’t hesitate to reach out.

#

Overview

Copy link to clipboard

Tired of getting up early every morning to change the bonus of the day in your game?

With Remote Configs, you’re able to customize gameplay parameters by sending key-value pairs directly to the player’s device. These ‘configs’ are defined in the Remote Configs UI and sent to the GameAnalytics SDK right away or at a scheduled date.

This gives you an easy way to trigger in-game changes, without updating app versions or coding every time.

#

Usage

Copy link to clipboard

Once a config is set and started, the corresponding key-value pair is delivered to the GameAnalytics SDK on the player device, and from there it can be actioned in the game.

  • For instance, you can have an in-game configuration that is set to turn on/off ad network integrations when it receives the value ‘ad_network_off’.

You can also use Configs to change game assets, such as characters or weapons.

  • For instance, sending values like ‘characterod_ninja’ could change the promoted character of the day to the ninja.
#

SDK Setup

Copy link to clipboard

Remote configs are supposed to alter the game experience for users inside the game.

In order to get active configs, a call has to be made in the game code. Once the config is returned the game can be altered. You can find detailed code examples within each SDK guide here.

Here’s some example code (Unity) for checking availability and for retrieving a config.

//Check if Remote Configs is ready and has been loaded with values
//It should be ready after initialize.
if(GameAnalytics.IsRemoteConfigsReady ())
{
	// call Remote Configs
}
//Gets Remote Configs value using specified key.
Example:
string value = GameAnalytics.GetRemoteConfigsValueAsString ("difficulty");
//Gets Remote Config using specified key. If there is no value at specified key the call will return the default value (1)

string value = GameAnalytics.GetRemoteConfigsValueAsString ("difficulty”, “1”);

 

#

Creation

Copy link to clipboard

To create your first config:

  • Click the ‘Create’ button when you open the Remote Configs page.
  • A config definition panel will open, which will allow you to input the key-value pair you want to send, as well as add a description and a start/end date.
#

Limits

Copy link to clipboard

You can create any number of configs, but the maximum number that can be running/created at any one time is 10.

#

Values

Copy link to clipboard

The value will be passed on as a string and it can contain any unicode character with a maximum length of 16.

#

Start Config

Copy link to clipboard

You can either set the config to start immediately or schedule it to trigger at a later date.

If a remote config is currently inactive, you can manually start it by selecting the ‘Start’ action from the overview page:

#

Stop Config

Copy link to clipboard

You can set the remote config to stay active indefinitely or schedule it to become inactive at a future date:

A remote config can be manually stopped by selecting the ‘Stop’ action from the overview page:

 

For the config to take effect, the GameAnalytics SDK in your game must be updated to the latest version that supports Remote Configs.

 

Contact support

We’ll get back to you ASAP.

Report a bug

Let us know more details.