analytics-tracking

개요

analytics-tracking 스킬이 하는 일

analytics-tracking 스킬은 분석 트래킹을 설계·구현·점검해서 데이터에 대한 신뢰를 높이고, 더 나은 마케팅 및 제품 의사결정을 할 수 있도록 도와줍니다. 특히 다음에 초점을 둡니다.

• 비즈니스 질문을 측정 가능한 이벤트로 전환하기
• 깔끔한 이벤트 이름 및 파라미터 규칙 설계하기
• **Google Analytics 4 (GA4)**와 Google Tag Manager (GTM) 에서 트래킹 구현하기
• 명확한 기여 분석을 위한 UTM 파라미터와 캠페인 구조 설계하기
• 리포팅과 퍼포먼스 분석에 바로 활용할 수 있는 트래킹 플랜 만들기

의미 없는 클릭·페이지뷰를 마구 수집하는 대신, analytics-tracking은 웹사이트·제품·캠페인에 대해 “지금 이게 효과가 있는가?” 라는 질문에 답해 줄 수 있는 이벤트에 집중하도록 도와줍니다.

이 스킬이 적합한 사람

analytics-tracking은 다음과 같은 상황에서 활용하면 좋습니다.

• 캠페인용 전환 추적을 신뢰성 있게 구축해야 하는 마케팅 매니저
• 기능 이용과 활성화를 이해하고 싶은 프로덕트 매니저
• 실험이 효과가 있는지 측정해야 하는 창업자 또는 그로스 리더
• 프런트엔드나 태그 매니저를 통해 이벤트 구현을 담당하는 개발자
• 대시보드·리포트용으로 깔끔하고 일관된 이벤트 데이터를 필요로 하는 애널리스트

특히 GA4, GTM, Google Ads, Google Sheets, Google Docs 기반으로 일하는 팀에 유용합니다.

analytics-tracking 스킬이 해결하는 문제

이 스킬은 다음과 같은 말이 자주 나오는 팀을 위해 설계되었습니다.

• “GA4를 설정하긴 했는데 숫자를 믿을 수가 없어요.”
• “이벤트가 너무 지저분하고 일관성이 없어요.”
• “이 새로운 기능이나 퍼널에서 무엇을 트래킹해야 할지 모르겠어요.”
• “UTM이 제각각이라 어떤 채널이 진짜 잘 되는지 볼 수가 없어요.”
• “GTM에서 태그는 발화되는데 이벤트가 제대로 설정된 건지 모르겠어요.”

레포지토리에 포함된 레퍼런스를 활용해, 이 스킬은 다음을 도와줍니다.

• 현재 트래킹 셋업에 대한 초기 진단 수행
• “데이터를 위한 트래킹이 아니라, 의사결정을 위한 트래킹” 원칙 적용
• 명확한 이벤트 이름·트리거·파라미터를 갖춘 트래킹 플랜을 신규 작성하거나 개선
• gtag.js 또는 GTM을 사용해 GA4에 이벤트 구현
• (마케팅 사이트, SaaS, 이커머스 등) 비즈니스 모델에 맞춘 이벤트 라이브러리 활용

analytics-tracking이 맞는 경우와 아닌 경우

analytics-tracking을 사용하기 좋은 경우:

• GA4 + GTM 트래킹을 새로 구축하거나 개선해야 할 때
• 이벤트 트래킹·전환·기여 분석 구조를 설계하거나 점검할 때
• UTM 전략을 정의하거나 캠페인 네이밍을 표준화할 때
• (가입, 기능 사용, 업그레이드 등) 제품 분석 이벤트를 설계할 때

다음과 같은 경우에는 이 스킬이 1순위 도구는 아닙니다.

• A/B 테스트 설계와 측정만 필요하다면 (별도의 ab-test-setup 스킬 사용 권장)
• 고급 데이터 웨어하우스 모델링이나 BI 전용 질문이 중심이라면 (이 스킬은 SQL 모델링이 아닌 인스트루멘테이션과 구현에 초점을 둡니다.)

핵심 질문이 “이걸 어떻게 측정하지?”, “이게 제대로 작동하고 있는지 어떻게 알 수 있지?” 라면 analytics-tracking이 적합합니다.

레포지토리의 주요 레퍼런스 파일

analytics-tracking 스킬은 다음과 같은 핵심 레퍼런스로 뒷받침됩니다.

• SKILL.md – 초기 진단 단계와 핵심 원칙을 포함한 스킬 기본 동작 정의
• references/event-library.md – (마케팅 사이트, 제품, 수익화, 이커머스, B2B/SaaS 등) 컨텍스트별 이벤트 라이브러리
• references/ga4-implementation.md – GA4 셋업 및 구현에 대한 상세 가이드
• references/gtm-implementation.md – Google Tag Manager 구조 및 구현 상세 가이드
• evals/evals.json – 예시 시나리오와 모범 답변 (예: SaaS 트래킹 플랜, UTM 규칙)

이 파일들을 통해 스킬은 추상적인 조언이 아니라 실제 구현에 바로 활용 가능한 가이드를 제공합니다.

사용 방법

설치 및 설정

1. analytics-tracking 스킬 설치

coreyhaines31/marketingskills 레포지토리에서 Skills CLI를 사용해 스킬을 추가합니다.

npx skills add https://github.com/coreyhaines31/marketingskills --skill analytics-tracking

이 명령을 실행하면 analytics-tracking의 설정, 평가 프롬프트, 레퍼런스가 포함되어, 에이전트가 구현 중심의 상세 답변을 제공할 수 있습니다.

2. 포함된 레퍼런스 검토

설치 후, 다음 파일들을 환경에서 열어 컨텍스트를 파악하세요.

• SKILL.md – 범위, 전제, 핵심 원칙 이해
• references/event-library.md – 추천 이벤트 및 파라미터 살펴보기
• references/ga4-implementation.md – GA4, 커스텀 이벤트, 전환, 디버깅 설정 방법 확인
• references/gtm-implementation.md – 컨테이너 구조, 트리거, 변수, 데이터 레이어 사용법 학습
• evals/evals.json – 예시 프롬프트와 기대 출력 형식(예: 트래킹 플랜) 확인

이 문서들을 그대로 복붙하는 체크리스트가 아닌, 템플릿과 가드레일로 활용하세요. 제품 특성, 컴플라이언스, 기술 스택에 맞게 조정하는 것이 중요합니다.

이 스킬이 지원하는 대표 워크플로우

1. 트래킹 플랜을 처음부터 설계할 때

에이전트에게 다음과 같이 요청할 수 있습니다.

“우리 B2B SaaS 제품에 대해 GA4와 GTM에서 analytics tracking을 셋업하고 싶어요. 가입, 기능 사용, 업그레이드 이벤트를 추적해야 합니다.”

analytics-tracking 스킬은 다음과 같이 동작합니다.

1. 제품·마케팅 컨텍스트 확인

   • .agents/product-marketing-context.md (또는 이전 버전 .claude/product-marketing-context.md) 파일이 있다면, 불필요한 질문 반복을 피하기 위해 먼저 읽습니다.

2. “데이터가 아니라 의사결정을 위한 트래킹” 원칙 적용

   • “어떤 기능이 업그레이드를 유도하는가?”, “어떤 채널이 트라이얼 가입을 이끄는가?”처럼, 어떤 의사결정을 지원해야 하는지 명확히 합니다.

3. 핵심 이벤트와 네이밍 규칙 정의

   • signup_completed, feature_used, plan_upgraded와 같은 object_action 이벤트 네이밍 규칙을 사용합니다.
   • references/event-library.md에서 SaaS용 이벤트를 참고합니다. 예를 들어:
     • signup_completed
     • trial_started
     • feature_used
     • plan_upgraded
     • subscription_canceled

4. 구조화된 트래킹 플랜 생성

   • Google Sheets나 Docs에 바로 옮겨 쓸 수 있도록 테이블 형태로 출력합니다. 포함 요소:
     • 이벤트 이름
     • 트리거(어떤 사용자 행동이 이벤트를 발화시키는지)
     • 파라미터 (예: plan_name, feature_name, pricing_page_variant)
     • 이벤트가 지원하는 목적/의사결정

5. GA4 구현 상세 제공

   • 추천 파라미터, 어떤 이벤트를 전환으로 설정할지 등 GA4 이벤트 설정 방법을 제안합니다.

6. GTM 데이터 레이어 패턴 제공

   • 프런트엔드에서 사용할 수 있는 dataLayer.push 예시를 제시하고, 이를 GTM의 GA4 Event 태그와 어떻게 연결할지 설명합니다.

이 워크플로우는 신규 제품 출시, 퍼널 리디자인, 기존 난잡한 트래킹 정리 시에 특히 유용합니다.

2. 기존 GA4와 GTM 구현 감사(audit)

다음과 같이 물어볼 수 있습니다.

“GA4 데이터가 이상해 보여요. 트래킹을 감사해 줄 수 있나요?”

그러면 이 스킬은 다음을 안내합니다.

• 현재 data streams와 enhanced measurement 설정 검토 (references/ga4-implementation.md)
• 잘못된 설정이 없는지 conversion, custom dimensions, audiences 확인
• GTM 컨테이너 구조, 태그 네이밍, 트리거, 변수 점검 (references/gtm-implementation.md)
• GA4 DebugView와 GTM Preview 모드에서 이벤트 검증
• 현재 이벤트 목록을 event library와 비교해 누락 또는 중복 이벤트 식별

이를 바탕으로 이벤트 통합, 파라미터 이름 정리, 트리거 표준화 등 우선순위 높은 수정 작업을 정리할 수 있습니다.

3. UTM 파라미터와 기여 분석 구조 설계

다음과 같이 요청할 수 있습니다.

“Google Ads, Meta, LinkedIn, 뉴스레터에 어떤 UTM 파라미터를 써야 할까요?”

evals/evals.json의 가이드를 바탕으로, analytics-tracking은 다음을 도와줍니다.

• utm_source, utm_medium, utm_campaign, utm_term, utm_content와 같은 일관된 UTM 전략 추천
• 채널에 맞는 값 제안, 예를 들어:
  • utm_source: google, meta, linkedin, newsletter
  • utm_medium: cpc, paid_social, email, social
• GA4 리포트에서 깔끔하게 볼 수 있도록 플랫폼별 캠페인 네이밍 표준화 지원
• UTMs가 GA4에 제대로 수집되는지 확인하는 방법 안내

이 규칙은 Google Sheet나 내부 플레이북에 정리해 팀 전체 기준으로 활용할 수 있습니다.

4. 개발자에게 전달할 트래킹 문서화

전략을 실제 구현 지침으로 바꿔야 할 때, analytics-tracking은 다음을 도와줍니다.

• 트래킹 플랜을 기반으로 다음을 생성:
  • GTM 데이터 레이어 스펙 (예: dataLayer.push({ event: 'feature_used', feature_name: 'bulk_import' }))
  • 어느 frontend code 위치에 해당 호출을 넣어야 하는지에 대한 메모
  • GTM에서 일치하는 GA4 Event 태그와 트리거를 만드는 가이드

이는 정확한 이벤트 이름, 파라미터, 발화 조건이 필요한 프런트엔드 개발자에게 특히 유용합니다.

좋은 결과를 얻기 위한 베스트 프랙티스

• 컨텍스트를 먼저 제공하세요: 제품 유형(SaaS, 이커머스, 마켓플레이스 등), 주요 목표, 사용하는 도구(GA4만 사용하는지, GA4 + GTM인지, Segment를 쓰는지 등)를 공유하세요.
• 의사결정을 명확히 하세요: “어떤 채널이 가입을 많이 유도하는가?”, “기능 X가 리텐션을 높이는가?”처럼 알고 싶은 내용을 구체적으로 말하세요.
• 제약사항을 언급하세요: 프라이버시·컴플라이언스 요구사항이 있다면 알려서, 현실적인 트래킹 플랜을 만들 수 있도록 합니다.
• 반복적으로 다듬으세요: 처음에는 핵심 이벤트 소수로 시작한 뒤, 구현·학습 과정에서 스킬에게 확장·개선을 요청하세요.

FAQ

ab-test-setup 대신 analytics-tracking을 사용해야 하는 시점은 언제인가요?

다음과 같은 경우에는 analytics-tracking을 사용하세요.

• 핵심 트래킹 기반(이벤트, 전환, UTM, GA4/GTM 셋업)을 설계하거나 수정할 때
• “이 기능/페이지/캠페인을 어떻게 측정해야 할까?” 같은 질문에 답해야 할 때

반대로 **ab-test-setup**이 더 적합한 경우는 다음과 같습니다.

• A/B 테스트 구조, 실험 변형, 실험 지표를 설계할 때
• 실험이 깔끔하게 측정되고 통계적으로 유의미한지 확인해야 할 때

실무에서는 보통 analytics-tracking으로 베이스 트래킹을 먼저 만들고, 그 위에 A/B 테스트 측정을 얹는 방식으로 함께 사용합니다.

analytics-tracking이 주로 다루는 도구는 무엇인가요?

레포지토리 레퍼런스 기준으로, analytics-tracking은 Google 분석 스택에 최적화되어 있습니다.

• Google Analytics 4 (GA4) – 설정, 커스텀 이벤트, 전환, 오디언스, 디버깅
• Google Tag Manager (GTM) – 컨테이너 구조, 트리거, 변수, 데이터 레이어 패턴
• Google Ads 연동 – GA4 연결 및 전환 가져오기(GA4 구현 가이드에서 다룹니다.)

개념적으로는 Mixpanel, Segment 같은 다른 분석 도구(이벤트, 속성, 트래킹 플랜 등)에도 적용 가능하지만, 가장 구체적인 구현 가이드는 GA4 + GTM에 초점이 맞춰져 있습니다.

이 스킬이 프런트엔드 구현 디테일도 도와주나요?

실무에 쓸 수 있는 수준까지는 가능합니다. 이 스킬은 다음을 도와줍니다.

• 프런트엔드 트래킹에 적합한 이벤트 이름과 파라미터 제안
• GTM용 dataLayer.push 패턴 예시 제공
• 버튼 클릭, 폼 제출, 페이지 로드 등 이벤트가 일반적으로 언제 발화되는지 설명

다만 React hooks, Vue 컴포넌트 등 특정 프레임워크 코드 레벨에서는 여전히 개발자의 판단이 필요할 수 있습니다. 그럼에도 analytics-tracking은 “무엇을”, “어떻게” 구현해야 하는지에 대한 명확한 청사진을 제공합니다.

GA4와 GTM 가이드는 얼마나 상세한가요?

GA4와 GTM 레퍼런스는 비교적 상세하며 다음 내용을 다룹니다.

• GA4 (references/ga4-implementation.md):

  • Data streams와 enhanced measurement
  • 추천 이벤트(이커머스 이벤트 포함)
  • 전환, 이벤트 파라미터, 커스텀 지표/차원
  • 오디언스 생성과 디버깅 도구
  • 데이터 품질 고려사항 및 Google Ads 연동

• GTM (references/gtm-implementation.md):

  • Tags, triggers, variables
  • 컨테이너 네이밍 규칙
  • 데이터 레이어 패턴
  • 일반적인 GA4 및 픽셀 태그 셋업
  • 프리뷰/디버깅, 워크스페이스, 버저닝

이 스킬은 이러한 내용을 바탕으로 단순한 개념 설명이 아니라, 바로 구현에 옮길 수 있는 수준의 가이드를 제공합니다.

analytics-tracking이 우리 비즈니스에 딱 맞는 이벤트를 정확히 알려주나요?

강력하고 의견이 분명한 출발점을 제공합니다. 특히 마케팅 사이트, SaaS, 이커머스에 대해서는 이벤트 라이브러리와 베스트 프랙티스를 활용해 제안하되, 다음에 대해 추가 질문을 합니다.

• 비즈니스 모델과 가격 구조
• 핵심 전환 액션
• 주요 유입 채널
• 핵심 사용자 여정과 주요 기능

이를 통해 “범용 이벤트 목록”이 아니라, 실제 의사결정과 맞닿아 있는 트래킹 플랜을 만들 수 있습니다.

이 스킬을 Google Sheets나 Docs와 함께 사용하려면 어떻게 해야 하나요?

많은 팀이 Google Sheets나 Google Docs에 트래킹 플랜을 문서화합니다. analytics-tracking을 사용하면 다음과 같이 활용할 수 있습니다.

• 시트에 바로 붙여 넣을 수 있도록, 테이블 형식의 트래킹 플랜을 요청
• 내부 문서에 적합한 파라미터 사전 및 네이밍 규칙 생성
• 분석 구현을 진행하면서, 에이전트와 함께 해당 플랜을 반복적으로 개선

이렇게 하면 마케터, 프로덕트 매니저, 애널리스트, 개발자 사이에서 공유되는 살아 있는 단일 정보 소스를 만들 수 있습니다.

분석이 “잘 안 되는 것 같다”, 이벤트가 안 찍힌다면 어떻게 해야 하나요?

GA4에 이벤트가 보이지 않거나, 전환 수치가 이상하거나, GTM 프리뷰에 태그가 뜨지 않는 등의 증상을 설명하면, analytics-tracking은 다음 단계를 안내합니다.

• GTM Preview에서 태그 발화 여부 확인
• dataLayer 이벤트와 파라미터 확인
• GA4 DebugView와 실시간 리포트 활용
• 전환이 올바르게 정의되어 있고 데이터를 받고 있는지 검증

그 후 GA4 및 GTM 레퍼런스를 기반으로, 구체적인 디버깅 단계와 설정 점검 항목을 제안합니다.