Google Analytics¶

Node: googleAnalytics · Full type: n8n-nodes-base.googleAnalytics · Version: 2

Credentials¶

googleAnalyticsOAuth2 (alias: @google)

CREDENTIAL @google = googleAnalyticsOAuth2 "My Google Analytics"

Parameter	Type	Default	Details
`propertyType`	options	"ga4"	`ga4`, `universal`
`propertyId`	resourceLocator	{...}	required; modes: `list`, `url`, `id`
`dateRange`	options	"last7days"	required; `last7days`, `last30days`, `today`, `yesterday`, `lastCalendarWeek`, `lastCalendarMonth`, `custom`
`startDate`	dateTime	"2026-03-06T00:00:00.000+02:00"	required
`endDate`	dateTime	"2026-03-13T00:00:00.000+02:00"	required
`metricsGA4`	fixedCollection	{...}	groups: `metricValues`
`dimensionsGA4`	fixedCollection	{...}	groups: `dimensionValues`
`returnAll`	boolean	false
`limit`	number	50
`simple`	boolean	true
`additionalFields`	collection	{}	keys: `currencyCode`, `dimensionFiltersUI`, `metricAggregations`, `metricsFiltersUI`, `keepEmptyRows`, `orderByUI`, ...
`viewId`	resourceLocator	{...}	required; modes: `list`, `url`, `id`
`dateRange`	options	"last7days"	required; `last7days`, `last30days`, `today`, `yesterday`, `lastCalendarWeek`, `lastCalendarMonth`, `custom`
`startDate`	dateTime	"2026-03-06T00:00:00.000+02:00"	required
`endDate`	dateTime	"2026-03-13T00:00:00.000+02:00"	required
`metricsUA`	fixedCollection	{...}	groups: `metricValues`
`dimensionsUA`	fixedCollection	{...}	groups: `dimensionValues`
`returnAll`	boolean	false
`limit`	number	50
`simple`	boolean	true
`additionalFields`	collection	{}	keys: `dimensionFiltersUi`, `hideTotals`, `hideValueRanges`, `includeEmptyRows`, `useResourceQuotas`

Parameter	Type	Default	Details
`viewId`	options	""	required
`userId`	string	""	required
`returnAll`	boolean	false
`limit`	number	100
`additionalFields`	collection	{}	keys: `activityTypes`

metricsGA4 children:

metricValues group:

Parameter	Type	Default	Details
`listName`	options	"totalUsers"	`active1DayUsers`, `active28DayUsers`, `active7DayUsers`, `checkouts`, `eventCount`, `screenPageViews`, `userEngagementDuration`, `sessions`, ... (12 total)
`name`	options	"totalUsers"
`name`	string	"custom_metric"
`expression`	string	""
`invisible`	boolean	false

dimensionsGA4 children:

dimensionValues group:

Parameter	Type	Default	Details
`listName`	options	"date"	`browser`, `campaignName`, `city`, `country`, `date`, `deviceCategory`, `itemName`, `language`, ... (11 total)
`name`	options	"date"

additionalFields children:

Parameter	Type	Default	Details
`currencyCode`	string	""
`dimensionFiltersUI`	fixedCollection	{}	groups: `filterExpressions`
`metricAggregations`	multiOptions	[]	multi: `MAXIMUM`, `MINIMUM`, `TOTAL`
`metricsFiltersUI`	fixedCollection	{}	groups: `filterExpressions`
`keepEmptyRows`	boolean	false
`orderByUI`	fixedCollection	{}	groups: `metricOrderBy`, `dimmensionOrderBy`
`returnPropertyQuota`	boolean	false

metricsUA children:

metricValues group:

Parameter	Type	Default	Details
`listName`	options	"ga:users"	`ga:productCheckouts`, `ga:totalEvents`, `ga:pageviews`, `ga:sessionDuration`, `ga:sessions`, `ga:sessionsPerUser`, `ga:users`, `other`, ... (9 total)
`name`	options	"ga:users"
`name`	string	"custom_metric"
`expression`	string	""
`formattingType`	options	"INTEGER"	`CURRENCY`, `FLOAT`, `INTEGER`, `PERCENT`, `TIME`

dimensionsUA children:

dimensionValues group:

Parameter	Type	Default	Details
`listName`	options	"ga:date"	`ga:browser`, `ga:campaign`, `ga:city`, `ga:country`, `ga:date`, `ga:deviceCategory`, `ga:productName`, `ga:language`, ... (11 total)
`name`	options	"ga:date"

NODE "googleAnalytics" @google AS "Google Analytics" {
  resource: "report",
  operation: "get",
  userId: {{ $json.userId }}
}