Localytics Home

Articles in this section

Location

Heads up—this article is about the Location feature in the Localytics product, which is an Analytics feature that tells you where your users are located. If you’re looking for information on geofences, head to the Places docs.

Overview

Location is a feature in Localytics that gives you visibility into where your app is more popular. Here you can see countries, areas, and cities where your users access your app.

The Localytics SDK collects location data to power the Location report. In order for Localytics to collect and report on latitude-longitude data, your app must first receive permission to collect this data from the user.

That data must then be configured to hand it off to Localytics. For more information, see the corresponding set-up guide in the developer docs:

If Localytics is unable to determine lat-long data (which we regard as the most accurate representation of location), we’ll look for a high-confidence IP address. These are typically available if a user connects via WiFi. If neither lat-long nor IP address is available, we’ll report at the country level using the network’s country.

A Note about End-User Privacy

It's important to note that Location data may be considered personal data by your end users. Depending on your unique privacy requirements, consent may be required prior to collecting non-precision location data generated from an IP lookup. We expect customers to solicit consent as appropriate to their unique privacy requirements. Read more in the Privacy section.

IP addresses are not stored in any Localytics analytics databases. That being said, the location data generated from an IP lookup is, by default, collected and stored. This includes country, region, state, and city/metro if available. Collecting GPS coordinated must be configured, and relies on your application obtaining appropriate permissions to access the OS GPS data.

Using Location

To get to the Location section of your dashboard, select Location from under the Analytics header.

Like most analytics reports, you'll be able to Filter by Dimension and/or Profile, set a date range, change the view, save your report, and apply data splits. To learn more about these features, check out our article on the anatomy of an analytics report.

The Location landing page will give you a high-level view of your users. At the top, you’ll see an interactive map. Click into any country for more information, and to drive down into deeper analytics.

If you need to go back up a level, click the World Map or Country Map option at the top of the page.

Screen_Recording_2019-01-17_at_03.50_PM.gif

Something not loading? Location requires Flash to view the map. In most browsers, you can enable Flash on a per-page basis.

At the top of the page, you’ll have an option to toggle between Sessions or Users, and WiFi or GPS.

Below the map, you’ll see a list of the collected locations based on popularity. At the highest level, you’ll see Countries/Regions on the left, and Top Cities on the right. You can export any of these charts along the way with the Export to CSV button.