Advanced guide

Last updated 09/03/2026

1. Initialization parameters

The TDRemoteConfigSettings configuration passed in during initialization is described below:

Property name	Type	Description
appId	String	app id of the project created in the AE backend
serverUrl	String	server url of the project created in the AE backend
mode	TDRemoteConfigMode	NORMAL: normal mode DEBUG: debug mode
customFetchParams	Map<String, dynamic>?	(Used by TDRemoteConfig) Custom request parameters for fetching configurations

2. Customize fetch timing

2.1 Automatic fetching

The SDK automatically fetches remote configuration data in the following scenarios

• App cold start
• App foreground/background switch, more than 6 hours after the previous one
• The account system of the data collection SDK changes, for example, login or logout

2.2 Manual fetching

Call the SDK method manually to fetch remote configuration at any time

TDRemoteConfig.fetch();

This API has internal rate limiting. Avoid fetching too frequently.

3. Customize Fetch parameters

Fetch parameters are parameters that the client SDK can use when it requests values from the AE server. You can customize Fetch parameters and add them as Environment Parameters of config channels. You can then use the Fetch parameters to customize the target audience environment when you configure strategies.

3.1 Add

TDRemoteConfig.setCustomFetchParams({"fetch_key": "fetch_value"});

3.2 Delete

Delete by the specified key

TDRemoteConfig.removeCustomFetchParam("key");