检查安装与数据可见性
明确已有网站安装入口及发布、预览、导出的区别，依次验证标签、请求与分析结果。
准备能重现的测试条件
先确定目标 Profile、站点和用户最终访问的网址，并由有权限的负责人修改网站或标签管理设置。不要使用其他站点的标签。已经存在标签时，先检查对应的 Profile 和安装方式，再决定是否需要调整。
记录测试时间与时区、设备、浏览器、网址和动作，先从打开一个页面开始。需要同意的网站应按正常流程完成同意，并确认测试访问未被 IP 或 User-Agent 排除规则过滤。
区分发布、预览与导出
| 对象 | 需要确认 |
|---|---|
| 已有外部网站 | 在网站侧安装目标 Profile 的基本标签，按下方共用安装流程操作。 |
| 从 Ptengine AI 发布到自有域名的页面 | 发布过程会加入采集标签。应测试最终公开网址，不要再手动重复添加同一标签。 |
| 编辑或生成过程的预览 | 与加入生产基本标签的发布过程不同，不能只凭预览判断生产采集成功或失败。 |
| HTML 导出 | 开启包含采集的设置时会加入标签；关闭时，导出过程不会额外加入采集标签。目标站点可能已有标签，仍应检查实际部署后的 HTML。 |
公开网址准备见发布到自己的网站，导出操作见导出 HTML。给页面设置自定义 Head/Body 脚本与安装 Ptengine 基本标签是不同任务。
给已有网站安装基本标签
本节是使用旧 Ptengine 界面的共用安装流程，不是在 Ptengine AI 的资产界面寻找代码。
- 在旧 Ptengine 打开目标站点，进入“実装”，或点击站点名旁的齿轮，打开“基本設定とタグ取得”。
- 复制目标站点的基本标签，按官方基本标签安装指南（旧界面，日文）核对对象与代码。
- 普通 HTML 网站将标签放入需要采集页面的 head 内，保存并部署到网站。使用公共模板时，确认所需页面都会输出标签。
- 通过 GTM 安装时，按GTM 指南（日文）配置自定义 HTML 标签、目标页面触发器并发布容器；WordPress 则参考WordPress 指南（日文）选择适合当前主题的方法。
- 打开最终公开网址，依次完成下方标签、请求与分析结果三项验证。
以上链接属于旧 Ptengine 的日文帮助。入口或安装权限不符时，请网站维护者处理。Shopify 标签安装不适用本节的 HTML 直接粘贴步骤；它也不同于把 Ptengine AI 页面推送到 Shopify。
第一步：确认正确页面包含采集代码
- 用浏览器打开准备好的公开网址，在开发者工具中打开 Network，然后重新加载页面。
- 记下所复制基本标签中的 Profile ID，查找以该 ID 命名的
.js请求，例如https://js.ptengine.jp/＜Profile ID＞.js。加载域名会随地区与环境不同，以实际取得的标签为准。 - 确认 ID 与目标 Profile 一致，脚本成功加载。使用 GTM 时还要确认标签在该页触发，容器已经发布。
打开 Ptengine AI 热图时若出现未安装标签提示，也要区分手动安装、GTM 触发条件与浏览器广告拦截。自动检测结果只是一项线索，不代表数据已经发送或进入分析结果。
第二步：确认访问时请求能够成功
- 保持 Network 记录，重新加载页面，用
collect筛选。常规采集使用发往/collect的 POST 请求，网址含traceId；具体主机随部署环境而异。 - 打开请求，检查 Payload 中的
profileId是否与目标 Profile 一致。脚本文件加载成功与这个采集发送请求是两个不同检查对象。 - 确认请求没有被拦截或报错。失败时向技术负责人提供网址、时间、状态，必要时提供 traceId；Payload 可能包含识别信息，不要原样整体分享。
有代码但没有发送请求时，检查同意设置、GTM 触发条件、浏览器扩展和控制台错误。任意请求成功或脚本返回 200，都不能单独证明采集已发送。确认发送后，还要继续检查分析结果。
第三步：在相同范围检查数据
- 回到 Ptengine AI，在同一 Profile 打开 Insight。
- 通过 @ 选择目标页面，写明包含测试访问的期间与时区，提问“查看这个页面的 PV，并列出目标网址、期间与设备条件”，先去掉不必要的筛选。若 @ 候选中没有该页面，直接写出公开网址，询问该期间是否有数据；不能只凭没有候选就断定安装失败。
- 确认回答引用了实际数据，网址和期间与测试一致；需要时进入页面分析详情，以同样条件复查。
完整检查记录应包含三项：“目标 Profile 的标签已加载”“同一 profileId 的 collect 发送未报错”“同一公开网址、测试所在期间的分析结果有 PV”。由于可能混入其他访问，看到 PV 不等于已经单独识别了自己的这一次测试。请求已发送但仍无数据时，不承诺固定等待时间，附上条件与请求记录进一步排查。
按证据定位，而不是反复重装
| 观察 | 优先检查 |
|---|---|
| 没有目标 Profile ID 的脚本 | 公开环境、模板、GTM 发布与触发条件 |
| 有脚本但没有 collect 发送 | 同意、执行错误、浏览器拦截 |
| collect 请求报错 | 请求目标、网络、错误状态与时间 |
| 已发送但分析无数据 | Profile、公开网址、期间、设备、排除与过滤条件 |
内部访问与机器人排除，可由管理员参考旧 Ptengine 的IP 排除（日文）和User-Agent 排除（日文）核对；这些链接不表示 Ptengine AI 内存在同名设置页面。不要无依据地重复装标签，每次修正一个条件后重新检查三个环节。
把可复查的信息交给协作者
需要协助时提供页面地址、发生时间与时区、测试动作、当前站点范围、报表筛选，以及请求的成功或错误状态。敏感凭据、完整用户会话和不必要的个人信息不应放进共享截图；只提供定位问题需要的部分。
修复后用同样条件重新测试，再判断问题是否解决。一次成功不代表所有页面都覆盖，若站点有不同模板、域名或设备版本，应检查本次业务真正需要的范围，最后再开始比较用户表现。