インストール状態

リアルタイム グローブを監視せずに、Zenovay トラッカーが正しく動作しているかを検証できます。Install Health エンドポイントは、トラッカーの最近のアクティビティ、サイトの到達性、現在の Cookie レス・同意記録の構成、そして対応すべき問題のリストを構造化して返します。

表示場所

Zenovay ダッシュボードで:

1. ドメイン ページを開き、対象のドメインをクリックします。
2. 設定 を開き、インストール状態 タブをクリックします。
3. レポートは 30 秒ごとに自動的に更新されます。更新 ボタンで強制的に再チェックできます。

レスポンスの読み方

各呼び出しは次のフィールドを持つ JSON オブジェクトを返します。

ダッシュボードのステータス カラー

タブ上部の 4 枚のカードは次のしきい値を使用します。

• 緑 — 直近 5 分以内にイベントを受信。
• 黄 — 直近 1 時間以内、ただし直近 5 分以内ではない。
• 赤 — 1 時間以上イベントなし、または一度もイベントを受信していない。

よくある問題と対処

issues 配列は Zenovay が返す可能性のある診断コードを列挙します。各エントリには severity、安定した code、人間が読める message、fix_url が含まれます。

メール アラート (ドメインごとにオプトイン)

診断がドメインで silent_tracker エラーを検出すると、Zenovay はサイトの所有者に 1 回限りのメールを送信します。イベントが再開されると、1 回限りの「復旧通知」メールが届きます。1 つの障害につき最大 1 通のメール — 5 層の重複排除でスパムを防止します:

1. cron は 1 分ごとではなく、6 時間ごとに実行されます。
2. silent_tracker のしきい値自体が、最低 6 時間の間隔を要求します。
3. 直近 24 時間で 5 件未満のイベントしかないサイトは、アラートをトリガーしません (1 日 1 訪問者の個人ブログには決してメールが届きません)。
4. 内部のステート マシンは遷移時のみ発火します (正常 → 沈黙、または 沈黙 → 正常)。連続する cron 実行では発火しません。
5. メール ログの冪等性キーは障害の最初の沈黙のタイムスタンプに固定されています — ステート マシンのバグであっても、1 つの障害につき 2 通のサイレント メールを送信することはできません。

サンドボックス/開発ドメイン (localhost、*.vercel.app、*.netlify.app、*.pages.dev、*.workers.dev、*.test、*.local) は、アラートから完全に除外されます。

ドメインごとのアラートは、ドメイン → 設定 → インストール状態 → メール アラート で切り替えます。デフォルトはオンです。

API リファレンス

リクエスト例

# URL の先頭にコロンはありません — ZV_YOUR_TRACKING_CODE を
# app.zenovay.com → ドメイン → 設定 にある実際のコードに置き換えて
# ください。Bearer JWT は必須です。ログイン済みのダッシュボード
# セッションから DevTools → ネットワーク → /api/auth/user 経由で
# コピーしてください。
curl https://api.zenovay.com/api/install-health/ZV_YOUR_TRACKING_CODE \
-H "Authorization: Bearer $YOUR_JWT"

レスポンス例

{
"last_event_seen_at": "2026-05-02T21:15:42.110Z",
"minutes_since_last_event": 0,
"last_event_count_5m": 12,
"last_event_count_24h": 1843,
"script_reachable": true,
"script_version": "v2.0.1",
"csp_blocking_suspected": false,
"cookieless_enabled": true,
"consent_recording_active": false,
"last_5_event_types": ["pageview", "click", "scroll", "form_submit", "outbound_click"],
"issues": []
}