Analytics

Über

Das Plugin bringt Google Analytics 4-Daten direkt in das Payload CMS v3-Admin. Die Funktion `analyticsPlugin()` registriert eine Dashboard-Ansicht unter `/admin/analytics` und REST-Endpunkte unter `/api/analytics/*`. Diese Endpunkte lesen Berichte aus der GA4 Data API über ein Google Service Account. Analytics-Daten werden nicht in der Datenbank gespeichert, GA4 bleibt die alleinige Wahrheitsquelle. Die Client-Seite besteht aus einem React-Provider. `AnalyticsProvider` in Kombination mit `ga4Provider()` umschließt das Frontend, injiziert `gtag.js` und trackt `page_view`-Events beim initialen Laden und bei jedem Routenwechsel. Die Komponenten `Track`, `TrackPage` und `TrackLeadAction` sowie der Hook `useAnalytics` erlauben das Feuern von Engagement-Events und `lead_action`-Konversions-Events. Lead-Action-Typen sind konfigurierbar (z.B. `phone_click`, `email_click`, `form_submit`). Das Dashboard zeigt KPIs, Traffic-Trends, top Seiten, Quellen, Events, Geräte, Geografie, Sitzungen und Journeys sowie einen Lead-Actions-Tab. Ein optionaler A/B-Tab integriert das Schwester-Paket `@focus-reactive/payload-plugin-ab`. Das Dashboard-Layout ist über Custom Blocks erweiterbar, und der Endpunkt-Zugriff lässt sich über eine Access-Funktion konfigurieren. Ein Mock-Modus ermöglicht die lokale Entwicklung am Dashboard ohne GA4-Anfragen. Für die Einrichtung werden eine GA4 Property ID, eine Measurement ID und Service Account-Credentials benötigt. Ereignisbezogene Custom Dimensions (`fr_session_id`, `fr_lead_type` u.a.) und die Custom Metric `fr_elapsed_ms` müssen in GA4 registriert sein, damit das Dashboard Daten anzeigt.

Paketinformationen

Paketname

@focus-reactive/payload-plugin-analytics

Neueste Version

1.2.2

Entpackte Größe

1,5 MB

Lizenz

MIT

Wöchentliche Downloads

568

Zuletzt veröffentlicht

8. Juli 2026