🎉 ローンチセール開催中 — 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以上
WordPress Multisite は v1.1.1 では動作保証対象外です。

有効化

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

  • wp_fpai_sessions — デバイス・ブラウザ・UTMデータを含む訪問者セッション
  • wp_fpai_pageviews — スクロール深度・滞在時間を含む個別ページビュー
  • wp_fpai_events — 行動イベント: 基本的なクリック/フォームイベント（無料版）、全イベント（Pro）
  • wp_fpai_conversions — 達成済みコンバージョンゴール
  • wp_fpai_ai_reports — AI会話履歴（AI分析ページの質問と回答）

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

最初のデータを確認する

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

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

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

設定画面の概要

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

一般

  • 計測を有効化 — データ収集のマスターON/OFFスイッチ
  • 管理者を除外 — 管理者セッションをカウント対象から外す（推奨：ON）
  • セッションタイムアウト — 非アクティブ状態が続いた場合にセッションを終了するまでの時間（デフォルト：30分）
  • 計測モード — 標準（localStorage使用）／ストレージレス（端末に何も保存しない）／自動（EU圏の訪問者のみストレージレス。ブラウザのタイムゾーンで判定。新規インストールの推奨デフォルト）。ストレージレス計測では日替わりソルトからサーバー側で仮名IDを生成するため、日をまたいだ訪問者の照合はできず、訪問者数や新規・再訪の判定は推定値になります。各記録には収集方式（標準／ストレージレス）が保存され、画面・書き出しで確認できます （v1.1.1より）。
  • ボット・大量送信フィルタ （v1.1.1より） — OFF／標準（既定）／強。自動操作やボットなどによる大量送信を除外します（「偽データ注入」ではなく、自動クライアントからの異常な大量送信が対象）。該当する送信は保存前に破棄されます。サイト全体の日次上限は設けません。容量・イベント数・IP別送信速度といった安全上の制限は、この設定に関わらず（OFFでも）常時有効です。

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

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

コンバージョンゴールが使う基本的なクリック・フォーム送信イベントは、無料版・Pro版を問わず常に計測されます。上記のトグルはPro版の拡張イベント群を制御するものです。

IP除外

計測対象から除外するIPアドレスを1行に1つずつ入力します。社内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 → 設定 → 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がファイルからデータを読み取って回答する

コンバージョンゴール

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

ゴールの種類

  • URL（ページビュー型） — 特定のURLまたはURLパターン（例：/thank-you/）に訪問者が到達したときに発火。無料版・Pro版ともに利用可能。
  • フォーム送信型 — フォームID（例：#contact-form-7）で識別された特定のフォームが送信されたときに発火。無料版・Pro版で利用可。
  • クリック型 — クリックされたボタン/リンクのテキスト・リンク先URL・ID・クラスが設定と部分一致したときに発火。無料版・Pro版で利用可。

ゴールの作成

  1. ゴールを追加 をクリックする
  2. ゴール名を入力する（例：「資料請求」）
  3. ゴールの種類を選択する
  4. 対象のURL、フォームID、またはボタン/リンクの文言（部分一致。リンク先URL・ID・クラスでも可）を入力する
  5. 必要に応じてコンバージョン単価を入力する
  6. 保存する — ゴールは即時に有効になる

データエクスポート

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

  • CSV — セッション・ページビュー・イベント・コンバージョンのテーブルを含む複数シート形式のファイル
  • JSON — すべてのフィールドと値を含む完全な構造化エクスポート

v1.1.1より：直近30日は日付ピッカーで期間を指定、それ以前は暦月単位で選択してダウンロードします。逐次ストリーミングのため、データ量が多くてもタイムアウトせずに出力できます。（現在配布中のv1.1.0は、単一のカスタム期間での書き出しです。）

イベント計測（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. ライセンスキーとPro版zipのダウンロードリンクがメールで届く
  3. FPAI Free版プラグインを停止する（プラグイン → インストール済みプラグイン）。計測データはデータベースに残り、FreeとProで同じテーブルを共有します
  4. Pro版プラグインをインストールして有効化する（プラグイン → 新規追加 → プラグインのアップロード）
  5. WordPress管理画面で FPAI → 設定 → ライセンス を開き、ライセンスキーを入力して有効化をクリックする
  6. Pro機能が即時に有効化される — 既存の計測データはそのまま引き継がれる

ライセンスはLemon Squeezy APIに照合して検証され、12時間キャッシュされます。APIに一時的にアクセスできない場合、直近の検証から7日間（買い切りライセンスは180日間）はオフラインでもProとして動作を継続します。APIが明示的に無効・期限切れと応答した場合は即時に反映されます。

ライセンスの移行

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

よくある質問

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

トラブルシューティング

プラグインの競合

予期しない動作が発生した場合は、他のプラグインを一時的に無効化して競合の原因を特定してください。セキュリティプラグイン（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() を使用して不足しているテーブルを再作成します。