Dynamic configuration finds the best Amplitude server URL based on app users' location.
- If you have your own proxy server and use
setServerUrlAPI, don't use dynamic configuration.
- If you have users in Mainland China, we recommend that you use dynamic configuration.
- By default, this feature is off. You must explicitly enable it to use it.
Send users from different regions to the server for their region.
stateDiagram-v2 s1: Dynamic Config Server cn_user: User in China us_user: User in United States s1 --> cn_user : api2.amplitude.com s1 --> us_user : api.amplitude.com
Dynamically adjust server URLs¶
If a server URL becomes unreachable for some reason, Amplitude can change the address in the dynamic configuration server. This makes the ingestion endpoint dynamic, so you don't need to release a new version of your app.
stateDiagram-v2 s1: Dynamic Config Server user: User s1 --> user : new.amplitude.com (new URL) s1 --> user : old.amplitude.com (broken URL)