# VISTA Link B 端统计需求定义 ## 1. 文档用途 - 本文从 VISTA Link B 端查看数据的角度，集中定义 HOMEVISTA 客户访问端需要提供的页面访问、页面公共操作和 Widget 记录。 - 本文说明 B 端需要取得什么业务结果，以及销售最终看到什么；不规定事件字段名、心跳、接口、数据库、去重程序或异常补偿方式。 - 客户追踪、营销统计、筛选、权限和计算口径以《VISTA Link 产品需求文档》§4.6 为准。 - 页面公共组件和 Widget 的顾客可见功能仍以 C 端正式需求为准。本文不增加 C 端原本不存在的功能。 ## 2. 依据与审核状态 - 文档版本：V0.4。 - 最近更新：2026-09-01。 - B 端依据：VISTA Link PRD V0.250、VISTA Link 用例文档 V0.200。 - C 端依据：[C 端全部 Widget 清单](https://vista-new-c.homevista.work/docs/c/02-Widget%E4%BD%93%E7%B3%BB/02-%E5%85%A8%E9%83%A8Widget%E6%B8%85%E5%8D%95.md) v0.18。清单用于确认 22 个 Widget 名称，不代替各 Widget 的单项 PRD。 - 当前状态：开发评审稿。未标注「建议」的内容按已确认需求评审；标注「建议」的内容给出了产品选择，开发可按建议评估工作，正式验收前由产品确认是否采用。 ## 3. B 端怎样使用这些数据 | B 端功能 | 查看角度 | 使用的记录 | |---|---|---| | 客户追踪 | 从单一客户出发，还原客户自主访问，并与已关联的现场讲解并列展示 | 客户自主访问使用页面访问、内容浏览、普通操作和客户操作；现场讲解使用独立讲解记录 | | 营销统计 | 从当前项目出发，看整体、页面、内容和客户排行 | 页面访问与内容浏览的汇总结果；客户操作只用于最近客户操作等客观字段 | - 本文只定义客户自主访问的上报与统计。现场讲解不经过固定链接，不产生客户自主访问记录，不进入营销统计。 - 客户追踪和营销统计使用同一批客户自主访问记录，不各自定义一套来源。 - 客户追踪展示发生顺序和具体对象；营销统计只展示汇总结果，不展示单次访问过程。 - Widget 实例只用于系统内部确定内容所在区域和计算数据。销售看到的是页面、内容、素材或具体对象，不看到 Widget 实例编号。 ## 4. 统一记录规则 ### 4.1 三层记录 1. **页面访问**：客户打开的分享页面、实际固定链接、进入时间和本次页面访问总时长。 2. **内容区域**：页面中承载内容的区域，系统内部对应一个 Widget 实例。 3. **具体记录**：该区域中实际发生的内容浏览、普通操作或客户操作。 页面访问次数不因切换语言、Widget 切换或同次访问中的内容切换而增加。 ### 4.2 三类具体记录 | 类型 | 成立条件 | 进入客户追踪 | 进入营销统计 | |---|---|---|---| | 内容浏览 | 具体内容、素材或有名称的结果已经成功显示 | 显示对象和参数；取得完整有效时长时再显示时长 | 计算浏览客户数和浏览次数；有完整有效时长时再计入累计有效浏览时长 | | 普通操作 | 客户完成了有助于理解访问过程的操作，但不能据此认定目标内容已显示 | 显示操作、对象和时间 | 不进入内容指标，不进入客户操作汇总 | | 客户操作 | 客户完成了需要销售关注的业务操作 | 显示操作、对象和时间 | 可进入最近客户操作和客户操作次数 | ### 4.3 记录成立条件 - 每条记录必须能够关联客户、当前项目、分享页面、固定链接和本次访问，并提供实际发生时间。 - Widget 记录还必须能够关联 Widget 实例，以及实际内容、素材或操作对象。 - 具体对象需要提供稳定标识、销售可读名称，以及访问发生时适合销售识别的结构化参数。 - 「成功显示」指客户完成当前查看所需的最小主要内容已经可读或可操作，且没有处于空状态或错误状态；不要求视频、地图、WALK 或 VR 的所有资源都已加载完成。各单项 Widget 应在开发评审中说明可用的「可查看」信号，但不能把列表曝光或预加载当作成功显示。 - 列表中存在某个条目，不表示客户浏览过该条目；卡片点击也不表示详情已经显示。 - 本文明确要求的点击、选择或切换必须作为普通操作上报；C 端当前没有对应记录时列为新增工作。本文未要求的点击、选择或切换不记录。目标内容成功显示后，才能另记内容浏览。 - 同一具体对象多次产生内容浏览记录时，分别计算浏览次数；按对象去重的内容数不重复增加。 - B 端不根据当前页面结构、列表内容或相邻记录推断未提供的行为、对象或时长。 ### 4.4 时间与时长 - 所有日期范围按日本时间计算，开始日期和结束日期均包含在内。 - 页面访问按进入时间归入日期和筛选范围；内容浏览、普通操作和客户操作按各自发生时间归入日期和筛选范围。 - 一次访问跨越日期时，页面访问次数和本次访问总时长归入进入日期；跨日后发生的内容浏览和操作归入实际发生日期。 - 页面总时长、内容区域有效浏览时长和具体对象有效浏览时长属于不同层级，上层可以包含下层，不能相加。 - 点击、选择、切换和客户操作本身没有浏览时长。 - 内容浏览只有取得完整有效时长结果时才显示时长；B 端不根据相邻操作时间推算。 - 内容已成功显示但无法取得完整有效时长时，仍计算浏览客户数和浏览次数；时长显示为不可用，不记为 0。0 仅用于已取得完整计时结果且有效时长确为 0 的情况。 - 计时开始、结束、无操作处理、异常关闭和单次上限属于 C 端与技术设计范围，但最终结果必须支持 PRD §4.6 的计算。 ### 4.5 历史信息与删除 - 历史记录保存访问发生时实际显示或操作的页面、内容、素材和对象的名称、稳定标识、主要参数与发生时间，不保存页面或内容副本，也不能据此回放当时的完整页面；后续不用当前名称改写历史。 - 页面、Widget、素材或对象之后被修改、下线或删除，不减少已经产生的历史数据。 - 页面或客户删除后的标记和进入限制按 PRD §4.6 执行。 ### 4.6 销售可见信息 - 内容浏览显示：发生时间、客观行为、具体对象、结构化参数，以及该条记录具备的有效浏览时长。 - 普通操作显示：发生时间、操作名称和具体对象，不显示时长。 - 客户操作显示：发生时间、操作名称和操作对象，不展示预约表单、联系方式、贷款输入、费用结果或后续处理结果。 - 同一对象名称或参数值不在同一条记录中重复展示。 ### 4.7 通用内容查看能力 - 图片、视频、PDF、WALK 和 VR 是内容或查看方式，不作为独立 Widget。 - 成功打开的内容归属于发起查看的 Widget 和实际业务对象。 - 缩放、拖动、旋转、播放暂停、复位、全屏开关和沉浸画面内部移动默认不记录；某个 Widget 明确要求的例外在对应 Widget 小节说明。 ### 4.8 B 端与 C 端职责 - B 端产品需求负责定义需要统计的业务对象、记录成立条件、销售可见结果和不记录范围。 - C 端和数据开发负责说明对应功能是否已经存在、当前是否已有记录、需要新增哪些记录，以及能否提供稳定标识、历史名称、参数和有效时长。 - C 端当前没有上报不表示 B 端不需要该结果；开发应将其列为需要新增的记录，不能自行删除需求。 - 如果某项上报需求依赖 C 端当前不存在的客户操作，则另行由产品决定是否增加 C 端功能，不把不存在的操作写成已确认统计项。 - 当前 C 端没有资料下载操作，VISTA Link 不提出下载上报需求，也不统计下载。 ### 4.9 数据可靠性与纠正 - 同一次真实访问只能计算一次；刷新、重复标签页和重复到达的数据不得增加访问次数或重复累计时长。 - 页面访问、内容浏览、普通操作和客户操作必须能够确认对应的客户、项目、分享页面、固定链接和单次访问；内容浏览、普通操作和客户操作还必须能够确认实际对象。 - 客户追踪和营销统计使用同一批有效访问记录；明细和汇总不一致时，页面显示数据异常，不把任一方显示为可确认结果。 - 统计结果必须可以返回构成该结果的访问和内容记录。 - 机器人、自动监测、内部测试和其他非购房客户访问不进入客户追踪、营销统计或 AI 建议依据；无法确定时先进入待检查。 - 非客户访问的识别与排除规则由系统统一提供，项目不能自行新增、修改或停用。 - 可以查看访问记录的项目成员可以报告归属错误、重复计算、异常时长、非客户访问或其他数据问题。 - 具备「纠正访问数据」功能权限的项目成员可以确认原记录有效、更正客户归属或排除无效记录；确认时必须填写理由。 - 数据纠正不提供直接填写访问次数、浏览次数或时长的操作。 - 延迟数据补入、数据状态改变或纠正确认后，受影响的明细、汇总、排行和最近活动必须一起重新计算。 - 重新计算完成前显示「数据更新中」；失败时显示失败和重试操作，不得把旧结果显示为最新数据。 ## 5. 页面与公共元素 ### 5.1 页面访问（已明确） - **统计对象**：一次成功打开的分享页面。 - **记录规则**：客户身份识别完成且页面成功显示后，记录页面名称、实际固定链接、进入时间和页面总时长。 - **销售看到的信息**：客户追踪显示一次页面访问；营销统计为该页面增加访问次数，并按客户去重计算访问客户数。 - **不记录**：认证页面、打开失败、未识别访客和页面资源预加载。 - **结果场景**：客户通过固定链接打开“来访前项目介绍”并浏览 8 分钟。客户追踪显示 1 次页面访问和 8 分钟总时长；营销统计为该页面增加 1 次访问和 1 位访问客户。 ### 5.2 切换语言（已明确） - **统计对象**：一次成功的页面语言切换。 - **记录规则**：记录切换前语言、切换后语言和发生时间，归为普通操作。 - **销售看到的信息**：访问时间线显示“切换语言 · 日语 → 英语”。 - **不记录**：打开语言菜单但没有切换、切换失败和页面初始语言。 - **结果场景**：客户在 20:15 从日语切换为英语。页面访问、内容浏览和客户操作次数均不增加。 ### 5.3 当前未纳入的页面公共操作 - 当前资料只确认页头和项目联系信息页脚属于页面固定公共部分，没有确认页面导航，也没有确认电话、邮件或即时沟通等可点击联系入口。 - 页头和项目联系信息页脚目前只作为页面展示内容，不形成普通操作或客户操作。 - 当前开发不需要等待更多页面公共操作；页面导航、联系、分享、收藏或返回首页等操作不在当前范围。 - C 端后续若定义新的页面公共操作，需要补充统计对象、记录条件、销售可见信息、不记录情况和结果场景，通过产品审核后才能进入统计。 ## 6. C 端 Widget 清单 | 序号 | Widget | B 端统计对象 | |---|---|---| | 01 | 项目概览 | 项目概览内容 | | 02 | 户型卡片列表 | 具体户型、关联样板间 | | 03 | 周边地图 | 地图；地点详情和路线结果按 S1 建议 | | 04 | 住户展示 | 具体住户及关联内容 | | 05 | 断面图与立面图 | 具体建筑图纸及关联目标 | | 06 | 楼层信息 | 楼层平面及关联对象 | | 07 | 共有部列表 | 具体共有部；WALK/VR 体验内容按 S2 建议 | | 08 | 3D大楼 | 三维建筑；命名视角或热点详情按 S3 建议 | | 09 | 样板间列表 | 具体样板间；WALK/VR 体验内容按 S2 建议 | | 10 | 户型卡片 | 具体户型大图或详情按 S4 建议 | | 11 | 住户表 | 具体住户及关联共有部 | | 12 | 眺望集 | 具体眺望素材 | | 13 | 资料集 | 具体资料 | | 14 | 单个文件夹展示 | 具体资料 | | 15 | 360转大楼 | 建筑环视内容 | | 16 | 日影 | 日影内容；已应用的日期、时刻按 S5 建议 | | 17 | 活动日历 | 具体活动 | | 18 | 来场预约 | 预约功能；已受理的提交操作按 S6 建议 | | 19 | 平面色彩切换 | 具体平面色彩方案 | | 20 | 3D色彩切换 | 具体三维色彩方案 | | 21 | 平面家具摆放 | 具体预设布局方案 | | 22 | 购置费用与贷款试算 | 费用计算或贷款试算模式；完成试算操作按 S7 建议 | ## 7. 各 Widget 统计要求 通用条件只在第 4 节说明；各 Widget 仅写自身差异。标题未标注「建议」的内容为已确认需求；标注「建议 S1–S7」的内容按第 8 节的建议评估。 ### 7.1 项目概览 - **统计对象**：项目概览内容。 - **记录规则**：概览成功显示后形成内容浏览；没有下一级内容或客户操作。 - **销售看到的信息**：概览名称、项目名称和有效浏览时长。 - **不记录**：语言切换、封面适配和页面布局。 - **结果场景**：客户查看“晴海 Residence 项目概览”3 分钟。客户追踪显示概览浏览；营销统计增加 1 位浏览客户、1 次浏览和 3 分钟。 ### 7.2 户型卡片列表 - **统计对象**：具体户型；从户型进入的具体样板间。 - **记录规则**：卡片点击记录为普通操作；户型大图或详情成功显示后形成户型浏览；关联样板间成功显示后另记内容浏览。 - **销售看到的信息**：户型名称、楼栋、面积、LDK/格局；样板间名称和体验方式。 - **不记录**：筛选、列表滚动、未打开的户型和图片缩放。 - **结果场景**：客户筛选 2LDK 后点击“A 户型”，打开大图 2 分钟，再进入“A 户型样板间”4 分钟。客户追踪显示一次点击和两项浏览；营销统计只累计 A 户型和样板间，B、C 户型不增加数据。 ### 7.3 周边地图（建议 S1） - **统计对象**：地图整体、成功显示的地点详情和路线结果。 - **记录规则**：地图显示后形成整体浏览；切换地点分类或选择标记属于普通操作；地点详情或路线结果完整显示后形成独立内容浏览。 - **销售看到的信息**：地图名称；地点名称、分类、地址或位置说明；路线目的地和出行方式。 - **不记录**：缩放、平移、复位、地图视图切换、街景内部操作和客户实时位置。 - **结果场景**：客户查看周边地图 3 分钟，选择“教育”，再打开“中央小学”详情 1 分钟。客户追踪显示地图浏览、分类操作和地点浏览；营销统计分别累计地图与中央小学，未打开的地点不统计。 ### 7.4 住户展示 - **统计对象**：指定住户，以及实际打开的户型图、外景、样板间或 WALK/VR 内容。 - **记录规则**：住户内容显示后形成住户浏览；每项关联内容成功显示后分别记录。 - **销售看到的信息**：房号、楼栋、楼层、户型名称、面积、LDK/格局和关联内容名称。 - **不记录**：页面中存在但未打开的关联内容和沉浸画面内部操作。 - **结果场景**：客户查看“A 栋 4801”2 分钟、户型图 1 分钟和样板间 WALK 4 分钟。客户追踪按顺序显示三项内容；营销统计分别累计，未打开的外景不增加数据。 ### 7.5 断面图与立面图 - **统计对象**：实际显示的每张建筑图纸及成功打开的关联目标。 - **记录规则**：图纸分别形成内容浏览；切换建筑、切换图纸和点击关联标记属于普通操作；关联目标显示后由目标内容另记浏览。 - **销售看到的信息**：建筑名称、图纸名称、图纸类型、关联目标名称和有效浏览时长。 - **不记录**：放大、缩小和平移。 - **结果场景**：客户查看“A 栋南立面图”2 分钟，点击“3 层公共空间”标记并打开详情。客户追踪显示图纸浏览、标记点击和公共空间浏览；营销统计不把点击本身当作内容。 ### 7.6 楼层信息 - **统计对象**：楼层平面，以及成功打开的住户、眺望或其他关联对象。 - **记录规则**：楼层平面显示后形成内容浏览；切换建筑、楼层和选择标记属于普通操作；关联对象显示后另记浏览。 - **销售看到的信息**：建筑名称、楼层名称、住户房号、关联对象名称和有效浏览时长。 - **不记录**：图纸缩放、未打开的标记和只出现在平面上的对象。 - **结果场景**：客户查看“A 栋 3 层平面”2 分钟，再打开“301 住户”1 分钟。客户追踪显示两项内容；营销统计分别累计楼层平面和 301 住户。 ### 7.7 共有部列表（建议 S2） - **统计对象**：具体共有部详情，以及该共有部的 WALK 或 VR 体验内容。 - **记录规则**：详情或大图显示后形成共有部浏览；进入 WALK/VR 后另记一项内容浏览，两者通过同一共有部关联。 - **销售看到的信息**：共有部名称、所属建筑、内容类型、体验方式和有效浏览时长。 - **不记录**：列表滚动、未打开的共有部和沉浸画面内部移动。 - **结果场景**：客户打开“A 栋迎宾大堂”详情 1 分钟，再进入 VR 3 分钟。客户追踪显示同一共有部下的两段浏览；营销统计按实际内容分别累计。 ### 7.8 3D大楼（建议 S3） - **统计对象**：三维建筑整体，以及 Widget 明确定义的命名视角、立面或热点详情。 - **记录规则**：三维建筑显示后形成整体浏览；选择楼栋、命名视角或热点属于普通操作；命名内容或详情完整显示后才形成独立内容浏览。 - **销售看到的信息**：三维建筑名称、楼栋名称、命名视角或热点名称、详情名称和有效浏览时长。 - **不记录**：自由旋转、缩放、拖动、复位和未命名视角变化。 - **结果场景**：客户浏览“晴海 Residence 3D大楼”5 分钟，进入“A 栋南立面”命名视角 2 分钟。客户追踪显示整体建筑和南立面两项浏览；自由旋转不单独出现。 ### 7.9 样板间列表（建议 S2） - **统计对象**：具体样板间详情，以及该样板间的 WALK 或 VR 体验内容。 - **记录规则**：详情或大图显示后形成样板间浏览；进入 WALK/VR 后另记一项内容浏览，两者通过同一样板间关联。 - **销售看到的信息**：样板间名称、内容类型、体验方式和有效浏览时长。 - **不记录**：列表滚动、未打开的样板间和沉浸画面内部移动。 - **结果场景**：客户打开“2LDK B 型样板间”详情 1 分钟，再进入 WALK 4 分钟。客户追踪显示两段浏览；营销统计按实际内容分别累计。 ### 7.10 户型卡片（建议 S4） - **统计对象**：具体户型的大图或详情。 - **记录规则**：卡片在页面中显示不代表客户主动浏览；卡片点击记录为普通操作；大图或详情成功显示后形成内容浏览。 - **销售看到的信息**：户型名称、面积、LDK/格局和有效浏览时长。 - **不记录**：卡片曝光、布局变化和大图缩放。 - **结果场景**：客户看到“A 户型”卡片后点击并查看大图 2 分钟。客户追踪显示点击和大图浏览；营销统计只增加 1 次户型浏览和 2 分钟，不把卡片曝光另算一次。 ### 7.11 住户表 - **统计对象**：成功打开的具体住户，以及实际进入的共有部 WALK/VR 内容。 - **记录规则**：住户详情显示后形成住户浏览；共有部体验显示后另记内容浏览。 - **销售看到的信息**：建筑、楼层、房号、户型代号、面积、LDK/格局、可售状态、共有部名称和体验方式。 - **不记录**：筛选、表格滚动、未打开的住户和不可进入的住户。 - **结果场景**：客户筛选 2LDK 后打开“A 栋 301”2 分钟，再进入“屋顶花园 VR”3 分钟。客户追踪显示住户和共有部体验；筛选不进入营销统计。 ### 7.12 眺望集 - **统计对象**：实际显示的每项眺望素材。 - **记录规则**：每项眺望内容分别形成浏览；成功切换到另一项素材时，结束上一项并开始下一项。 - **销售看到的信息**：素材名称、楼层或相对高度、朝向或位置、拍摄日期和有效浏览时长。 - **不记录**：筛选、全屏开关和相邻素材预加载。 - **结果场景**：客户查看“48 层南向眺望”2 分钟，再切换“48 层东向眺望”1 分钟。客户追踪显示两项内容；营销统计分别累计。 ### 7.13 资料集 - **统计对象**：成功打开的具体图片、视频、PDF 或其他资料。 - **记录规则**：资料完整显示后形成内容浏览。 - **销售看到的信息**：资料名称、资料类型、所属资料集和有效浏览时长。 - **不记录**：列表滚动、列表/网格切换、未打开的资料和下载。 - **结果场景**：客户查看“设备说明书.pdf”3 分钟。客户追踪显示资料浏览；营销统计增加 1 次浏览和 3 分钟，不产生客户操作。 ### 7.14 单个文件夹展示 - **统计对象**：成功打开的具体资料。 - **记录规则**：资料完整显示后形成内容浏览；文件夹只作为所属信息。 - **销售看到的信息**：资料名称、资料类型、所属文件夹或主题和有效浏览时长。 - **不记录**：资料流滚动、未打开的资料、文件夹本身和下载。 - **结果场景**：客户在“设计概念集”中打开“外观概念图 03”2 分钟。营销统计为图片增加 1 次浏览和 2 分钟，不另算文件夹。 ### 7.15 360转大楼 - **统计对象**：建筑环视内容整体。 - **记录规则**：建筑环视成功显示后形成一项内容浏览。 - **销售看到的信息**：建筑环视名称、建筑名称和有效浏览时长。 - **不记录**：拖动、旋转、播放暂停、复位和退出。 - **结果场景**：客户浏览“晴海 Residence 建筑环视”4 分钟并多次旋转。客户追踪只显示一段建筑环视浏览；营销统计增加 1 次浏览和 4 分钟。 ### 7.16 日影（建议 S5） - **统计对象**：日影内容整体；成功应用的离散日期或时刻。 - **记录规则**：日影显示后形成内容浏览；客户选定并成功应用日期或时刻时记录普通操作，连续拖动过程不逐次记录。 - **销售看到的信息**：日影名称、有效浏览时长，以及已应用的日期或时刻。 - **不记录**：播放暂停、全屏、缩放和连续拖动时间轴产生的中间值。 - **结果场景**：客户查看“冬至日日影”3 分钟，并应用 15:00。客户追踪显示日影浏览和“查看 15:00 日影”；营销统计只增加 1 次日影浏览和 3 分钟。 ### 7.17 活动日历 - **统计对象**：成功显示的具体活动详情。 - **记录规则**：活动详情形成内容浏览；进入预约功能属于普通操作；如果产品采用 S6，预约提交被受理后再由来场预约记录客户操作。 - **销售看到的信息**：活动名称、起止时间、状态、地点或类别和有效浏览时长。 - **不记录**：日历/列表切换、筛选、翻页和未打开详情的活动。 - **结果场景**：客户查看“周末样板间说明会”2 分钟并进入来场预约。营销统计为活动增加 1 次浏览；如果产品采用 S6，预约被受理后再由来场预约增加客户操作。 ### 7.18 来场预约（建议 S6） - **统计对象**：预约功能；提交请求被系统受理的操作。 - **记录规则**：预约表单显示后形成内容浏览；提交请求被系统受理后记录客户操作。 - **销售看到的信息**：预约功能名称、有效浏览时长、提交操作和发生时间。 - **不记录**：字段填写、修改、校验错误、失败提交、预约时间、联系方式和备注。 - **结果场景**：客户查看来场预约 2 分钟并完成一次已受理提交。营销统计增加 1 次浏览和 1 次客户操作；销售看不到表单内容。 ### 7.19 平面色彩切换 - **统计对象**：实际显示的每个平面色彩方案。 - **记录规则**：默认方案显示后形成内容浏览；成功切换后结束上一方案并开始记录新方案，不再重复增加一条切换操作。 - **销售看到的信息**：户型或空间名称、方案名称、已有色材说明和有效浏览时长。 - **不记录**：放大、缩小和比较滑块移动。 - **结果场景**：客户查看“A 户型标准色”1 分钟，再查看“暖色方案”2 分钟。客户追踪显示两项方案；营销统计分别累计。 ### 7.20 3D色彩切换 - **统计对象**：实际显示的每个三维色彩方案。 - **记录规则**：默认方案显示后形成内容浏览；成功切换后开始记录新方案。 - **销售看到的信息**：空间名称、方案名称、默认视点名称和有效浏览时长。 - **不记录**：空间内移动、旋转、缩放、复位和完整材质清单。 - **结果场景**：客户查看“2LDK 客厅·自然木色”3 分钟，再查看“深色方案”1 分钟。客户追踪显示两项方案；营销统计分别累计。 ### 7.21 平面家具摆放 - **统计对象**：实际显示的预设布局方案。 - **记录规则**：每个预设布局分别形成内容浏览；客户自行拖动后的临时布局不成为新内容。 - **销售看到的信息**：户型名称、布局方案名称和有效浏览时长。 - **不记录**：拖动家具、单件家具位置和客户自行调整后的结果。 - **结果场景**：客户查看“A 户型标准布局”2 分钟，再查看“家庭办公布局”2 分钟并拖动桌子。客户追踪只显示两个预设布局；系统不保存桌子位置。 ### 7.22 购置费用与贷款试算（建议 S7） - **统计对象**：购房费用计算和贷款试算两种模式；一次完成的试算。 - **记录规则**：模式显示后形成内容浏览；完成计算或重新试算属于普通操作，不进入客户操作汇总。 - **销售看到的信息**：模式名称、关联房号或户型名称和有效浏览时长；客户追踪的单次访问过程显示每次完成试算的发生时间。营销统计不汇总完成试算次数。 - **不记录**：贷款金额、收入、利率、首付、期限、月还款、费用明细、计算结果和输入过程。 - **结果场景**：客户查看“A 栋 4801 贷款试算”4 分钟并完成两次试算。客户追踪在本次访问中显示两条「完成试算」普通操作，各自使用实际发生时间；营销统计只增加 1 次浏览和 4 分钟，不汇总完成试算次数，客户操作也不增加。 ## 8. 尚未确认的产品选择与建议 以下内容由 B 端产品需求提出建议，不交给 C 端自行决定。开发可先按「建议采用」的口径评估；若技术实现有明显困难，需要把影响和可选方案返回产品确认。 | 编号 | 建议采用的规则 | 理由 | 不采用时的处理 | |---|---|---|---| | S1 | 地点详情和路线结果成功显示后分别形成内容浏览 | 两者都是客户实际取得的有名称结果 | 只记地图整体浏览，详情和路线不进入内容统计 | | S2 | 共有部或样板间详情与 WALK/VR 分别记录，并保留同一业务对象关联 | 销售需要区分客户看了详情还是进入了体验内容 | 只记共有部或样板间整体浏览，不单独统计体验方式 | | S3 | 3D 大楼只记录整体浏览和 Widget 明确定义的命名内容 | 自由旋转等操作数量大，不能说明客户关注了哪个对象 | 只记 3D 大楼整体浏览，不记命名视角或热点 | | S4 | 户型卡片曝光不算浏览；打开大图或详情才算内容浏览 | 列表显示不能证明客户主动查看了某个户型 | 如果只能取得曝光，则不生成户型内容浏览数据 | | S5 | 日影只记录成功应用的离散日期或时刻，不记录连续拖动中间值 | 保留有意义的选择，避免一次拖动产生大量记录 | 只记日影整体浏览，不记日期或时刻操作 | | S6 | 来场预约以提交请求被系统受理作为客户操作 | 可以排除失败提交，也不把后续预约处理误写成已完成 | 若 C 端不能提供受理结果，则只记「点击提交」普通操作，不进入客户操作汇总 | | S7 | 完成试算作为普通操作，不进入客户操作汇总 | 试算能说明使用过程，但不等于预约或购买意愿 | 只记试算模式浏览，不记完成次数 | ## 9. 开发评审结论 ### 9.1 开发必须按本文评审的部分 - B 端客户追踪和营销统计的页面范围、权限、筛选、排行、详情和错误处理，可以按 PRD §4.6 与对应用例评审。 - 页面访问、内容浏览、普通操作和客户操作的层级及 B 端展示方式，可以按第 4 节评审。 - 当前页面公共操作只包含切换语言；页头和项目联系信息页脚只展示，不产生统计记录。开发可以按这一范围评审，不需要等待通用组件清单。 - 删除或改名后的历史保留、销售页面不展示 Widget 实例、B 端不推断缺失记录等规则已经具备评审依据。 - 资料集和单个文件夹展示只上报实际打开的资料及其浏览结果；不要求上报或统计下载。 ### 9.2 开发需要回复的实现情况 以下问题不是让 C 端决定 B 端的统计需求，而是用于分清已有记录和新增工作。开发评审回复不应只写「支持」或「不支持」，应按 Widget 提供具体结果。 | 编号 | 开发需要回复的内容 | 本文的建议 | 产出 | |---|---|---|---| | T1 | 每个 Widget 已经有哪些页面显示、内容显示、点击、选择和客户操作记录 | 已有记录直接接入；本文要求但当前没有的记录列为新增工作 | 22 个 Widget 的「已有记录、需要新增、明确不记录」清单 | | T2 | 各内容和操作对象能否提供稳定标识、销售可读名称和访问时参数 | 必须使用稳定标识汇总，并保存访问发生时的名称与参数 | 对象字段来源和历史保留方式 | | T3 | 每类内容浏览能否提供进入、离开和完整有效时长 | 建议为本文要求的内容浏览补充有效时长；暂时无法提供时，保留浏览次数和客户数，时长显示为不可用，不记为 0 | 每个 Widget 的时长能力和需要新增的记录 | | T4 | 来场预约提交能否返回「请求已受理」和失败结果 | 建议按 S6 以「请求已受理」成立客户操作；不能提供时只记普通操作 | 成功、失败和网络异常时可提供的结果 | 以上四项不影响 B 端页面和汇总规则的评审，但会影响 C 端需要新增的工作、数据接入方式和最终验收范围。 ### 9.3 不属于产品文档的问题 - 计时采集方式、事件字段名、接口、重试、顺序、去重和存储方式由技术设计确定。 - 技术方案不能改变本文确认后的业务对象、记录成立条件、销售可见结果和不记录范围。 - B 端不得为了补齐页面数据而推测 C 端没有提供的对象、操作或时长。 ### 9.4 明确不在当前范围的内容 - 资料下载、下载点击、下载请求、下载成功和下载时间。 - 未被 C 端定义的电话、邮件、即时沟通、收藏、分享和返回首页操作。 - 现场讲解不进入客户自主访问统计；其独立记录规则按 PRD §4.3.8 和对应用例处理。 ## 10. 验收检查 - 同一访问中的页面、内容、普通操作和客户操作能够按发生顺序还原，且没有把点击写成内容浏览。 - 列表型 Widget 只统计客户实际打开的条目；未打开条目不产生记录。 - 3D、地图和沉浸内容只显示 Widget 明确定义的结果，不展示大量内部操作。 - 客户追踪不出现 Widget 实例编号；营销统计能够按页面和实际内容汇总。 - 每个 Widget 至少使用本节结果场景验证一次正常记录和一次“不记录”情况。 - 删除或改名后，历史数据仍使用访问发生时的信息。 - 无法取得的时长、对象或操作不由 B 端推算。 - 刷新、重复打开和多标签页不会把同一次真实访问重复计为多次有效访问。 - 机器人、自动监测、内部测试、重复和无效访问不会进入客户追踪统计、营销统计或新的 AI 处理。 - 待检查记录仍可在访问记录中查看和处理，但不会进入统计或新的 AI 处理。 - 纠正客户归属、确认有效或排除记录后，受影响的客户、页面、链接、内容和项目统计按同一批有效访问数据重新计算。 - 统计重新计算期间显示「数据更新中」；失败时保留已有结果、说明未更新并可重试。