数据源
同一个项目里的数据源共用一套身份和同一张事件表;未登记的网站域名或应用标识会被拒收,登记之后控制台才出现对应的网站统计或应用统计。这一页不轮换密钥。
控制台全端分析数据管理数据源管理上半是「已登记的数据源」列表(平台、标识、备注、「最近上报」),下半在已有网站时给出安装片段。套餐允许非网站端时,还有接入向导和 SDK 远程配置。
指标与口径
- 网站标识:不要带协议和路径,子域名自动允许。
- 应用标识:必须与 SDK 初始化时的
appId一致。 - 修改标识:已有上报时,旧数据留在旧标识下,不会迁移,新标识从保存起开始接收。
- 删除数据源:只停止接收,历史数据仍留在报表里;把同一标识重新登记即恢复接收。
- 远程配置:只下发给小程序和 App,网站不受影响。可配采集开关、采样率、上报间隔、批量条数、配置缓存、是否需要同意、预置事件、控件文本、性能采样、事件 / 设备 / 控件黑名单、最低 SDK 版本。与默认一致时不下发。
如何使用
添加一条网站域名,把安装片段放到页面里。密钥不在这里创建,去 控制台配置设置API 密钥,服务端上报用 wck_ 前缀且权限包含写入。想试读报表接口,用同组的 控制台全端分析数据管理API Playground,页内请求走当前登录态。
权限与限制
增删改数据源和保存远程配置需要所有者或管理员。套餐未包含某类端时,该类 SDK 上报会被丢弃,页面上会提示。规划中的端可以先登记标识,安装代码仍是设计稿。
常见问题
改错标识后历史数据会搬过去吗? 不会,历史留在旧标识下。
关闭远程配置里的采集会丢数据吗? 不会。SDK 停止上报但保留队列,重新开启后续传。
网站的自动采集在哪里开关? 写在安装片段里,不走这份远程配置。
数据导入
适合从别的统计工具迁移、把线下或 CRM 里的用户属性补到档案,或在没装脚本时先用访问日志看一轮页面浏览。它不是持续的采集通道,持续上报请看 数据源。
控制台全端分析数据管理数据导入页面上方是导入任务列表(最近 50 条),显示「文件」「类型」「总行数」「已导入」「失败」和「创建时间」。点「导入文件」开始向导。
指标与口径
三种类型:
| 类型 | 每行是什么 | 用途 |
|---|---|---|
| CSV 事件 | 一条事件:时间、事件名、用户、页面、UTM 等 | 迁移事件数据 |
| CSV 用户属性 | 一个用户:distinct_id 或邮箱、手机,加自定义属性 | 补用户档案 |
| Nginx / Apache 日志 | 一条请求,combined 格式 | 无 SDK 时的页面浏览 |
上传后系统会自动识别类型,也可以手动改。单文件最多 100,000 行,更大请拆分。
CSV 事件。 映射目标字段有时间、事件名、用户标识、路径、完整网址、来源页、user_agent、IP、三个 UTM 字段,以及「属性」。选为属性的列并入事件属性,数字和 true、false 会转成对应类型;没映射的列被忽略。至少要映射事件名,或路径、网址之一。事件名留空或写成页面浏览,就当页面浏览处理。时间支持 10 位或 13 位时间戳、ISO 格式和常见日期格式;没映射时间列时用导入当时的时间,映射了但无法解析的行算失败。没映射用户标识时,每行按内容哈希生成一个匿名访客,无法跨行归并成同一个人。同一用户的相邻事件在 30 分钟内算同一会话。
CSV 用户属性。 至少要映射用户标识、邮箱、手机之一。邮箱和手机作为身份时会先哈希再绑定。「姓名」写入用户的名字,「属性」列写入自定义属性。
Nginx / Apache 日志。 不需要映射。访客按 IP 加 user_agent 生成,30 分钟切一个会话。只保留 GET 请求,并跳过静态资源(样式、脚本、图片、字体等)、爬虫和没有 user_agent 的请求,也跳过返回 4xx、5xx 的请求。404 例外:它不跳过,而是记成 __404 事件,不算页面浏览。被跳过和解析不了的行都计入「失败」。
导入的事件平台和来源都是 import,走正常的入库队列,会计入网站统计的报表,可以用「平台」维度单独过滤。日志导入的访客不会和 SDK 访客合并。
如何使用
- 选择类型和文件。 支持 CSV 和
.log,UTF-8。大文件由页面分块上传,分块令牌 15 分钟内有效、只能用一次。 - 确认预览与映射。 页面展示前 20 行,并按列名猜好映射:比如
time、event_name、user_id、utm_source会各自对上。为每列选目标字段,或选「— 忽略 —」。预览只保留 10 分钟,过期要重新上传。 - 执行并看结果。 结果显示总计、导入、失败。数据几秒到几分钟后出现在报表里。
示例:把旧系统导出的 time,event,user_id,page 四列 CSV 导入。向导会把它们映射成时间、事件名、用户标识和路径;确认后执行。
权限与限制
任何能看这个项目的人都能看任务列表。上传、预览和执行需要分析师及以上。
常见问题
导入后报表没有数据怎么办? 先等几分钟,数据要经过入库队列。再检查报表的时间范围是否覆盖文件里的时间,以及有没有按平台过滤掉 import。
失败行为什么很多? CSV 看时间列是否能被解析;日志看有多少行是静态资源或爬虫,这些被跳过的也算失败,不一定是出错。
任务停在「待确认」怎么办? 预览过期后无法执行,重新上传即可。执行失败的任务可以在预览有效期内再次执行;已完成的任务不能重复执行。
同一文件导两次会去重吗? 不会,会有两份数据。
维度表
事件里往往只有 sku、campaign_id 这样的编号,品类、负责人在业务系统里。维度表把这张对照表存进项目,不改埋点就能挂到事件上。
列表显示「键属性」「列」「行数」「覆盖率」和「更新时间」。点一行进入详情:「表设置」、「上传 CSV」、搜索行、「导出 CSV」。
当前能做到什么
表和行可以建、传、搜、导出,覆盖率可以看。服务端已经有按 dim:<表编号>.<列名> 当拆分维度的能力,但控制台的分析界面还没有把维度表的列放进拆分下拉,所以现在不能直接在漏斗或事件分析里选它。需要时先用 虚拟事件与属性 的虚拟属性做简单映射。
指标与口径
- 键属性:事件属性里用来关联的键名,只能含字母、数字、下划线和
$,最多 60 个字符。 - 列:创建时至少一列,最多 30 列。列名可含中文、空格和连字符,最多 40 个字符,重复的会合并。
- 行数上限:每张表 50,000 行,单元格值最多保留 200 个字符,键最多 190 个字符。
- 关联覆盖率:取近 7 天带键属性的事件,最多抽 50,000 条,算键能在本表命中的比例,显示「命中 / 抽样」。偏低说明表不全,或事件里的取值和表里的写法不一致。近 7 天没有带这个键的事件时,显示无数据。
如何使用
- 新建维度表:名称(同一项目内不能重名)、键属性、列名,列名用逗号或换行分隔。
- 上传 CSV:UTF-8,首列、或名为键属性、或名为
key的列当键,其余列当属性;表头里出现的新列会自动并入列表,总数不超过 30。 - 选上传方式:「合并」按键覆盖已有行并保留其它行;「替换」先清空再写入,会先确认。超过 50,000 行会被拒绝,需要拆分文件。
- 用搜索框按键或任意列值找行;用「导出 CSV」取回整张表,最多 50,000 行。
示例:建一张键属性为 sku 的「商品表」,列为品类、价格带,上传含 sku,品类,价格带 三列的 CSV。上传后看覆盖率,低于预期时先核对事件里 sku 的写法。
大文件由页面分块上传。分块令牌 15 分钟内有效,且只能用一次;过期后重新选择文件。
删除维度表会删掉它的全部行,且不可恢复。
权限与限制
任何能看这个项目的人都能看列表、行、覆盖率并导出。新建、改设置、上传和删除需要分析师及以上。
常见问题
覆盖率很低怎么办? 先看事件里键属性的实际取值,大小写和前后空格都要一致。也可能是表里缺行,补传后用「合并」方式上传。
上传后列为什么没变? 只有 CSV 表头里出现的新列才会并入。已有的列不会因为这次文件没有它而被删除。
能改键属性吗? 能,在「表设置」里改。改了之后覆盖率按新键重算,已上传的行不变。