> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress プラグインのインストール

> WordPress 用の Agent Analytics プラグインをインストール・設定して、HTTP リクエストログを Profound プラットフォームに送信する方法を説明します

<Warning>
  WordPress プラグインは、WordPress プラットフォームの性質上、機能が制限される場合があります。詳しくは[制限事項](/ja-jp/agent-analytics/wordpress/limitations)のページをお読みください。
</Warning>

## 概要

Agent Analytics の [WordPress プラグイン](https://wordpress.org/plugins/profound-agent-analytics/)を使用すると、WordPress サイトからログを自動的に収集し、訪問者のトラフィックデータを Profound Agent Analytics プラットフォームに転送できます。このプラグインはバックグラウンドで透過的に動作し、管理およびシステムのアクティビティをすべて除外して、公開トラフィックのみを取得します。

## 前提条件

インストールを開始する前に、次のものが揃っていることを確認してください。

* バージョン 6.0 以上の WordPress サイト

* WordPress ダッシュボードへの管理者アクセス権

* Log Ingestion Token を持つ Profound アカウント

* ホスティング環境の PHP 7.4 以上

## インストール

<img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/wordpress/wordpress_setup.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=f42646e73b1c7a0b855229e799d0d5a4" alt="WordPress の検出" width="3680" height="2390" data-path="images/agent-analytics/wordpress/wordpress_setup.png" />

<Steps>
  <Step title="ステップ 1">
    WordPress の管理ダッシュボードにログインし、左サイドバーの **Plugins** に移動します。
    Plugins ページ上部の **Add New** をクリックします。「Profound Agent Analytics」を検索するか、[WordPress プラグインページ](https://wordpress.org/plugins/profound-agent-analytics/)にアクセスしてプラグインをダウンロードします。

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/wordpress/install.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=d5b2c8c215318441535107aea7c5c8b9" alt="WordPress Plugins のナビゲーション" width="3680" height="2390" data-path="images/agent-analytics/wordpress/install.png" />

    **Install Now** をクリックしてプラグインをインストールします。
  </Step>

  <Step title="ステップ 3">
    インストールが完了したら、**Activate** をクリックしてプラグインを有効化します。

    または、**Plugins** → **Installed Plugins** に移動し、一覧から「Agent Analytics」を見つけて **Activate** をクリックします。

    <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/wordpress/activate.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=295589131a4bab05245026c263d1ca7a" alt="プラグインを有効化" width="3680" height="2390" data-path="images/agent-analytics/wordpress/activate.png" />
  </Step>

  <Step title="ステップ 4">
    有効化したら、WordPress の管理メニューで **Settings** → **Agent Analytics** に移動します。
  </Step>

  <Step title="ステップ 5">
    General 設定タブで次の操作を行います。

    1. **Enable Logging** チェックボックスをオンにして、ログ収集を有効にします

    2. **Log Ingestion Token** フィールドに、Profound の Log Ingestion Token (`bot_` で始まります) を入力します

    3. 特に指示がない限り、**API Endpoint** はデフォルト値のままにします

    4. 必要に応じて、**Batch Size** と **Send Interval** の設定を調整します。

           <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/wordpress/settings.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=bba8eb1b9fb0ec5f5b70f27300ea1b16" alt="API の設定" width="3680" height="2382" data-path="images/agent-analytics/wordpress/settings.png" />

    <Warning>
      Log Ingestion Token は機密情報です。本番サイトでは、データベースに保存する代わりに環境変数の使用を検討してください。詳しくは[セキュリティのドキュメント](/ja-jp/agent-analytics/wordpress/security)を参照してください。
    </Warning>
  </Step>

  <Step title="ステップ 6 (任意)">
    **Privacy** タブに移動して、フィルタリングオプションを調整します。

    * **Query Parameter Redaction**: 秘匿化する追加の機密パラメーターを追加します (デフォルトでパスワード、トークン、カード情報が含まれます)

    * **Path Filtering**: ログから除外するカスタムパスを追加します

    * **Skip Options**: 管理画面、cron、AJAX、REST API リクエストの除外を切り替えます

          <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/wordpress/privacy.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=166226249d5a8483233df5348a382640" alt="プライバシー設定" width="3680" height="2390" data-path="images/agent-analytics/wordpress/privacy.png" />

    <Note>
      プラグインは、WordPress のすべての管理アクティビティとシステムパスを自動的に除外します。これらの設定を使用すると、デフォルト以外の追加のカスタマイズが可能です。
    </Note>
  </Step>

  <Step title="ステップ 7">
    設定ページの下部にある **Save Changes** をクリックします。

    **Status** タブに移動して、設定を確認します。

    1. **Queue Status** が「Active」と表示されていることを確認します

    2. **Send Test Event** をクリックして接続を確認します

    3. 「Test event sent successfully」と表示されることを確認します

           <img src="https://mintcdn.com/profound-37face47/tg0qbLRw_vFMInTl/images/agent-analytics/wordpress/status.png?fit=max&auto=format&n=tg0qbLRw_vFMInTl&q=85&s=25dfddfd4b78cdb856107eb25eba4762" alt="ステータスの確認" width="3680" height="2382" data-path="images/agent-analytics/wordpress/status.png" />

    <Tip>
      テストが失敗した場合は、Log Ingestion Token を再確認し、サーバーが `artemis.api.tryprofound.com` へのアウトバウンド HTTPS リクエストを送信できることを確認してください。
    </Tip>
  </Step>

  <Step title="ステップ 8">
    設定後、次の操作を行います。

    1. 公開 Web サイトのページをいくつか閲覧します (WordPress 管理画面にはログインしない状態で)

    2. **Settings** → **Agent Analytics** → **Status** に戻ります

    3. **Next automatic send** に 1 分以内の時刻が表示されていることを確認します

    4. 閲覧するにつれて **Queue size** が増加し、自動送信後に減少することを確認します

    以上です。WordPress サイトの Agent Analytics の設定が完了しました。数分以内に Profound のダッシュボードにデータが表示され始めます。
  </Step>
</Steps>

## インストール後の確認

すべてが正しく動作していることを確認するには、次の操作を行います。

1. **Status タブを確認する**: キューが定期的に (デフォルトでは 60 秒ごとに) 空になる必要があります

2. **ダッシュボードをモニタリングする**: Profound アカウントにログインし、データが表示されていることを確認します

3. **処理スケジュールを確認する**: 「Next automatic send」が定期的に更新されていることを確認します

## トラブルシューティング

### ログが送信されない

* Log Ingestion Token が正しく、`bot_` で始まっていることを確認してください

* General 設定で **Enable Logging** がオンになっていることを確認してください

* WordPress Cron が実行されていることを確認してください (サイトのフロントエンドにアクセスするとトリガーされます)

* Status タブにエラーメッセージが表示されていないか確認してください

### テストイベントが失敗する

* サーバーがアウトバウンド HTTPS 接続を許可していることを確認してください

* ファイアウォールが `artemis.api.tryprofound.com` への接続をブロックしていないか確認してください

* Log Ingestion Token に余分なスペースや文字が含まれていないことを確認してください

### キューが増加するが送信されない

* 自動送信では、WordPress Cron をトリガーするためにサイトへのアクセスが必要です

* 安定した処理のために、実際の cron ジョブを設定することを検討してください

* スケジュールが見当たらない場合は、**Re-schedule Automatic Sending** をクリックしてください

### IP アドレスが正しくない

* プラグインは、CDN やマネージドホストのプロキシヘッダーを自動的に検出します

* IP が正しくないように見える場合、ホストが標準以外のヘッダーを使用している可能性があります

* カスタムの IP 検出についてはサポートにお問い合わせください

## その他のリソース

* [セキュリティとプライバシーの設定](/ja-jp/agent-analytics/wordpress/security) - 詳細なプライバシー設定とデータの取り扱い

* [プラグインの概要](/ja-jp/agent-analytics/wordpress/introduction) - 機能に関する完全なドキュメント

* 統合に関するサポートは [support@tryprofound.com](mailto:support@tryprofound.com) までお問い合わせください