Security, Privacy, AI and CSR information for all Piano products now lives in one place. Explore our Compliance Center.
Analytics
English French
English French

What is the sub-region property?

The sub-region property (geo_metro), also called the metro code, identifies the metropolitan area a visitor is in. Piano Analytics derives it from the visitor's IP address, and the standard used to define a metropolitan area depends on the visitor's country.

Sub-region is only available for the 19 countries listed below. For all other countries, the property is empty.

Standard used by country

Country

Metro code is based on

United States

Nielsen Direct Market Areas (DMAs)

United Kingdom

ITV regions

France

Departments of France

Germany

Nielsen TV markets

South Korea

Municipal divisions: si, gun and gu

China

Diji shi (prefecture-level cities administered at the provincial level), plus the four zhixia shi administered by the Central Government: Beijing, Tianjin, Shanghai and Chongqing

Russia

Russian Federal Districts

Canada

Canadian Census Metropolitan Areas (CMAs)

Norway

Norwegian municipalities (kommuner)

New Zealand

Urban areas defined by Statistics New Zealand

Australia

Greater Capital City Statistical Areas (GCCSAs) and Significant Urban Areas (SUAs), defined by the Australian Bureau of Statistics

Finland

Finnish municipalities

Aland Islands

Finnish municipalities

Japan

Metropolitan areas defined by the Statistics Bureau of Japan

Denmark

Danish municipalities

Iceland

Icelandic municipalities

Sweden

Swedish municipalities

India

Municipalities or Panchayats, as assigned by the Ministry of Statistics and Programme Implementation

Details for specific countries

  • United States: every US city falls into a DMA, and a DMA can cross state lines. If any part of a state is in a DMA, that state is listed in the regions. When a DMA covers parts of several states, the states are separated by a "/". Within the sub-region value, multiple cities are also separated by a "/".

  • United Kingdom: since the ISO 3166-2 standardization of October 2012, the list of regions for an ITV area has grown quite large.

  • Russia: Crimea is one of the nine federal districts. The Russian government recognizes it as part of Russia, but the ISO standard used for country and region targeting recognizes it as part of Ukraine. Crimea is therefore listed with the country "rus" and the region "43", which is the ISO region code for Crimea in Ukraine.

  • Canada and Australia: the boundaries of the CMAs, GCCSAs and SUAs define which cities belong to each area. Cities outside these areas have no metro code.

  • South Korea: si, gun and gu are the three municipal levels of South Korea's administrative divisions. See "Administrative divisions of South Korea" for an explanation.

Empty sub-region values

If sub-region returns empty values, this is usually normal. It happens when:

  • the visitor is in a country that isn't in the table above.

  • the visitor is in Canada or Australia, but their city is outside the areas that define the metro codes.

For example, a report on visitors in Spain shows no sub-region values, because Spain isn't covered. To analyze these visitors by location, use the Country, Region or City properties instead.

Last updated: