ClkLog 常见问题 - 指标定义与统计逻辑 Sec.1

用户行为分析指标项是衡量产品和运营管理的关键因素，它们可以帮助企业深入了解用户需求、行为模式、产品表现等多个方面。

比如页面停留时间、平均停留时长可以分析用户的需求和兴趣；跳出率、留存率可以查询用户的体验情况；事件触发次数、转化率等可以评估业务流程是否顺畅或者营销策略是否成功。

这篇我们将完整介绍 ClkLog 的中使用到的指标项定义以及一些重点指标的统计逻辑，便于运营人员理解后做数据分析，同时如果大家在使用过程中发现了指标项为空或异常的情况，可以对照说明排查问题。

一、ClkLog 指标项说明

二、ClkLog 指标统计逻辑说明

1.基础统计指标

1.1.浏览量

● 统计逻辑：ClkLog 浏览量的统计基于浏览页面事件。用户每打开一个页面会被记录一次，同一页面被打开多次浏览量值累计计算。

● 注意：由于神策不同客户端的 SDK 的浏览页面事件的事件名称不同，ClkLog 根据神策 SDK 的浏览页面事件定义对各种端做了不同的统计分析处理。

● 神策各端 SDK 的浏览页面事件如下：

Web：$pageview

Android&iOS：$AppViewScreen

小程序：$MPViewScreen

其他端: ClkViewScreen

ClkViewScreen 事件是 ClkLog 付费版中定义的除 Web、Android&iOS、小程序端以外的其他端的 SDK 想要进行受访页面统计分析的通用事件。

1.2.访问次数

● 统计逻辑：ClkLog 访问次数的统计基于访问会话 ID（$event_session_id）。

● 注意：会话 ID（$event_session_id）是每条采集上来的事件日志都应该要包含的属性。多数神策 WEB JS、Android、iOS、React Native 版本的 SDK 都有实现会话，但需要开启或引用相关插件才能正常采集会话 ID。而比如 uni-app 的 SDK，需要自己实现会话。

● 贴士：神策 SDK 是否有实现会话的排查方法如下：

集成神策 SDK 后，在调试模式或 show_log 后，在控制台上看到采集的日志属性中如果有 $event_session_id 且有值则说明神策 SDK 会话集成成功。

1.3.访客数

● 统计逻辑：ClkLog 访客数的统计基于统计时间段内采集日志中的 distinct_id 去重数。

● 注意：distinct_id 是神策的用户标识 ，在匿名状态下就是匿名 ID（anonymous_id），匿名 ID 是通过神策 SDK 自动生成）； 如果通过 sensors.login 方法完成简易用户关联（付费功能）至业务系统的用户的用户 ID（一般为用户在业务系统中的唯一身份标识）后，SDK 会同步修改 distinct_id 为业务系统的用户 ID。

1.4.IP 数

● 统计逻辑：ClkLog 访客数的统计是统计时间段内的每一天访问应用的独立 IP 数的累计值，一天内同一 IP 多次访问应用只计算为一个 IP。

● 注意：如果同一局域网内使用同一个对外的公网 IP，多个用户的访问只会被记录为一个 IP。如果单次访问中因为网络变化（如切换 VNP）导致的 IP 变化，也可能会出现单次访问出现多个访问 IP 的情况。

1.5.平均访问页数

● 统计逻辑：ClkLog 平均访问页数 = 浏览量 / 访问次数

● 注意：平均访问页数显示为空可能出现的原因：

1.  采集的日志数据中对应的客户端没有可用于统计分析的浏览页面事件。

2.  采集的日志数据中没有会话 ID 或会话 ID 为空。

1.6.平均访问时长

● 统计逻辑：ClkLog 平均访问时长 = 访问总时长 / 访问次数

访客的单次访问中，访问的总时长为打开第一个页面到退出或关闭最后一个页面的时间差。

● 注意：平均访问时长显示为空可能出现的原因：

1.  单次会话相关的访问日志记录中只有一条日志记录。

2.  采集的日志数据中没有会话 ID（$event_session_id）或会话 ID（$event_session_id）为空。

1.7.跳出率

● 统计逻辑：ClkLog 跳出率 = 跳出次数 / 总访问次数 * 100%

跳出率是只浏览一个页面就离开或关闭应用的访问次数占总访问次数的百分比。

● 注意：跳出率值显示为空可能出现的原因：

1.  统计时间段内所有的会话的浏览页面事件日志记录都超过一条。

2.  采集的日志数据中没有会话 ID（$event_session_id）或会话 ID（$event_session_id）为空。

1.8.新访客/老访客

● 统计逻辑：ClkLog 新访客/老访客的统计基于采集的日志记录中的 is_first_day 的值。

● is_first_day：是否首日访问（从新用户第一次访问到当天的凌晨十二点之间的值都为真，之后为假，标识存在 storage 中）。

2.  特有统计指标

2.1.受访页面及标题

● 统计逻辑：ClkLog 受访页面及标题数据来源于浏览页面事件的 $title 和 $url 属性。

● 常见问题：受访页面和标题不一致。一般是由于开启了 SDK 全埋点的单页面应用（如 vue、uniapp）。

● 解决方案：

1.  全埋点的浏览页面事件在进入页面时即会采集，如果是动态路由页面的动态标题，此时埋点数据采集的可能会是上一个页面的标题，可以在切换动态路由页面之前改变页面标题避免该问题。

2.  对于纯动态标题的单页面应用，所有的标题的改变都是在进入路由页面后根据加载的数据来动态改变页面标题的情况，建议关闭 SDK 的自动采集页面浏览事件关闭，然后在页面标题改变后手动开启或手动埋点浏览页面事件。

2.2.结构化页面分析

● 统计逻辑：结构化页面分析是通过树状结构化的模式来统计查看受访页面各项流量指标数据。

● 注意：默认状态下结构化页面分析不会展示任何数据，需要做以下配置才能正常分析数据：

1.  社区版：结构化页面分析仅支持 web 应用的结构化页面分析，对于 web 应用的结构化页面数据的正常加载，需要先完成埋点网站域名在 ClkLog 的 api 服务的 project-host 中的配置网站的访问域名（多个域名以逗号分隔），结构化页面分析才会有相关数据。

2.  付费版：项目结构化页面数据的统计展示，WEB 项目需要在【系统设置】-【项目管理】处配置项目对外访问的所有域名。