Ahoy.js 开源项目教程
ahoy.jsSimple, powerful JavaScript analytics项目地址:https://gitcode.com/gh_mirrors/ah/ahoy.js
1、项目介绍
Ahoy.js 是一个简单而强大的 JavaScript 分析库,用于跟踪网站的访问和事件。它可以帮助开发者轻松地跟踪唯一访问者、跨页面导航的事件,并且可以与任何后端集成。对于使用 Rails 的开发者,还可以结合 Ahoy gem 使用。
2、项目快速启动
安装
你可以通过以下方式安装 Ahoy.js:
yarn add ahoy.js
引入和初始化
在你的页面中引入 Ahoy.js:
<script src="path/to/ahoy.js"></script>
或者通过模块导入:
import ahoy from 'ahoy.js';
基本配置
以下是默认配置:
ahoy.configure({
urlPrefix: "",
visitsUrl: "/ahoy/visits",
eventsUrl: "/ahoy/events",
page: null,
platform: "Web",
useBeacon: true,
startOnReady: true,
trackVisits: true,
cookies: true,
cookieDomain: null,
headers: {},
visitParams: {},
withCredentials: false,
visitDuration: 4 * 60, // 4 hours
visitorDuration: 2 * 365 * 24 * 60 // 2 years
});
示例代码
// 强制一个新的访问
ahoy.reset();
// 开启调试模式
ahoy.debug();
// 关闭调试模式
ahoy.debug(false);
3、应用案例和最佳实践
跟踪页面视图
ahoy.trackView();
跟踪点击事件
ahoy.trackClicks("#link1, #link2");
跟踪表单提交
ahoy.trackSubmits("#form1, #form2");
跨子域名跟踪
ahoy.configure({ cookieDomain: "yourdomain.com" });
4、典型生态项目
Ahoy.js 可以与多种后端服务集成,例如:
- Rails: 结合 Ahoy gem 使用,可以更方便地在 Rails 应用中进行分析。
- Node.js: 可以与 Express 等框架集成,实现后端的事件处理和数据存储。
- 其他后端服务: 通过自定义 API 接口,可以与任何后端服务集成。
通过这些集成,开发者可以构建完整的分析系统,实现用户行为分析、事件跟踪等功能。
ahoy.jsSimple, powerful JavaScript analytics项目地址:https://gitcode.com/gh_mirrors/ah/ahoy.js