ga-tracker-snippet 是一个能够将 Google Analytics (GA) 跟踪代码嵌入网站的 npm 包。本文将介绍如何使用该包来为您的网站添加 GA 跟踪功能。
安装
在开始之前，请确保您已经安装了 Node.js 和 npm。然后可以通过以下命令来安装 ga-tracker-snippet：
npm install ga-tracker-snippet --save
使用
基础用法
安装完成后，您可以在您的 JavaScript 文件中导入并使用 ga-tracker-snippet。以下是一些简单的示例：
import gaTrackerSnippet from 'ga-tracker-snippet';
// 初始化 GA 跟踪代码
gaTrackerSnippet('UA-XXXXXXXX-X');
// 发送页面浏览事件
ga('send', 'pageview');上述示例中的 'UA-XXXXXXXX-X' 是您的 GA 跟踪 ID。这个 ID 可以在您的 GA 控制台中找到。通过调用 gaTrackerSnippet 并传递该 ID，您就可以初始化 GA 跟踪代码了。然后，您可以使用 ga 全局对象来发送事件和跟踪行为。
选项
您还可以指定一些选项来自定义 GA 跟踪代码的行为。以下是 gaTrackerSnippet 函数的参数列表：
function gaTrackerSnippet(trackingId, options) {
// ...
}其中，trackingId 是必需的参数，而 options 是可选的。以下是所有可用的选项及其默认值：
-- -------------------- ---- ------- - ------------- ------- ------------ ------ ------------ ------ --------- ----- ----- ----- ------- ----- ---------------- ----- ---------------- ----- -
要自定义这些选项，您可以将选项对象传递给 gaTrackerSnippet 函数。例如，要使用自定义的 cookie 域，请执行以下操作：
import gaTrackerSnippet from 'ga-tracker-snippet';
// 初始化 GA 跟踪代码，并配置 cookie 域
gaTrackerSnippet('UA-XXXXXXXX-X', {
cookieDomain: 'example.com',
});高级用法
除了基本用法之外，ga-tracker-snippet 还提供了一些更高级的用法。
使用多个跟踪器
如果您需要在同一个页面上使用多个 GA 跟踪器，则可以调用 gaTrackerSnippet 函数多次：
-- -------------------- ---- ------- ------ ---------------- ---- --------------------- -- ------ -- --- ---------------------------------- -- ------ -- --- --------------------------------- - ----- ------------ --- -- ----------- ---------- -------- ----------- --------- --------- -- ----------- ----------------- -------- ----------- --------- ---------
上述示例中初始化了两个 GA 跟踪器。第一个使用默认的名称 'ga'，而第二个使用自定义名称 'myTracker'。要发送事件到不同的跟踪器，请在调用 ga 对象时使用相应的跟踪器名称。
使用 Universal Analytics
如果您正在使用 Universal Analytics（分析.js），则可以通过指定 trackingOptions 选项来配置一些高级功能。例如，要启用 Enhanced Ecommerce 功能，请执行以下操作：
-- -------------------- ---- -------
------ ---------------- ---- ---------------------
-- --- --------- ---------
--------------------------------- -
---------------- -
----- -----
------- ----------
-------------------- ----
------------- --------------
------------------- -----
- ----------------------------------------------------------- --------
----------------------------------------------------------------------------------