Determining the location
Location data helps you compare audiences by region. The determination method depends on the SDK settings and the app's access to device geo data.
What options are available
|
Option |
How it works |
What to check |
|
Transferring the device location |
The SDK uses the geo data available to the app. In the Help, this mode is described as determining down to the city |
Whether collection is enabled and whether the required user permission exists |
|
Determination by IP address |
When geo data transfer is disabled, the IP address is used; in the Help, accuracy is specified down to the country |
Don't expect the same detail from this mode as from device geo data |
SDK configuration by itself doesn't replace the user's permission to access the location.
How to configure
Determine which task needs geography and whether the country is enough or the city is required. Pass the task to the developer: they will check the app's capabilities and the required permissions. Connecting analytics by itself doesn't provide access to the device location.
How to check the result
- Ask the developer to check the settings on a test device.
- Perform an action that transfers data to AppMetrica.
- In the report with geographic grouping, check the received country or city.
- If the detail isn't enough, check the availability of geo data and the selected collection mode.
When checking, keep in mind that the IP address and device geo data are different sources. Changing the determination method may affect geographic slices.
Note
If you have IP address masking enabled, AppMetrica determines the location with country-level accuracy using the unmasked part of the IP address.
The app can determine the location based on the information available to it. The developer chooses the collection method and configures the permission request if it's needed.
For the developer: configuring location determination
Download the instructions for the developer (TXT): geo-developer-en.txt
Android. Starting from the AppMetrica SDK 5.0.0, geo data transfer is disabled by default. To enable it, the developer changes the SDK configuration and configures the required permissions. Examples are in the Android instructions.
iOS. The locationTracking option is enabled by default, but the SDK doesn't request user permission on its own. The request is configured in the app. The option can be disabled in the configuration. Learn more — in the iOS instructions.
For Flutter, React Native, and Unity, use the links to the instructions in the article about location. Consider the platform on which the app runs.
Instructions for platforms
Note
Starting from version 5.0.0, the AppMetrica Android SDK locationTracking option is disabled by default.
Note
Below version 5.0.0, the locationTracking option is enabled by default.
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.