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

  1. Ask the developer to check the settings on a test device.
  2. Perform an action that transfers data to AppMetrica.
  3. In the report with geographic grouping, check the received country or city.
  4. 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.

Contact support Suggest an improvement for documentation