Autotrack 开源项目使用教程

1. 项目的目录结构及介绍

Autotrack 项目的目录结构如下：

autotrack/
├── dist/
│   ├── autotrack.js
│   ├── autotrack.js.map
│   └── ...
├── docs/
│   ├── advanced-configuration.md
│   ├── custom-builds.md
│   └── ...
├── src/
│   ├── plugins/
│   │   ├── eventTracker.js
│   │   ├── outboundLinkTracker.js
│   │   └── ...
│   ├── autotrack.js
│   └── ...
├── test/
│   ├── plugins/
│   │   ├── eventTracker.test.js
│   │   ├── outboundLinkTracker.test.js
│   │   └── ...
│   └── ...
├── .gitignore
├── .npmignore
├── .travis.yml
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── package.json
└── ...

目录介绍：

• dist/：包含编译后的文件，如 autotrack.js 和其源映射文件。
• docs/：包含项目的文档，如高级配置和自定义构建的说明。
• src/：包含项目的源代码，特别是 plugins/ 目录下包含各个插件的源代码。
• test/：包含项目的测试文件，特别是 plugins/ 目录下包含各个插件的测试文件。
• .gitignore：指定 Git 忽略的文件和目录。
• .npmignore：指定 npm 忽略的文件和目录。
• .travis.yml：Travis CI 的配置文件。
• CONTRIBUTING.md：贡献指南。
• LICENSE：项目的许可证。
• README.md：项目的介绍和使用说明。
• package.json：项目的 npm 配置文件，包含依赖和脚本。

2. 项目的启动文件介绍

Autotrack 的启动文件是 src/autotrack.js。这个文件是项目的入口点，负责加载和初始化各个插件。

启动文件内容概述：

// src/autotrack.js
import 'autotrack/lib/plugins/eventTracker';
import 'autotrack/lib/plugins/outboundLinkTracker';
import 'autotrack/lib/plugins/urlChangeTracker';
// 其他插件的导入

// 初始化代码

3. 项目的配置文件介绍

Autotrack 的配置文件主要是 package.json 和各个插件的配置选项。

package.json 配置文件：

{
  "name": "autotrack",
  "version": "2.4.1",
  "description": "Automatic and enhanced Google Analytics tracking for common user interactions on the web",
  "main": "dist/autotrack.js",
  "scripts": {
    "build": "rollup -c",
    "test": "karma start"
  },
  "dependencies": {
    "analytics.js": "^2.9.1"
  },
  "devDependencies": {
    "rollup": "^1.27.8",
    "karma": "^4.4.1",
    "jasmine": "^3.5.0"
  },
  "repository": {
    "type": "git",
    "url": "git+https://github.com/googleanalytics/autotrack.git"
  },
  "keywords": [
    "analytics",
    "google-analytics",
    "autotrack"
  ],
  "author": "Philip Walton",
  "license": "Apache-2.0",
  "bugs": {
    "url": "https://github.com/googleanalytics/autotrack/issues"
  },
  "homepage": "https://github.com/googleanalytics/autotrack#readme"
}

插件配置选项：

每个插件都有自己的配置选项，可以在项目的文档中找到详细说明。例如，eventTracker 插件的配置选项可以在 docs/advanced-configuration.md 中找到。

ga('require', 'eventTracker', {
  eventCategory: '默认类别',
  event