> ## 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.
# モニターの紹介
> エンリッチメント付き自動シグナル検出 — ウェブフックまたはメールにリアルタイムで配信。
## なぜモニターなのか？
従来のAPIでは、シグナルパイプラインを自分で構築・維持する必要がありました — エンドポイントのポーリング、状態の追跡、ページネーションの処理、そしてエンリッチメントのための複数の呼び出しの組み合わせ。モニターはこれらすべてを単一の設定に置き換えます。
シグナルが出現次第、検出・配信されます — ポーリングループやcronジョブは不要です。
シグナルフィルターとグローバル企業フィルターを1つのクエリで組み合わせ。「500人以上の従業員でAI人材を採用中の企業」— 1つの設定で、複数のAPI呼び出しは不要。
各トリガーで企業プロフィールと人材コンタクト情報が自動的にエンリッチされます。別途のAPI呼び出しは不要。
リトライロジック、障害処理、重複排除、配信追跡 — すべて自動管理されます。
## モニターの仕組み
追跡するシグナル（求人、ニュース、広告）を選択し、シグナルレベルのフィルターを設定します。オプションで**グローバル企業フィルター**を重ねて結果を絞り込めます — 例えば、米国の従業員500人以上の企業のシグナルのみを表示するなど。
`frequency_minute` を `0`（デフォルト）に設定すると、モニターはリアルタイムで実行され — シグナルが現れると同時に検出・配信します。
マッチしたシグナルは完全な企業プロファイルと、オプションで人物の連絡先情報で自動的にエンリッチメントされます — すべて単一のトリガーで完了。追加の呼び出しは不要です。
結果はウェブフックエンドポイントまたはメール受信箱に届きます。ダッシュボードエンドポイントを通じて完全な統計データとログ履歴も取得できます。
***
## 検出モード
各モニターは2つの検出モードのいずれかで動作します：
**シグナルが発見を主導します。** 探すシグナルを定義すると、システムがすべての企業からマッチするシグナルを見つけ、結果をエンリッチメントします。
**グローバル企業フィルター**（`company_filters`）を第2層として使用し、対象企業を絞り込みます。例えば：「すべてのAI求人を検索するが、従業員1,000人以上の企業のみ」。
最適な用途：
* 幅広い市場スキャンとトレンド発見
* これまで追跡したことのない新しい企業の発見
* 大規模なシグナル駆動プロスペクティング
```
Signal Filters → Matching Signals → Global Company Filters (optional) → Enrichment → Delivery
```
**特定の企業が発見を主導します。** `companies`（domain\_search\_ids）、`domains`、または `linkedin_urls` でターゲット企業リストを提供し、システムがマッチするシグナルを監視します。いずれか1つのみ必要です。
**グローバル企業フィルター**（`company_filters`）はここでも第2層として適用されます — ウォッチリストをより広い基準と組み合わせる場合に便利です。
最適な用途：
* 指名アカウントの追跡（「OpenAIが新しい求人を投稿したら通知」）
* 特定企業の競合インテリジェンス
* アカウントベースのモニタリングパイプライン
```
Target Companies (companies/domains/linkedin_urls) → Signal Filters → Global Company Filters (optional) → Enrichment → Delivery
```
***
## シグナルタイプ
モニターは現在3つのシグナルタイプをサポートしており、定期的に追加されています：
新規求人情報 — タイトル、勤務地、掲載日などでフィルタリング。テクノロジーベンダーやリクルーターにとって強力な購買シグナルです。
企業ニュース — ローンチ、パートナーシップ、資金調達ラウンド、経営陣の変更、課題。カテゴリ、ギャラリー、地域、キーワードでフィルタリング。
アクティブな広告キャンペーン — ターゲット地域、日付範囲、キーワードでフィルタリング。マーケティング戦略と拡大計画が明らかになります。
### 各シグナルが伝えること
| シグナルタイプ | 何がわかるか | 活用例 |
| ---------------------- | -------------------------------------------------- | --------------------------------------------------- |
| **Jobs（求人）** | 企業が積極的に採用中 — 特定部門の成長、新プロジェクト、予算配分を示します。 | エンジニア採用の急増は新製品開発の兆候。営業採用は収益拡大を示唆。 |
| **News（ニュース）** | 企業のマイルストーン — 資金調達、製品ローンチ、パートナーシップ、リーダーシップの変更など。 | 資金調達の発表はアウトリーチの理想的なタイミング。リーダーシップの変更は新しい意思決定者の機会を創出。 |
| **Advertisements（広告）** | マーケティングへの投資方法と方向 — 拡大計画、ターゲット市場、競合ポジショニングを明らかにします。 | 新しい地域での大量広告出稿は市場参入を示唆。競合他社の類似キャンペーンは市場の活発さを示します。 |
### 配信頻度
`frequency_minute` でモニターが新しいシグナルをスキャンする頻度を制御します：
| 設定 | 動作 | 適した用途 |
| -------------- | ---------------------------- | ---------------------- |
| **`0`（デフォルト）** | **リアルタイム** — シグナルが出現次第、検出・配信 | 時間に敏感なアラート、競合インテリジェンス |
| `15` | 15分ごと | 予測可能な配信リズムの高優先度モニタリング |
| `60` | 毎時 | 中程度のボリュームのモニターに最適なバランス |
| `1440` | 毎日 | ダイジェスト形式のサマリー、低優先度の追跡 |
シグナルライブラリは継続的に拡張されています。新しいシグナルタイプは利用可能になり次第追加されます — 既存のモニターは新しいタイプのリリースによる影響を受けません。
***
## グローバル企業フィルター
モニターの最も強力な機能の1つは、シグナルフィルターと**グローバル企業フィルター**を組み合わせられることです。これにより、以下のような条件を定義できます：
* 「**従業員500人以上**で**AI職種を採用中**の企業」
* 「**製品ローンチニュース**に登場した**米国のSaaS企業**」
* 「**特定のテクノロジー**を使用し、ヨーロッパで**広告キャンペーン**を展開している企業」
グローバル企業フィルター（`company_filters`）は、[企業検索](/jp/api-reference/endpoint/companies/search)エンドポイントと同じパラメータを受け付けます — 地域、従業員規模、業種、テクノロジー、バーティカルなど。
`company_first` モードでは、`companies`（domain\_search\_ids）、`domains`、または `linkedin_urls` でターゲット企業リストを指定します — いずれか1つのみ必要です。`company_filters` は両方のモードで追加のフィルタリング条件を加えます。
***
## ピープルエンリッチメント
ピープルエンリッチメントを有効にすると、各トリガーで自動的にマッチした企業の関連連絡先を検索します。`people_enrichment_configs` で設定：
* **フィルター** — 管理レベル、部門、役職、地域 — [ピープル検索](/jp/api-reference/endpoint/people/search)エンドポイントと同じ構造
* **連絡先タイプ** — `email-work`、`email-personal`、`phone`
* **最大返却人数** — コンフィグレイヤーごとに1〜25人
**複数のエンリッチメントレイヤー**を定義でき、それぞれ異なるフィルターを使用できます。例えば、1つのレイヤーでCスイートエグゼクティブ、もう1つでエンジニアリングディレクターを対象にするなど。各レイヤーは独立したピープル検索を実行します。
各エンリッチメントレイヤーは、返却される人数に関係なく、トリガーごとにピープル検索クレジットを消費します。必要な異なるオーディエンスに基づいてレイヤーを計画してください。
***
## クレジットについて
各モニタートリガーは処理内容に基づいてクレジットを消費します。最新のクレジットレートは[料金ページ](/jp/get-started/pricing)をご覧ください。
| クレジットタイプ | 消費方法 |
| --------------- | ---------------------------------------------------------------------------------------- |
| **トリガークレジット** | トリガーごとに10クレジット |
| **企業クレジット** | 結果でエンリッチメントされた企業ごと |
| **ピープル検索クレジット** | `people_enrichment_configs` の各エンリッチメントレイヤーごと — 各レイヤーがピープル検索を実行（ピープル検索エンドポイントと同じクレジットコスト） |
| **リディームクレジット** | リディームされた人物ごと — 成功した取得時のみ課金され、1人あたりに返されるメールや電話番号の数に関係なく課金 |
### 例
`is_company_enrichment: true`、1つのピープルエンリッチメントレイヤー（メールリディーム付き）、`max_records_per_trigger: 5` で設定されたモニターがトリガーし、各2人の連絡先を持つ3社を検出した場合：
| コンポーネント | 計算 | クレジット |
| --------- | -------------------------- | ----------------------- |
| トリガー | 1トリガー | 10 |
| 企業 | 3社エンリッチメント | 3 |
| ピープル検索 | 1エンリッチメントレイヤー | ピープル検索クレジット |
| ピープルリディーム | 6人リディーム（3 × 2、成功時に人物ごとに課金） | 6 × リディームレート |
| **合計** | | **13 + ピープル検索 + リディーム** |
クレジットレートは変更される場合があります — 最新情報は[料金ページ](/jp/get-started/pricing)をご確認ください。連絡先データが必要な場合のみピープルエンリッチメントを有効にしてください。
***
## 配信先タイプ
HTTPエンドポイントでJSONペイロードとして結果を受信します。認証用のカスタムヘッダーとボディフィールドを含めることができます。モニターのシグネチャを使用して配信の真正性を検証します。
開発者に推奨される配信先です。完全なウォークスルーは[ウェブフックの設定](/jp/developer-guides/setting-up-webhooks)をご覧ください。
メールでフォーマットされた結果を受信します。エージェンシーやチーム向けのホワイトラベルブランディングをサポートしています。
ホワイトラベルメール配信にご興味がありますか？[お問い合わせ](https://pubrio.com/en/get-in-touch)ください。
マッチしたコンタクトをアウトリーチシーケンスに自動登録します。`destination_config` に `sequence_identifier` と `record_type` の設定が必要です。
詳細は [モニター作成](/jp/api-reference/endpoint/monitors/create) エンドポイントリファレンスをご覧ください。
***
## 設定リファレンス
すべての設定パラメータにはデフォルト値があります。ほとんどの場合、フィルターと配信先を設定するだけで済みます — それ以外はすべてオプションです。
| パラメータ | 範囲 | デフォルト | 説明 |
| ------------------------- | --------- | ----- | --------------------------- |
| `frequency_minute` | 0 - 10080 | 0 | スキャン間隔（分）。**`0` = リアルタイム。** |
| `max_records_per_trigger` | 1 - 100 | 25 | トリガーごとの最大配信レコード数。 |
| `max_daily_trigger` | 0 - 86400 | 500 | 1日のトリガー上限。`0` = 無制限。 |
| `max_retry_per_trigger` | 0 - 3 | 1 | 配信失敗時のリトライ回数。 |
| `retry_delay_second` | 1 - 5 | 1 | リトライ間隔（秒）。 |
| `max_failure_trigger` | 1 - 10 | 5 | 自動一時停止までの連続失敗回数。 |
***
## フィルターリファレンス
シグナルと企業フィルターは検索エンドポイントと同じスキーマを再利用します：
求人検索と同じフィルター — タイトル、勤務地、掲載日など。
ニュース検索と同じフィルター — カテゴリ、ギャラリー、キーワード、日付。
広告検索と同じフィルター — ターゲット地域、日付範囲、キーワード。
企業検索と同じフィルター — 地域、規模、業種、テクノロジー、バーティカルなど。
ピープルエンリッチメントフィルター（管理レベル、部門、役職）は[ピープル検索](/jp/api-reference/endpoint/people/search)エンドポイントと同じ構造に従います。
***
## 次のステップ
システムを接続してリアルタイムでデータを受信。
頻度、配信の信頼性、障害処理。
完全なcompany\_firstとsignal\_firstのウォークスルー（コピー可能なコード付き）。
モニター作成エンドポイントリファレンスへ。