#Filament Metrics GA4

Google Analytics 4 dashboard widgets for Filament, with a settings page powered by Spatie Laravel Settings to manage the GA4 property ID and service account key directly from the admin panel.

Built on top of jeffersongoncalves/laravel-metrics-ga4 (GA4 Data API, service account auth).

#Compatibility

#Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-metrics-ga4:"^3.0"

Publish the settings migrations and run them:

php artisan vendor:publish --tag=metrics-ga4-settings-migrations
php artisan migrate

#Google Cloud setup

1. Enable the Google Analytics Data API in a Google Cloud project.
2. Create a service account and download its JSON key.
3. In Google Analytics, Admin → Property access management: add the service account's client_email as Viewer.
4. Copy the numeric Property ID from Admin → Property details.

#Usage

Add the plugin to your Filament panel provider:

use JeffersonGoncalves\Filament\MetricsGA4\GA4MetricsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            GA4MetricsPlugin::make(),
        ]);
}

Then open Settings > Google Analytics in your panel, fill in the property ID and paste the service account JSON key (stored encrypted).

#Widgets

All widgets cover the last 30 days and are cached (15s for realtime, 5 minutes for the rest):

#Customization

GA4MetricsPlugin::make()
    ->settingsPage(false) // hide the settings page
    ->widgets(false),     // don't register the dashboard widgets

With widgets(false) you can still place the widget classes on any page yourself.

#Requirements

• PHP 8.2 or higher (with the OpenSSL extension)
• Filament 5.x

#Testing

composer test

#Changelog

Please see CHANGELOG for more information on what has changed recently.

#Contributing

Please see CONTRIBUTING for details.

#Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

#Credits

• Jèfferson Gonçalves
• All Contributors

#License

The MIT License (MIT). Please see License File for more information.