项目设置

「系统 → 项目」里每个页签的每一项。创建和修改只有管理员能做；有项目权限的人可以看项目列表和接入检查。

创建项目

创建时只问三件事，其余用默认值，之后在设置里改：

字段	说明
名称	显示用
标识 `project_code`	`[a-z][a-z0-9_-]{1,31}`，按名称自动建议。创建后不能改，停用后也不能再用
时区	IANA 时区，默认 `Asia/Shanghai`。创建后不能改

时区不能改，是因为事件入库时就按项目时区算好了日期，改了会让历史和新数据的日期边界对不上。项目创建时会自动落到项目数最少的分片上，也不能改，见多节点与分片。

创建完成会弹出写入密钥（evs_wk_xxx），关掉之后页面上只显示前缀。要再看完整密钥，管理员在「接入」页签点「查看」并输入自己的登录密码。

首次引导里选了创建演示项目，列表里会有一个「演示项目」，里面是虚构的示例数据，用来熟悉各个页面，见创建演示项目。不需要时停用即可，停用后不会再建。

项	说明	默认
名称	可改
标识、时区、分片	只读
保留天数	明细保留多少天，1～3650。只影响之后写入的数据	365
采集开关	关掉后这个项目的上报一律 `40101`，已有数据照常能查	开
停用项目	停用后采集关闭、项目从列表里消失，事件还在，到保留天数后自然清理

项	说明
写入密钥	平时只显示前缀。「查看」要输入当前登录账号的密码，通过后显示完整密钥，下面的上报片段也会填好（仅管理员）。「轮换」生成新密钥并立即作废旧的（仅管理员）
上报片段	Web、Go、Java、像素四个页签，可直接复制。上报地址是当前站点的 `/sa`
接入检查	收到了什么、谁发的、丢了多少、为什么，见接入检查

查看时密码输错 5 次，这个账号 10 分钟内不能再查看（42901）。每次查看都记进操作日志（write_key_view），输错的也记。离开页面后完整密钥不再保留在页面上。

轮换之后，旧密钥在所有进程上立即失效（总线断开的极端情况下最多 60 秒），记得同步更新各端。

如果「查看」提示这把密钥还不能查看，轮换一次就行：早期版本创建的密钥，服务端只存了哈希。

项	说明	默认
域名白名单	页面所在的域名必须在名单里，否则丢弃。支持精确域名和 `*.example.com`（匹配子域，不匹配 `example.com` 本身）。每行或逗号分隔一个，最多 200 条	空（不限制）
域名黑名单	开关打开时，命中的域名丢弃。同样最多 200 条	关
采集跨域	允许哪些网站在浏览器里上报（`allow_origins`）。留空允许所有来源	空
丢弃爬虫	丢弃 User-Agent 像爬虫的请求	开
排除 IP	单个 IP 或 CIDR，最多 50 条，例如办公室出口	空
站内搜索参数名	页面地址里哪些查询参数算站内搜索词	`q,keyword,wd,search,query`

黑白名单同时启用时，先看黑名单，再看白名单。它们比较的是事件里页面的域名（小写、去掉端口），不是跨域请求的 Origin。没有页面地址的事件（例如服务端上报的用户属性）不受白名单限制，免得误伤服务端埋点。

被过滤掉的事件按原因计数，在接入检查里能看到。

项	说明	默认
全埋点	自动记录点击和停留	开
热力图	点击带坐标	开
遮罩选择器	每行一个 CSS 选择器，最多 50 条，命中的元素不采文本、回放里遮住	`[data-evstats-mask]`
会话回放	总开关	关
回放抽样比例	1～100	10
归因回看天数	1～90	30

改了之后，SDK 最多 5 分钟后按新配置工作（/sdk/config 的缓存时间）。见全埋点与热力图、会话回放、归因。