简介
Ember-cli-ahoy是一个 Ember.js 应用程序的追踪解决方案，它可以帮助你收集并监控来自访问者的活动，并提供一个清晰的界面来分析这些数据。
安装
在你的 Ember.js 应用中使用 ember-cli-ahoy 非常简单，只需要在终端中执行以下命令：
ember install ember-cli-ahoy
这会自动从 npm 上下载并安装 ember-cli-ahoy，并在你的应用程序中添加必要的依赖项和配置文件。
配置
一旦你安装了 ember-cli-ahoy，你就需要进行一些基本的配置，以确保它能够正确地工作。
应用程序名称
首先，你需要设置你的应用程序名称，这可以帮助你在 Ahoy 的仪表板中区分不同的应用程序。在 config/environment.js 文件中设置 APP_NAME 的值即可：
var ENV = {
// ...
APP_NAME: 'My Ember App',
// ...
};必需事件
接下来，你需要确定你想收集哪些事件。默认情况下， ember-cli-ahoy 收集了 5 种事件：visit，page，click，submit 和 change。如果你没有特殊要求，可以跳过这一步，否则你可以将这些事件中的任何一个或多个从跟踪中排除。
要排除一个事件，你需要在 config/environment.js 文件中设置一个对象，该对象名为 discardEvents 并包含你想排除的事件的名称。例如：
-- -------------------- ---- -------
--- --- - -
-- ---
------------- -
-------------- -
------ -----
------- ----
-
--
-- ---
--在这个例子中，我们从跟踪中排除了“click”和“submit”事件。
请求路径
Ember-cli-ahoy使用Rails的ahoy.js来记录跟踪数据。在使用Ember-cli-ahoy之前，你需要在你的Rails应用程序中设置Rails的ahoy.js请求路径。
<%= ahoy.trackView %> <%= ahoy.trackVisit %> <%= ahoy.track %>
使用
访问事件
访问事件在用户访问你的应用程序的任意页面时触发。在控制台中，这个事件会被命名为“visit”。
要在你的应用程序中手动跟踪一个访问事件，你需要调用 ember-cli-ahoy 提供的 trackPageview 方法。例如：
-- -------------------- ---- -------
------ ----- ---- -----------------------
------ - ------ -- ------- - ---- -----------------
------ ------- --------------
----- ----------
------------ -
---------------------------------
-
---这段代码将在每次用户访问应用程序的一个新页面时跟踪一个访问事件。
点击事件
点击事件在用户点击页面上的任何可单击的元素时触发。在控制台中，这个事件会被命名为“click”。
要在你的应用程序中手动跟踪一个点击事件，你需要在你想要跟踪的元素上添加一个事件处理程序，该处理程序将调用 trackClick 方法并提供有关该事件的元素信息。例如：
<button {{action "doSomething" }} {{on "click" (track-click)}}>Do something</button>-- -------------------- ---- -------
------ --------- ---- -------------------
------ - ------ -- ------- - ---- -----------------
------ ------- ------------------
----- ----------
-------- -
------------- -
-- -- ---------
-
-
---提交事件
提交事件发生在用户提交一个表单时。在控制台中，这个事件会被命名为“submit”。
要在你的应用程序中手动跟踪一个提交事件，你需要在你想要跟踪的表单上添加一个事件处理程序，该处理程序将调用 trackSubmit 方法并提供有关提交的表单信息。例如：
<form {{on "submit" (track-submit)}}>
<!-- Form inputs -->
<button type="submit">Submit</button>
</form>-- -------------------- ---- -------
------ --------- ---- -------------------
------ - ------ -- ------- - ---- -----------------
------ ------- ------------------
----- ----------
-------- -
------------ -
-- ------ ---- ----------
-------------------------------------------
-
-
---使用仪表板
一旦你的应用程序开始跟踪事件，你就可以使用 Ahoy 的仪表板来查看和分析跟踪数据。要访问仪表板，只需使用你的应用程序名称作为子域名访问 ahoy.newrelic.com 即可。例如，如果你的应用程序名称为“my-ember-app”，则可以访问 my-ember-app.ahoy.newrelic.com。
你可以使用仪表板来查看有关所有已跟踪事件的有趣统计信息，包括访问次数、页面停留时间、用户地理位置、设备信息等等。这些信息可帮助你了解你的用户如何使用你的应用，并将有助于你进行优化和改进。
结论
Ember-cli-ahoy 是一个非常强大和灵活的应用追踪解决方案，它可以方便地集成到你的 Ember.js 应用程序中，并为你提供了一个清晰且易于使用的仪表板，以帮助你收集、分析和理解有关你的用户和应用程序的数据。我强烈建议你考虑在你的下一个 Ember.js 项目中使用 ember-cli-ahoy。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005596b81e8991b448d6f05