トップ ／ プロダクト管理 ／ 手動での調査実行
手動での調査実行
このページでできること
- 選択中プロダクトの登録キーワードに対して、DataForSEO 各 API（順位 / AI Overview / AI Mode / 各 LLM）を即時呼び出し、結果を DB に保存します。
- 「すべて取得」と「本日未取得・エラーのみ取得」の 2 モードを選べます。
- 実行前に「予想コスト」（USD / JPY 換算）を確認できます。
- 実行プラン（Live / Priority / Standard）を反映した進捗・スループットが確認できます。
URL: manage/survey.php?product_id=<id>。システム管理者（admin）またはプロダクト管理者（product_manager）がアクセス可能。
2 つのモード
| モード | 挙動 | 用途 |
|---|---|---|
| すべてのキーワードを調査実行 | 本日取得済みのキーワードも含めて再取得。同一日に複数バッチが残ります（最新の captured_at が「最新値」となる）。 |
1 日に複数回スナップショットを取りたいとき／取得設定（モデル変更・自社ブランド変更）後に再取得したいとき。 |
| 本日未取得・エラーのデータのみ調査を実行 | 本日のスナップショットが存在し、かつエラーで無いキーワードはスキップ。 | cron で取りこぼした分の手動補完／エラー再試行。 |
予想コストの見方
画面上部「予想コスト」パネルに、すべてのキーワードを 1 回調査した場合の合計コストが表示されます。
- 「すべての軸（順位＋ AI Overview ＋ AI Mode ＋ 各 LLM）を 1 回ずつ実行した場合の最大値」が基準。
- 未取得のみ実行する場合は「未取得・エラーのみ」の行に該当件数で再計算した予想コストが表示されます。
- 1 USD あたりの円換算は システム管理 で設定したレートを使用。
実行プランの違い
DataForSEO API 管理 で「SERP API」「LLM Responses API」のそれぞれに実行プランを設定できます。
| プラン | SERP | LLM | 挙動 |
|---|---|---|---|
| Live | ○ | ○ | 同期 API、即時応答、最高コスト。1 件ずつ順次処理。 |
| Priority Queue | ○ | × | 非同期 + 高優先度キュー、中コスト。複数キーワードへ並列でリクエストを送信し、ポーリングで結果を取得。全体スループットは Live より大幅に高速。 |
| Standard Queue | ○ | ○ | 非同期 + 標準キュー、最安。完了まで数十秒〜数分かかる場合がある。 |
取得中の挙動
ブラウザを開いたままにする必要があります
手動取得はブラウザのタブから JS で API を順次呼び出します。タブを閉じると取得が中断されます（他のタブを開いたり、PC をスリープしないようにする等は OK）。
- 1 件ごとに進捗が画面に流れ、完了件数 / 残件数 / 推定残時間が表示されます。
- エラー発生時はその場で「エラー」と記録されます（再実行で再試行可能）。
- 調査実行管理（曜日スケジュール）で 本日対象外になっている軸は、手動でもスキップされます。
DB バックアップ
本ページから「DB バックアップ」を実行すると backup/app_YYYY-MM-DD_HHmmss.db が生成されます。本格的な取得を行う前に必ず実行してください。
関連 API
POST /api/router.php?path=run_keyword：1 キーワード × 1 軸の取得。GET /api/router.php?path=keywords/missing-today：本日未取得 / エラーのみのキーワード ID 一覧。POST /api/backup_db.php：DB スナップショット作成。