Docs > Tool Features > Remote Configs > Remote Configs

Remote Configs

#

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”);

 

#

Create

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
    • Description
    • Filter: Country, Build and OS.
      • Each filter can be either inclusive (“Only players located in these countries”) or exclusive (“Every player apart from those from located in these countries”).
    • Start/end date

 

#

Priority

Copy link to clipboard

You can create multiple Config Values for the same Config Key:

  • Create a new Remote Config with an existing Config Key
  • Select the relative priority of the new Remote Config
  • Values for each Remote Config are sent to players based on their relative priority and filter criteria

For example, you may already have a Remote Config that specifies the points gained for a level completion, but you want to double it for players in Denmark during the Halloween period.

You can do this by creating a new Remote Config with the same Config Key. During the creation stage, you will be asked to select the priority of the new Remote Config.

Now players who are from Denmark will receive the value 200, while all other players will receive the value 100.

Values for each Remote Config Key are assigned based on their relative priority.

#

Limits

Copy link to clipboard

You can create any number of configs, but the maximum number that can be active 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 / Schedule

Copy link to clipboard

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

You can set the Remote Config to stay active indefinitely, once started, or schedule it to become inactive at a future 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

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

 

#

Edit

Copy link to clipboard

You can edit all properties of a Remote Config, except for the name.

Contact support

Any queries about the platform are welcome.

Give article feedback

Let us know what you think about the articles.