Rube MCP による Google Ads 自動化
Google Analytics 統合を介して Google Ads データにアクセスし、パフォーマンスレポートの実行、リンクされた Ads アカウントの一覧表示、キャンペーンメトリクスの分析を Rube MCP（Composio）を使って行います。
ツールキットドキュメント: composio.dev/toolkits/googleads
前提条件
- Rube MCP が接続されていること（
RUBE_SEARCH_TOOLSが利用可能であること） RUBE_MANAGE_CONNECTIONSを使用して、ツールキットgoogle_analyticsとのアクティブな接続が確立されていること- 常に最初に
RUBE_SEARCH_TOOLSを呼び出して、現在のツールスキーマを取得すること
セットアップ
Rube MCP を入手する: クライアント設定で MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要で、エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認して、Rube MCP が利用可能かどうかを確認するRUBE_MANAGE_CONNECTIONSをツールキットgoogle_analyticsで呼び出す- 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了する
- ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認する
注: Google Ads データは Google Analytics ツールキット統合を介してアクセスされます。以下のツールは、Google Ads アカウントにリンクされた GA4 プロパティを使用します。
コアワークフロー
1. プロパティの Google Ads リンクを一覧表示する
GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS を使用して、GA4 プロパティに設定されているすべての Google Ads アカウントリンクを取得します。
ツール: GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS
パラメータ:
- parent（必須）: プロパティリソース名（形式: "properties/{propertyId}"）
- pageSize: 最大結果数（1～200、デフォルト50）
- pageToken: ページネーショントークン
2. GA4 パフォーマンスレポートを実行する
GOOGLE_ANALYTICS_RUN_REPORT を使用して、ディメンション、メトリクス、日付範囲、フィルターを指定したカスタムレポートを実行します。
ツール: GOOGLE_ANALYTICS_RUN_REPORT
パラメータ:
- property（必須）: プロパティリソース（形式: "properties/{property_id}"）
- dimensions: ディメンションオブジェクトの配列（例: [{"name": "sessionCampaignName"}, {"name": "date"}]）
- metrics: メトリクスオブジェクトの配列（例: [{"name": "sessions"}, {"name": "totalRevenue"}]）
- dateRanges: startDate と endDate を持つ配列（例: [{"startDate": "2025-01-01", "endDate": "2025-01-31"}]）
- dimensionFilter: ディメンション値によるフィルター
- metricFilter: メトリクス値によるフィルター（集計後に適用）
- orderBys: 結果の並び替え
- limit: 返す最大行数（1～250000）
3. ディメンション/メトリクスの互換性を確認する
GOOGLE_ANALYTICS_CHECK_COMPATIBILITY を使用して、レポートを実行する前にディメンションとメトリクスの組み合わせを検証します。
ツール: GOOGLE_ANALYTICS_CHECK_COMPATIBILITY
説明: 選択したディメンションまたはメトリクスの互換性をレポート実行前に検証します。
注: このツールの完全なスキーマを取得するには、RUBE_SEARCH_TOOLS を呼び出してください。
4. GA4 アカウントを一覧表示する
GOOGLE_ANALYTICS_LIST_ACCOUNTS を使用して、アクセス可能なすべての Google Analytics アカウントを列挙します。
ツール: GOOGLE_ANALYTICS_LIST_ACCOUNTS
パラメータ:
- pageSize: 返す最大アカウント数
- pageToken: ページネーショントークン
- showDeleted: ソフト削除されたアカウントを含める
5. アカウント配下の GA4 プロパティを一覧表示する
GOOGLE_ANALYTICS_LIST_PROPERTIES を使用して、特定の GA4 アカウントのプロパティを一覧表示します。
ツール: GOOGLE_ANALYTICS_LIST_PROPERTIES
パラメータ:
- account（必須）: アカウントリソース名（形式: "accounts/{account_id}"）
- pageSize: 最大プロパティ数（1～200）
- pageToken: ページネーショントークン
- showDeleted: ゴミ箱に入ったプロパティを含める
6. 利用可能なディメンションとメトリクスを取得する
GOOGLE_ANALYTICS_GET_METADATA を使用して、レポート作成に利用可能なすべてのフィールドを発見します。
ツール: GOOGLE_ANALYTICS_GET_METADATA
説明: GA4 プロパティのディメンション、メトリクス、比較のメタデータを取得します。
注: このツールの完全なスキーマを取得するには、RUBE_SEARCH_TOOLS を呼び出してください。
一般的なパターン
- 発見してからレポート:
GOOGLE_ANALYTICS_LIST_ACCOUNTSでアカウント ID を検索し、次にGOOGLE_ANALYTICS_LIST_PROPERTIESでプロパティ ID を検索し、最後にGOOGLE_ANALYTICS_RUN_REPORTでデータを取得します。 - クエリ前に検証:
GOOGLE_ANALYTICS_CHECK_COMPATIBILITYを使用してディメンション/メトリクスの組み合わせを事前に検証し、400 エラーを回避します。 - キャンペーンパフォーマンス:
sessionCampaignName、sessionSource、sessionMediumなどのディメンションと、sessions、activeUsers、totalRevenueなどのメトリクスでレポートを実行します。 - 広告リンクの発見:
GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADSを使用して、各 GA4 プロパティにリンクされている Google Ads アカウントを特定します。 - フィールド発見: 複雑なレポートを作成する前に、
GOOGLE_ANALYTICS_GET_METADATAを使用して利用可能なすべてのディメンションとメトリクスを一覧表示します。
既知の落とし穴
- ディメンション/メトリクスの互換性: GA4 API には厳格な互換性ルールがあります。すべてのディメンションをすべてのメトリクスと組み合わせられるわけではありません。人口統計ディメンション（例:
userAgeBracket、userGender）は、セッションスコープのディメンション/フィルター（例:sessionCampaignName、sessionSource）と互換性がないことがよくあります。 dateRangeはディメンションではありません:dateRangeをディメンション配列に含めないでください。代わりにdate、dateHour、year、month、weekを使用してください。exitsは無効です:exitsはディメンションとしてもメトリクスとしても GA4 では有効ではありません。- プロパティ ID の形式:
properties/{numeric_id}の形式である必要があります（例:properties/123456789）。Google アカウント ID（長い OAuth ID）は使用しないでください。 - アカウント ID の形式:
accounts/{numeric_id}の形式である必要があります。数値 ID は 6～10 桁です。 - フィルターの分離:
dimensionFilterはディメンションフィールドにのみ使用し、metricFilterはメトリクスフィールドにのみ使用してください。混在させるとエラーが発生します。 - レポートリクエストごとに最大 9 つのディメンションと 10 つのメトリクス。
クイックリファレンス
| アクション | ツール | 主要パラメータ |
|---|---|---|
| Ads リンクの一覧表示 | GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS | parent |
| レポートの実行 | GOOGLE_ANALYTICS_RUN_REPORT | property、dimensions、metrics、dateRanges |
| 互換性の確認 | GOOGLE_ANALYTICS_CHECK_COMPATIBILITY | （完全なスキーマは RUBE_SEARCH_TOOLS で確認） |
| アカウントの一覧表示 | GOOGLE_ANALYTICS_LIST_ACCOUNTS | pageSize |
| プロパティの一覧表示 | GOOGLE_ANALYTICS_LIST_PROPERTIES | account、pageSize |
| メタデータの取得 | GOOGLE_ANALYTICS_GET_METADATA | （完全なスキーマは RUBE_SEARCH_TOOLS で確認） |
提供: Composio