ドキュメント
Data Studio:AutoPSEOのデータでレポートを作成する
AutoPSEOには専用のData Studioコネクタはありません。Googleの Search Console コネクタ、CSVアップロード、またはREST APIで常に最新の状態に保つGoogleスプレッドシートを利用してください。
AutoPSEOは、Googleのダッシュボードツール(旧Looker Studio)であるData Studio向けのコネクタを提供していません。それでも、次の3つの方法でAutoPSEOの数値をグラフ化できます。生データにはGoogle公式のSearch Consoleコネクタ、AutoPSEOのレポートからエクスポートしたCSV、そしてスケジュール実行のスクリプトがAutoPSEOのREST APIから取得したデータを書き込むGoogleスプレッドシートです。どの方法が適しているかは、ダッシュボードにどれだけの鮮度が必要か、そしてAutoPSEOの分析結果が必要か、生の指標だけで足りるかによって決まります。
オプション1:GoogleのSearch Consoleコネクタ
Googleのコネクタは Search Console から直接データを読み取るため、取得できるのは生の指標のみで、AutoPSEOの分析結果は含まれません。Googleのコネクタ解説によると、次のとおりです。
- テーブルは Site Impression と URL Impression の2種類があり、1つのデータソースで使えるのはどちらか一方です。両方を表示したい場合は、レポートに2つのデータソースを追加してください。
- Search Consoleプロパティに対する閲覧権限以上が必要で、両方のプロダクトに同じGoogleアカウントでログインしている必要があります。
- Site Impressionはウェブ、画像、動画、ニュースの検索結果を対象とし、URL Impressionはこれに Discover とGoogleニュースを加えたものです。
追加するには、作成 → データソース → Search Console を選び、サイト、テーブル、デフォルトの検索タイプを指定して 接続 をクリックします。
オプション2:AutoPSEOからCSVをアップロードする
単発または月次のダッシュボードであれば、任意のレポートからテーブルをエクスポートし(データのエクスポート)、Data StudioのCSVファイルアップロードコネクタで追加します。エクスポート方法は、Googleのアップロード要件に合わせて決めてください。
- フィールドはカンマ区切りである必要があるため、先に アカウント → CSVエクスポート形式 を 標準(US / UK) に設定してください。
- ファイルはヘッダー行付きのUTF-8である必要があります。AutoPSEOのエクスポートはこの条件を満たしています。
- 1つのデータセットに追加するファイルは、すべて列の内容と順序がまったく同じでなければなりません。毎回、同じレポートを同じ列構成・同じ比較設定でエクスポートしてください。
- 新しいファイルは追記され、重複は削除されません。そのため、期間が重なるデータはアップロードしないでください。
- ファイルサイズの上限は1ファイルあたり100 MBで、ユーザーごとのアップロード用ストレージは2 GBです。
パーセンテージはパーセント記号付き(27.03%)でエクスポートされるため、アップロード後にフィールドの型を確認してください。
オプション3:REST APIで更新するGoogleスプレッドシート
自動で最新の状態を保つダッシュボードにするには、スケジュール実行のジョブでAutoPSEOの数値をGoogleスプレッドシートに書き込み、そのシートを接続します。Googleのスプレッドシートコネクタは、レポートがクエリを実行するたびに、値の変更や新しい行がないかを確認します。
- AutoPSEOで MCP & API を開き、Read only スコープのAPIキーを作成します。キーは一度しか表示されないため、ジョブのシークレットに保存してください。
- スケジュール実行のジョブ(Google Apps Script、cronジョブ、ワークフローツールなど)からREST APIを呼び出し、取得した行をシートに書き込みます。
- Data Studioで、Googleスプレッドシートコネクタを使ってシートを追加し、1行目をヘッダーとして使用 にチェックを入れます。
過去28日間の上位クエリを取得する呼び出しは、次のようになります。
curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
-H "Authorization: Bearer apk_live_..."レスポンスはJSON形式で、結果は data に、呼び出しの詳細は meta に格納されます。REST APIは、MCPサーバーと同じ19個の Search Console およびGA4ツールを提供します。具体的には、プロパティ、検索アナリティクスの行、上位クエリ・ページ・国、期間比較、順位変動、新規・喪失した順位、コンテンツの劣化、カニバリゼーション、CTRベンチマーク、ページの横取り、URL検査、サイトマップ、アノテーション、そしてGA4の概要、内訳、キーイベントです。上位クエリと上位ページは最大1,000行、上位国は最大300行を返し、search-analytics は1つまたは2つのディメンションで最大5,000行の生データを返します。呼び出しの上限は、キーあたり1分間に60回、アカウントあたり1時間に1,000回です。すべてのパラメータは、https://app.autopseo.com/v1/openapi.json にあるOpenAPI 3.1ドキュメントで確認できます。
どのオプションを選ぶか
| 必要なもの | 使う方法 |
|---|---|
| Googleが最新の状態に保つ、クリック数・表示回数などの生データ | GoogleのSearch Consoleコネクタ |
| AutoPSEOの特定レポートの月次スナップショット | CSVアップロード |
| 順位変動やコンテンツの劣化など、AutoPSEOの分析結果を定期的に取得したい場合 | REST APIで更新するGoogleスプレッドシート |
ダッシュボードの主な目的がクライアントに数値を見せることであれば、共有レポートのリンクや、スケジュール配信の Slack または Teams レポートのほうが手間は少なく済むかもしれません。GoogleのコネクタについてはFAQのSearch Console と Looker Studioでさらに詳しく解説しています。