Remote Configs

Watch Video play_circle

One of the powerful Live Ops features we have at ByteBrew, Remote Configs let's you send updates to your players devices remotely in milliseconds using the ByteBrew dashboard; without having to ship new updates to the app stores.

Required to Start using Remote Configs

tag

To start using our Remote Configs dashboard on ByteBrew, you must first have initialized the ByteBrew SDK in your game or app and implemented remote configs in your game code where ever you'd want to ship live updates in your game. To learn how to integrate Remote Configs in your games, go to the remote configs section in your platform's SDK integration page.

Set up a Remote Config

tag

To setup a Remote Config on the ByteBrew dashboard, follow the steps below:

1

Select "Create Config" in the top corner of the Remote Config dashboard to open the Config Settings panel.

2

Select the Config Type and choose "Single".

3

Input in the Key for your Key/Pair value.

4

Input in the Value for your Key/Pair value.

5

Select the time range you want this config to be available by selecting a config Start Date using the YYYY-MM-DD format. Optionally, you can also select an end date for the config to make it only available to your players for a limited time. If you don't pick an end date then the config will be distributed continously to your players till you remove the config.

6

Select "Create!"

Set up a Conditional Remote Config

tag

To setup a Conditional Remote Config on the ByteBrew dashboard, follow the steps below:

1

Select "Create Config" in the top corner of the Remote Config dashboard to open the Config Settings panel.

2

Select the Config Type and choose "Conditional".

3

Select a Condition for your Key/Pair value. Note: See Conditions section for how to create a condition.

4

Input in the Key for your Key/Pair value.

5

Input in the Value for your Key/Pair value of input a JSON.

6

Select the time range you want this config to be available by selecting a config Start Date using the YYYY-MM-DD format. Optionally, you can also select an end date for the config to make it only available to your players for a limited time. If you don't pick an end date then the config will be distributed continously to your players till you remove the config.

7

Select "Create!"

Set up a Grouped Config

tag

To setup a Grouped Config on the ByteBrew dashboard, follow the steps below:

1

Select "Create Config" in the top corner of the Remote Config dashboard to open the Config Settings panel.

2

Select the Config Type and choose "Group".

3

Input the Key for your Key/Pair value.

4

Input in the Value for your Key/Pair value.

5

Click the plus (+) button to add the number of values you want for this grouped config.

6

Input in the rest of the Values for your Key/Pair value.

7

Select the time range you want this config to be available by selecting a config Start Date using the YYYY-MM-DD format. Optionally, you can also select an end date for the config to make it only available to your players for a limited time. If you don't pick an end date then the config will be distributed continously to your players till you remove the config.

8

Set the interval you want the configs to switch at. We currently only allow for Hourly ("H") and Daily ("D") based intervals on the dashboard. For example, if you want a 6 hour interval then input "6H", however if you'd like every 7 days then input "7D".

Update Remote Configs

tag

To update a Remote Config or Grouped Config on the ByteBrew dashboard, follow the steps below:

1

Click the "Edit" button next to the config you want to edit to open the Config Settings panel.

2

Change the settings you want to update in the panel.

3

Save the new settings you've changed.

Remove Remote Configs

tag

To remove a Remote Config or Grouped Config on the ByteBrew dashboard, follow the steps below:

1

Click the "Delete" button next to the config you want to remove.

Remote Config Statuses

tag

There are two different tag statuses for Remote Configs. See table below for their descriptions:

Active Status of a live config.
Inactive Status of a removed config.

Remote Config Calendar

tag

The Remote Config Calendar is used to visualize all events/configs in your game with their active date periods. Clicking a config in the calendar will redirect to the list item on the table. Configs are split up by type in different colors:

1

Single

2

Conditional

3

Group

Using JSON

tag

JSON can be used as a value in both Single and Conditional Remote Configs. See steps below for adding JSON to Remote Configs:

1

Select the “{ }” button to open the JSON popup and input the value.

2

Save the JSON.

Conditions

tag

On ByteBrew you can distribute live updates to various segments of your user population by creating segments of players using Remote Config Conditions.

Creating Conditions

To create a Condition for remote configs follow the steps below:

1

Navigate to the Conditions tab under the Remote Configs Dashboard page.

2

Select Add New Condition.

3

Name your condition. Note: It’s recommended to name your condition based on it’s descriptive use.

4

Choose Condition Filters. Note: You can choose any number of filters to be applied to your Condition. See list of available condition filters below:

fiber_manual_record
Session Count
fiber_manual_record
Ad Watch Amount
fiber_manual_record
Purchases Amount
fiber_manual_record
Country Origin
fiber_manual_record
Current Build Version
fiber_manual_record
User Langauage
fiber_manual_record
Custom Data Tag
5

Save the Condition.

Editing Conditions

To edit an existing condition, follow the steps below:

1

Select the edit button next to the Condition.

2

Edit the condition filters that you previously created.

3

Save the edited Conditions to apply the changes.

Deleting Conditions

Delete a Condition by hitting the delete button next to the existing Condition on the dashboard.


FAQs

To start using our Remote Configs dashboard on ByteBrew, you must first have initialized the ByteBrew SDK in your game or app and implemented remote configs in your game code where ever you'd want to ship live updates in your game. To learn how to integrate Remote Configs in your games, go to the remote configs section in your platform's SDK integration page.

When a Remote Config is triggered, it acts like a hot patch and updates all your user's devices globally, so the next time a user plays your game it will have the newest delivered updates.

Remote Configs deliver in milliseconds after the ByteBrew SDK is initialized.

If a user is offline and remote configs are sent, then the user's game will use the default value set up in the config until they reconnect to the internet on their next session.

Yes, see Using JSON section for how to use JSON as values for Remote Configs.

JSON’s won’t be able to be saved if (1) the JSON exceeds 1024 characters, or (2) if the JSON is an invalid format.

Each app has a max of 250 remote configs. Within that 250 remote configs, 50 of them can be conditional.

You can run up to 10 Conditions in a single remote config.

Each app has a max of 50 Conditions.

App behavior such as (1) calling remote configs in every frame, or (2) rapidly firing calls per user per second; are two examples of remote config spamming. This type of behavior will be auto detected by the system and flagged.

Need some help?

Join the ByteBrew Discord community to chat with our team and other developers on the platform.