如何在 Laravel 项目中轻松使用这款插件 Pan 进行数据分析

当你构建一个网站或应用时，了解用户如何与之互动是至关重要的。然而，许多跟踪工具复杂难懂、昂贵，或不关心隐私。这时，Pan 就派上用场了。Pan 是一个由 Laravel 团队成员 Nuno Maduro 和 David Hill 创建的简单、隐私友好的行为追踪工具，专为你的 Laravel 应用设计。

在本指南中，我将向您展示如何将Pan整合进您的Laravel项目，并跟踪查看、悬停和点击等操作，同时不会从您的用户那里收集个人数据。

在我们开始之前，请确保你已经准备好以下这些：

• PHP 8.3 或更高版本
• 一个设置好的 Laravel 11+ 项目
• 安装了 Composer（用于管理项目的依赖项）

看看由 Josh Cirre 制作的介绍视频：[Josh Cirre](https://x.com/joshcirre)

首先，让我们把这个 Pan 加到您的 Laravel 项目里。您可以使用 Composer 来完成这一步。

1. 打开你的终端。
2. 导航到你的 Laravel 项目文件夹。
3. 运行此命令：

在命令行中运行以下命令来安装panphp/pan插件:`` composer require panphp/pan ```

全屏切换，退出全屏

这会把 Pan 安装进你的项目里。

1. 现在，请运行下面的命令来设置Pan：

运行以下命令来安装插件：php artisan install:pan

全屏模式 退出全屏

这个命令会帮你搞定所有配置！

安装了 Pan 之后，你现在可以追踪网站里特定的部分了。Pan 用 data-pan 属性来标记并追踪这些特定元素。

例如，如果你想跟踪某人何时点击或悬停在“注册”按钮上，你需要添加如下内容：

onclick="你的跟踪代码"
onmouseover="你的跟踪代码"

    <button data-pan="sign-up-button">注册</button>

全屏模式, 退出全屏

这里有更多的例子，

    <div data-pan="hero-section">欢迎来到我们的网站！希望您在这里玩得开心！</div>
    <a data-pan="learn-more-link" href="/about">了解更多详情</a>
    <form data-pan="contact-form">
      <!--  your form fields here -->
      <!-- 请在此处填写表单字段，例如：姓名，电子邮件，留言等 -->
    </form>

进入全屏，退出全屏

这些元素的展示、悬停和点击将会被自动跟踪！

现在 Pan 正在追踪你的元素数据，你可以用 Artisan 查看这些数据。

1. 打开你的终端。
2. 进入你的项目文件夹。
3. 运行下面的命令：

php artisan pan

这是一个PHP命令，用于运行特定的Artisan命令。

全屏；切换回正常模式

你将获得一个表格，显示每个元素的浏览次数、鼠标悬停次数和点击次数。

如果你想检查某个特定元素，可以这样做：（具体步骤）

php artisan pan --filter=sign-up 按钮

进入全屏模式，退出全屏模式

把 sign-up-button 改成你要跟踪的元素。

注：如果“Pan”不是特定技术术语，可以省略解释，直接作为步骤呈现。

默认情况下，Pan 会跟踪最多 50 个元素，但如有需要，可以修改。要自定义 Pan 的设置，请在 AppServiceProvider.php 文件中进行相应的修改。

use Pan\PanConfiguration;

public function 登记(): void
{
    // 跟踪特定元素（如注册按钮和联系表单）
    PanConfiguration::允许分析元素([
        'sign-up-button',
        'contact-form',
    ]);

    // 或增加限制
    // PanConfiguration::最大分析数(10000);

    // 或完全取消限制
    // PanConfiguration::无限制分析数();
}

全屏显示 退出全屏

Pan跟踪的就是这里：

1. Impressions ：记录元素的曝光次数。
2. Hovers ：统计用户在元素上悬停的次数。
3. Clicks ：统计用户点击元素的次数。

Pan 完全保护隐私——它不收集任何个人数据。

通过 Pan 跟踪用户与您的网站互动的方式，您可以使用这些数据来优化您的网站，比如说。

• 如果某个按钮很少被点击，可能需要更多关注或者文字更清楚一些。
• 如果用户在某个元素上悬停但没有点击，可能是因为太困惑了。
• 如果某些部分很少被查看，考虑把它们移动到更显眼的地方。

如果你需要清除潘的追踪记录，这非常简单。

1. 打开你的终端。
2. 切换到你的项目文件夹。
3. 运行此命令：（请根据实际情况调整）

运行此命令来清空所有缓存数据：

php artisan pan:flush

进入全屏模式 退出全屏

这会重置 Pan 的追踪数据，你可以重新开始。

Pan 工具让您轻松了解用户如何与您的 Laravel 应用交互。

通过添加data-pan属性并使用Artisan命令，你可以跟踪用户的操作，从而对你网站和应用做出明智的调整。