创建跟踪器

跟踪器对象(也称为“跟踪器”)指的是可以收集和存储数据并将这些数据发送给 Google Analytics(分析)的对象。

在创建新的跟踪器时,您必须指定一个跟踪 ID [与对应您的 Google Analytics(分析)媒体资源的“媒体资源 ID”相同] 和一个 Cookie 网域(指定如何存储 Cookie,推荐值 'auto' 表示自动配置 Cookie 网域。)

如果指定的网域无对应的 Cookie,那么会系统会生成一个客户端 ID 并将其存储在新创建的 Cookie 中,同时将相应用户识别为“新”用户。如果存在包含客户端 ID 值的 Cookie,则系统会在跟踪器中设置该客户端 ID,并将相应用户识别为“回访”用户。

创建跟踪器后,这些对象还会收集关于当前浏览上下文的信息(例如页面标题和网址)、关于设备的信息(例如屏幕分辨率、视口尺寸)以及文档编码。当需要向 Google Analytics(分析)发送数据时,跟踪器对象会将自身当前存储的所有信息发送出去。

create 方法

analytics.js 库提供了多种创建跟踪器的方式,最常见的方式是使用 create 命令,并将跟踪 IDCookie 网域字段分别作为第二个和第三个参数传递给该命令:

ga('create', 'UA-XXXXX-Y', 'auto');

为跟踪器命名

您还可以选择为跟踪器命名,方法是将 name 字段作为第四个参数传递给 create 命令。如果您需要为相同页面创建多个跟踪器,就有必要对跟踪器进行命名。如需详细了解为何可能需要创建多个跟踪器,请参阅下面的使用多个跟踪器部分。

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

在未设置 name 字段的情况下创建的跟踪器也称为“默认”跟踪器。默认跟踪器具有内部名称“t0”。

在创建时指定字段值

您还可以选择传递字段对象,通过这种方式可以在创建时设置任何 analytics.js 字段,以便将这些字段存储在跟踪器中并应用于所有要发送的命中。

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
  userId: '12345'
});

与对 ga() 函数的所有调用一样,也可使用字段对象一次指定所有字段:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto',
  name: 'myTracker',
  userId: '12345'
});

如需了解更为全面的详细信息,请参阅 create 方法参考。

使用多个跟踪器

在一些情况下,您可能想要从单个页面发送数据到多个媒体资源。这对由多名负责人分别管理各个版块的网站非常有用;每名负责人都可以查看自己的媒体资源。

要为两个不同的媒体资源跟踪数据,需要创建两个不同的跟踪器,并且至少其中一个必须是已命名的跟踪器。以下两条命令分别创建了一个默认跟踪器和一个名为“clientTracker”的跟踪器:

ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');

针对特定跟踪器执行命令

要针对特定跟踪器执行 analytics.js 命令,需要将跟踪器名称加英文句点用作命令名称的前缀。如果不指定跟踪器名称,系统就会针对默认跟踪器执行命令。

要让上述两个跟踪器发送网页浏览量数据,需要执行以下两条命令:

ga('send', 'pageview');
ga('clientTracker.send', 'pageview');

我们以后会发布相应的指南,详细介绍用于执行特定命令的语法。您也可以参阅命令队列参考,了解所有 analytics.js 命令的完整命令语法。

后续步骤

创建跟踪器后,您可能需要访问存储在该跟踪器对象中的数据。下一篇指南介绍如何获取和设置跟踪器数据