Ember Metrics 使用指南

Ember Metrics 使用指南

ember-metrics Send data to multiple analytics integrations without re-implementing new API 项目地址: https://gitcode.com/gh_mirrors/em/ember-metrics

1. 目录结构及介绍

Ember Metrics 是一个针对 Ember.js 应用的插件，旨在简化多分析服务的数据发送过程。以下是一般的目录结构概述及其关键组件说明：

• addon: 包含了插件的核心代码，提供服务和其他可重用组件。
• app: 这里存放的是默认提供的集成代码，当直接安装到 Ember 应用中时会被合并。
• blueprints: 自定义的蓝图，用于生成或修改应用内的特定文件，如自定义命令或配置。
• config: 包含了示例配置文件，指导用户如何设置分析服务。
• tests: 测试套件所在的位置，确保插件功能的稳定性。
• types: 类型定义文件，用于类型检查工具如 TypeScript。
• vendor: 第三方库或不能直接作为 npm 包管理的资源存放处。

2. 项目的启动文件介绍

Ember Metrics 的核心逻辑并不直接通过一个单一的“启动文件”来启动，而是通过 Ember 的服务注入机制。当你在你的 Ember 应用中安装并配置了此插件后，它会在应用初始化过程中自动激活。具体来说，重要的是配置文件（通常在 config/environment.js 中配置该插件）和引入的服务使用。

为了启用和使用 Ember Metrics，不需要手动操作任何明显的“启动”脚本。安装后，在合适的地方（比如路由或组件）通过服务注入来调用其方法即可开始追踪数据。

3. 项目的配置文件介绍

主配置：config/environment.js

配置 Ember Metrics 至关重要的一部分发生在 config/environment.js 文件内。在这里，你会定义想要使用的分析服务以及它们的相应配置。例如，配置 Google Analytics 可以如下进行：

module.exports = function(environment) {
  let ENV = {
    metricsAdapters: [
      {
        name: 'GoogleAnalytics',
        environments: ['development', 'production'],
        config: {
          id: 'YOUR_TRACKING_ID',
          debug: environment === 'development',
        },
      },
      // 可添加更多服务的配置...
    ],
    // 其他环境配置
  };

  return ENV;
};

配置细节

每个分析服务的配置键值对是特定于服务的。例如，对于 Mixpanel，你需要提供一个 token 而不是 id。此外，可通过调整 environments 数组来控制哪些环境中启用特定的服务。

注意：服务的名称应当使用帕斯卡命名法，并且要参考项目文档或源码中提供的支持服务列表来正确配置。

通过这样的配置，Ember Metrics 确保了在不重复实现新API的情况下，能够向多个分析平台发送数据，大大简化了多服务数据跟踪的复杂度。

ember-metrics Send data to multiple analytics integrations without re-implementing new API 项目地址: https://gitcode.com/gh_mirrors/em/ember-metrics