当你构建一个网站或应用时,了解用户如何与之互动是至关重要的。然而,许多跟踪工具复杂难懂、昂贵,或不关心隐私。这时,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首先,让我们把这个 Pan 加到您的 Laravel 项目里。您可以使用 Composer 来完成这一步。
- 打开你的终端。
- 导航到你的 Laravel 项目文件夹。
- 运行此命令:
在命令行中运行以下命令来安装panphp/pan插件:`` composer require panphp/pan ```
全屏切换,退出全屏
这会把 Pan 安装进你的项目里。
- 现在,请运行下面的命令来设置Pan:
运行以下命令来安装插件:php artisan install:pan
全屏模式 退出全屏
这个命令会帮你搞定所有配置!
第2步 — 跟踪用户行为安装了 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 查看这些数据。
- 打开你的终端。
- 进入你的项目文件夹。
- 运行下面的命令:
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 跟踪的内容Pan跟踪的就是这里:
- Impressions :记录元素的曝光次数。
- Hovers :统计用户在元素上悬停的次数。
- Clicks :统计用户点击元素的次数。
Pan 完全保护隐私——它不收集任何个人数据。
第6步 — 利用数据进行改进通过 Pan 跟踪用户与您的网站互动的方式,您可以使用这些数据来优化您的网站,比如说。
- 如果某个按钮很少被点击,可能需要更多关注或者文字更清楚一些。
- 如果用户在某个元素上悬停但没有点击,可能是因为太困惑了。
- 如果某些部分很少被查看,考虑把它们移动到更显眼的地方。
如果你需要清除潘的追踪记录,这非常简单。
- 打开你的终端。
- 切换到你的项目文件夹。
- 运行此命令:(请根据实际情况调整)
运行此命令来清空所有缓存数据:
php artisan pan:flush
进入全屏模式 退出全屏
这会重置 Pan 的追踪数据,你可以重新开始。
结论部分Pan 工具让您轻松了解用户如何与您的 Laravel 应用交互。
通过添加data-pan
属性并使用Artisan命令,你可以跟踪用户的操作,从而对你网站和应用做出明智的调整。