Activity Map

Where any event happens. Pick one or more events and see their occurrences per country, then per region or city inside a country, with the share the leaders hold and how the top three move over time.

What the map shows

The Activity Map answers one question for any event: where does it happen? Pick an event, or several, and the page counts its occurrences per country for the date range, ranks the countries, colors the map by that count, and plots the top three day by day. Open a country and the same page does it again for that country's regions or cities.

Activity means occurrences. A profile that triggers the event ten times in Berlin adds ten to Germany, and Sessions, the default event, counts sessions rather than the profiles who had them. When several events are picked, each is counted on its own and the counts add up, so the map reads "all of these, together", never "profiles who did both".

Every view keeps the same shape: a strip of four numbers for the whole and its concentration, the ranked list, the map, and the top-three trend, so the reading learned on the world carries into every country.

Where the location comes from

A country, region and city are attached to each profile, and an event lands where its profile is.

The SDK may send a location with a session: a country code, a city, or coordinates. When it sends none, Countly derives the location from the IP address the session came from. Either way the result is written on the profile, and every event that profile sends carries it.

What gets written is governed by two project settings. With Track country data off, no country is recorded and the map is empty. With Track city data off, no region or city is recorded and a country cannot be opened for detail.

The location is the profile's current one. A profile that moves to another country takes its future events there, and events already recorded stay where they were counted at the time.

Use Cases

See where an event happens

Find out where one behavior happens, and how concentrated it is.

1. Open Activity Map. It starts on Sessions; replace the event with the one you care about, and add a property filter if only some occurrences count, for example purchases above a value.
2. Read the four numbers. Total activity is the size of the whole; countries reached is its spread; the largest share and the top 3 concentration say how much of it sits in a few places.
3. Read the ranked list for the order and the exact counts, and the map for the picture. The color scale runs from the smallest country to the largest.
4. Look at Top 3 over time. A country that leads the list but not the recent days is a leader in decline.
5. Turn on comparison in the date picker to see each country's change against the previous period, in the list and on the KPI cards.

Compare two behaviors by geography

See whether two behaviors have the same geography, for example sign-ups and purchases, or one event on the latest version against the same event on older versions.

1. Add a second event group with the plus control, and give each group the filters that define it. Groups add up, so a row's activity is the sum of both.
2. Read the list with one group first, then with both. A country that climbs when the second group joins is where the second behavior is stronger.
3. For a cleaner comparison, run the two groups one at a time and note the top-3 concentration each time; the difference between the two figures is how differently the behaviors are spread.
4. Use a property filter for the version split: the same event filtered to the current version in one group, and to everything else in the other.

Go from a country to its cities

Look inside one country.

1. Click the country in the ranked list or on the map. The page turns into that country's view: the list ranks its regions, the map fits the regions that have activity, and the four numbers now describe regions.
2. Switch Regions to Cities. Cities are drawn as points sized by activity rather than as colored areas, because they have no shape.
3. Read Top 3 over time for the three leading regions or cities; a city that grows while the country's total is flat is taking share from the others.
4. Turn on comparison to see which regions moved against the previous period.
5. Use World to return, then open another country from the list or the map.

FAQs

Why does a country's number differ from Sessions › Segments › Countries?

The map counts occurrences of the picked events for the date range from the raw events; the Sessions section reads pre-aggregated counts. Small differences are expected, large ones usually mean a different date range or an event filter.

Why is "Regions reached" so small?

Regions and cities are recorded only while city tracking is on, and only for profiles the server could place. Profiles without a region are left out of the country view.

A city I know we serve is missing. Why?

A city is stored only while Track city data is on, so profiles recorded while it was off carry none. A profile whose location came from a coarse IP lookup may carry no city at all.

What happens if I add the same event twice?

It is counted twice. Groups add up; use one group with a broader filter instead.

Why does the trend show three lines and no total?

The trend is narrowed to the three largest geographies so the chart stays readable. The total is on the KPI card, and the other geographies are in the list.

Does clicking a country change the date range?

No. Only the scope changes; the date range and the events stay as they are.