STEP 1 ZIP 압축 해제 & GA4 CSV 준비
1
준비
2
열기
3
자동 설정
4
확인
총 4단계 · 약 10분 소요

GA4 리포트 자동화 가이드

GA4 CSV 내보내기 → prompts.txt 붙여넣기.
Claude Code가 채널 분석부터 슬랙 발송까지 설정합니다.

Claude Code가 처음이라면
설치 방법 안내 — 이미 설치되어 있으면 넘어가세요

① Node.js 설치 확인

터미널node --version

v18.0.0 이상이면 OK. 없으면 nodejs.org에서 LTS 설치 후 재시도.

② Claude Code 설치

터미널npm install -g @anthropic-ai/claude-code

③ 로그인

터미널claude

처음 실행 시 브라우저에서 Anthropic 계정 로그인이 열립니다. claude.ai 계정으로 로그인하면 완료.

1
ZIP 압축 해제 & GA4 CSV 준비
GA4에서 CSV를 내보내 폴더 안에 넣기

ZIP 압축 해제

ga4-report-package.zip을 더블클릭하면 폴더가 생성됩니다.

GA4 CSV 내보내기

GA4에서 데이터를 CSV로 내보내는 방법입니다:

GA4 보고서 획득 트래픽 획득 오른쪽 상단 공유 아이콘 → 파일 다운로드 → CSV
! 기본 리포트는 세션 기본 채널 그룹 기준으로 내보냅니다. 소스/매체 기준이 필요하면 탐색 보고서를 사용하세요.
GA4 탐색 새 탐색 만들기 측기준: 날짜/소스매체 · 측정항목: 세션/전환/수익 내보내기 → CSV
탐색 보고서는 소스/매체를 포함해서 내보낼 수 있습니다. 채널별 분석에 더 적합합니다.

권장 포함 컬럼

CSV에 포함되면 좋은 컬럼날짜 (date) 소스/매체 (source/medium) 또는 채널 그룹 세션 수 (sessions) 사용자 (users) 이탈률 (bounce rate) 전환 (conversions / goal completions) 수익 (revenue) — 있으면 수익 KPI 활성
! 날짜 컬럼이 반드시 있어야 합니다. 날짜가 없으면 기간 필터가 작동하지 않으며 Claude Code가 진행을 중단합니다.

파일을 폴더 안에 복사

폴더 구조 예시ga4-report-package/ ├── ga4-report.html ├── ga4-sample.csv ← 샘플 (그대로 두세요) ├── CLAUDE.md ├── prompts.txt ├── send-report.js └── analytics_export.csv ← 내 실제 GA4 데이터를 여기에
2
Claude Code에서 폴더 열기
폴더를 열면 CLAUDE.md를 자동으로 읽고 준비됩니다

Antigravity 실행 → File → Open Folderga4-report-package 폴더 선택

폴더를 열면 Claude Code가 CLAUDE.md를 읽어 이 프로젝트가 GA4 리포트 자동화임을 인식합니다.

Cursor 실행 → File → Open Folderga4-report-package 폴더 선택

터미널cd ~/Downloads/ga4-report-package claude
3
prompts.txt 붙여넣기
전체 복사해서 채팅창에 한 번만 붙여넣으면 됩니다

prompts.txt 전체 복사

폴더 안의 prompts.txt 더블클릭 → 전체 선택(Cmd+A) → 복사(Cmd+C)

채팅창에 붙여넣기

에디터 왼쪽 Claude 아이콘 클릭 → 채팅창에 Cmd+V → 전송

이것으로 끝입니다. Claude Code가 단계마다 확인을 요청하며 알아서 진행합니다.

Claude Code 자동 처리 순서

Claude Code 자동 처리
1
폴더 스캔 → 샘플 제외 후 "이 파일이 맞나요?" 확인 요청
2
CSV 컬럼 자동 인식 → 날짜/채널/세션/전환 매핑 계획 제안
3
날짜 형식 확인 → 기간 필터 자동 설정 (가장 오래된 날짜~최근 날짜)
4
이상 지표 감지 기준 설정 → AI 인사이트 텍스트 자동 생성
5
(선택) 브랜드 컬러 적용 → 슬랙 Webhook URL 입력 → 자동 발송 스케줄 설정
각 단계에서 "맞아" 또는 "건너뛰기"만 하면 됩니다. 나머지는 Claude Code가 처리합니다.

인코딩 문제가 발생하면

GA4 CSV가 깨져 보이는 경우 (특히 Windows에서 내보냈을 때):

Claude Code에게 요청"CSV 파일을 UTF-8로 변환해줘"

또는 메모장/TextEdit → 다른 이름으로 저장 → 인코딩 UTF-8 선택

4
대시보드 확인 & 슬랙 발송 설정
브라우저에서 확인하고, 선택으로 슬랙 자동 발송까지

대시보드 열기

Claude Code 설정이 완료되면 ga4-report.html을 브라우저로 직접 열거나, Claude Code가 알려준 서버 주소로 접속하세요.

직접 열기 (파일 방식)ga4-report.html 더블클릭 → 브라우저에서 열림 CSV 업로드 버튼 클릭 → 내 GA4 CSV 선택
대시보드가 열리면 채널별 성과 · 트래픽 추이 · AI 인사이트가 내 데이터로 표시됩니다.

추가 요청 예시

Claude Code 채팅에서 바로 요청"네이버 광고 채널만 따로 분리해서 보여줘" "전주 대비 증감을 % 대신 숫자로 표시해줘" "목표 전환율 5%로 기준선 추가해줘" "차트 컬러 우리 회사 브랜드 색(#FF5733)으로 바꿔줘" "엑셀 내보내기 버튼 추가해줘"
선택 기능 — 슬랙/이메일 자동 발송

send-report.js 설정

send-report.js를 텍스트 에디터로 열어 CONFIG 섹션을 수정하세요:

send-report.js CONFIG 섹션const CONFIG = { SLACK_WEBHOOK_URL: 'https://hooks.slack.com/services/XXX/XXX/XXX', SLACK_CHANNEL: '#analytics', // 발송할 채널명 CSV_FILE: './my-ga4-data.csv', // 실제 파일명으로 교체 DAYS: 7, // 최근 N일 기준 };

슬랙 Webhook URL 발급 방법: api.slack.com/messaging/webhooks

발송 테스트

터미널node send-report.js
슬랙 채널에 리포트가 도착하면 완료. 이후 "매주 월요일 오전 9시에 자동 발송해줘"라고 요청하면 cron 설정까지 해줍니다.

막히는 부분이 있으신가요?

어떤 단계에서 막히셨는지 이메일로 알려주시면 도와드립니다.

support@databridge.co.kr