Filament Google Analytics 使用教程
1. 项目介绍
Filament Google Analytics
是一个用于将 Google Analytics 集成到 FilamentPHP 应用中的开源项目。通过这个项目,开发者可以轻松地将 Google Analytics 的数据展示在 Filament 管理面板中,从而实时监控网站的访问情况。
该项目支持多种 Google Analytics 数据的可视化展示,包括页面浏览量、访问者数量、活跃用户、会话数等。此外,它还提供了自定义配置选项,允许开发者根据需求启用或禁用特定的数据展示组件。
2. 项目快速启动
安装
首先,确保你已经有一个使用 FilamentPHP 的 Laravel 应用。然后,通过 Composer 安装 Filament Google Analytics
包:
composer require bezhansalleh/filament-google-analytics
配置
安装完成后,你需要获取 Google Analytics 的凭证,并将其放置在应用的存储目录中。具体步骤如下:
- 按照 Spatie's Laravel Google Analytics 包 的指引获取凭证。
- 将凭证文件放置在
yourapp/storage/app/analytics/service-account-credentials.json
。 - 在
.env
文件中添加以下配置:
ANALYTICS_PROPERTY_ID=your-analytics-property-id
发布配置文件
接下来,发布配置文件并进行自定义设置:
php artisan vendor:publish --tag=filament-google-analytics-config
启用组件
默认情况下,所有组件都会在 Google Analytics 仪表板中启用。你可以在配置文件中启用或禁用特定的组件。以下是一些可用的组件:
\BezhanSalleh\FilamentGoogleAnalytics\Widgets\PageViewsWidget::class,
\BezhanSalleh\FilamentGoogleAnalytics\Widgets\VisitorsWidget::class,
\BezhanSalleh\FilamentGoogleAnalytics\Widgets\ActiveUsersOneDayWidget::class,
\BezhanSalleh\FilamentGoogleAnalytics\Widgets\ActiveUsersSevenDayWidget::class,
\BezhanSalleh\FilamentGoogleAnalytics\Widgets\ActiveUsersTwentyEightDayWidget::class,
\BezhanSalleh\FilamentGoogleAnalytics\Widgets\SessionsWidget::class,
3. 应用案例和最佳实践
应用案例
假设你正在开发一个电子商务网站,并希望实时监控用户的访问情况。通过 Filament Google Analytics
,你可以轻松地将 Google Analytics 的数据集成到 Filament 管理面板中,从而实时查看用户的访问量、活跃用户数、会话时长等关键指标。
最佳实践
- 定期检查数据:建议定期检查 Google Analytics 的数据,以便及时发现异常情况。
- 自定义配置:根据业务需求,自定义配置文件,启用或禁用特定的数据展示组件。
- 数据备份:定期备份 Google Analytics 的凭证文件,以防数据丢失。
4. 典型生态项目
Laravel Analytics by Spatie
Laravel Analytics
是 Spatie 提供的一个 Laravel 包,用于与 Google Analytics API 进行交互。Filament Google Analytics
依赖于这个包来获取 Google Analytics 的数据。
FilamentPHP
FilamentPHP
是一个现代化的 Laravel 管理面板框架,提供了丰富的组件和工具,帮助开发者快速构建管理面板。Filament Google Analytics
是 FilamentPHP 生态系统中的一个重要组件,用于集成 Google Analytics 数据。
通过这些生态项目,开发者可以构建一个功能强大且易于维护的管理面板,实时监控网站的访问情况。