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와 같은 측정항목으로 보고서를 실행합니다. - Ads 링크 발견:
GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS를 사용하여 각 GA4 속성에 연결된 Google Ads 계정을 찾습니다. - 필드 발견: 복잡한 보고서를 구성하기 전에
GOOGLE_ANALYTICS_GET_METADATA를 사용하여 사용 가능한 모든 차원과 측정항목을 나열합니다.
알려진 함정
- 차원/측정항목 호환성: GA4 API는 엄격한 호환성 규칙을 가지고 있습니다. 모든 차원을 모든 측정항목과 결합할 수 있는 것은 아닙니다. 인구통계 차원(예:
userAgeBracket,userGender)은 세션 범위의 차원/필터(예:sessionCampaignName,sessionSource)와 호환되지 않는 경우가 많습니다. dateRange는 차원이 아닙니다: dimensions 배열에dateRange를 포함하지 마세요. 대신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를 통해 전체 스키마 확인) |
Composio 제공