トラッキングが機能しない

Zenovayが訪問者をトラッキングしていない場合の問題を診断・修正するには、このガイドに従ってください。

クイック診断

ブラウザコンソールで確認

ウェブサイトを開く
F12キーを押すか、右クリック → 検査
コンソールタブに移動
入力: window.zenovay

予想される結果: 関数 (typeof === 'function') undefined の場合: スクリプトが読み込まれていない

ネットワークタブで確認

ネットワークタブに移動
ページを更新
"zenovay" または "analytics" でフィルター
z.js と API呼び出しを探す

よくある問題

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

症状: window.zenovay が undefined

原因:

スクリプトタグが見つからないか間違っている
広告ブロッカーがスクリプトをブロック
Content Security Policy (CSP) がブロック
スクリプト読み込みエラー

解決方法:

スクリプトタグを確認:

<!-- 正しい形式 -->
<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

よくあるミス:

<!-- 間違い: ウェブサイトIDが見つからない -->
<script src="https://api.zenovay.com/z.js"></script>

<!-- 間違い: URLの誤字 -->
<script src="https://api.zennovay.com/z.js"></script>

<!-- 間違い: 閉じタグが見つからない -->
<script src="https://api.zenovay.com/z.js">

問題: 広告ブロッカーの干渉

症状: スクリプトが読み込まれるが、すべての訪問者には読み込まれない

テスト:

広告ブロッカーを無効化
ページを更新
トラッキングが機能するか確認

解決方法:

スクリプトの自己ホスティング:

# スクリプトをダウンロード
curl -o zenovay.js https://api.zenovay.com/z.js

# 自分のドメインでホスト
# その後、使用:
<script src="/js/zenovay.js" data-tracking-code="YOUR_TRACKING_CODE"></script>

自分のオリジンからスクリプトを自己ホストしている場合、ほとんどの広告ブロッカーはブロックしません。自己ホストする場合は、ファイルを最新の状態に保ち、修正と新機能を入手してください。

問題: Content Security Policy がブロック

症状: コンソールにCSP違反エラーが表示される

エラー例:

Refused to load the script 'https://api.zenovay.com/z.js'
because it violates the Content-Security-Policy directive

解決方法:

CSPヘッダーを更新:

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

問題: ウェブサイトIDが間違っている

症状: ダッシュボードにデータがない

確認:

ドメインを開き、ウェブサイトを選択
設定 → 一般を開いて、そのサイトのインストールスニペットを表示
スニペット内の data-tracking-code 値をライブページの値と比較

コードは正確に一致する必要があります:

<script data-tracking-code="abc123-def456-ghi789"></script>

問題: スクリプトが訪問者の離脱後に読み込まれる

症状: ページビュー数が少ない

原因: スクリプトの位置が間違っているか、読み込みが遅い

解決方法: スクリプトを <head> に defer で配置:

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

問題: シングルページアプリがページ変更をトラッキングしない

症状: 初期ページビューのみが記録される

原因: シングルページアプリはフルページロードをトリガーしない

Zenovayがこれをどのように処理するか: トラッカーはクライアント側のルート変更を自動的に検出します。history.pushState / history.replaceState をパッチし、popstate と pageshow をリッスンするため、React Router、Vue Router、Next.js、および同様のフレームワークでのナビゲーションは追加コードなしで記録されます。

最初のページビューのみが表示されている場合は、以下を確認:

スクリプトが一度だけ読み込まれ、アプリの上部近くに配置 (<head> に defer) され、ルート変更時に削除されていない
ルーターが History API 経由でURLを実際に更新している (ほとんどの場合そう)

手動ページビュー (オプション): アプリがURLを変更せずに表示される「ページ」を変更する場合、手動でページビューを記録できます:

if (window.zenovay) {
  window.zenovay('page');
}

トラッカーが自分自身で見ることができないナビゲーションのみ実行してください – 自動トラッキングに加えてすべてのルート変更で呼び出すと、ビューが重複カウントされます。

問題: Localhost/開発がトラッキングしない

症状: 本番環境では機能するが、ローカルではしない

原因: トラッカーはデフォルトで localhost、127.0.0.1、*.local ホスト名をブロックして、開発トラフィックが本番データを汚さないようにします。

localhost でのトラッキングを許可するには, スクリプトタグに data-allow-localhost="true" を追加:

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

ダッシュボードでサイトごとにオンにすることもできます。ドメインを開き、ウェブサイトを選択、設定 → 一般で localhost / デバッグオプションを有効にします。

トラッカーが何をしているかを見るには, data-debug="true" でデバッグログを有効化 (またはページURL に ?zenovay_debug=true を追加):

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

問題: HTTPS/HTTP ミスマッチ

症状: スクリプトが HTTPS サイトでブロックされる

原因: HTTPS ページで HTTP スクリプトを読み込む

解決方法: 常に HTTPS を使用:

<!-- 正しい -->
<script src="https://api.zenovay.com/z.js"></script>

<!-- HTTPS サイトでは間違い -->
<script src="http://api.zenovay.com/z.js"></script>

デバッグモード

スクリプトに data-debug="true" を追加して、詳細なログを有効化:

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

スニペットを変更せずに任意のページで有効化することもできます。URL に ?zenovay_debug=true を追加:

コンソールで確認:

スクリプト初期化
ページビューイベント
API レスポンス
エラーメッセージ

トラッキングテスト

手動テスト

// ブラウザコンソール内
if (window.zenovay) {
  window.zenovay('track', 'test_event', { test: true });
  console.log('Event sent!');
} else {
  console.log('Zenovay not loaded');
}

リアルタイムで確認

ドメインを開き、ウェブサイトを選択して ライブビュータブに移動
別のタブでサイトにアクセス
数秒以内に表示されるはず

サーバー側レンダリングの問題

Next.js

// クライアント上でのみ読み込む
import dynamic from 'next/dynamic';

const Analytics = dynamic(() => import('./Analytics'), {
  ssr: false
});

Nuxt.js

// nuxt.config.js
export default {
  head: {
    script: [
      {
        src: 'https://api.zenovay.com/z.js',
        'data-tracking-code': 'YOUR_ID',
        defer: true,
        body: true // body の最後に読み込む
      }
    ]
  }
}

WordPress の問題

Zenovay は公式の WordPress プラグインを提供していません – トラッキングスクリプトを手動で追加 (テーマの header.php で、functions.php の wp_head アクション経由で、または「ヘッダー/フッタースクリプト」プラグインで)。WordPress に Zenovay を追加で正確なコードをご覧ください。

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

確認:

トラッキングスニペットがページソースに実際に存在する (ソース表示、z.js を検索)
data-tracking-code 値がダッシュボードのものと一致
テーマまたはスニペットを編集した後、キャッシュがクリアされている

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

Zenovay を最適化から除外:

WP Rocket:

Settings → File Optimization → Exclude External:
api.zenovay.com

W3 Total Cache:

Performance → Minify → JS Minify Settings → Never minify:
api.zenovay.com/z.js

確認チェックリスト

スクリプトタグがページソースに存在
ウェブサイトID が正しい
コンソールエラーなし
ネットワーク要求成功 (200ステータス)
広告ブロッカーでブロックされていない
CSP がアナリティクスドメインを許可
ダッシュボード設定に正しいドメイン
ライブビューが訪問を表示

まだ動きませんか？

情報を集める

サポートに連絡する前に:

ウェブサイトURL
ブラウザコンソールエラー
ネットワークタブのスクリーンショット
ウェブサイトID (一部)
いつ動作しなくなったか

サポートに連絡

[email protected] にメール送信:

件名: "Tracking Not Working"
上記で集めた情報
既に試したステップ

トラッキングが機能しない

クイック診断

ブラウザコンソールで確認

ネットワークタブで確認

よくある問題

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

問題: 広告ブロッカーの干渉

問題: Content Security Policy がブロック

問題: ウェブサイトIDが間違っている

問題: スクリプトが訪問者の離脱後に読み込まれる

問題: シングルページアプリがページ変更をトラッキングしない

問題: Localhost/開発がトラッキングしない

問題: HTTPS/HTTP ミスマッチ

デバッグモード

トラッキングテスト

手動テスト

リアルタイムで確認

サーバー側レンダリングの問題

Next.js

Nuxt.js

WordPress の問題

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

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

確認チェックリスト

まだ動きませんか？

情報を集める

サポートに連絡

次のステップ

関連記事

トラッキングスクリプトのインストール

ドメイン検証エラー

WebflowでZenovayをインストールするには？

この記事は役に立ちましたか？