# Wordpress統合手順
お使いのウェブサイトが WordPress を利用している場合は、手動の手順を省略して、WordPress プラグインディレクトリから Pushly をインストールできます。
## ステップ 1: WordPress API キーを作成する
WordPress プラグインから直接通知を送信したい場合は、プラットフォーム内で WordPress API キーを作成する必要があります。WordPress から直接通知を作成したくない場合は、このセクションをスキップできます。
移動して *ドメイン設定* Pushly プラットフォームのセクションを開き、 *統合* タブをクリックします。このタブ内に、 *コンテンツ管理システム* という WordPress カードを含むセクションがあります。
クリックして **新しい API キー** ボタンを押し、キーが画面に表示されるまで待ちます。表示されたら、キーをクリックしてクリップボードにコピーし、ステップ 3 で使用できるように保存します。
## ステップ 2: プラグインをインストールする
新しいプラグインをインストールできる権限を持つユーザーで WordPress 管理画面にログインし、プラグインディレクトリに移動します。 `新規追加` ボタンをクリックすると、インストール可能なプラグインの一覧が表示されます。
で `プラグインを追加` ページで `Pushly` を検索ボックスに入力し、次に `今すぐインストール` ボタンを Pushly プラグインカードでクリックします。
プラグインがインストールされると、 `今すぐインストール` ボタンは `有効化` ボタンに変わります。このボタンをもう一度クリックしてインストールを完了し、その後ステップ 2 に進んでプラグインのセットアップを完了してください。
## ステップ 3: プラグインを設定する
ステップ 1 を完了してプラグインを有効化すると、 `Pushly` という新しいメニュー項目がサイドバーメニューに表示されます。このメニュー項目をクリックすると、Pushly の設定ページに移動し、プラグインの動作を設定できます。
利用可能な設定オプションは以下のとおりです。
* **SDK キー**：プラットフォームの *ドメイン設定* セクションから SDK キーを取得し、このテキストボックスに入力してください。アカウントマネージャーから SDK キーを提供してもらうこともできます。
* **新しい投稿の通知を送信：** このスイッチをオンにすると、新しい投稿が作成されたときに WordPress から直接通知を作成できます。このスイッチを有効にすると、新しい *Pushly* セクションが投稿エディターのサイドバーに表示され、通知送信に関連するオプションが含まれます。
* **自動送信**：このスイッチをオンにすると、WordPress で新しい投稿を作成する際に *通知を送信* チェックボックスが自動的にオンになります。 *通知を送信* ボックスにチェックが入ると、投稿が公開されたときに通知が作成されます。
* **API キー：** ステップ 1 で生成した WordPress API キーをこのテキストボックスに入力してください。
* **詳細設定：**
* **SDK 初期化を無効にする：** このボックスにチェックを入れると、Pushly SDK は **自動的に実行されません** が、既存の購読者は引き続き通知を受信できます。
設定オプションを設定したら、フォームを保存してください。フォームが保存されると、サイト訪問者には通知許可ダイアログが表示され始めます。通知送信を設定した場合、WordPress のユーザーは WordPress 投稿を作成する際に通知送信オプションも表示されます。
{% hint style="info" %}
これらの手順を完了しても通知のオプトインを求められない場合は、Pushly プラットフォームの `プロンプト` セクションに少なくとも 1 つの有効なプロンプトがあることを確認してください。
{% endhint %}
## ステップ 4: アクティビティログでトラブルシューティングする
Pushly プラグインには、通知送信プロセスの各ステップを記録する組み込みのアクティビティログが含まれています。通知が期待どおりに送信されない場合、アクティビティログには何が起こったのか、なぜ起こったのかが正確に表示されるため、サポートに連絡しなくても問題を簡単に診断できます。
### デバッグログを有効にする
1. 移動して **Pushly** WordPress 管理画面のサイドバーにある設定ページ
2. 開く **デバッグ** タブの下部にあるセクション
3. 切り替える **デバッグログ** をオンにする
4. クリック **保存**
有効にすると、プラグインは投稿が公開または更新されるたびに詳細なログエントリを記録します。ログが初めて有効化されると、環境スナップショットが自動的に取得され、WordPress とプラグインの設定に関する有用なコンテキストが提供されます。
{% hint style="info" %}
ログエントリは各リクエストの শেষেに一括で書き込まれ、14 日後またはログが 5,000 件に達した時点で自動的に整理されます。
{% endhint %}
### アクティビティログを表示する
クリックして **アクティビティログ** タブを Pushly 設定ページで開くと、記録されたログエントリを表示できます。各エントリには以下が含まれます：
* **タイムスタンプ** — イベントが発生した時刻（お住まいのローカルタイムゾーンで表示）
* **重要度** — イベントの重要度レベル（debug、info、warning、error）
* **イベントタイプ** — イベントの機械可読な識別子（例： `send_flow_start`, `api_response`)
* **メッセージ** — 発生した内容の人間可読な説明
ログエントリは新しいものから順に逆時系列で表示され、1 ページあたり 50 件表示されます。
### サポート用にログをエクスポートする
通知の問題について Pushly サポートに連絡する必要がある場合：
1. へ移動し **アクティビティログ** タブ
2. クリック **ログをダウンロード** して、すべてのログエントリをテキストファイルとして保存します
3. ダウンロードしたファイルをサポートチケットに添付してください
エクスポートされたファイルには、タイムスタンプ、重要度レベル、および完全なメッセージ詳細を含む、記録されたすべてのログエントリが含まれます。これにより、サポートチームは WordPress 管理画面にアクセスしなくても問題を診断するために必要な情報をすべて得られます。
また、 **クリップボードにコピー** をクリックして、現在ページに表示されているエントリをコピーすることもできます。
### ログエントリを理解する
投稿が公開されると、プラグインは通知送信フロー内の各判断ポイントをログに記録します。以下は、最もよく表示されるエントリです。
| イベントタイプ | 意味 |
| -------------------- | ---------------------------------------- |
| `send_flow_start` | 投稿の通知送信プロセスが開始されました |
| `meta_check` | 「通知を送信」チェックボックスがオンになっていたかどうか |
| `duplicate_check` | この投稿にはすでに通知が送信されていました |
| `notification_build` | 通知ペイロードが組み立てられました |
| `api_request` | 通知が Pushly API に送信されました |
| `api_response` | API が応答しました — 成功またはエラーの詳細はメッセージを確認してください |
通知の送信に失敗した場合は、 **error** 重要度のエントリを確認してください。メッセージには、HTTP ステータスコードや API からのエラーメッセージなどの具体的な詳細が含まれます。
### ログを消去する
クリック **ログを消去** をクリックして、すべてのログエントリを削除し、最初からやり直します。これは、特定の問題を切り分けたいときに便利です。ログを消去し、問題を再現してから、新しいエントリを確認またはエクスポートしてください。
{% hint style="warning" %}
ログの消去は永続的で、元に戻すことはできません。
{% endhint %}