다중 신호 키워드 수익 어트리뷰션
GSC 대량 내보내기와 GA4 내보내기 데이터(모두 BigQuery)를 사용하여 키워드 수준의 수익 어트리뷰션 분석을 실행합니다. 출력은 정렬 가능한 마크다운 테이블(쿼리, 페이지, 의도, 클릭, 귀속 세션, 귀속 전환, 귀속 수익, 신뢰도)과 간단한 요약 헤드라인입니다.
사용 시기
사용자가 클릭만이 아닌 트래픽 가치(세션, 전환, 수익)를 창출하는 쿼리를 알고 싶어 할 때 이 스킬을 트리거하십시오. 이 방법론은 GA4 지표를 분배하기 전에 3가지 신호(페이지 + 날짜 + 기기)를 조인하고, 브랜드 및 거래성 쿼리가 인포메이셔널 쿼리보다 더 많은 가중치를 받도록 의도 가중치를 적용하며, 총계가 GA4와 정확히 일치하도록 재정규화하기 때문에 표준 ga4_gsc_query_revenue MCP 도구보다 한 단계 더 세밀하게 어트리뷰션을 수행합니다.
사용자가 클릭 점유율만 원하거나 "내 사이트가 어떤 키워드로 순위가 매겨지나요?"와 같은 한 줄 답변만 원한다면, 대신 ahrefs-quick-lookup 또는 미리 구축된 ga4_gsc_query_revenue 도구를 사용하십시오.
필수 입력값
누락된 항목이 있으면 사용자에게 물어보십시오. 사용자가 지정하지 않으면 표시된 기본값을 사용하십시오.
| 매개변수 | 기본값 | 참고사항 |
|---|---|---|
brand_terms | 필수 | 소문자 배열. 1계층 부분 문자열 일치. 정식 브랜드 형태 사용 (예: ['snippet digital', 'snippetdigital']). |
brand_tokens | [] | 소문자 배열. 2계층 어간-접두사 토큰. 각 토큰은 모든 단어의 시작 부분과 일치하므로 'model'은 'models', 'modelling', 'modeling'을 잡습니다. 여러 단어로 된 브랜드의 단어 순서 및 어간 변형을 잡기 위해 권장됩니다. |
brand_min_token_matches | 2 | 쿼리가 브랜드로 분류되기 위해 brand_tokens에서 나타나야 하는 토큰 수. 두 단어 브랜드의 경우 2가 올바른 기본값입니다. |
brand_negative_terms | [] | 소문자 배열. 3계층 오탐지 방어. 이 중 하나라도 포함된 쿼리는 절대 브랜드로 분류되지 않습니다. 모호한 단일 단어 브랜드(예: Apple의 경우 ['apple pie', 'apple cider'])에 사용하십시오. |
gsc_dataset | 필수 | searchdata_url_impression을 보유한 데이터셋(예: searchconsole). |
ga4_dataset | 필수 | GA4 내보내기 데이터셋(예: analytics_123456789). |
days | 28 | 오늘 기준 과거 일수에서 3일 뺌(GSC는 약 3일 지연). |
min_clicks | 5 | 해당 기간 동안 총 클릭 수가 이보다 적은 쿼리는 제외. |
value_per_conversion | 0.0 | GA4에 금전적 가치가 없는 경우 선택적 고정 리드 가치. 고정 전환 가치의 경우 예: 499.0으로 설정. |
conversion_events | ['form_submit', 'generate_lead', 'purchase'] | 전환으로 계산할 GA4 이벤트 이름. |
의도 가중치와 의도 정규식도 구성 가능합니다(attribution.sql의 DECLARE 블록 참조). 기본값은 B2B/리드 생성 사이트에 맞춰져 있습니다. 전자상거래의 경우 트랜잭션 가중치를 2.5로 높이는 것이 좋을 수 있습니다.
브랜드 매칭: 입력 방법
사용자에게 브랜드 용어를 물어볼 때, 두 계층을 명시적으로 요청하십시오:
"당신의 브랜드는 무엇인가요? 1) 사람들이 당신을 위해 입력하는 정확한 구문(예: 'snippet digital', 'snippetdigital'), 2) 어간으로 일치시킬 브랜드의 고유 단어(예: 'snippet', 'digital')를 알려주세요."
대부분의 여러 단어 브랜드의 경우, 2계층은 1계층과 동일한 단어를 개별 토큰으로 분할한 것을 포함해야 합니다. 예:
| 브랜드 | brand_terms (1계층) | brand_tokens (2계층) | min |
|---|---|---|---|
| Coca-Cola | ['coca cola', 'cocacola', 'coke'] | ['coca', 'cola'] | 2 |
| Snippet Digital | ['snippet digital', 'snippetdigital'] | ['snippet', 'digital'] | 2 |
| UK Models | ['uk models', 'ukmodels'] | ['uk', 'model'] | 2 |
| Keyword Insights | ['keyword insights', 'keywordinsights'] | ['keyword', 'insights'] | 2 |
단일 단어 브랜드(Apple, Notion, Stripe)의 경우 2계층은 일반적으로 불필요합니다. 대신 3계층을 사용하여 오탐지를 제외하십시오:
| 브랜드 | brand_terms (1계층) | brand_negative_terms (3계층) |
|---|---|---|
| Apple (회사) | ['apple'] | ['apple pie', 'apple cider', 'apple fruit'] |
| Stripe (결제) | ['stripe'] | ['pin stripe', 'stripe pattern'] |
사용자가 명백히 브랜드와 관련된 쿼리가 인포메이셔널로 분류된다고 보고하는 경우(예: 복수형 또는 단어 순서 변형이 누락되는 경우), 해결 방법은 거의 항상 2계층 토큰을 추가하는 것입니다.
절차
-
입력값 확인. brand_terms, gsc_dataset, 또는 ga4_dataset이 누락된 경우 사용자에게 물어보십시오. 비정상적인 값(예: days > 90, min_clicks > 25)은 명시적으로 확인하십시오.
-
두 데이터셋이 존재하는지 확인. 전체 쿼리를 실행하기 전에 BigQuery MCP
query도구를 통해 두 개의 저렴한 탐색 쿼리를 실행하십시오:SELECT MAX(data_date) FROM \{gsc_dataset}.searchdata_url_impression``SELECT MAX(_TABLE_SUFFIX) FROM \{ga4_dataset}.events_*`` 둘 중 하나라도 오류가 발생하면 정확한 오류를 사용자에게 표시하고 중단하십시오. 메인 쿼리를 진행하지 마십시오.
-
어트리뷰션 쿼리 실행.
attribution.sql의 SQL을 사용하여 BigQuery MCPquery도구를 실행하십시오.<<GSC_DATASET>>와<<GA4_DATASET>>을 사용자의 데이터셋 이름으로 대체하십시오. 사용자의 brand_terms, days, min_clicks, value_per_conversion, conversion_events를 반영하도록 DECLARE 블록을 업데이트하십시오.max_rows를 200으로 설정하여 긴 꼬리를 포착하십시오. -
출력 렌더링. 결과를 귀속 수익 내림차순으로 정렬된 마크다운 테이블로 형식화하십시오. 열: query, page, intent, clicks, att_sessions, att_conversions, att_revenue (통화 기호 포함), candidates_on_page, confidence. 테이블 다음에 다음을 작성하십시오:
- 총 클릭, 세션, 전환, 수익 및 브랜드 점유율을 요약하는 2-3문장 헤드라인.
- 상위 3개의 높은 신뢰도 드라이버(각각 한 줄).
- 주목할 만한 패턴(예: 모든 HIGH 신뢰도 페이지에 전환이 없는 경우, 비정상적으로 보이는 의도 분할, 부분 문자열 규칙에 의해 누락된 브랜드 변형).
-
선택적으로 시각적 산출물 렌더링. 사용자가 대시보드, 스냅샷 또는 스크린샷을 요청하는 경우,
show_widgetMCP 도구를 사용하여 인라인 HTML 위젯을 구축하십시오. 위젯에는 다음이 포함되어야 합니다: 4개의 메트릭 카드(클릭, 세션, 전환, 수익), 의도별로 색상이 지정된 상위 12개 쿼리의 귀속 수익 가로 막대 차트, 의도 분할(클릭 대 세션 대 수익)의 누적 막대 차트, 정렬 및 필터 가능한 테이블.
일반적인 함정과 조치 사항
- 부분 문자열 규칙에 의해 누락된 브랜드 용어. "uk model"에는 "uk models"가 포함되지 않습니다. 항상 사전에 브랜드 목록을 퍼징하십시오: 단수/복수 포함, 공백 유무, 일반적인 오타, 내부 직함. 홈페이지의 인포메이셔널 쿼리가 원시 클릭 수에서 브랜드 쿼리를 능가하는 경우, 거의 항상 브랜드 변형이 누락된 것입니다.
- 수익이 모든 곳에서 0입니다. 이는 GA4가
ecommerce.purchase_revenue또는event_params.value를 채우지 않고 있음을 의미합니다. 리드 생성 사이트의 경우 정상입니다. 전환을 성공 메트릭으로 받아들이거나,value_per_conversion을 전달하여 수익이전환 수 x 가치로 대체되도록 하십시오. - 모든 신뢰도 등급이 홈페이지에 있기 때문에 LOW입니다. 이는 버그가 아니라 합법적인 발견입니다. 홈페이지는 실제로 어트리뷰션을 명확하게 분할하기에는 후보 쿼리가 너무 많습니다. 점수를 조작하려고 시도하지 말고 구조적 발견 사항으로 표시하십시오("내부 링크 및 주제별 랜딩 페이지는 이 어트리뷰션을 결정론적 청크로 분할할 것입니다").
- 조인율이 낮은 것 같습니다. GSC와 GA4는 URL을 다르게 정규화합니다(후행 슬래시, 쿼리 문자열, 프래그먼트). SQL은 양쪽에서 후행 슬래시와 쿼리 문자열을 제거합니다. 조인율이 여전히 50% 미만이면 프로토콜 불일치(http vs https) 또는 호스트 이름 차이(www vs non-www)를 확인하십시오.
- GA4 오가닉 필터가 너무 많이 제외합니다. SQL은 이벤트가
medium=organic을 보고하는 세션으로 필터링합니다. 사용자의 GA4 설정이 다른 트래픽 소스 값(예: 채널 그룹화로 'Organic Search')을 사용하는 경우,ga4_sessionsCTE의 WHERE 절을 편집하십시오. - GSC 데이터셋은 한 프로젝트에, GA4는 다른 프로젝트에 있습니다. BigQuery 교차 프로젝트 쿼리는 잘 작동합니다. 두 플레이스홀더를 완전히 한정하십시오(예:
project-a.searchconsole,project-b.analytics_123456789). MCP 서비스 계정은 두 프로젝트에 대한 읽기 권한이 필요합니다.
출력 형식 예시
## [도메인] 키워드 수익 어트리뷰션, 최근 28일
**기간:** 2026-04-01 ~ 2026-04-28
**브랜드 용어:** "..." | **최소 클릭:** 5
| Query | Page | Intent | Clicks | Att. Sessions | Att. Conv | Att. Revenue | Confidence |
|---|---|---|---|---|---|---|---|
| ... | ... | branded | 280 | 263.4 | 19.96 | £9,960 | HIGH |
헤드라인: 903 클릭, 697 귀속 세션, 39 전환, £19,461 수익. 브랜드는 57%의 클릭에서 86%의 전환을 차지합니다.
상위 3개 고신뢰도 드라이버
1. ...
2. ...
3. ...
패턴
- ...
- ...
이 스킬의 파일
attribution.sql: 매개변수화된 쿼리SKILL.md: 이 파일examples/synthetic_saas_demo.md: 참고용 작업 예제 출력