README

Google Analytics 与 Nova 集成

安装

您可以使用 composer 将此包安装到使用 Nova 的 Laravel 应用程序中

composer require tightenco/nova-google-analytics

目前，请按照 Spatie 的 Laravel Google Analytics 包中的说明获取凭证，然后将它们放在这里

yourapp/storage/app/analytics/service-account-credentials.json

同时，将以下内容添加到您的 Nova 应用程序的 .env 文件中

ANALYTICS_PROPERTY_ID=

升级到 4.0

版本 4.0 使用新的 Google Analytics 4 数据 API。

将 spatie/laravel-analytics 升级到 v5.2
- 停止支持 PHP 8.0
- 停止支持 Laravel 9
移除 GA4 中不可用的 FourteenDayActiveUsersMetric 指标

所需环境变量 ANALYTICS_VIEW_ID 已重命名为 ANALYTICS_PROPERTY_ID 以符合 Google 的使用。

用法

您必须使用 Nova 注册您想要显示的卡片。这通常在 Main 仪表板的 cards 方法中完成。

// in app/Nova/Dashboards/Main.php

// ...

public function cards()
{
    return [
        // ...
        new \Tightenco\NovaGoogleAnalytics\PageViewsMetric,
        new \Tightenco\NovaGoogleAnalytics\VisitorsMetric,
        new \Tightenco\NovaGoogleAnalytics\MostVisitedPagesCard,
        new \Tightenco\NovaGoogleAnalytics\ReferrersList,
        new \Tightenco\NovaGoogleAnalytics\OneDayActiveUsersMetric,
        new \Tightenco\NovaGoogleAnalytics\SevenDayActiveUsersMetric,
        new \Tightenco\NovaGoogleAnalytics\TwentyEightDayActiveUsersMetric,
        new \Tightenco\NovaGoogleAnalytics\SessionsMetric,
        new \Tightenco\NovaGoogleAnalytics\SessionDurationMetric,
        new \Tightenco\NovaGoogleAnalytics\SessionsByDeviceMetric,
        new \Tightenco\NovaGoogleAnalytics\SessionsByCountryMetric,
    ];
}

在您的 NovaServiceProvider 的 tools 方法中与 Nova 注册工具

// in app/Providers/NovaServiceProvider.php

// ...

public function tools()
{
    return [
        new Tightenco\NovaGoogleAnalytics\Tool(),
    ];
}

功能

查看访问者和页面浏览量指标

查看活跃用户指标

查看会话和平均会话时长指标

按会话查看设备和国家指标

查看最常访问的页面和推荐者的列表

测试

首先，将您的 .env.example 文件复制到一个名为 .env.testing 的新文件中

cp .env.example .env.testing

确保在该文件中定义以下变量以运行所有测试

ANALYTICS_PROPERTY_ID
ANALYTICS_PROJECT_ID
ANALYTICS_PRIVATE_KEY_ID
ANALYTICS_PRIVATE_KEY
ANALYTICS_CLIENT_EMAIL_KEY
ANALYTICS_CLIENT_ID
ANALYTICS_CLIENT_CERT_URL

将 .env.testing 文件添加到 .gitignore 中，以便您可以安全地使用与卡片相同的分析视图 ID 运行测试。

贡献

有关详细信息，请参阅 CONTRIBUTING

安全

如果您发现任何安全问题，请通过电子邮件 matt@tighten.co 而不是使用问题跟踪器来报告。

致谢

支持我们

Tighten 是一家从事 Laravel、Vue 和 React 的网络开发公司。您可以在我们的网站上了解更多关于我们的信息

许可

MIT 许可证 (MIT)。有关更多信息，请参阅许可文件

tightenco / nova-google-analytics

维护者

详细信息