Cliredas – Client Dashboard for Google Analytics (GA4)

Aprašymas

Adds a clean, client-friendly Google Analytics 4 (GA4) dashboard inside the WordPress admin.

Use it to show key GA4 performance metrics without sending clients to the GA4 interface.

Key Features

  • Connect Google Analytics 4 via OAuth (no service account needed)
  • Select your GA4 Property from a dropdown
  • Dashboard KPIs: Sessions, Total users, Pageviews, Avg engagement time
  • Toggle line chart between Sessions over time and Total users over time
  • Top pages table with Sessions, Views, and Avg engagement time per page
  • Device breakdown (desktop / mobile / tablet)
  • Traffic sources breakdown (Organic Search / Direct / Referral / Social / Other)
  • Built-in caching (default 15 minutes) for fast dashboards and fewer API calls
  • Clear Cache button (forces a fresh fetch on the next load)
  • Optional access control: allow Editors to view the dashboard

External Services

The plugin does not send analytics data anywhere except Google APIs and your WordPress site.

When enabled and connected, the plugin sends requests to:
* Google OAuth 2.0 endpoints (to authorize and refresh access): https://accounts.google.com/ and https://oauth2.googleapis.com/
* Google Analytics Admin API (to list properties): https://analyticsadmin.googleapis.com/
* Google Analytics Data API (to fetch reports): https://analyticsdata.googleapis.com/

Data sent includes your OAuth client credentials (Client ID + Client Secret), authorization codes, refresh/access tokens, and API request parameters (selected property, date range, requested dimensions/metrics).

These requests are only made when an authorized WordPress admin user connects GA4 and when the dashboard needs to load or refresh data.

Google privacy policy: https://policies.google.com/privacy

Ekrano nuotraukos

  • Dashboard (KPIs, chart toggle, top pages, devices, traffic sources).
  • Settings page (OAuth credentials, connect/disconnect, property selection).

Diegimas

  1. Upload the plugin folder to /wp-content/plugins/ or install via Plugins > Add New (when published).
  2. Activate the plugin.
  3. Go to Client Report in the admin menu.
  4. Go to Settings > Client Report and add your Google OAuth Client ID and Client Secret.
  5. In Google Cloud Console, add the Redirect URI shown in Settings as an Authorized redirect URI.
  6. Click Connect Google Analytics, complete the consent screen, then select a GA4 Property.

DUK

Does this connect to Google Analytics 4?

Yes. Use Settings > Client Report to connect GA4 via OAuth and select a property.

Why does Google block my redirect URI on a local domain?

Google OAuth redirect URIs must use a public top-level domain (e.g. .com, .org). For local development, use a public tunnel (e.g. ngrok) or a real domain.

Does this plugin store tokens/secrets in the database?

Yes. OAuth credentials and tokens are stored in the WordPress options table under the cliredas_settings option. The plugin never displays your saved client secret back in the UI.

Can Editors see the dashboard?

Yes. Enable the option in Settings > Client Report.

Atsiliepimai

Įskiepis neturi atsiliepimų.

Programuotojai ir komandos nariai

“Cliredas – Client Dashboard for Google Analytics (GA4)” yra atviro kodo programa. Prie jos sukūrimo prisidėję žmonės surašyti toliau.

Autoriai

Pakeitimų istorija

1.0.0

  • GA4 OAuth connect + disconnect
  • GA4 property listing + selection
  • Real GA4 dashboard data (Data API)
  • Dashboard improvements: chart toggle, pageviews KPI, traffic sources, caching + clear cache