外掛說明
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
螢幕擷圖
Dashboard (KPIs, chart toggle, top pages, devices, traffic sources). 
Settings page (OAuth credentials, connect/disconnect, property selection).
安裝方式
- Upload the plugin folder to /wp-content/plugins/ or install via Plugins > Add New (when published).
- Activate the plugin.
- Go to Client Report in the admin menu.
- Go to Settings > Client Report and add your Google OAuth Client ID and Client Secret.
- In Google Cloud Console, add the Redirect URI shown in Settings as an Authorized redirect URI.
- Click Connect Google Analytics, complete the consent screen, then select a GA4 Property.
常見問題集
-
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_settingsoption. 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.
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
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