Skip to main content

Node Inputs

This node does not accept inputs from other nodes.

Node Parameters

Required Fields

Integration: Your Google Analytics integration connection. Must be configured with proper Google Analytics API access. Account: The Google Analytics account to query. Select from the dropdown list of available accounts linked to your integration. Property: The Google Analytics 4 property to retrieve data from. Select from the dropdown list of properties available in the selected account. Metrics: The metrics to include in your analytics report. Default: sessions,activeUsers Available metrics:
MetricDescription
activeUsersNumber of distinct users who visited your site
newUsersNumber of first-time users
totalUsersTotal number of users
sessionsNumber of sessions
engagedSessionsSessions with engagement
averageSessionDurationAverage session length in seconds
sessionsPerUserAverage sessions per user
engagementRatePercentage of engaged sessions
bounceRatePercentage of non-engaged sessions
userEngagementDurationTotal time users were engaged
screenPageViewsTotal number of page views
screenPageViewsPerSessionAverage pages viewed per session
eventCountTotal number of events
conversionsNumber of conversion events
totalRevenueTotal revenue from all sources
ecommercePurchasesNumber of purchases
transactionsNumber of transactions
itemsViewedNumber of items viewed
addToCartsNumber of add to cart events
checkoutsNumber of checkout events
purchaseRevenueRevenue from purchases
Date Range: The time period for the analytics data. Default: last_28_days Available date ranges:
  • today - Current day only
  • yesterday - Previous day
  • last_7_days - Past 7 days
  • last_28_days - Past 28 days
  • last_30_days - Past 30 days
  • last_90_days - Past 90 days
  • last_12_months - Past 12 months
  • this_month - Current month to date
  • last_month - Previous full month
  • this_year - Current year to date
  • last_year - Previous full year
  • personalized - Custom date range (requires start and end dates)

Optional Fields

Dimensions: The dimensions to segment your analytics data by. Available dimensions:
DimensionDescription
Time
dateDate in YYYYMMDD format
dateHourDate and hour combined
monthMonth of the year
weekWeek of the year
yearYear
dayOfWeekDay of the week (0-6)
hourHour of the day (0-23)
Geographic
countryCountry of the user
cityCity of the user
regionRegion/State of the user
continentContinent of the user
Device
deviceCategoryDevice type (desktop, mobile, tablet)
browserBrowser name
operatingSystemOS name
platformPlatform (web, iOS, Android)
mobileDeviceBrandingMobile device manufacturer
screenResolutionScreen resolution
Page
pagePathPage URL path
pageTitlePage title
landingPageFirst page in the session
pagePathPlusQueryStringPage path with query string
hostnameWebsite hostname
Traffic Source
sessionSourceTraffic source for the session
sessionMediumTraffic medium for the session
sessionCampaignNameCampaign name
sessionDefaultChannelGroupDefault channel grouping
firstUserSourceOriginal acquisition source
firstUserMediumOriginal acquisition medium
Other
eventNameName of the event
newVsReturningWhether user is new or returning
userAgeBracketAge bracket of the user
userGenderGender of the user
Start Date: The beginning of a custom date range. Format: YYYY-MM-DD Required when Date Range is set to personalized. Supports variable input: {{startDate}} End Date: The end of a custom date range. Format: YYYY-MM-DD Required when Date Range is set to personalized. Supports variable input: {{endDate}} Row Limit: Maximum number of rows to return in the response. Default: 10000 Range: 1 to 100,000

Node Output

Analytics Data: JSON containing analytics data with the requested metrics and dimensions. Example Output:
{
  "rows": [
    {
      "date": "20241015",
      "sessions": 1250,
      "activeUsers": 980,
      "bounceRate": 0.42,
      "averageSessionDuration": 185.5
    },
    {
      "date": "20241016",
      "sessions": 1340,
      "activeUsers": 1050,
      "bounceRate": 0.38,
      "averageSessionDuration": 210.3
    }
  ],
  "rowCount": 2,
  "metadata": {
    "property": "properties/123456789",
    "dateRange": {
      "startDate": "2024-10-15",
      "endDate": "2024-10-16"
    }
  }
}

Node Functionality

The Google Analytics Reader node:
  • Retrieves analytics data from Google Analytics 4 properties.
  • Supports a wide range of GA4 metrics including user, session, engagement, page view, event, and e-commerce metrics.
  • Allows data segmentation using multiple dimensions.
  • Provides flexible date range options from predefined ranges to custom periods.
  • Supports dynamic date inputs through variables for workflow automation.
  • Enables row limiting to control data volume.

Use Cases

Traffic Analysis: Monitor website traffic trends by tracking sessions, users, and page views over time. User Behavior Insights: Analyze engagement metrics like bounce rate, session duration, and pages per session. Conversion Tracking: Track e-commerce metrics including purchases, revenue, and conversion events. Channel Performance: Segment data by traffic source, medium, and campaign to evaluate marketing effectiveness. Device Analysis: Understand your audience by analyzing traffic across different devices, browsers, and platforms.

Notes

  • This node requires a valid Google Analytics integration with appropriate API permissions.
  • Only Google Analytics 4 (GA4) properties are supported; Universal Analytics properties are not compatible.
  • When using custom date ranges, the start date must be before or equal to the end date.
  • Large date ranges with many dimensions may result in slower response times.
  • Row limits exceeding the available data will return all available rows.

Version History

VersionChanges
1.1Improved UI with autocomplete for accounts, properties, metrics and dimensions
1.0Initial release of Google Analytics 4 Reader