Flowcourier.Umbraco.GoogleAnalytics 17.5.0-alpha.2

Flowcourier.Umbraco.GoogleAnalytics

Google Analytics 4 inside the Umbraco backoffice. The Google Analytics provider for Flowcourier.Umbraco.Analytics.Core (installed automatically). Editors get the numbers where they work — no Google login, no context switch:

• An Analytics section with five dashboards: Realtime (who is on the site right now), Visitors (traffic over time, countries, regions, cities), Behaviour (pages, landing pages), Acquisition (channels, referrers, search engines, social networks, campaigns, AI assistants) and Technology (devices, browsers, operating systems, screen resolutions, device models).
• An Analytics tab on every document: that page's pageviews, visits, engaged time, bounce rate and entrances with previous-period comparison, a daily chart, where its visitors came from, which pages they came from and went to next, and their locations and devices.
• A shared date-range control on every date-ranged view, and a live visitor count on the Analytics section in the top bar.
• Optional PageSpeed Insights and Google Search Console views on the same document tab (plus a Search queries dashboard) — configured in the core package's Flowcourier:Analytics section, using the same service account.

Everything is read live from your GA4 property through the Google Analytics Data API. The package stores nothing, adds no database tables and uses no Google SDK.

This is the successor to the legacy Flowcourier.Umbraco.Analytics package (Umbraco 10–13). See Migrating from the legacy package below.

Requirements

• Umbraco 17.5 or later (net10.0)
• A GA4 property and a Google Cloud service account with the Google Analytics Data API enabled (the Admin API too, optionally, for the property name and site URL)
• The service account added as a Viewer on the property

Install

dotnet add package Flowcourier.Umbraco.GoogleAnalytics --prerelease

Configure

{
  "Flowcourier": {
    "GoogleAnalytics": {
      "PropertyId": "123456789",
      "SiteUrl": "https://www.example.com"
    },
    "Analytics": {
      "Google": {
        "ServiceAccountJsonPath": "/secrets/ga-service-account.json"
      }
    }
  }
}

The service-account key lives under Flowcourier:Analytics:Google (ServiceAccountJson inline or ServiceAccountJsonPath) — the same key Search Console uses. It is only ever sent to Google; the settings page shows the account's e-mail, never the key. Prefer the environment variable Flowcourier__Analytics__Google__ServiceAccountJsonPath over committing a path.

Setting up the service account

1. In Google Cloud, create (or reuse) a service account and download a JSON key. Enable Google Analytics Data API and Google Analytics Admin API for the project.
2. In Google Analytics, open Admin → Property → Property access management and add the service account's e-mail as a Viewer.
3. Put the key path (or the JSON) under Flowcourier:Analytics:Google and the property id under Flowcourier:GoogleAnalytics:PropertyId. Restart.

Settings → Flowcourier → Google Analytics shows the effective configuration and the e-mail to add.

What differs from the Matomo provider

GA4's API reports aggregates, never individual visits. The views are the same; these parts are empty or absent on a Google Analytics site:

Dates are the property's time zone. A full walk through the backoffice costs roughly 40 API requests; the standard quota is 200 000 tokens a day, and the cache keeps a busy team well inside it.

Migrating from the legacy package

The legacy Flowcourier.Umbraco.Analytics package kept its connection in a database table and its licence in a .lic file. This package reads configuration only, and needs no licence key:

1. Uninstall Flowcourier.Umbraco.Analytics and Flowcourier.Umbraco.Backoffice.Assets.
2. Move the service-account JSON you pasted into the old connection screen to Flowcourier:Analytics:Google:ServiceAccountJson (or a file path), and the property id to Flowcourier:GoogleAnalytics:PropertyId.
3. Install this package. The Flowcourier_ServiceConnections table is not read and can be dropped.
4. Delete umbraco/Licenses/flowcourier-analytics.lic. All traffic reports are free; AI Visibility (Analytics Pro) is the family's paid feature and takes a Flowcourier:Licenses:AnalyticsPro key.

License

Free to use under the Flowcourier License 1.0 (see the repository). Paid Pro features and consulting are available from Flowcourier ApS.