00先看这四步
照着做，遇到“暂无数据”时先检查浏览器标签页和采集桥。
01
登录控制台
注册或登录工作区，保持会话有效。所有设备和规则按用户隔离。
02
插件登录账号
点击插件图标，使用同一个控制台账号登录；设备凭证自动创建，不复制令牌。
03
选择监控目标
打开目标计划的广告层级，日期选择“今天”，保存广告账户和计划编号，账户时间由插件自动识别。
04
先观察再配置规则
先看到完整快照和正确的花费、购买价值，再设置目标 ROAS 与最低花费。
这套工具各自负责什么？
指纹浏览器负责保持 Meta 登录页面；插件负责读取当前页面的实时投放响应并上传；控制台负责保存快照、计算 ROAS、展示状态和记录动作。插件和控制台必须登录同一账号，才能把数据归到同一个工作区。
01控制台和插件使用同一账号
插件 0.2.2 默认自动连接；一键安装包自带连接组件，直接登录控制台账号即可绑定本浏览器。
1下载、解压、双击安装
下载顶部的 Windows 一键安装包，先解压，再双击包内的“双击安装.cmd”入口。程序会校验组件、安装本机连接客户端并设置当前用户登录后启动；无需安装 Node、输入端口或复制令牌。安装窗口会给出插件目录和下一步说明。
2首次在指纹浏览器加载插件
使用指纹浏览器的插件安装入口，或打开 Chrome 扩展管理页，开启开发者模式并选择“加载已解压的扩展程序”。选择安装窗口显示的插件目录，目录内应直接包含 manifest.json。每个独立浏览器首次都要加载一次。已有插件升级时，请保留原安装路径和设备，按窗口提示操作。
3登录控制台的同一账号
点击 FB ROAS 图标，输入控制台用户名和密码，保持默认“自动连接”，点击“登录并开启同步”。程序优先检测浏览器直连，网络不通时检测本机客户端；验证账号归属后显示当前同步账号。密码不保存在插件，同账号重复登录沿用设备编号。
4核对监控目标和真实数据时间
在 Ads Manager 选择目标计划的广告层级和“今天”，点击插件“从广告页面读取编号”，确认账户和计划编号后保存目标。无需手动选择时区，插件会从 Meta 响应自动识别账户时间。今日金额可以先同步；账户当天时间和日期未确认前不会自动暂停。连接成功只代表控制通道接通，请回控制台确认新快照时间、花费和购买价值。
隐私边界：Meta Cookie、会话令牌和完整请求内容留在本地浏览器；控制台接收的是设备状态和指标快照。不要把令牌粘贴到群聊或提交到代码仓库。
登录控制台演示截图 / 示例数据；点击图片可放大。
插件账号登录0.2.0 登录页演示截图；默认自动连接，遇到问题点击一键修复。
02连接指纹浏览器里的 Ads Manager
采集来源是已经登录的页面网络响应，页面可见数据和后台快照需要分别检查。
1在正确的浏览器配置文件里打开 Ads Manager
确认使用绑定设备对应的指纹浏览器配置文件，并登录目标广告账户。打开计划下的“广告”层级，日期选择“今天”，让花费和购买价值列完整出现。
2连接当前标签页
在插件中点击“从广告页面读取编号”，核对账户和计划编号后点击“保存目标并开始同步”。广告层级日期选择“今天”，无需填时区；账户时间由插件从 Meta 返回信息自动识别。插件会自动连接相同账户的 Ads Manager 页面，读取当前选中的计划并持续跟随；切换计划后会自动更新采集目标，不需要重新手动填写计划编号。首次打开或会话恢复后，页面产生新的网络响应时插件会自动保存可复用的读取模板。
3等待控制台出现首条快照
回到总览，检查设备在线状态、最后采集时间和广告创意表格。控制台刷新读取已经保存的快照；数据采集由插件每 60 秒发起。检查每条广告的数据时间，超过两分钟的数据不得用于暂停。今日金额可以先上传展示；账户当天时间或日期仍待自动确认时，不会触发暂停。
数据链路示意。Cookie 和完整响应正文不进入控制台。
无人值守采集如何运行：插件连接已登录的 Ads Manager，首次观察到广告层级“今天”的请求后，每 60 秒在原浏览器会话中重新读取数据，并自动跟随当前选中的计划，不需要人工反复刷新页面或反复配置计划。连接方式默认自动检测，遇到异常点击插件“一键修复连接”；需要本机客户端时解压后双击“双击安装.cmd”启动。客户端只转发本站控制通道，不转发 Meta Cookie 或 Meta 请求。浏览器需要持续运行，使用本机客户端线路时客户端也要保持运行，标签页可以在后台。客户端会发现已开放本机调试端口的指纹浏览器；没有开放调试端口的浏览器仍可尝试直接连接。插件会重新连接同一账户的页面。如果 Meta 会话失效，插件会停止使用旧模板并显示会话失效提示；恢复 Ads Manager 登录后，插件会自动重新抓取读取模板。旧版 CDP 监听工具仅用于只读诊断，不负责自动停投。
实时数据口径：系统使用广告层级当前“今天”的投放成效网络响应，读取花费和购买价值；投放状态须由经过验证的状态请求回读。购买金额缺失会显示“未返回”，不当作零收入。插件按采集间隔重新读取已捕获的当前会话请求；命中低 ROAS 后，只有状态请求模板已完成验证才会下发暂停并等待回读确认，否则只记录“待验证”。
在线更新：插件设置页可以检查版本。后台更新代理会从版本清单下载新包、校验 SHA256、替换扩展目录并重载后台服务线程；更新失败时保留旧版本回滚目录。开发者模式的版本检查与安装是两个步骤：安装需要单独运行更新代理并配置实际扩展目录和 CDP 端口；本机连接代理只负责通信，不自动下载或替换插件。
查看总览演示截图 / 示例数据；不代表当前账号实时状态。
03配置规则：先读数，再决定动作
规则按计划保存，判断粒度是广告创意；没有规则时只保存指标，不生成暂停任务。
填写计划规则
- 计划 ID：与实时投放快照中的 campaign_id 一致。
- 目标 ROAS：例如 2.00。
- 最低花费：例如 100，防止刚开始投放就判断。
- 统计窗口固定为 account_today，以账户时区划分当天。
- 首次建议不勾选“命中后自动暂停广告”。
ROAS 怎么算
购买价值÷广告花费=ROAS
例如花费 120、购买价值 180，ROAS = 180 ÷ 120 = 1.50。如果目标是 2.00 且最低花费门槛已满足，快照会被标记为低于目标。
自动暂停的开关：只有在快照属于账户时区当天、实时投放数据完整、花费达到门槛、花费大于零、广告仍为投放中、没有未完成暂停任务，并且 ROAS 低于目标时，才会创建一次暂停任务。目标 ROAS 和最低花费必须自行填写，未填写时只采集。成功状态必须有回读证据；请求超时或浏览器在执行中重启时，保留不确定结果，跨日也不重复发送暂停。人工恢复广告后，须先观察到有效 ROAS 回到目标以上，再次跌破目标才重新触发。当前“请求发送与状态回读”的真实 Meta 发包链路仍处于待验证状态；先关闭自动暂停观察数据。
设置目标 ROAS 和最低花费演示截图 / 示例数据；先用只读模式确认口径。
04连接多个浏览器
每个指纹浏览器都当作一台独立采集设备管理。
| 浏览器配置文件 | 设备 ID | 插件账号 | 设备凭证 |
|---|
| 店铺 A / 主窗口 | fp-shop-a | 同一控制台账号 | 插件自动管理 |
| 店铺 B / 主窗口 | fp-shop-b | 同一控制台账号 | 插件自动管理 |
四个值要一一对应：独立配置文件、独立 CDP 端点、独立设备 ID、独立设备凭证。后两项由插件登录时自动创建和保存，无需手动复制。后台会把多个设备的快照合并到当前账号。一个账号建议先运行一个采集器；同一广告被多个采集器同时上传时，幂等保护虽已覆盖暂停任务，但多采集并发仍建议先小范围验证。
端点配置的实际含义
本机连接客户端会检查浏览器已开放的本机调试端口，并验证插件身份后连接；不同客户的扩展编号无需手动填写。每个独立浏览器中分别登录控制台账号和保存监控目标；设备凭证由插件分别保存。旧版只读 CDP 诊断器每次只监听一个目标，不等同于新版插件控制通道。多浏览器同时采集同一广告仍需单独现场验证。
05如何理解数据和状态
“页面看到了数据”和“控制台保存了快照”是两个检查点。
数据口径
window默认是账户时区当天，跨午夜后当天边界会变化。
spend / value直接读取 Meta 当前投放成效响应中的花费和购买价值。
currency金额和最低花费均按广告账户币种理解，后台不做币种换算。
snapshot是一次观测记录，不等于当天唯一广告数，也不保证每条都是最新页面状态。
状态词典
ACTIVE解析结果显示广告仍在投放。
PAUSED解析结果显示广告已暂停，人工暂停也会被记录。
审核未通过广告开关虽然开启，但 Meta 返回审核未通过；不视为正在投放，不触发低 ROAS 暂停。
UNKNOWN状态字段缺失或无法归类，安全起见不会触发自动暂停。
不完整 / 过期只做记录或忽略，不参与低 ROAS 判定。
06常见问题
先点击“一键修复连接”，再检查插件账号、广告页面和数据时间。
第一次打开插件，应该按什么顺序操作？
先在控制台注册或登录，再在同一个指纹浏览器里打开 Ads Manager 并进入目标计划的广告层级，日期选择“今天”。点击插件图标，用同一账号登录，读取或填写广告账户 ID 和计划 ID，点击“保存目标并开始同步”。无需选择时区，账户时间由插件自动识别；未确认前可以同步今日金额，但不会自动暂停。看到广告页面已连接、控制台连接正常和最新同步数量后，再回控制台核对快照。
客户提示“本机连接代理尚未就绪”，怎样一次解决？
升级到 0.2.2，默认使用自动连接。先点击“一键修复连接”；如仍提示连接客户端未启动，下载 Windows 一键安装包，完整解压后双击“双击安装.cmd”，保持指纹浏览器开启，再回插件登录。安装成功不代表广告数据已同步，需检查控制台的新采集时间。
还需要选时区吗？
0.2.2 无需手动填写或选择时区。在 Ads Manager 的目标计划广告层级选择“今天”，插件会从当前 Meta 会话返回的账户元数据中自动识别账户时间，不按电脑所在地猜测。时区仍用于确认账户“今天”的日期边界，不改变 ROAS = 购买价值 ÷ 花费。今日金额可以先同步展示；若账户时间或当天日期仍显示待确认，自动暂停会等待确认完成。旧版填过 Alaska 也不再阻止保存目标。真实 Meta 自动识别与暂停回读仍待实际账号现场验证。
选择今天，自动确认账户时间0.2.2 演示截图 / 示例账号和目标，未连接真实广告；点击图片可放大。
购买价值显示“未返回”时会怎样？
这表示当前响应还没有完整返回购买价值，可能仍在加载、分页或字段没有展开。工具会继续记录可见状态，但这条快照不满足自动暂停的数据完整性条件；先刷新广告表格并等待下一次同步。
控制台显示“暂无数据”，但 Ads Manager 页面有数字，怎么办？
确认日期是“今天”、层级是“广告”、花费和购买价值列已加载，并确认 Ads Manager 会话仍有效；如果插件提示 Meta 会话已失效，恢复登录后它会自动重新抓取模板。检查插件同步账号是否与控制台账号一致，点击“一键修复连接”；提示需要客户端时，下载并解压后双击“双击安装.cmd”启动。页面重新打开并不代表后台已经收到新快照，需等待“最后采集时间”变化。
设备显示离线，是账号掉线了吗？
设备离线只表示后台最近没有收到该设备的上传或心跳；可能是浏览器关闭、采集桥退出、CDP 端口变化、令牌过期或网络中断。先保持浏览器开启，点击插件“一键修复连接”；提示登录过期时，用控制台账号重新登录。
为什么没有规则时仍然看得到指标？
这是预期行为：指标采集与规则判定分开。没有计划规则，后台可以保存并展示快照，但不会生成暂停任务。建议先用这个模式核对广告 ID、页面“今天”的日期范围和金额口径，并留意插件账户时间是否已自动确认。
窗口重启后需要重新操作吗？
保持指纹浏览器开启即可重新检测连接。浏览器直接连接时无需本机客户端；使用本机客户端线路时，确认客户端已随 Windows 登录启动，并且浏览器开放了本机调试端口。插件凭证有效时会恢复同一设备和监控目标；登录过期时使用控制台账号重新登录。
多个浏览器上传同一个广告，会不会重复暂停？
后台会按账号、计划、广告和当天窗口查找已有动作，已创建动作不会重复创建。为了降低并发和口径差异，仍建议一个账号先运行一个采集器，确认数据链路后再扩展。
自动暂停现在是否已经可以直接用于生产？
规则判定和动作状态模型已在代码中，但当前真实 Meta 私有请求模板、请求成功后的状态回读，以及浏览器重启后的完整恢复仍需用脱敏样本和单广告实测验证。没有完成验证前，保持“只读观察”更合适。
07上线前检查清单
完成下面项目后，再扩大到更多浏览器和计划。