Studio317 Report Drafts for Google Analytics

説明

このプラグインは、選択したGoogle アナリティクス（GA4）のデータをもとに、AIが報告書の下書きを作成します。作成した下書きは、利用前にWordPress内で確認・編集・コピーできます。AIプロバイダーの設定と認証情報は、サイト管理者がWordPress の設定 > コネクタで管理します。

このプラグインは 渡部公也 / スタジオ317 により開発されています。Google との提携、Google による承認、または Google による支援を受けたものではありません。

このプラグインは Google Analytics のダッシュボードに代わるものではありません。選択した GA4 レポートデータを、利用前に確認および編集できる下書きへ変換することに特化した管理者向けワークフローを提供します。

ワークフロー

初回設定：

1. GA4 プロパティと任意のホストフィルターを設定します。
2. Google OAuth クライアント設定を構成するか、サーバー設定を使用します。
3. WordPress の「設定」>「コネクタ」で、対応する AI テキスト生成プロバイダーを設定します。
4. 「Google アカウントに接続」をクリックし、選択したGA4プロパティを閲覧できるGoogle アカウントを接続します。Googleから、そのプロパティへの読み取り専用アクセスを許可するよう求められる場合があります。

通常の利用：

1. レポートビルダーで、期間、比較、取得範囲などのレポート条件を選択します。
2. 「AIレポートを作成」をクリックします。
3. 条件が有効で、Google アナリティクスと設定済みのAIプロバイダーを利用できる場合、プラグインは必要なGA4レポートデータを取得し、WordPress AI Clientを通じて報告書の下書き作成を依頼します。
4. 生成された下書きを確認、編集、コピーします。

レポート条件、Google アカウントとの接続、GA4データの取得、またはAIプロバイダーの設定に問題があり、プラグインが処理を続けられない場合は、問題の内容を表示して処理を中止します。選択したレポート条件は画面に残るため、修正後にもう一度実行できます。

レポートの出力言語は、レポートビルダーを実行する管理者の WordPress 言語設定に従います。ユーザーロケールを利用できない場合、このプラグインはサイトロケールへ、さらに英語へフォールバックします。WordPress のタイムゾーンはレポート期間および日付処理に使用され、レポート言語の選択には使用されません。

対応サイト範囲

初期対応範囲はシングルサイトの WordPress です。マルチサイトのネットワーク有効化、ネットワークアンインストール、サイト間の保存動作は、初期対応範囲に含まれません。

外部サービス

Studio317 Report Drafts for Google Analyticsが外部サービスへ接続するのは、管理者がGoogle アカウントへの接続を明示的に開始した場合、または「AIレポートを作成」をクリックした場合だけです。設定またはレポートビルダーを表示するだけでは、GoogleやAIプロバイダーへ接続しません。

Google OAuth 認可

管理者が「Google アカウントに接続」をクリックすると、ブラウザはGoogleへ移動する場合があります。Googleから、選択したGoogle アナリティクスのプロパティをこのプラグインが読み取るためのアクセス許可を求められる場合があります。ブラウザが戻った後、プラグインはローカルのコールバック状態を確認し、認可結果をGoogle OAuthトークンと交換する場合があります。

このフローで使用するサービスエンドポイント:

• Google 認可エンドポイント: https://accounts.google.com/o/oauth2/v2/auth
• Google トークンエンドポイント: https://oauth2.googleapis.com/token

このフローで Google に送信されるデータには、OAuth クライアント設定、プラグインのリダイレクト URI、要求した Google Analytics の読み取り専用アクセス、ローカルの state 値が含まれる場合があります。Google から受信するデータには、認可結果およびトークンレスポンスデータが含まれる場合があります。認可コード、トークン値、プロバイダーのレスポンス、オプション値は、プラグイン管理画面に表示されません。

Google の利用規約およびプライバシー情報:

• Google APIs 利用規約: https://developers.google.com/terms
• Google プライバシーポリシー: https://policies.google.com/privacy

Google Analytics Data API

管理者が「AIレポートを作成」をクリックすると、プラグインは最初に選択したレポート条件を確認します。Google アカウントとの接続設定を利用できる場合は、必要なレポートデータを取得するため、Google アナリティクス Data APIへリクエストを送信します。

サービス URL: https://analyticsdata.googleapis.com/

Google に送信するデータには、次が含まれる場合があります。

• GA4 プロパティ ID。
• Authorization ヘッダー内の Google OAuth アクセストークン。
• 選択した期間。
• 比較を有効にした場合の比較設定および比較期間。
• 有効な場合のホスト名フィルター。
• ディレクトリまたはページ範囲を選択した場合のページパスフィルター。
• レポートプリセットに必要な指標とディメンション。

Google から受信するデータには、次が含まれる場合があります。

• 概要指標。
• 日別推移データ。
• 上位ページ。
• トラフィックチャネル。
• トラフィックソース。
• 利用可能な場合の都市レベルの地域別推移。

Google Analytics Data API のリクエスト本文には、AI プロバイダーの認証情報、WordPress ユーザー識別子、Cookie、IP アドレスを含めない設計です。

AI 生成プロバイダー

「AIレポートを作成」の実行中に取得したGA4データが報告書の下書きを作成できる状態である場合、プラグインはWordPress AI Clientを通じて、サイト管理者がWordPress の設定 > コネクタで設定したAIプロバイダーへ下書き作成を依頼します。

このプラグインは固定の AI プロバイダーエンドポイントを定義しません。利用規約、プライバシー方針、課金、保持、認証情報の管理は、サイト管理者が WordPress を通じて設定した AI プロバイダーに依存します。

WordPress AI Client を通じて送信されるデータには、次が含まれる場合があります。

• 選択したレポート出力言語を含むシステム指示。
• 選択したレポート条件をもとに作成されたGA4由来のレポートデータ。
• WordPress のロケール設定から解決されたレポート出力言語およびロケール情報。

WordPress AI Client を通じて送信されるレポートデータには、次が含まれる場合があります。

• ホスト名。
• 期間と比較情報。
• 正規化されたパス条件。
• 概要指標と計算された差分。
• 日別推移データ。
• 上位ページ。
• トラフィックチャネル。
• トラフィックソース。
• 利用可能な場合の都市レベルの地域別推移。

WordPress AI Client を通じて送信されるレポートデータには、Google OAuth トークン、AI プロバイダーの認証情報、GA4 プロパティ ID、WordPress ユーザー識別子、Cookie、IP アドレスを含めない設計です。

AI 生成では、設定済みの AI プロバイダーに応じて利用量、クレジット、または割り当てを消費する場合があります。生成されたレポート本文は、管理者による確認、編集、コピーのために表示されます。このプラグインは、生成されたレポート本文を意図的に保存しません。生成されたレポート本文は下書きであり、公開、共有、送信する前に管理者が確認および編集する必要があります。

データ保存と確認

このプラグインは、プラグイン独自の設定を WordPress データベースに保存します。保存される設定には、GA4 プロパティ ID、ホストフィルター設定、保存済みの Google OAuth クライアント設定が含まれる場合があります。

このプラグインは、プラグイン独自の AI プロバイダー API キーを保存しません。AI プロバイダーの認証情報およびプロバイダーの選択は、WordPress コネクタを通じて管理されます。

Google OAuth トークンデータは、プラグイン専用のオプションに保存されます。このオプションは、新規保存時に自動読み込みを無効にして作成されます。保存済みの認証情報の値は、管理画面に再表示されません。

Google OAuth クライアント設定はサーバー設定で指定することもできます。サーバー管理の値が優先され、プラグインの設定画面から編集または削除することはできません。

報告書の下書き作成時に利用する一時的なレポートデータは、現在の管理者向けに短時間保存され、自動的に期限切れになります。データ検証は一時保存の前とAI生成の前に行われます。欠落、期限切れ、古い形式、または無効なレポートデータは、WordPress AI Clientを通じて送信されません。

ローカルの Google 接続解除では、このプラグインが保存したローカル OAuth トークンデータのみを削除します。Google への接続、プロバイダーアクセスの取り消し、保存済み OAuth クライアント設定の削除、AI プロバイダー設定の変更は行いません。

シングルサイト環境でアンインストールすると、このプラグインはメイン設定オプションと専用の Google OAuth トークンオプションを削除します。必要に応じて、プロバイダー側のアクセスは Google アカウントまたは Google Cloud の設定で別途確認してください。

データベース管理者、バックアップ、サーバー管理者、または WordPress オプションを読み取れるコードは、保存された認証情報の値にアクセスできる可能性があります。