6分で読めます

トラブルシューティング

このガイドでは、Zenovay を使用する際に遭遇する可能性のある一般的な問題と、その解決方法について説明します。

トラッキングスクリプトの問題

スクリプトが読み込まれない

症状: トラッキングスクリプトをインストール後、ダッシュボードにデータが表示されない。

考えられる原因と解決方法:

1. スクリプトが正しくインストールされていない

スクリプトがページの <head> セクションにあることを確認してください:

<head>
  <script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
</head>

以下を確認してください:

スクリプトの URL が正しいこと
data-tracking-code があなたのドメインのトラッキングスクリプト設定に表示されているコードと一致していること
スクリプトが </head> タグを閉じる前に読み込まれていること

2. Content Security Policy (CSP) がブロックしている

CSP ヘッダーを使用している場合、Zenovay をアローリストに追加してください:

Content-Security-Policy: script-src 'self' https://api.zenovay.com; connect-src 'self' https://api.zenovay.com;

3. 広告ブロッカーまたはプライバシー拡張機能

一部のブラウザ拡張機能がアナリティクススクリプトをブロックする可能性があります。確認するには:

DevTools を開く (F12)
コンソールタブでブロックされたリクエストを確認する
拡張機能なしのシークレットウィンドウでテストする

従来のアナリティクスとは異なり、Zenovay はプライバシーに優しく、クッキーを使用しないため、プライバシーツールによってブロックされにくいです。

スクリプトは読み込まれるがデータがない

症状: スクリプトは正常に読み込まれるが、ダッシュボードに訪問者が表示されない。

解決方法:

ブラウザコンソールを確認する

DevTools コンソールを開いてエラーを探してください:

// 正常に動作している場合は、これが表示されます
[Zenovay] Tracking initialized for site: abc123
[Zenovay] Pageview tracked successfully

ネットワークリクエストを確認する

DevTools → ネットワークタブを開く
「zenovay」または「api.zenovay.com」でフィルタリングする
/e/YOUR_TRACKING_CODE への POST リクエストを探す
リクエストが 200 OK またはエラーコードを返しているかを確認する

一般的なエラーコード:

ステータスコード	意味	解決方法
401	無効なサイト ID	`data-tracking-code` を再度確認してください
403	ファイアウォールによってブロック	CSP ヘッダーまたはファイアウォールルールを確認してください
429	レート制限中	リクエストが多すぎます。待機してから再試行してください
500	サーバーエラー	継続する場合はサポートにお問い合わせください

スクリプト配置の問題

Zenovay は一般的なインストール上の間違いを自動的に検出し、ブラウザコンソールに警告を表示します。インストール確認をクリックしたときにダッシュボードに診断情報も表示されます。

スクリプトの配置場所:

常に Zenovay スクリプトを HTML の <head> セクションに defer 属性を付けて配置してください:

正しい配置HTML

<head>
<!-- その他の head タグ -->
<script defer data-id="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
</head>

一般的な間違い:

間違い	問題	修正
スクリプトが `<body>` にある	最初のページビューを見落とす可能性があり、読み込みが遅い	`<head>` に移動する
スクリプトが `<body>` の末尾にある	ページが完全に読み込まれた後にトラッカーが実行される	`<head>` に移動する
`defer` がない	ページレンダリングをブロックする	`defer` 属性を追加する
スクリプトが重複している	ページビューとメトリックスを水増しする	余分なスクリプトタグを削除する
`data-id` が間違っている	イベントが誤ったウェブサイトに送信される	ドメイン → あなたのサイト → 一般からスニペットをコピーしてください

フレームワーク固有のガイダンス:

React: ルート App コンポーネントで useEffect を使用するか、public/index.html の <head> に追加してください
Next.js (App Router): app/layout.tsx で <Script> コンポーネントを使用して strategy="afterInteractive" を指定してください
Next.js (Pages Router): pages/_document.tsx 内の <Head> に追加してください
Vue: public/index.html の <head> セクションに追加してください
WordPress: 「ヘッダーとフッターの挿入」プラグインを使用して、ヘッダーにスクリプトを挿入してください
Shopify: theme.liquid の </head> の前に追加してください

ファーストパーティプロキシの問題:

ファーストパーティプロキシ (例: /api/_z/script.js) を使用している場合:

プロキシ URL が 200 レスポンスを返していることを確認してください (404 ではなく)
プロキシが X-Zenovay-Real-IP ヘッダーをフォワードしていることを確認してください
https://api.zenovay.com/z.js を直接読み込んで、プロキシ対スクリプトの問題を分離してください
サーバーの Content-Security-Policy が api.zenovay.com への接続を許可していることを確認してください

コンソール診断:

インストールの問題がある場合、以下のようなメッセージが表示されます:

⚠️ [Zenovay] Installation issue: Script should be in <head> for accurate tracking. Currently in <body>.
   → Fix: Move the <script> tag into your website's <head> section.
   → Docs: https://docs.zenovay.com/guides/troubleshooting#script-placement

これらの警告はブラウザセッションごとに 1 回表示され、セットアップの修正を支援するように設計されています。

イベントがトラッキングされない

症状: ページビューは動作するが、カスタムイベントが表示されない。

イベント構文を確認する:

// 正しい
window.zenovay('track', 'button_click', {
  button_name: 'signup',
  page: '/pricing'
});

// 不正 (イベント名が不足)
window.zenovay('track',{
  button_name: 'signup'
});

スクリプト読み込みを確認する:

// Zenovay が利用可能かを確認
if (window.zenovay) {
  console.log('Zenovay loaded');
  window.zenovay('track', 'custom_event');
} else {
  console.error('Zenovay not loaded yet');
}

準備完了コールバックを使用する:

window.addEventListener('zenovay:ready', function() {
  // Zenovay は準備完了
  window.zenovay('track', 'page_load_complete');
});

ダッシュボードの問題

データが更新されない

症状: ダッシュボードが古いデータを表示するか、リアルタイムで更新されない。

解決方法:

1. ブラウザキャッシュをクリアする

Ctrl+Shift+R (Windows/Linux) または Cmd+Shift+R (Mac) を押してハード更新してください。

2. 日付範囲を確認する

日付範囲セレクタが正しい期間を表示していることを確認してください:

日付範囲ドロップダウンをクリックしてください
「今日」または「過去 24 時間」を選択してください
設定 → アカウント → 環境設定でタイムゾーンが正しいことを確認してください

3. 処理を待つ

リアルタイムデータは通常 1 ~ 2 秒以内に表示されますが:

集計メトリクスには 5 ~ 10 分かかる場合があります
履歴レポートは 1 時間ごとに更新されます

訪問者が 0 と表示される

症状: サイトへのトラフィックがあるにもかかわらず、ダッシュボードに「訪問者 0」と表示される。

診断手順:

サイト ID を確認: ドメイン → あなたのサイト → 一般を開き、トラッキングコードがあなたのスクリプトと一致していることを確認してください
フィルタを確認: アクティブなフィルタ (位置情報、デバイス、ソース) を削除してください
ローカルでテストする: あなたのサイトを訪問して、リアルタイムビューに表示されるかを確認してください
除外を確認: ドメイン設定を開いて、除外設定を確認し、あなたの IP が除外されていないかを確認してください

デフォルトでは、Zenovay は開発トラフィックをカウントしないようにするために、localhost と 127.0.0.1 をトラッキングから除外しています。

訪問者数が不正確

症状: 訪問者数が期待値と異なるか、他のアナリティクスツールと一致しない。

一般的な理由:

1. 定義の違い

Zenovay は以下をカウントします:

ユニーク訪問者: 匿名化された訪問者 ID に基づく (24 時間ウィンドウ)
訪問: 個別セッション (30 分のタイムアウト)
ページビュー: 各ページロード

他のツールは異なる定義またはセッションタイムアウトを使用する場合があります。

2. 広告ブロッカーの影響

一部の訪問者は広告ブロッカーを使用しており、以下の可能性があります:

従来のアナリティクスはブロックするが、Zenovay はブロックしない (プライバシーに優しい)
Zenovay を含むすべてのアナリティクスをブロックする (積極的な設定)

3. ボットフィルタリング

Zenovay は既知のボットとクローラーを自動的にフィルタリングします。他のツールは以下の場合があります:

ボットトラフィックをカウントに含める
異なるボット検出方法を使用する

統合の問題

WordPress プラグインが機能しない

症状: WordPress 統合が訪問者をトラッキングしない。

解決方法:

1. プラグインインストールを確認する

プラグイン → インストール済みプラグインに移動してください
「Zenovay Analytics」が有効化されていることを確認してください
バージョンが最新であることを確認してください

2. サイト ID の設定を確認する

設定 → Zenovay に移動してください
サイト ID が正しく入力されていることを確認してください
変更を保存してキャッシュをクリアしてください

3. テーマの互換性

一部のテーマはヘッダー/フッター挿入と競合する場合があります:

// フォールバックとしてテーマの functions.php に追加してください
function zenovay_tracking_script() {
  ?>
  <script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
  <?php
}
add_action('wp_head', 'zenovay_tracking_script');

4. キャッシングプラグインの競合

WP Super Cache、W3 Total Cache などを使用している場合:

すべてのキャッシュをクリアしてください
Zenovay スクリプトを縮小/結合から除外してください
シークレットモードでテストしてください

React/SPA がルート変更をトラッキングしない

症状: 初期ページロードだけがトラッキングされ、ルート変更がカウントされない。

解決方法: クライアント側のルーティングトラッキングを実装してください:

import { useEffect } from 'react';
import { useLocation } from 'react-router-dom';

function App() {
  const location = useLocation();

  useEffect(() => {
    // ルート変更をトラッキング
    if (window.zenovay) {
      window.zenovay('track', 'pageview', {
        path: location.pathname + location.search
      });
    }
  }, [location]);

  return <YourApp />;
}

Next.js App Router の場合:

'use client';
import { usePathname, useSearchParams } from 'next/navigation';
import { useEffect } from 'react';

export function AnalyticsTracker() {
  const pathname = usePathname();
  const searchParams = useSearchParams();

  useEffect(() => {
    if (window.zenovay) {
      window.zenovay('track', 'pageview');
    }
  }, [pathname, searchParams]);

  return null;
}

API の問題

認証エラー

症状: API リクエストが 401 Unauthorized を返す。

API キーを確認する:

# API キーをテスト
curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.zenovay.com/api/external/v1/websites

一般的な間違い:

API キーの代わりにサイト ID を使用している
X-API-Key ヘッダーが不足している
API キーが期限切れまたは失効している
環境 (テスト対本番) の API キーが間違っている

新しい API キーを生成する:

設定 → セキュリティ → API キーに移動してください
「新しいキーを作成」をクリックしてください
すぐにキーをコピーしてください (1 回だけ表示されます)
アプリケーションで古いキーを新しいキーに置き換えてください

レート制限

症状: API が 429 Too Many Requests を返す。

レート制限ヘッダーを確認する:

curl -I -H "X-API-Key: YOUR_API_KEY" \
  https://api.zenovay.com/api/external/v1/websites

以下を確認してください:

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1673456789

X-RateLimit-Limit の値はあなたのプランの 1 分あたりの制限を反映しています (例: Free は 10、Pro は 30、Scale は 60、Enterprise は 120)。

解決方法:

指数バックオフを実装してください (レート制限を参照)
可能な限り API レスポンスをキャッシュしてください
個別の呼び出しではなくリクエストをバッチ処理してください
より高い制限のためにプランのアップグレードを検討してください

パフォーマンスの問題

スクリプトがページロードを遅くしている

症状: Zenovay を追加した後、ページロード時間が増加した。

非同期読み込みを確認する:

スクリプトに async 属性があることを確認してください:

<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

影響をテストする:

ブラウザ DevTools または Lighthouse を使用してください:

スクリプトあり/なしで Lighthouse 監査を実行してください
「Time to Interactive」メトリクスを比較してください
「Blocking Time」を確認してください

Zenovay スクリプトは通常 < 5KB gzip で非同期に読み込まれ、ページロードに < 50ms を追加します。

ダッシュボードの読み込みが遅い

症状: ダッシュボードがチャートとデータを読み込むのに時間がかかる。

解決方法:

1. 日付範囲を短縮する

12 ヶ月のデータを読み込むのは 7 日間より遅いです:

可能な限り短い日付範囲を使用してください
フィルタを適用してデータボリュームを削減してください

2. ブラウザデータをクリアする

ブラウザキャッシュとクッキーをクリアしてください
ブラウザ拡張機能を無効化してください (干渉する可能性があります)
別のブラウザを試してください

3. ネットワークを確認する

インターネット接続速度をテストしてください
別のネットワークで試してください
コーポレートファイアウォールがスロットリングしていないかを確認してください

データ精度の問題

地理的データが不足している

症状: 一部の訪問者の位置情報が「不明」と表示される。

原因:

訪問者による VPN またはプロキシの使用
位置情報をマスクするプライバシー重視のブラウザ
一元化された IP アドレスを持つコーポレートネットワーク

これは予期された動作であり、オーディエンスによって 5 ~ 15% の訪問者に影響します。

参照元が「ダイレクト」と表示される

症状: ほとんどのトラフィックが実際のソースではなく「ダイレクト」と表示される。

一般的な原因:

1. HTTPS → HTTP の遷移

HTTPS から HTTP に移動するとき、参照元は削除されます。解決方法: あなたのサイトで HTTPS を使用してください。

2. 参照元ポリシー

一部のサイトは厳格な参照元ポリシーを使用しています:

<meta name="referrer" content="no-referrer">

これは送信元サイトのポリシーであり、あなたが制御できるものではありません。

3. モバイルアプリとメール

モバイルアプリとメールクライアントからのトラフィックはダイレクトと表示されることが多いです。これは正常で予期された動作です。

ヘルプを受ける

これらの解決方法を試した後も問題が続く場合:

サービスステータスを確認する

status.zenovay.com にアクセスして、既知の障害またはインシデントがないかを確認してください。

診断情報を収集する

サポートにお問い合わせする前に、以下を収集してください:

ブラウザコンソールログ:
- DevTools → コンソールを開く
- エラーメッセージをコピーする
- スクリーンショットを撮影する
ネットワークリクエスト:
- DevTools → ネットワークを開く
- 「zenovay」でフィルタリングする
- 失敗したリクエストのスクリーンショットをステータスコード付きで撮影する
サイト情報:
- あなたのサイト URL
- ダッシュボードのサイト ID
- プラットフォーム/CMS (WordPress、カスタムなど)
- 大まかなトラフィックボリューム

サポートに連絡する

メール: [email protected]

含める情報:

問題の詳細な説明
すでに試した手順
上記の診断情報
スクリーンショットまたはスクリーン録画

応答時間:

Free プラン: 48 ~ 72 時間
有料プラン: 24 時間
Enterprise: 4 時間 (SLA)

コミュニティヘルプ

GitHub: github.com/zenovay
ドキュメント: 特定のトピックについてドキュメントを検索してください
AI アシスタント: ドキュメントページのチャットウィジェットを使用してください

トラブルシューティング

トラッキングスクリプトの問題

スクリプトが読み込まれない

スクリプトは読み込まれるがデータがない

スクリプト配置の問題

イベントがトラッキングされない

ダッシュボードの問題

データが更新されない

訪問者が 0 と表示される

訪問者数が不正確

統合の問題

WordPress プラグインが機能しない

React/SPA がルート変更をトラッキングしない

API の問題

認証エラー

レート制限

パフォーマンスの問題

スクリプトがページロードを遅くしている

ダッシュボードの読み込みが遅い

データ精度の問題

地理的データが不足している

参照元が「ダイレクト」と表示される

ヘルプを受ける

サービスステータスを確認する

診断情報を収集する

サポートに連絡する

コミュニティヘルプ

その他のリソース