Google Ads 자동화 via Rube MCP
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 가져오기: 클라이언트 설정에서 https://rube.app/mcp를 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는 유효하지 않습니다:exits는 차원으로도 측정항목으로도 GA4에서 유효하지 않습니다.- 속성 ID 형식:
properties/{숫자_id}형식이어야 합니다 (예:properties/123456789). Google 계정 ID(긴 OAuth ID)를 사용하지 마세요. - 계정 ID 형식:
accounts/{숫자_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 제공