> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Monitor 简介
> 自动信号检测与数据补充 — 通过 webhook 或电子邮件实时传送。
## 为什么选择监控？
传统 API 需要您自行构建和维护信号管道 — 轮询端点、跟踪状态、处理分页，并将多个调用拼接在一起进行数据补充。监控用一个配置替代了所有这些工作。
信号一出现即被检测并投递 — 无需轮询循环或定时任务。
在一个查询中组合信号过滤器和全局公司过滤器。"500+ 员工且正在招聘 AI 岗位的公司" — 一个配置，而非多次 API 调用。
每次触发自动补充公司档案和人员联系信息，无需额外 API 调用。
重试逻辑、故障处理、去重和投递跟踪 — 全部为您管理。
## Monitor 工作原理
选择要追踪的信号（招聘、新闻、广告），设置信号级筛选。可选择叠加**全局公司筛选**来缩小结果范围——例如，只显示美国500人以上公司的信号。
将 `frequency_minute` 设置为 `0`（默认值）后，monitor 将实时运行——在信号出现时立即检测并投递。
匹配的信号会自动补充完整的公司档案，以及可选的联系人信息——全部在一次触发中完成。无需额外调用。
结果将发送到你的 webhook 端点或电子邮件收件箱。你还可以通过仪表板端点获取完整的统计数据和日志历史。
***
## 检测模式
每个 monitor 以两种检测模式之一运行：
**信号驱动发现。** 你定义要查找的信号——系统在所有公司中查找匹配的信号，然后补充结果数据。
使用**全局公司筛选**（`company_filters`）作为第二层来缩小符合条件的公司范围。例如："查找所有 AI 职位，但仅限于1000人以上的公司。"
最适合：
* 广泛的市场扫描和趋势发现
* 发现你从未追踪过的新公司
* 大规模信号驱动的潜客挖掘
```
Signal Filters → Matching Signals → Global Company Filters (optional) → Enrichment → Delivery
```
**特定公司驱动发现。** 你通过 `companies`、`domains` 或 `linkedin_urls` 提供目标公司列表，系统监控它们的匹配信号。
**全局公司筛选**（`company_filters`）在此仍作为第二层应用——在将关注列表与更广泛的条件结合时非常有用。
最适合：
* 追踪具名客户（"当 OpenAI 发布新职位时通知我"）
* 针对特定公司的竞争情报
* 基于客户的监控流水线
```
Target Companies (companies/domains/linkedin_urls) → Signal Filters → Global Company Filters (optional) → Enrichment → Delivery
```
***
## 信号类型
Monitor 目前支持三种信号类型，更多类型持续添加中：
新的职位发布——按职位名称、地点、发布日期等筛选。
公司新闻——发布、合作、融资轮次、领导层变动等。
活跃的广告活动——按目标地点、日期范围和关键词筛选。
### 每种信号的含义
| 信号类型 | 揭示内容 | 示例用途 |
| ---------------------- | ---------------------------------- | ----------------------------------- |
| **Jobs（职位）** | 公司正在积极招聘 — 表明特定部门的增长、新项目或预算分配。 | 工程招聘激增通常预示新产品开发。销售招聘暗示收入扩张。 |
| **News（新闻）** | 公司里程碑 — 融资轮次、产品发布、合作伙伴关系、领导层变动或挑战。 | 融资公告是触达的理想时机。领导层变动创造新的决策者机会。 |
| **Advertisements（广告）** | 公司在营销上的投入方式和方向 — 揭示扩张计划、目标市场和竞争定位。 | 在新地域的大量广告投放预示市场进入。竞争对手投放类似广告表明市场活跃。 |
### 投递频率
通过 `frequency_minute` 控制监控扫描新信号的频率：
| 设置 | 行为 | 适用场景 |
| ----------- | -------------------- | --------------- |
| **`0`（默认）** | **实时** — 信号一出现即检测并投递 | 时间敏感的提醒、竞争情报 |
| `15` | 每 15 分钟 | 高优先级监控，可预测的投递节奏 |
| `60` | 每小时 | 中等数量监控的平衡频率 |
| `1440` | 每天 | 摘要式汇总，低优先级追踪 |
信号库在持续扩展中。新的信号类型会在可用时添加——你现有的 monitor 不会受到新类型上线的影响。
***
## 全局公司筛选
Monitor 最强大的功能之一是能够将信号筛选与**全局公司筛选**结合使用。这意味着你可以定义如下条件：
* "**500人以上**且正在**招聘 AI 岗位**的公司"
* "出现在**产品发布新闻**中的**美国 SaaS 公司**"
* "使用**特定技术**且在欧洲投放**广告活动**的公司"
全局公司筛选（`company_filters`）接受与[公司搜索](/cn/api-reference/endpoint/companies/search)端点相同的参数——地点、员工规模、行业、技术、垂直领域等。
在 `company_first` 模式中，`companies`、`domains` 或 `linkedin_urls` 指定你的目标公司列表，而 `company_filters` 添加额外的筛选条件。在 `signal_first` 模式中，`company_filters` 从信号结果中缩小符合条件的公司范围。
***
## 人员数据补充
启用人员数据补充后，每次触发会自动查找匹配公司的相关联系人。通过 `people_enrichment_configs` 配置：
* **筛选条件** — 管理层级、部门、职位、地点——与[人员搜索](/cn/api-reference/endpoint/people/search)端点结构相同
* **联系方式类型** — `email-work`、`email-personal`、`phone`
* **最大返回人数** — 每个配置层1到25人
你可以定义**多个补充层**，每层使用不同的筛选条件。例如，一层用于 C 级高管，另一层用于工程总监。每层运行独立的人员搜索。
每个补充层在每次触发时消耗人员搜索积分，无论返回多少人。请根据你需要的不同受众群体来规划层数。
***
## 了解积分
每次 monitor 触发根据其处理内容消耗积分：
| 积分类型 | 如何消耗 |
| ---------- | --------------------------------------------------- |
| **触发积分** | 每次触发10积分 |
| **公司积分** | 按结果中补充的每家公司计算 |
| **人员搜索积分** | 按 `people_enrichment_configs` 中的每个补充层计算——每层运行一次人员搜索 |
| **兑换积分** | 按每人收费，仅在成功兑换时计算。详见[定价页面](/cn/get-started/pricing) |
### 示例
一个配置了 `is_company_enrichment: true`、一个人员补充层和 `max_records_per_trigger: 5` 的 monitor 触发后发现5家公司，每家3个联系人：
| 组成部分 | 计算方式 | 积分 |
| ------ | ---------------- | ------------- |
| 触发 | 1次触发 | 10 |
| 公司 | 5家补充公司 | 5 |
| 人员搜索 | 1个补充层 | 按层计算 |
| 人员兑换 | 15个联系人（5 × 3封邮件） | 15 |
| **合计** | | **30 + 人员搜索** |
只有在需要联系人数据时才启用 `is_people_enrichment`。如果你只需要信号和公司档案，跳过人员补充可以将成本降到最低。
***
## 投递目标类型
在你的 HTTP 端点接收 JSON 格式的结果。包含自定义请求头和请求体字段用于身份验证。使用 monitor 的签名验证投递真实性。
这是推荐给开发者的投递目标。请参阅[设置 Webhook](/cn/developer-guides/setting-up-webhooks) 获取完整指南。
通过电子邮件接收格式化的结果。支持为代理商和团队提供白标品牌。
对白标邮件投递感兴趣？[联系我们](https://pubrio.com/en/get-in-touch)了解更多。
自动将匹配的联系人注册到外联序列中。需要在 `destination_config` 中配置 `sequence_identifier` 和 `record_type`。
详见 [创建监控](/cn/api-reference/endpoint/monitors/create) 端点参考。
***
## 配置参考
所有配置参数都有合理的默认值。在大多数情况下，你只需设置筛选条件和投递目标——其他一切都是可选的。
| 参数 | 范围 | 默认值 | 描述 |
| ------------------------- | --------- | --- | --------------------- |
| `frequency_minute` | 0 - 10080 | 0 | 扫描间隔分钟数。**`0` = 实时。** |
| `max_records_per_trigger` | 1 - 100 | 25 | 每次触发投递的最大记录数。 |
| `max_daily_trigger` | 0 - 86400 | 500 | 每日触发上限。`0` = 无限制。 |
| `max_retry_per_trigger` | 0 - 3 | 1 | 投递失败时的重试次数。 |
| `retry_delay_second` | 1 - 5 | 1 | 重试间隔秒数。 |
| `max_failure_trigger` | 1 - 10 | 5 | 自动暂停前的连续失败次数。 |
***
## 筛选参考
信号和公司筛选复用与搜索端点相同的结构：
与招聘搜索相同的筛选——职位名称、地点、发布日期等。
与新闻搜索相同的筛选——类别、画廊、关键词和日期。
与广告搜索相同的筛选——目标地点、日期范围和关键词。
与公司搜索相同的筛选——地点、规模、行业、技术、垂直领域等。
人员补充筛选（管理层级、部门、职位）遵循与[人员搜索](/cn/api-reference/endpoint/people/search)端点相同的结构。
***
## 后续步骤
连接你的系统以实时接收数据。
频率、投递可靠性和故障处理。
完整的 company\_first 和 signal\_first 演练，附可复制代码。
跳转到创建 Monitor 端点参考。