How do I install the Ua To Ga4 skill?

Run npx skillmds@latest add surendranb/ua-to-ga4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ua To Ga4 safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ua To Ga4?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ua To Ga4 free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ua To Ga4?

surendranb (@surendranb) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ua To Ga4 by surendranb — Agent Skill

Name: Ua To Ga4
Rating: 4.2 (5 reviews)
Author: surendranb

Ua To Ga4

Universal Analytics (UA) and GA4 use different names for equivalent concepts. UA was sunset on 2023-07-01; models trained before or around then guess UA field names that no longer exist in the GA4 Data API. On 2024-05-06 GA4 also renamed "conversions" to "key events" (see the conversions rows below). If a name feels obviously right but returns "Invalid metric/dimension", assume your training predates the change and verify with `search_schema`. This skill gives the correct GA4 Data API name for every common UA metric and dimension.

surendranb Updated Sep 10, 2026

File contents

UA to GA4 Field Name Mapping

Universal Analytics (UA) and GA4 use different names for equivalent concepts. UA was sunset on 2023-07-01; models trained before or around then guess UA field names that no longer exist in the GA4 Data API. On 2024-05-06 GA4 also renamed "conversions" to "key events" (see the conversions rows below). If a name feels obviously right but returns "Invalid metric/dimension", assume your training predates the change and verify with search_schema. This skill gives the correct GA4 Data API name for every common UA metric and dimension.

Metrics

UA name (wrong)	GA4 API name (correct)
`users`	`totalUsers`
`uniquePageviews`	`screenPageViews`
`pageviews`	`screenPageViews`
`avgSessionDuration`	`averageSessionDuration`
`timeOnPage` / `avgTimeOnPage`	`userEngagementDuration`
`goalCompletionsAll` / `conversions`	`keyEvents`
`goalConversionRateAll` / `conversionRate` / `sessionConversionRate`	`sessionKeyEventRate`
`userConversionRate`	`userKeyEventRate`
`transactions` / `purchases`	`ecommercePurchases`
`transactionRevenue` / `revenue`	`purchaseRevenue`
`revenuePerTransaction`	`averagePurchaseRevenue`
`transactionsPerSession`	`purchaseToViewRate`
`itemQuantity` / `itemViews`	`itemsViewed`
`itemRevenue`	`itemRevenue` (same)
`entrances`	`sessions` (no direct equivalent — use sessions)
`pageValue`	no direct equivalent

Dimensions

UA name (wrong)	GA4 API name (correct)
`channelGrouping`	`sessionDefaultChannelGroup`
`defaultChannelGrouping`	`sessionDefaultChannelGroup`
`source`	`sessionSource`
`medium`	`sessionMedium`
`campaign`	`sessionCampaignName`
`keyword`	`sessionManualTerm`
`sourceMedium`	`sessionSourceMedium`
`adContent`	`sessionManualAdContent`
`pagePath`	`pagePath` (same)
`pageTitle`	`pageTitle` (same)
`landingPagePath`	`landingPage`
`exitPagePath`	no direct equivalent
`deviceCategory`	`deviceCategory` (same)
`operatingSystem`	`operatingSystem` (same)
`browser`	`browser` (same)
`country`	`country` (same)
`city`	`city` (same)
`userType`	use `newVsReturning`

Key rules

All GA4 API names are camelCase — never snake_case.

Wrong (snake_case)	Correct
`page_path`	`pagePath`
`session_source`	`sessionSource`
`device_category`	`deviceCategory`
`event_name`	`eventName`
`total_users`	`totalUsers`

Attribution scope

GA4 splits attribution into three scopes. Use the right prefix:

Scope	Prefix	Use for
Session	`session` (e.g. `sessionSource`)	Traffic acquisition analysis
First user	`firstUser` (e.g. `firstUserSource`)	User acquisition analysis
Event	`(none)` (e.g. `pagePath`)	Event-level analysis

Mixing scopes causes 400 errors — see compatible-combinations skill.

---name: ua-to-ga4description: Universal Analytics (UA) and GA4 use different names for equivalent concepts. UA was sunset on 2023-07-01; models trained before or around then guess UA field names that no longer exist in the GA4 Data API. On 2024-05-06 GA4 also renamed "conversions" to "key events" (see the conversions rows below). If a name feels obviously right but returns "Invalid metric/dimension", assume your training predates the change and verify with `search_schema`. This skill gives the correct GA4 Data API name for every common UA metric and dimension.---# UA to GA4 Field Name MappingUniversal Analytics (UA) and GA4 use different names for equivalent concepts.UA was sunset on 2023-07-01; models trained before or around then guess UA fieldnames that no longer exist in the GA4 Data API. On 2024-05-06 GA4 also renamed"conversions" to "key events" (see the conversions rows below). If a name feelsobviously right but returns "Invalid metric/dimension", assume your trainingpredates the change and verify with `search_schema`. This skill gives the correctGA4 Data API name for every common UA metric and dimension.## Metrics| UA name (wrong) | GA4 API name (correct) ||---|---|| `users` | `totalUsers` || `uniquePageviews` | `screenPageViews` || `pageviews` | `screenPageViews` || `avgSessionDuration` | `averageSessionDuration` || `timeOnPage` / `avgTimeOnPage` | `userEngagementDuration` || `goalCompletionsAll` / `conversions` | `keyEvents` || `goalConversionRateAll` / `conversionRate` / `sessionConversionRate` | `sessionKeyEventRate` || `userConversionRate` | `userKeyEventRate` || `transactions` / `purchases` | `ecommercePurchases` || `transactionRevenue` / `revenue` | `purchaseRevenue` || `revenuePerTransaction` | `averagePurchaseRevenue` || `transactionsPerSession` | `purchaseToViewRate` || `itemQuantity` / `itemViews` | `itemsViewed` || `itemRevenue` | `itemRevenue` (same) || `entrances` | `sessions` (no direct equivalent — use sessions) || `pageValue` | no direct equivalent |## Dimensions| UA name (wrong) | GA4 API name (correct) ||---|---|| `channelGrouping` | `sessionDefaultChannelGroup` || `defaultChannelGrouping` | `sessionDefaultChannelGroup` || `source` | `sessionSource` || `medium` | `sessionMedium` || `campaign` | `sessionCampaignName` || `keyword` | `sessionManualTerm` || `sourceMedium` | `sessionSourceMedium` || `adContent` | `sessionManualAdContent` || `pagePath` | `pagePath` (same) || `pageTitle` | `pageTitle` (same) || `landingPagePath` | `landingPage` || `exitPagePath` | no direct equivalent || `deviceCategory` | `deviceCategory` (same) || `operatingSystem` | `operatingSystem` (same) || `browser` | `browser` (same) || `country` | `country` (same) || `city` | `city` (same) || `userType` | use `newVsReturning` |## Key rulesAll GA4 API names are camelCase — never snake_case.| Wrong (snake_case) | Correct ||---|---|| `page_path` | `pagePath` || `session_source` | `sessionSource` || `device_category` | `deviceCategory` || `event_name` | `eventName` || `total_users` | `totalUsers` |## Attribution scopeGA4 splits attribution into three scopes. Use the right prefix:| Scope | Prefix | Use for ||---|---|---|| Session | `session` (e.g. `sessionSource`) | Traffic acquisition analysis || First user | `firstUser` (e.g. `firstUserSource`) | User acquisition analysis || Event | `(none)` (e.g. `pagePath`) | Event-level analysis |Mixing scopes causes 400 errors — see `compatible-combinations` skill.

Frequently asked questions