用途:该技能用于识别 Parse.ly 客户是否在 tracker 中通过 extra_data 标记员工或内部页面的 pageview。Parse.ly 仪表盘会用该标签做分群过滤,但 DPL 流是原始数据,已标记事件仍会到达,因此需要在分析流程中主动过滤。
主要能力:采样事件并判断是否存在明确无误的员工流量标签,将结果写入 bucket.json,后续 staircase 运行会自动应用过滤并在报告中给出一行提示。仅当标签明确时才自动应用:键名为 internal、is_internal、is_employee、employee、staff、internal_user/internalUser、internal_traffic 之一,值为 true/1/yes 等布尔式,且被标记比例占采样 pageview 的 0.1% 至 25% 之间(大小写不敏感)。键下存在多个不同值或比例超范围则静默跳过。
使用方式:先解析插件根目录并设置 plugin_python,插件根目录为 SKILL.md 上方两级的安装目录,开发检出时为 plugin/。读取 ${XDG_CONFIG_HOME:-~/.config}/agentic-analytics/bucket.json,其中需包含 bucket(存放客户 DPL 事件的 S3 桶)与 cache_dir(客户数据标识)。若文件缺失,应先运行 init 流程。检测命令:
"$plugin_python" "$plugin_root/skills/identify-employees/scripts/detect_employee_filter.py"
--bucket-config "${XDG_CONFIG_HOME:-$HOME/.config}/agentic-analytics/bucket.json"
[--site <site>]
传 --site 可将采样限定到指定站点,省略则跨所有站点采样。清除已保存过滤:在上述命令基础上加 --clear,会直接删除已保存过滤并退出,不扫描。输出脚本的一行结果,原样输出,不加框定或总结。若湖中无 pageview 事件,需先运行 staircase 报告或 refresh-cache 流程填充数据后再重试。客户更改 tracker 后应重跑本流程刷新过滤条件。本流程不涉及 Parse.ly 账户级 IP 黑名单,使用该机制的客户无需本流程。