google-analytics-automation

Rube MCP による Google Analytics の自動化

Rube MCP を介して Composio の Google Analytics ツールキットを使用し、Google Analytics 4（GA4）のレポート作成とプロパティ管理を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット google_analytics を指定した RUBE_MANAGE_CONNECTIONS による有効な Google Analytics 接続
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出すこと

セットアップ

Rube MCP の取得：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。エンドポイントを追加しても Google へのアクセスは認証されません。ホストがサポートする認証と、ユーザーが承認したアカウントを使用してください。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット google_analytics を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Google OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主要なワークフロー

正確な GA4 プロパティ／アカウントとレポートのタイムゾーンを確認します。結果を解釈する際は、日付範囲、アトリビューションの範囲、レスポンスのメタデータ（しきい値適用、サンプリング、データ損失／その他の行に関するフラグ）を記録します。行や日をまたいで、ユーザー数を単純に合計することはできません。conversions が引き続きサポートされていると決めつけず、現在のメタデータでキーイベントの指標名を確認します。読み取り専用の分析は、キーイベントの作成・削除やプロパティ設定の変更を許可するものではありません。こうした書き込み操作は、ユーザーから具体的な依頼があった場合にのみ実行し、結果を再取得して確認してください。

1. アカウントとプロパティの一覧表示

使用する場面：ユーザーが利用可能な GA4 アカウントとプロパティを確認したい場合

ツールの順序：

1. GOOGLE_ANALYTICS_LIST_ACCOUNTS - アクセス可能なすべての GA4 アカウントを一覧表示します［必須］
2. GOOGLE_ANALYTICS_LIST_PROPERTIES - アカウントに属するプロパティを一覧表示します［必須］

主なパラメーター：

• pageSize：ページあたりの結果数
• pageToken：前回のレスポンスから取得したページネーショントークン
• filter：プロパティのフィルター式（例：parent:accounts/12345）

注意点：

• プロパティ ID は「properties/」を接頭辞とする数値文字列です（例：'properties/123456'）
• アカウント ID は「accounts/」を接頭辞とします（例：'accounts/12345'）
• 必ず最初にアカウントを一覧表示し、次に各アカウントのプロパティを一覧表示します
• プロパティが多数ある組織ではページネーションが必要です

2. 標準レポートの実行

使用する場面：ユーザーが GA4 データの指標とディメンションをクエリしたい場合

ツールの順序：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - プロパティ ID を取得します［前提条件］
2. GOOGLE_ANALYTICS_GET_METADATA - 利用可能なディメンションと指標を確認します［任意］
3. GOOGLE_ANALYTICS_CHECK_COMPATIBILITY - ディメンションと指標の互換性を確認します［任意］
4. GOOGLE_ANALYTICS_RUN_REPORT - レポートクエリを実行します［必須］

主なパラメーター：

• property：プロパティ ID（例：'properties/123456'）
• dateRanges：startDate と endDate を含む日付範囲オブジェクトの配列
• dimensions：name フィールドを含むディメンションオブジェクトの配列
• metrics：name フィールドを含む指標オブジェクトの配列
• dimensionFilter / metricFilter：フィルター式
• orderBys：並べ替え順の設定
• limit：返す行の最大数
• offset：ページネーション用の行オフセット

注意点：

• 日付形式は「YYYY-MM-DD」、または「today」「yesterday」「7daysAgo」「30daysAgo」などの相対値です
• すべてのディメンションと指標に互換性があるわけではありません。事前に CHECK_COMPATIBILITY を使用してください
• 有効なディメンション名と指標名を確認するには GET_METADATA を使用してください
• 1 回のレポートリクエストで指定できるディメンションは最大 9 個です
• 行数のデフォルト上限は異なる場合があります。大規模なデータセットでは明示的に設定してください
• offset は結果のページネーション用であり、日付のページネーション用ではありません

3. バッチレポートを実行する

使用する場面：同じプロパティに対して、複数の異なるレポートを1回の呼び出しで取得したい場合

ツールの順序：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - プロパティ ID を取得します［前提条件］
2. GOOGLE_ANALYTICS_BATCH_RUN_REPORTS - 複数のレポートを一度に実行します［必須］

主なパラメーター：

• property：プロパティ ID（必須）
• requests：個別のレポートリクエストオブジェクトの配列（RUN_REPORT と同じ構造）

注意点：

• 1回のバッチ呼び出しにつき、レポートリクエストは最大5件です
• バッチ内のすべてのレポートで、同じプロパティを対象にする必要があります
• 個々のレポートには、RUN_REPORT と同じディメンション／指標の上限が適用されます
• バッチエラーがすべてのレポートに影響する場合があります。個々のレポートレスポンスを確認してください

4. ピボットレポートを実行する

使用する場面：ピボットテーブルのように、行と列でクロス集計したデータを取得したい場合

ツールの順序：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - プロパティ ID を取得します［前提条件］
2. GOOGLE_ANALYTICS_RUN_PIVOT_REPORT - ピボットレポートを実行します［必須］

主なパラメーター：

• property：プロパティ ID（必須）
• dateRanges：日付範囲オブジェクト
• dimensions：いずれかのピボットで使用するすべてのディメンション
• metrics：集計する指標
• pivots：fieldNames、limit、orderBys を含むピボット定義の配列

注意点：

• ピボットで使用するディメンションは、トップレベルの dimensions にも指定する必要があります
• ピボットの fieldNames では、トップレベルのリストにあるディメンション名を参照します
• 多数のディメンションを含む複雑なピボットでは、非常に大きな結果セットが生成される場合があります
• 各ピボットには、それぞれ独立した limit と orderBys があります

5. ファネルレポートを実行する

使用する場面：コンバージョンファネルと離脱率を分析したい場合

ツールの順序：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - プロパティ ID を取得します［前提条件］
2. GOOGLE_ANALYTICS_RUN_FUNNEL_REPORT - ファネル分析を実行します［必須］

主なパラメーター：

• property：プロパティ ID（必須）
• dateRanges：日付範囲オブジェクト
• funnel：steps 配列を含むファネル定義
• funnelBreakdown：ファネルの内訳に使用する任意のディメンション

注意点：

• ファネルのステップには順序があり、各ステップでユーザーが満たす必要のある条件を定義します
• ステップでは、ディメンション／指標フィルターに似たフィルター式を使用します
• オープンファネルでは任意のステップから開始できますが、クローズドファネルでは順番に進む必要があります
• ファネルレポートは、標準レポートより処理に時間がかかる場合があります

6. キーイベントを管理する

使用する場面：GA4 のコンバージョンイベント（キーイベント）を表示または管理したい場合

ツールの順序：

1. GOOGLE_ANALYTICS_LIST_PROPERTIES - プロパティ ID を取得します［前提条件］
2. GOOGLE_ANALYTICS_LIST_KEY_EVENTS - プロパティのすべてのキーイベントを一覧表示します［必須］

主なパラメーター：

• parent：プロパティのリソース名（例：'properties/123456'）
• pageSize：1ページあたりの結果数
• pageToken：ページネーション用トークン

注意点：

• GA4 では、キーイベントは以前「コンバージョン」と呼ばれていました
• 結果を返すには、プロパティにキーイベントが設定されている必要があります
• キーイベント名は GA4 のイベント名に対応します

一般的なパターン

ID の解決

アカウント名 -> アカウント ID：

1. Call GOOGLE_ANALYTICS_LIST_ACCOUNTS
2. Find account by displayName
3. Extract name field (e.g., 'accounts/12345')

プロパティ名 -> プロパティ ID：

1. Call GOOGLE_ANALYTICS_LIST_PROPERTIES with filter
2. Find property by displayName
3. Extract name field (e.g., 'properties/123456')

ディメンション／指標の確認

1. Call GOOGLE_ANALYTICS_GET_METADATA with property ID
2. Browse available dimensions and metrics
3. Call GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to verify combinations
4. Use verified dimensions/metrics in RUN_REPORT

ページネーション

• レポート：行のページネーションには offset と limit を使用します
• アカウント／プロパティ：レスポンスの pageToken を使用します
• pageToken がなくなるか、rowCount に達するまで続けます

一般的なディメンションと指標

ディメンション：date、city、country、deviceCategory、sessionSource、sessionMedium、pagePath、pageTitle、eventName

指標：activeUsers、sessions、screenPageViews、eventCount、conversions、totalRevenue、bounceRate、averageSessionDuration

既知の落とし穴

プロパティ ID:

• 常に完全なリソース名の形式を使用します：'properties/123456'
• 数値の ID のみを使用するとエラーになります
• LIST_PROPERTIES を使用してプロパティ名を ID に解決します

日付範囲:

• 形式：'YYYY-MM-DD' または相対指定（'today'、'yesterday'、'7daysAgo'、'30daysAgo'）
• データ処理の遅延により、今日のデータは不完全な場合があります
• 最大日付範囲はプロパティの設定によって異なります

互換性:

• すべてのディメンションがすべての指標と組み合わせて使えるわけではありません
• 複雑なレポートの前には、必ず CHECK_COMPATIBILITY で確認してください
• カスタムディメンション／指標には特定の命名パターンがあります

レスポンスの解析:

• レポートデータは dimensionValues と metricValues を含む rows 配列にネストされています
• 値は文字列として返されるため、数値は明示的に解析してください
• 空のレポートには rows キーがありません（空の配列ではありません）

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
アカウントの一覧表示	GOOGLE_ANALYTICS_LIST_ACCOUNTS	pageSize, pageToken
プロパティの一覧表示	GOOGLE_ANALYTICS_LIST_PROPERTIES	filter, pageSize
メタデータの取得	GOOGLE_ANALYTICS_GET_METADATA	property
互換性の確認	GOOGLE_ANALYTICS_CHECK_COMPATIBILITY	property, dimensions, metrics
レポートの実行	GOOGLE_ANALYTICS_RUN_REPORT	property, dateRanges, dimensions, metrics
バッチレポート	GOOGLE_ANALYTICS_BATCH_RUN_REPORTS	property, requests
ピボットレポート	GOOGLE_ANALYTICS_RUN_PIVOT_REPORT	property, dateRanges, pivots
ファネルレポート	GOOGLE_ANALYTICS_RUN_FUNNEL_REPORT	property, dateRanges, funnel
キーイベントの一覧表示	GOOGLE_ANALYTICS_LIST_KEY_EVENTS	parent, pageSize

使用する場面

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは、タスクが上記の説明された対象範囲に明確に該当する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、停止して確認を求めてください。