google-analytics-automation

Rube MCP による Google Analytics の自動化

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

ツールキットのドキュメント：composio.dev/toolkits/google_analytics

前提条件

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

セットアップ

Rube MCP を取得する：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで利用できます。

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

主なワークフロー

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

---

Composio 提供