[UA] About Geographical Data

Organize your data around your company's geographic regions.

Importing geographical data enables the mapping of geographical IDs to custom regions, allowing you to report on and analyze your Analytics data in ways that are better aligned with your business' organization.

In this article:

How Geographical Data import works

Analytics provides a number of geographical dimensions, such as City, Country, Continent, etc. The values for these dimensions are automatically derived from the IP address of the hit, which is convenient but also has a few drawbacks:

  • IP-based locations are approximate.
  • Values for standard geographic dimensions are localized into the user's preferred language, possibly making it complicated to share the data with users who speak other languages or use other tools.
  • Many businesses operate in arbitrary regions that make sense to them but that don't appear on a map. For example in North America, you might operate in East, Central, and West groups of states or provinces. In Europe, companies might operate across North, Central, and South groups of countries.

As an alternative to IP-based regions, you can create your own custom regions by mapping them to a set of geographical ID dimensions. These dimensions are based on widely used standards, so sharing the data with other users and applications is simpler. The table below lists the available geographical IDs and the standards upon which they are based.

Geographical ID dimensions and standards
Dimension Name ID Standard
City ID Geographical Criteria ID
Country ISO Code ISO-3166-1 alpha-2
Region ID Geographical Criteria ID
Sub Continent Code UN M.49


Data Set details

The Data Set is the container that will hold your imported data. Expand the section below to see the Data Set details.

Data Set details


  • Scope—the scope determines which hits will be associated with the import dimension values. There are four levels of scope: hit, session, user and product. Learn more about scope.
  • Schema Key—lists the key dimensions or metrics. The key is used to join the data you upload with the existing data in your hits for this Data Set type.
  • Imported Data—lists the dimensions and metrics available for the data you upload to Google Analytics.
The dimensions and metrics listed here for the schema key and imported data are for reference only and may not be complete; the actual dimensions and metrics available will appear in the user interface when you create the Data Set.
Scope Session
Modes Processing Time, Query Time
Schema Key Any ONE of the following dimensions is required:
  • City ID
  • Country ISO code
  • Region ID
  • Sub continent code
Imported Data

Custom dimension (session scope)



Was this helpful?

How can we improve it?
Choose your own learning path

Check out google.com/analytics/learn, a new resource to help you get the most out of Google Analytics 4. The new website includes videos, articles, and guided flows, and provides links to the Google Analytics Discord, Blog, YouTube channel, and GitHub repository.

Start learning today!

Clear search
Close search
Google apps
Main menu