客户建站平台开发说明书
项目计划 →
08|网站运营数据

询盘、流量与SEO

可靠接收询盘、记录页面浏览,并按Yandex、百度和Google提供差异化数据。

INQUIRY

网站表单与询盘

P0
使用角色:客户、网站访客、内部服务人员
页面:表单配置、询盘列表/详情、接收规则、垃圾识别和导出
模块目标

合法询盘先可靠入库,再通知和提供客户处理。

主流程

访客提交→WAF/验证码/限流→字段校验→原始入库→垃圾评分/去重→通知→客户处理/导出。

关键规则
  • 每次提交保存tenant_id、site_id、page_id、form_version、来源、UTM、同意状态和原始时间。
  • idempotency_key防重复;相同IP不自动合并。
  • 未读→处理中→已跟进→已转化/无效;状态历史保留。
  • 客户配置接收人和渠道,但通知失败不能回滚询盘。
  • 附件扫描通过前不可下载;敏感字段按角色脱敏。
异常边界
  • 采集/统计/邮件故障时仍优先入库询盘。
  • 恶意突发按IP、站点、指纹限流,不封禁整个客户。
核心数据

inquiry、inquiry_raw、form_version、spam_score、inquiry_status_history

接口 / 事件

POST /public/v1/inquiries;inquiry.created;notification.requested

验收标准
  • 100 RPS表单突发合法询盘成功率≥99.9%。
  • 重复提交只产生一条业务记录。
  • 跨租户查看、搜索、导出和附件下载全部拒绝。
TRAFFIC

第一方流量采集与报表

P1
使用角色:客户、平台数据人员
页面:效果总览、趋势、渠道、页面、地区设备、转化、数据状态
模块目标

记录百万级页面浏览并形成可解释、可延迟、可重算的统计。

主流程

浏览器SDK批量发送→采集网关→队列→校验/去敏/去重→Session→分析库→小时/日聚合→报表缓存。

关键规则
  • SDK异步、批量、压缩、短超时,失败绝不阻塞页面和询盘。
  • 事件包含event_id、event_time、tenant_id、site_id、anonymous_id、session_id、URL白名单、consent_state、sdk_version。
  • PV按event_id去重;Session默认30分钟无活动;所有指标口径版本化。
  • 原始明细、可查明细和聚合按隐私、成本和套餐分别留存。
  • 关键转化事件优先于普通PV;队列拥塞先关闭调试事件再采样普通事件。
异常边界
  • URL中的邮箱、手机、Token、表单内容不得进入分析库。
  • 迟到事件按event_time重算受影响聚合并记录数据更新时间。
核心数据

raw_event、session、traffic_hour/day、metric_definition、aggregation_batch

接口 / 事件

POST /collect/batch;traffic.aggregated;aggregation.recomputed

验收标准
  • 持续1000 events/s、突发3000 events/s 10分钟,成功≥99.99%。
  • 峰值后30分钟内消化积压且不重复计数。
  • 100万事件/日下30天看板P95≤2秒。
SEO

SEO与第三方统计

P1
使用角色:客户、内部SEO人员
页面:SEO总览、页面检查、关键词、收录、第三方授权和同步
模块目标

按俄文/Yandex、中文/百度、英文/Google提供不同能力,并统一展示数据来源与更新时间。

主流程

授权第三方→绑定站点→每日同步前一完整日→页面技术扫描→关键词/收录数据→报告。

关键规则
  • RU_YANDEX、ZH_BAIDU、EN_GOOGLE决定可用工具、模板提示和指标。
  • Yandex Metrica/GA4/百度统计Token加密、可撤销、按最小Scope授权。
  • 来源+账号+站点+日期作为同步幂等键;失败指数退避并支持区间补采。
  • 图表显示来源、时区、口径、过滤、数据时间和同步状态。
  • 不同平台不可比指标不直接相加。
异常边界
  • Token失效展示最近成功数据并通知重新授权。
  • 第三方限流不影响第一方数据和站点服务。
核心数据

integration_account、sync_job、seo_audit、keyword_rank、index_status、report_snapshot

接口 / 事件

integration.connected/expired;sync.completed/failed

验收标准
  • 站点类型只显示适用工具。
  • 同步重跑不重复数据;失败可补采。
  • 无第三方授权时第一方数据和技术SEO仍可用。