googleads-automation

Rube MCP による Google Ads 自動化

Google Analytics 統合を通じて Google Ads データにアクセスし、パフォーマンスレポートの実行、リンクされた Ads アカウントの一覧表示、キャンペーンメトリクスの分析を Rube MCP（Composio）を使用して行います。

ツールキットドキュメント: composio.dev/toolkits/googleads

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット google_analytics を使用した RUBE_MANAGE_CONNECTIONS によるアクティブな接続
• 現在のツールスキーマを取得するため、最初に必ず RUBE_SEARCH_TOOLS を呼び出すこと

セットアップ

Rube MCP の入手: クライアント設定で MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認します。
2. ツールキット google_analytics を使用して RUBE_MANAGE_CONNECTIONS を呼び出します。
3. 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します。
4. ワークフローを実行する前に、接続ステータスが 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 を dimensions 配列に含めないでください。代わりに date、dateHour、year、month、week を使用してください。
• exits は無効です: GA4 では、exits はディメンションとしてもメトリクスとしても有効ではありません。
• プロパティ 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 で完全なスキーマを確認）

---

Powered by Composio