🎉 ローンチセール開催中 — Pro版が期間限定 50% OFF。  今すぐ購入 →

ドキュメント

FPAIドキュメント

インストールから設定、AI活用まで。FPAIを最大限に使いこなすための情報をまとめています。

インストール

FPAIは通常のWordPressプラグインです。インストール方法は2通りあります。

Option A — WordPress公式ディレクトリ（推奨）

  1. WordPress管理画面で プラグイン → 新規追加 を開く
  2. FPAI で検索する
  3. 今すぐインストール をクリックし、その後 有効化 をクリックする

Option B — ZIPファイルを手動でアップロード

  1. WordPress.org からzipをダウンロードする
  2. WordPress管理画面で プラグイン → 新規追加 → プラグインのアップロード を開く
  3. ZIPファイルを選択し、今すぐインストール をクリックする
  4. プラグインを有効化 をクリックする
動作要件 WordPress 6.0以上 · PHP 7.4以上 · MySQL 5.7以上 または MariaDB 10.3以上

有効化

FPAIを有効化すると、WordPressデータベースに5つのテーブルが自動的に作成されます。

  • wp_fpai_sessions — デバイス・ブラウザ・UTMデータを含む訪問者セッション
  • wp_fpai_pageviews — スクロール深度・滞在時間を含む個別ページビュー
  • wp_fpai_events — クリック・スクロール・フォーム送信などの行動イベント（Pro）
  • wp_fpai_conversions — 達成済みコンバージョンゴール
  • wp_fpai_ai_reports — AI分析履歴（将来利用のために予約）

有効化直後から計測が始まります。データ収集を開始するために追加の設定は不要です。

最初のデータを確認する

有効化すると、WordPress管理画面のサイドバーに FPAI メニューが表示されます。クリックするとアナリティクスダッシュボードが開きます。

すぐにデータが表示されない場合は、管理者でないブラウザ（またはプライベート・シークレットウィンドウ）でサイトのフロントページを開いてください。管理者のセッションはデフォルトで除外されます。数秒以内にダッシュボードにセッションが表示されるはずです。

管理者除外について デフォルトでは、ログイン中の管理者は計測対象外です。計測が正常に動作しているか確認するには、プライベートウィンドウ、またはWordPressにログインしていないデバイスでアクセスしてください。

設定画面の概要

FPAI → 設定 からプラグインの設定を変更できます。設定画面はいくつかのセクションに分かれています。

一般

  • 計測を有効化 — データ収集のマスターON/OFFスイッチ
  • 管理者を除外 — 管理者セッションをカウント対象から外す（推奨：ON）
  • セッションタイムアウト — 非アクティブ状態が続いた場合にセッションを終了するまでの時間（デフォルト：30分）

イベント計測オプション（Pro）

  • クリックを計測 — 要素セレクタ・テキストを含む全クリックイベントを記録
  • スクロール深度を計測 — 25%・50%・75%・90%・100%のスクロール到達時点で記録
  • フォーム送信を計測 — フォームIDと送信イベントを記録
  • 外部リンクを計測 — 外部ドメインへのリンクのクリックを検知

IP除外

計測対象から除外するIPアドレスをカンマ区切りで入力します。社内IPアドレス・代理店のIPアドレス・開発環境のフィルタリングに便利です。

192.168.1.100, 203.0.113.42, 198.51.100.0

AI分析の設定

FPAIのWP管理画面内に、AI分析チャット機能が内蔵されています。無料プランから利用できます。あなた自身のAPIキーを使い、FPAIはデータ整形と送信のみを担当します。

対応プロバイダー

  • Anthropic Claude
  • OpenAI ChatGPT
  • Google Gemini
  • xAI Grok
  • Perplexity
  • Mistral
  • DeepSeek
  • Cohere
  • Alibaba Qwen
  1. FPAI → Settings → AI設定 を開く
  2. 9種類のプロバイダーから使いたいものを選択する
  3. APIキーを入力（あなたのWordPress DBにのみ保存される）
  4. FPAI → AI Analysis を開いて質問する
プリセット質問 ワンクリックで送れるプリセットが6種類あります：パフォーマンス概要、ページ分析、流入元分析、コンバージョン分析、行動パターン、改善提案。選ぶだけで整形済みのデータを含む分析リクエストをAIに送信します。
会話履歴の自動保存 会話履歴は自動保存されます。次回AI Analysisページを開いたときに過去の会話が表示されます。
APIキーのプライバシー APIキーはあなた自身のWordPressデータベースに保存され、リクエスト時に選択したAIプロバイダーに直接送信されます。FPAIのサーバーがAPIキーを受信・記録することはありません。

AIチャット機能を使う

APIキーを保存したら、FPAI → AI Analysis を開きます。分析期間を選択し、プリセット質問を選ぶか自由に質問を入力して送信してください。FPAIがアナリティクスデータを収集・整形してAIに送り、回答がダッシュボード上に表示されます。

会話履歴はあなたのWordPressデータベースの wp_fpai_ai_reports テーブルに保存されます。FPAIのサーバーにデータが残ることはありません。

CSV/JSONエクスポートで外部AIツールを使う

WordPress外のツール — Claude.ai・ChatGPT・Geminiなど — でアナリティクスデータを使いたい場合は、エクスポート機能を使います。

  1. FPAI → エクスポート を開く
  2. 期間を選択し、CSV または JSON を選ぶ
  3. ダウンロード をクリックする
  4. ファイルをAIチャット（ChatGPT・Gemini・Claude.aiなど）にアップロードする
  5. 質問を入力する — AIがファイルからデータを読み取って回答する

AIサマリー形式（Pro）は、スキーマの説明を含むコンパクトなプレーンテキスト形式でエクスポートされます。ファイルのアップロードなしに任意のAIチャットに直接貼り付けられるよう最適化されています。

コンバージョンゴール

コンバージョンゴールを使うと、特定のユーザーアクションを追跡・計測できます。FPAI → 設定 → コンバージョンゴール から管理します。

ゴールの種類

  • URL（ページビュー型） — 特定のURLまたはURLパターン（例：/thank-you/）に訪問者が到達したときに発火。無料版・Pro版ともに利用可能。
  • フォーム送信型 — フォームID（例：#contact-form-7）で識別された特定のフォームが送信されたときに発火。Pro版のみ。
  • クリック型 — CSSセレクタで指定した要素を訪問者がクリックしたときに発火。Pro版のみ。

ゴールの作成

  1. ゴールを追加 をクリックする
  2. ゴール名を入力する（例：「資料請求」）
  3. ゴールの種類を選択する
  4. 対象のURL・フォームID・CSSセレクタを入力する
  5. 必要に応じてコンバージョン単価を入力する
  6. 保存する — ゴールは即時に有効になる

データエクスポート

FPAI → エクスポート からアナリティクスデータをダウンロードできます。

  • CSV — セッション・ページビュー・イベント・コンバージョンのテーブルを含む複数シート形式のファイル
  • JSON — すべてのフィールドと値を含む完全な構造化エクスポート
  • AIサマリー（Pro）— スキーマの説明付きのコンパクトなプレーンテキスト形式。AI分析に最適化。

日付ピッカーで期間を選択してからダウンロードをクリックします。対象期間が長い場合、生成に数秒かかることがあります。

イベント計測（Pro）

Proライセンスが有効で、設定でイベント計測が有効になっている場合、FPAIトラッカーは以下を自動的に記録します。

  • クリック — 要素タグ・CSSセレクタ・表示テキスト・リンク先URL
  • スクロール深度 — セッションごとにページ別で25%・50%・75%・90%・100%の到達ポイント
  • フォーム送信 — フォーム要素のIDとメソッド
  • 外部リンク — クリックされた外部リンクの完全なURL
  • コピーイベント — 訪問者がページのテキストを選択してコピーした操作
  • JSエラー — エラーメッセージとスタックトレース（デバッグに有用）

イベントはダッシュボードの イベント タブで確認でき、CSV/JSONエクスポートにも含まれます。

Proライセンスを有効化する

  1. Lemon Squeezy経由で fpai.orora.co.jp/ja/pricing からProを購入する
  2. ライセンスキーがメールで届く
  3. WordPress管理画面で FPAI → 設定 → ライセンス を開く
  4. ライセンスキーを入力し、有効化 をクリックする
  5. Pro機能が即時に有効化される — 再インストール不要・データの損失なし

ライセンスはLemon Squeezy APIに照合して検証され、12時間キャッシュされます。APIに一時的にアクセスできない場合は、ローカルに保存されたステータスにフォールバックします。

ライセンスの移行

  1. 旧サイトの FPAI → 設定 → ライセンス で 無効化 をクリックする
  2. Lemon Squeezyのライセンスインスタンスが解放される
  3. 新サイトで同じライセンスキーを入力して有効化する

よくある質問

まず管理者でないブラウザまたはシークレットウィンドウで確認してください。管理者セッションはデフォルトで除外されます。また、FPAI → 設定 → 一般で計測が有効になっているか確認してください。キャッシュプラグインを使用している場合は、FPAIのトラッカースクリプトが誤ってキャッシュされていないか確認してください。
APIキーが正しいか確認してください。プロバイダーによってキーの形式が異なります。例：Claudeのキーは sk-ant- で始まり、OpenAIのキーは sk- で始まります。Settings でプロバイダーの選択とキーが一致しているか確認してください。
前後にスペースが入っていないか確認しながら、キーを正確にコピーしてください。以前別のサイトで有効化したライセンスの場合は、まずそのサイトで無効化してください。それでも解決しない場合は、注文番号を添えてサポートにお問い合わせください。
トラッカースクリプトは約3KBで、非同期で読み込まれます。データの送信にはsendBeacon APIを使用し、ページ読み込み後にバックグラウンドで処理されるため、レンダリングをブロックすることはなく、Core Web Vitalsのスコアにも影響しません。
購入時にLemon Squeezyから届いたメールに記載の「Manage your subscription」リンクから解約できます。解約後もライセンスの有効期限まではProの機能を引き続き利用できます。

トラブルシューティング

プラグインの競合

予期しない動作が発生した場合は、他のプラグインを一時的に無効化して競合の原因を特定してください。セキュリティプラグイン（Wordfence・Sucuriなど）がREST APIのエンドポイントをブロックすることがあります。セキュリティプラグインのホワイトリストに /wp-json/fpai/ を追加してください。

キャッシュプラグイン

FPAIのトラッカースクリプトは動的に読み込まれるため、キャッシュプラグインによる圧縮やキャッシュ対象にしないでください。キャッシュプラグインのスクリプト最適化設定から fpai-tracker.js を除外してください。

REST APIがブロックされている

FPAIはWordPressのREST API（POST /wp-json/fpai/v1/collect）を使用して計測イベントを受信します。サーバーまたはセキュリティプラグインが認証なしのREST APIアクセスをブロックしている場合、計測は機能しません。collectエンドポイントは意図的に公開されています（レート制限あり・サーバーサイドで検証済み）。

データベーステーブルが見つからない

FPAIダッシュボードにデータが表示されず、テーブルが存在しないように見える場合は、プラグインの無効化・再有効化を試してください。有効化フックが dbDelta() を使用して不足しているテーブルを再作成します。