/geo-device-segmentation

name: geo-device-segmentation
description: "Break down user behaviour by country, city, device category, and OS to understand regional patterns and optimise for your key markets."

Geo and Device Segmentation

Break down user behaviour by country, city, device category, and OS to understand regional patterns and optimise for your key markets.

Correct dimension names

| Concept | GA4 API name | |---|---| | Country | `country` | | City | `city` | | Region | `region` | | Device category | `deviceCategory` | | Operating system | `operatingSystem` | | OS version | `operatingSystemVersion` | | Browser | `browser` | | Screen resolution | `screenResolution` | | Language | `language` |

Device category values: `desktop`, `mobile`, `tablet`.

Step 1 — Country breakdown

dimensions: ["country"]
metrics: ["totalUsers", "sessions", "userEngagementDuration",
          "screenPageViewsPerSession", "keyEvents"]
date_range: last 30 days
order_by: totalUsers DESC
limit: 20

Step 2 — Device split

dimensions: ["deviceCategory"]
metrics: ["sessions", "totalUsers", "engagementRate",
          "userEngagementDuration", "bounceRate"]
date_range: last 30 days
order_by: sessions DESC

Step 3 — Country + device cross-tab

Understand device preferences by market:

dimensions: ["country", "deviceCategory"]
metrics: ["sessions", "userEngagementDuration", "bounceRate"]
dimension_filter: country IN [your top 5 countries from Step 1]
date_range: last 30 days
order_by: sessions DESC

Note: combining country + deviceCategory + additional dimensions in one query may exceed GA4's cardinality limit. Keep to 2–3 dimensions max.

Step 4 — Single-country deep dive

For a specific country (e.g. Japan):

dimensions: ["city", "deviceCategory"]
metrics: ["sessions", "totalUsers", "userEngagementDuration", "keyEvents"]
dimension_filter: {
  "filter": {
    "fieldName": "country",
    "stringFilter": {"matchType": "EXACT", "value": "Japan"}
  }
}
date_range: last 30 days
order_by: sessions DESC
limit: 20

Step 5 — Browser and OS (for technical optimisation)

dimensions: ["browser", "operatingSystem", "deviceCategory"]
metrics: ["sessions", "bounceRate", "userEngagementDuration"]
date_range: last 30 days
order_by: sessions DESC
limit: 20

What to report

• Top 10 countries by users and their engagement quality
• Mobile vs desktop vs tablet split (sessions and engagement rate)
• Any country where engagement is significantly below average — flagged for investigation
• Device preferences by your top 3 markets if they differ meaningfully