美洽访客轨迹不显示

美洽访客轨迹不显示，多半不是“神秘故障”，而是埋点、脚本或会话丢失等环节出了问题。按顺序排查脚本是否加载成功、浏览器或插件是否拦截、单页应用路由是否已上报、跨域与 Cookie 策略是否影响会话、以及美洽后台配置与数据保留设置，通常能在短时间内定位并修复问题。

先弄清楚“访客轨迹”到底记录了什么

先把概念弄清楚很重要。美洽的访客轨迹本质上是把用户在网站上的页面浏览、停留时间、来源等信息按时间线记录下来，方便坐席在会话里看到来访者看过哪些页、什么时候来过、路径如何。要记录这些信息，前端脚本要把“页面浏览”事件发送到美洽系统，并且需要把这些事件和同一个“访客身份”关联起来（通过 cookie、localStorage 或其他会话标识）。

三个技术要点（很关键）

• 埋点/脚本加载：负责发送页面浏览事件。
• 会话标识：通过 cookie 或本地存储维持同一访客的多个页面访问关系。
• 后台接收与展示：美洽后台需要接受并保存这些事件，然后在访客面板里展示轨迹。

不显示的常见原因（把容易忽略的说清楚）

故障看似复杂，但大体上可归为几类。我把每类用最朴素的语言讲清楚，然后给出排查要点。

1）前端脚本没有正确加载或执行

• 页面没有引入美洽的 JS 或引入顺序有问题；
• 脚本被 CSP（内容安全策略）或浏览器插件（广告拦截、隐私保护）拦截；
• HTTPS 页面加载 HTTP 脚本被浏览器阻止（混合内容）；

排查要点：用浏览器元素面板看是否存在美洽脚本、Network 看脚本请求是否 200、Console 看有没有语法错误或 CSP 报错。

2）单页应用（SPA）未显式上报路由变更

很多现代网站是单页应用，路由变化不触发整页刷新。若美洽的默认埋点只监控 page load，那么路由切换不会产生新的“页面浏览”事件，结果就是轨迹中看不到内页切换。

排查要点：在路由切换时检查 Network 或 Console，确认是否有“虚拟页面浏览”或类似请求；若没有，需要在路由回调里手动调用美洽的上报方法（或触发自定义事件）。

3）会话与访客 ID 丢失或不同步（跨域、Cookie 策略）

如果每次打开页面都被识别为新用户，那么轨迹不会串成一条完整路线。常因跨域（例如首页和子域不同）、第三方 Cookie 被浏览器阻止或 Cookie Domain 设置不当导致会话无法维持。

排查要点：观察是否存在用于识别访客的 cookie 或 localStorage key，检查其在不同页面/子域是否存在且一致。注意 Safari 的隐私策略和浏览器的“阻止第三方 Cookie”设置会影响跨域识别。

4）前端上报被拦截或请求失败

即便脚本加载成功和事件发出，网络请求也可能被拦截（如跨域未允许、代理/防火墙阻断、返回 4xx/5xx）。

排查要点：Network 面板过滤出提交轨迹的请求，查看返回状态、响应体、请求头是否带上必要参数（如 appId、访客 id、token 等）。

5）企业后台或权限配置关闭/筛选规则导致不展示

有时后台设置了采集开关、隐私合规设置、IP 白/黑名单或数据保留策略，导致部分或全部轨迹不被保存或不展示。

排查要点：去美洽管理后台查看埋点、隐私/合规、数据保留和筛选规则设置，确认没有意外关闭或过滤。

6）老数据被清理或采样策略生效

如果问题是“历史轨迹突然消失”，考虑是否触及数据保留策略或系统的采样策略（只存一部分访客轨迹以节省空间）。

排查要点：查询后台的数据保留期与采样策略，确认时间窗口和采样比率。

一步步排查指南（像玩侦探游戏一样）

下面是按顺序的具体操作，按着做即可。遇到某步就停下来解决，通常不需要跑全套。

第一步：确认脚本加载与执行

• 在页面打开开发者工具 → Elements，查找美洽相关脚本标签；
• Network 中筛选 JS，确认脚本 URL 返回 200，没有被重定向或阻止；
• Console 中查看是否有 ReferenceError、CSP 报错或脚本异常；

第二步：观察上报请求（最直接）

• 在 Network 中搜索与美洽上报有关的请求（通常是 POST 或 GET，带有 session/visitor 字段）；
• 关注请求时间点是否与页面切换一致，响应码是否为 200 或 204；
• 若请求被拦截或返回错误，根据错误信息继续定位（403/401 可能是鉴权问题，4xx/5xx 说明服务端或请求格式问题）。

第三步：验证单页应用路由上报

• 在 SPA 中切换路由，查看是否有额外的“页面浏览”上报请求；
• 如果没有，按你所用框架的路由生命周期（如 Vue 的 afterEach、React Router 的 history.listen）手动触发一次页面上报；
• 测试后查看后台是否收到新的页面事件。

第四步：检查会话与识别信息

打开 Application（或储存）面板，检查 cookie、localStorage、sessionStorage 中美洽相关字段，确认：

• 同一浏览器会话不同页面是否有相同的访客标识（ID）；
• 跨域访问时该标识是否丢失；
• 浏览器隐私模式或设置是否清除了此类存储。

第五步：确认后台配置与展示规则

• 登录美洽后台查看访客轨迹开关、数据保留期、权限设置与筛选条件；
• 确认没有配置错误的 IP 黑名单、渠道过滤或敏感数据规则；
• 如果团队中有人改过配置，最好回溯修改记录。

常见问题与操作建议（实操篇）

SPA 如何确保轨迹完整

单页应用需要在每次路由切换时手动上报“虚拟页面浏览”。思路如下：

• 在路由切换回调里调用美洽的页面上报方法（若文档提供 SDK 方法就用它）；
• 同时将当前页面 URL、title、来源 referer 等信息附带上报；
• 保证上报时携带或能关联到当前访客 ID，以便把事件串联为一条轨迹。

跨域场景的对策

如果站点在主域和子域之间跳转，或存在第三方域名，常见问题是 cookie 不能跨域共享。解决思路：

• 尽量使用第一方 cookie（将埋点脚本部署到主域，并用主域设置 cookie）；
• 若必须跨域，使用 URL 参数或后端拼接方式把访客 ID 传递到目标域并写入该域的本地存储；
• 或在后端做“会话绑定”：把前端上报的临时 id 与后端会话绑定，后台再把事件合并。

隐私合规与用户同意

现在很多公司在收集访客行为时需要征得用户同意（尤其是跨境或涉及敏感信息时）。如果站点实现了“未同意不埋点”的逻辑，那么在未同意情况下轨迹不会产生，这属于合规行为而非故障。

处理建议：与产品/法务确认同意逻辑是否生效，测试在同意后轨迹是否恢复。

一张排查清单（方便复制到故障单里）

如果在排查中遇到这些具体情况，怎么处理

控制台出现 CSP 报错

这说明当前页面的 Content-Security-Policy 不允许加载外部脚本或发起请求。解决办法是把美洽脚本所在的域和上报域加入到 script-src 和 connect-src 的白名单里，或者调整 CSP 策略。

上报请求返回 401/403

通常是鉴权或域名校验问题。确认前端请求头或参数中有正确的 appId/token，或与美洽后台确认当前站点授权是否到期或被限制。

只在部分浏览器出现问题

那很可能是浏览器策略差异或扩展影响。先用无痕/禁用扩展模式验证，再检查浏览器版本是否存在已知的第三方 Cookie 或 localStorage 限制。

小技巧与防御性做法（避免类似问题再次出现）

• 在关键路由上加入控制台日志，方便定位是否触发了页面上报；
• 对上报请求做监控报警，网络请求失败超过阈值自动告警；
• 在埋点脚本里容错处理，确保友好降级而不致报错阻断页面其它脚本；
• 记录并审计后台配置变更，避免误关采集开关。

总结思路（用费曼式一句话复述，记着往里钻）

访客轨迹不显示是“信息没有被完整从浏览器送到美洽并保持会话关联”的表现，沿“脚本→请求→会话→后台”这个链条逐步排查，通常能快速定位原因并修复。

好啦，这些是我排查美洽访客轨迹不显示时常用的思路和具体步骤。说白了就是走流程，用浏览器工具看脚本和请求，考虑 SPA 路由与跨域会话这两大坑，再看看后台配置与隐私合规。你现在可以先按上面的排查清单试一遍，有具体日志或错误信息的话我可以继续帮你分析。嗯，这里先记到这儿，动手试试会更快找到原因。