Neutrope SEO Report Dashboard

説明

Neutrope SEO Report Dashboard は、実際にレポートで使う数値を Google Search Console と Google Analytics 4 (GA4) から取得し、WordPress 内のレポート特化の1画面にまとめます。

これは Google Site Kit や汎用のアクセス解析ツールの代わりになるものではありません。Google のデータの上に重ねるレポート特化のレイヤーであり、定期的に SEO レポートを作成し、Search Console と GA4を行き来せずに主要な数値を把握したい SEO 担当者、Web 制作・保守会社、インハウスのマーケターに向けて作られています。

できること

  • Google Search Console と GA4の主要指標を WordPress 管理画面に表示する。
  • SEO レポートと、月次のクライアント向け・社内向けレポートのために作られている。
  • Google のデータの上に重ねるレポート特化のレイヤー。Site Kit の代替ではない。
  • 重要なキーワードを登録し、Search Console での成果を追跡できる。
  • 重要なページを登録し、オーガニック流入とコンバージョンを追跡できる。
  • 月次のレポート用メモを保存できる (実施した施策、結果、懸念点、次の注力ポイント、社内メモ)。
  • 前週比と前月比を確認できる。
  • キーワード、ページ、月次メモのデータを CSV に出力できる (BOM 付き UTF-8、Excel 対応)。
  • 必要なときに更新するか、WP-Cron で自動的に更新できる。
  • 自分の OAuth クライアントを使い、Google OAuth 2.0で安全に連携できる。セットアップウィザードと、クライアント ID / クライアントシークレットのコピー機能を備える。
  • 取得したデータはすべて WordPress のデータベースに保存する。

表示できる指標

  • Search Console: クリック数、表示回数、CTR、平均掲載順位 (サイト全体、キーワード別、ページ別)。
  • GA4: オーガニックセッション、アクティブユーザー、エンゲージメントのあったセッション、エンゲージメント率、設定したコンバージョンイベント (サイト全体とページ別)。

開発者向けフック

Neutrope SEO Report Dashboard は、開発者がレポートのデータを読み取ったり調整したり、独自のツールと連携したりできるよう、少数のフィルターとアクションを公開しています。すべてのフックは neutrope_srd_ という接頭辞を使用し、コールバックを登録していない場合の動作は変わりません。

フィルター

  • neutrope_srd_capability (string $capability, string $context) – プラグインの管理画面を表示し、admin-post のアクションを実行するために必要な権限。既定は manage_options です。この値はメニューの表示、ページへのアクセス、書き込み操作のすべてを制御するため、ユーザーが完全に持っているか完全に持っていないかのどちらかになる権限を返してください。$context は参考情報 (画面名またはアクション名) なので、それに依存しない値を返してください。
  • neutrope_srd_dashboard_summary (array $summary) – ダッシュボード画面に表示する、組み立て済みのダッシュボードサマリー。
  • neutrope_srd_keywords_report (array $rows) – キーワードレポートの2次元配列 (先頭行はヘッダー)。CSV 出力に使用します。
  • neutrope_srd_pages_report (array $rows) – ページレポートの2次元配列 (先頭行はヘッダー)。CSV 出力に使用します。
  • neutrope_srd_monthly_memo_report (array $report, string $month) – 指定した YYYY-MM 月の月次メモレポート (ヘッダー行とデータ行1行)。CSV 出力に使用します。

アクション

  • neutrope_srd_after_fetch_all (array $result) – データの一括更新 (Search Console + GA4) とスナップショットの再生成が完了したあとに発火します。手動の「Update all data」操作と、定期実行 (WP-Cron) による更新の両方が対象です。$result には overall、gsc、ga4の状態文字列 (success、partial、skipped、failed) が入ります。管理画面のコンテキスト外で実行されることがあるため、コールバックは管理画面からのリクエストであることを前提にしないでください。

定数

  • NEUTROPE_SRD_MENU_SLUG – プラグインのトップレベル管理メニューのスラッグ。連携するツールが、スラッグをハードコードせずにサブページを追加できます。

外部サービス

このプラグインは、Search Console と Analytics のデータを取得するために Google API に接続します。接続するのは OAuth で自分の Google アカウントを連携したあとだけで、データを手動更新したときや定期更新 (WP-Cron) が実行されたときに Google と通信します。Google の API 以外にデータを送信することはなく、取得したデータは WordPress のデータベースに保存します。

Google OAuth 2.0 (accounts.google.com、oauth2.googleapis.com)
アクセスの承認と、アクセストークンの取得および更新に使用します。プラグインは OAuth のクライアント ID とシークレット、認可コードまたはリフレッシュトークンを送信し、アクセストークンとリフレッシュトークンを受け取ります。トークンは暗号化して保存します。

Google Search Console API (www.googleapis.com/webmasters)
送信するもの: OAuth のアクセストークン、選択した Search Console プロパティの URL、期間、登録済みのキーワード、登録済みのページ URL。
受け取るもの: クリック数、表示回数、CTR、平均掲載順位、クエリとページのパフォーマンスデータ。
タイミング: Search Console のデータを手動更新したとき、または定期更新が実行されたとき。

Google Analytics Data API (analyticsdata.googleapis.com)
送信するもの: OAuth のアクセストークン、GA4のプロパティ ID、期間、登録済みのページパス、設定したコンバージョンイベント名。
受け取るもの: オーガニックセッション、アクティブユーザー、エンゲージメントのあったセッション、エンゲージメント率、設定したコンバージョンイベントの発生回数。
タイミング: GA4のデータを手動更新したとき、または定期更新が実行されたとき。

Google Analytics Admin API (analyticsadmin.googleapis.com)
送信するもの: OAuth のアクセストークン。
受け取るもの: 連携した Google アカウントで利用できる GA4のアカウントとプロパティの概要。
タイミング: GA4の設定タブでプロパティ一覧の再取得をクリックしたときのみ。

このプラグインを通じて Google API を利用する場合は、Google API 利用規約 (https://developers.google.com/terms) と Google プライバシーポリシー (https://policies.google.com/privacy) が適用されます。

スクリーンショット

インストール

  1. neutrope-seo-report-dashboard フォルダーを /wp-content/plugins/ にアップロードするか、「プラグイン -> 新規追加 -> プラグインのアップロード」から ZIP をインストールする。
  2. 「プラグイン」画面からプラグインを有効化する。
  3. SEO Report -> Settings -> Google Connection を開く。
  4. Google Cloud Console で OAuth クライアント (種類: ウェブ アプリケーション) を作成するか既存のものを使い、Search Console API、Google Analytics Data API、Google Analytics Admin API を有効にして、設定画面に表示されるリダイレクト URI をクライアントの「承認済みのリダイレクト URI」に追加する。
  5. Google Cloud から OAuth クライアントの JSON ファイルをダウンロードして「Google 連携」画面で読み込むか、クライアント ID とクライアントシークレットを手入力する。
  6. OAuth の設定を保存し、Connect Google account をクリックする。
  7. Search Console タブでプロパティの一覧を再取得し、対象のプロパティを選択して保存したあと、Update Search Console data をクリックする。
  8. GA4タブで GA4のプロパティ一覧を再取得してプロパティを選択し (数値のプロパティ ID を手入力してもよい)、Update GA4 data をクリックする。コンバージョンイベント名は Conversions タブで設定する。
  9. (任意) Auto Update タブで、定期更新を有効にする。

FAQ

これは Google Site Kit の代わりになりますか ?

いいえ。Site Kit は幅広い分野を扱うアクセス解析の統合ツールです。Neutrope SEO Report Dashboard は、週次・月次の SEO レポートに必要な数値だけを表示するレポート特化のレイヤーで、キーワードとページの追跡、月次メモ、比較、CSV 出力を追加します。

自分の Google OAuth クライアントが必要ですか ?

はい。OAuth のクライアント ID とクライアントシークレットは自分で用意します。そのため、Neutrope がサイト用の共通の接続サーバーを運用することはありません。セットアップウィザードでは、Google の client_secret.json ファイル (任意) を読み込んでこれらの項目を自動入力できます。クライアントシークレットとリフレッシュトークンは、暗号化してデータベースに保存します。

このプラグインはどのような権限を要求しますか ?

読み取り専用のスコープのみです: https://www.googleapis.com/auth/webmasters.readonly と https://www.googleapis.com/auth/analytics.readonly。このプラグインが Google のデータを変更することはできません。

データはどこに保存されますか ?

WordPress のデータベース内です。Google の API 以外に、Neutrope や第三者へデータを送信することはありません。

一部の数値が遅れて反映されるのはなぜですか ?

Search Console のデータは数日遅れて反映されるため、レポートでは2日前を終了日として使用します。

複数サイトや PDF 出力に対応していますか ?

このバージョンでは対応していません。今回のリリースは、単一プロパティ、画面上でのレポート表示、CSV 出力に絞っています。

評価

このプラグインにはレビューがありません。

貢献者と開発者

Neutrope SEO Report Dashboard はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“Neutrope SEO Report Dashboard” は1ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“Neutrope SEO Report Dashboard” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログを RSS で購読してみてください。

変更履歴

0.1.4

  • Add: show a contextual Upgrade to Pro link on the Plugins screen when the Pro add-on is not active. The link points to the live purchase page and includes product-specific campaign attribution. No data, settings, or front-end behavior changes.

0.1.3

  • Prevent Search Console page metrics from double-counting URL-fragment jump links such as table-of-contents sitelinks.

0.1.2

  • Add developer extension points: filters for report data and for the required capability, an action after a full data update, and a public menu-slug constant. No changes to existing behavior or stored data.

0.1.1

  • Add Japanese translation.

0.1.0

  • Initial MVP: Google OAuth connection, Search Console and GA4 integration, keyword/page registration, monthly memos, week/month comparisons, CSV export, manual and WP-Cron updates.