Docs > Knowledge base > Features > Remote Configs – Migration Guide

Remote Configs – Migration Guide

Please follow the below steps to migrate your existing Configs:

  • View Old Configs
  • Create New Remote Configs
  • Install Latest GameAnalytics SDKs
  • Update SDK Functions
  • Remove Old Configs
#

view old configs

Copy link to clipboard
  • Access Remote Configs from the navigation menu
  • Click on “Old Configs” in the bottom right corner:

 

  • You can always go back to the new Remote Configs by clicking on “New Configs” in the bottom right corner or by accessing Remote Configs from the navigation menu:

 

#

create new remote configs

Copy link to clipboard

Please follow the below steps to re-create any existing configs within Remote Configs:

  • Open GameAnalytics in a new tab and access Remote Configs
  • Click “Create Config”
  • Enter
    • Config Key
    • Key Description (optional)
    • Key Value
    • Start Date
    • End Date
  • Click “Create”

You will now see the new Remote Config on the overview page, with a status of Scheduled or Active.

#

install latest sdk

Copy link to clipboard

In order to use Remote Configs within your game, you need to update to the latest GameAnalytics SDK. 

You can find the latest SDK packages within the respective SDK guides here.

We have deprecated the old Config calls, and thus old configs will no longer propogate to your game after updating to the latest SDK. You will need to recreate each within the new Remote Configs tool and then use the new SDK calls as described below.

#

update sdk calls

Copy link to clipboard

Once the latest SDK package has been installed, you can now use Remote Configs with your games by using our new calls. The setup and usage remain the same, however the function names have changed. 

Below you can find the mappings, from old to new functions, for Unity, Android and iOS.

You can find the detailed respective guides for all SDKs here.

#

Register To Events

Copy link to clipboard

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

Unity


Old call:
public static event Action OnCommandCenterUpdatedEvent;

New call:
public static event Action OnRemoteConfgisUpdatedEvent;

Android


Old call:
public interface ICommandCenterListener
{
   void onCommandCenterChanged();
}


New call:
public interface IRemoteConfigsListener
{
   void onRemoteConfigsChanged();
}


Old call:
public static void addCommandCenterListener(ICommandCenterListener listener);

New call:
public static void addRemoteConfigsListener(IRemoteConfigsListener listener);

iOS


Old call:
@protocol GACommandCenterDelegate 
@optional
- (void) onCommandCenterUpdated;
@end


New call:
@protocol GARemoteConfigsDelegate 
@optional
- (void) onRemoteConfigsUpdated;
@end


Old call:
+ (void) setCommandCenterDelegate:(id)newDelegate;

New call:
+ (void) setRemoteConfigsDelegate:(id)newDelegate;
#

Manual Check

Copy link to clipboard

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

Unity


Old call:
public static bool IsCommandCenterReady();

New call:
public static bool IsRemoteConfigsReady();

Android


Old call:
public static boolean isCommandCenterReady();

New call:
public static boolean isRemoteConfigsReady();

iOS


Old call:
+ (BOOL) isCommandCenterReady;

New call:
+ (BOOL) isRemoteConfigsReady;
#

Get Values

Copy link to clipboard

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

Unity

Without custom default values (using normal default values):


Old call:
public static string GetCommandCenterValueAsString(string key);

New call:
public static string GetRemoteConfigsValueAsString(string key);

With custom default values:


Old call:
public static string GetCommandCenterValueAsString(string key, string defaultValue);

New call:
public static string GetRemoteConfigValueAsString(string key, string defaultValue);

Android

Without custom default values (using normal default values):


Old call:
public static String getCommandCenterValueAsString(String key);

New call:
public static String getRemoteConfigsValueAsString(String key);

With custom default values:


Old call:
public static String getCommandCenterValueAsString(String key, String defaultValue);

New call:
public static String getRemoteConfigsValueAsString(String key, String defaultValue

iOS

Without custom default values (using normal default values):


Old call:
+ (NSString *) getCommandCenterValueAsString:(NSString *) key;

New call:
+ (NSString *) getRemoteConfigsValueAsString:(NSString *) key;

With custom default values:


Old call:
+ (NSString *) getCommandCenterValueAsString:(NSString *) key defaultValue:(NSString *)defaultValue;

New call:
+ (NSString *) getRemoteConfigsValueAsString:(NSString *) key defaultValue:(NSString *)defaultValue;
#

remove old configs

Copy link to clipboard

After you have updated to the latest SDKs, recreated the Remote Configs and confirmed that they are working as expected with your game, you can now remove your old configs:

 

#

support

Copy link to clipboard

If you have any questions or difficulties in migrating and configuring Remote Configs, please don’t hesitate to reach out.

Contact support

We’ll get back to you ASAP.

Report a bug

Let us know more details.