首页
/ Analytical 项目技术文档

Analytical 项目技术文档

2024-12-18 01:24:51作者:幸俭卉

1. 安装指南

1.1 环境要求

  • Ruby on Rails 应用程序
  • 支持的 Ruby 版本

1.2 安装步骤

  1. 在 Gemfile 中添加以下内容:
    gem 'analytical'
    
  2. 运行以下命令安装 gem:
    bundle install
    
  3. 在 Rails 应用程序的 config/initializers 目录下创建一个名为 analytical.rb 的文件,并添加以下内容:
    Analytical.setup do |config|
      config.google.key = 'UA-5555555-5'
      config.clicky.key = '55555'
      # 其他配置项
    end
    

2. 项目的使用说明

2.1 基本使用

在 Rails 控制器中添加以下代码以启用 Analytical:

analytical

2.2 配置文件

config/analytical.yml 文件中配置 API 密钥:

production:
  google:
    key: UA-5555555-5
  clicky:
    key: 55555
development:
test:

2.3 模板文件

在模板文件中添加 Analytical 的辅助方法以初始化跟踪 JavaScript:

<!DOCTYPE html>
<html>
  <head>
    <%= raw analytical.head_prepend_javascript %>
    <title>Example</title>
    <%= stylesheet_link_tag :all %>
    <%= javascript_include_tag :defaults %>
    <%= csrf_meta_tag %>
    <% analytical.identify '5', :email=>'josh@transfs.com' %>
    <%= raw analytical.head_append_javascript %>
  </head>
  <body>
    <%= raw analytical.body_prepend_javascript %>
    <%= yield %>
    <%= raw analytical.body_append_javascript %>
  </body>
</html>

2.4 条件性识别

在模板文件中添加条件性识别命令:

<% analytical.identify(current_user.id, :email=>current_user.email) if current_user %>

2.5 跟踪方法

在视图和控制器中使用 track()event() 方法进行跟踪:

analytical.track '/a/really/nice/url'
analytical.event 'Some Awesome Event', :with=>:data

3. 项目API使用文档

3.1 模块配置

在控制器中配置模块:

analytical :modules=>[:console, :google, :clicky]

3.2 动态模块配置

动态指定模块及其配置:

analytical :modules => lambda{ |controller| controller.analytical_modules }

3.3 禁用分析

条件性禁用分析:

analytical :disable_if => lambda{ |controller| controller.i_can_haz_tracking? }

3.4 过滤模块

动态过滤活动模块:

analytical :filter_modules => lambda{ |controller, modules|
  controller.use_google_analytics? ? modules : modules - [:google]
}

4. 项目安装方式

4.1 通过 Gemfile 安装

在 Gemfile 中添加 gem 'analytical',然后运行 bundle install

4.2 手动安装

通过命令行手动安装 gem:

gem install analytical

4.3 配置文件

config/analytical.yml 中配置 API 密钥。

4.4 初始化

config/initializers/analytical.rb 中进行初始化配置。

通过以上步骤,您可以成功安装并使用 Analytical 项目,实现对多个分析服务的管理。

热门项目推荐
相关项目推荐

项目优选

收起
Python-100-DaysPython-100-Days
Python - 100天从新手到大师
Python
610
115
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
286
79
mdmd
✍ WeChat Markdown Editor | 一款高度简洁的微信 Markdown 编辑器:支持 Markdown 语法、色盘取色、多图上传、一键下载文档、自定义 CSS 样式、一键重置等特性
Vue
111
25
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
60
48
RuoYi-Cloud-Vue3RuoYi-Cloud-Vue3
🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
45
29
go-stockgo-stock
🦄🦄🦄AI赋能股票分析:自选股行情获取,成本盈亏展示,涨跌报警推送,市场整体/个股情绪分析,K线技术指标分析等。数据全部保留在本地。支持DeepSeek,OpenAI, Ollama,LMStudio,AnythingLLM,硅基流动,火山方舟,阿里云百炼等平台或模型。
Go
1
0
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
205
57
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
376
36
RuoYi-VueRuoYi-Vue
🎉 基于SpringBoot,Spring Security,JWT,Vue & Element 的前后端分离权限管理系统,同时提供了 Vue3 的版本
Java
182
44
frogfrog
这是一个人工生命试验项目,最终目标是创建“有自我意识表现”的模拟生命体。
Java
8
0