# 剑鱼埋点相关问题

::: danger
该文档已过期

新文档，[点这里](./index-new.html)
:::

## 埋点用途

目前项目中存在两个统计方式：**百度统计**、**荟聚统计**。

两者的区别： 
* 百度统计主要用于延续之前的分析，可分析网站流量等数据指标。
* 荟聚统计用于统计**页面事件、页面访问**，以及运营用于营销活动、页面的使用。

## 如何在新项目中集成百度统计、荟聚统计

1. 如下图加载对应三个JS文件引用

2. head.js、fotter.js修改对应环境路由，需确保对应环境存在 **common-module** 资源文件映射，能正确访问。


![代码示例](/images/track-demo.png)

#### 代码示例
```
<!--S 加载百度统计及剑鱼自定义埋点 -->
<script src="https://www.jianyu360.cn/common-module/public/head.js"></script>
<!--E 加载百度统计及剑鱼自定义埋点 -->

<!--S 加载荟聚SDK初始化及剑鱼自定义埋点注入 -->
<script src="https://cdn-common.jianyu360.com/cdn/lib/jquery/3.5.1/jquery.min.js"></script>
<script src="https://www.jianyu360.cn/common-module/public/fotter.js"></script>
<!--E 加载荟聚SDK初始化及剑鱼自定义埋点注入 -->
```

## 荟聚统计相关

### 页面访问数据埋点

通过 fotter.js 针对荟聚平台原有的 open_page 字段进行了扩展，跟随每次进入页面的上报事件一同上报。

主要用途：
* 绑定用户信息，用于荟聚分析平台能使用 c_uid 进行对应关联。
* 更新替换页面自定义属性，如页面名称、页面Id，使其能在分析时进行便捷使用。

#### 使用示例
![使用示例](/images/track-hj-open-page.png)

#### 页面名称、ID定义数据

* 该数据由运营、研发、产品共同制定。
* 可通过全局变量 **jyPageMaps** 访问查阅。

![页面名称、ID定义数据](/images/track-page-maps.png)




### 通用点击事件埋点

通过 head.js 注入自研 track 统计SDK，用于收集后端渲染Go项目、前后端分离Vue项目的点击事件信息，并调用荟聚上报函数。


#### 上报自定义字段明细

|      字段       |  描述   |                规则                |
|:-------------:|:-----:|:--------------------------------:|
|  c_platform   |  平台   | PC、APP、WeChatWeb、WeChatMP、Other  |
|   c_pageid    | 页面ID  |  使用 AES 加密后的 location.pathname   |
|     c_url     | 页面url |               href               |
|  c_pagename   | 页面名称  |          document.title          |
| c_breakername | 断点名称  | 点击元素或者父级元素的 innerText，最大字符长度为 20 |
|  c_breakerid  | 断点ID  |      使用 AES 加密后的点击元素 xpath       |
|  c_breakerid  | 断点ID  |      使用 AES 加密后的点击元素 xpath       |


#### 荟聚平台分析使用示例
1. 访问登录荟聚分析平台
2. 选择进入 **分析 - 常用分析 - 行为分析**
3. 分析行为中，选择 **客户自定义事件 - 剑鱼通用点击事件（勿删）**
4. 限制事件属性来分析指定场景的点击数据
5. 选择分析维度、分析指标、分析时间等筛选条件

##### 👇下面示例分析 ** 再次购买 ** 按钮的点击情况
1. 限制事件属性中，设置条件为：**断点名称** 包含 **再次购买**，与上报信息中 c_breakername 一致
2. 分析维度中，选择根据 平台 / 页面url 分析，与上报信息中 c_platform、c_url 一致
![荟聚示例](/images/track-hj.png)


> 如需了解其他技术细节、加解密密钥请前往 [jy-track](http://192.168.3.207:8080/zhangyuhan/jy-track)

> 也可以使用埋点反查询工具，寻找查看对应关系

### 通用点击事件-埋点反查询工具
![埋点反查询工具](/images/track-tools.png)

#### 下载安装
1. 访问企业微信 - 微盘 - 项目文件 - 埋点查询工具
2. 根据自己操作系统下载不同的平台(Windows/MAC)的安装包