mapa-calor은(는) 무엇을 하나요?
서로 보완하는 두 가지 진단 도구:
| 부분 | 해결하는 질문 | 데이터 출처 | 스크립트 |
|---|---|---|---|
| 영상 | 시청자가 내 광고의 몇 초에서 이탈하는가? | Meta Graph API (GET만) | scripts/retencion_videos.py |
| 랜딩 페이지 | 사람들이 아래로 스크롤하고, 읽고, 클릭하는가, 아니면 위에서 나가는가? | Microsoft Clarity Data Export API | scripts/landing_clarity.py |
| 연결 | 모든 것이 연결되어 있는가? | 둘 다 | scripts/conexion.py |
스크립트는 이 스킬 폴더 내 scripts/ 디렉토리에 있습니다 (Claude Code에서는 "Base directory for this skill"로 표시되며, 일반적으로 ~/.claude/skills/mapa-calor). 아래 명령어에서 $SK는 해당 폴더를 나타냅니다. python3 (Windows에서는 python)을 사용하세요.
요청에 따른 처리
/mapa-calor아무것도 없이, 또는 처음 → conexion 실행 후 영상, 랜딩, 또는 전체 중 무엇을 원하는지 질문/mapa-calor conexion→python3 "$SK/scripts/conexion.py". 누락된 항목이 있으면 README ("Meta 연결" / "Clarity 연결" 섹션)를 참고하여 단계별 안내.act_를 모르는 경우:python3 "$SK/scripts/conexion.py" --cuentas/mapa-calor videos→python3 "$SK/scripts/retencion_videos.py"(최근 7일, 활성 광고). 옵션:--periodo last_14d,--desde YYYY-MM-DD --hasta YYYY-MM-DD,--todos(비활성 포함),--png mapa.png,--video archivo.mp4(처음 4초 스틸컷, 0.5초 간격)/mapa-calor landing→python3 "$SK/scripts/landing_clarity.py". 옵션:--url /products/x,--meta(Meta의 링크 CTR 및 장바구니 데이터와 교차 분석),--solo-cache,--cuota/mapa-calor todo→ 먼저 영상, 그 다음--meta옵션으로 랜딩, 마지막으로 종합 진단- 연결이 없거나 연습용 →
--entrada <file.json>옵션 사용 (리포지토리의ejemplos/폴더에 예제 파일 있음)
해석 방법 (간단한 용어로 설명하고 숫자를 함께)
영상
- 맵의 3s 열 확인: 3초 시점에 계속 시청 중인 비율
- < 25% → 후크 실패. 구체적 권장: 처음 2.5초 재제작
- 25–39% → 보통. 첫 장면에 제품을 넣은 버전 테스트
- ≥ 40% → 후크는 작동함; 다음 이탈 지점 찾기 (스크립트가 표시: "후크 통과 후...")
- 제품(또는 해결하는 문제)은 2.5초 이전에 등장해야 합니다. 0초에 제품을 보여주는 영상의 유지율이 더 높습니다. 사용자가 영상 파일을 가지고 있다면
--video를 제안하고 스틸컷 시트를 확인 (이미지 도구로 읽기)하여 사람들이 이탈하는 지점에 무엇이 보이는지 설명 - 0초에서 1초 사이의 큰 하락은 피드에서 정상적: 영상 서로 간 비교, 100% 기준과 비교하지 않음
- 노출 수 100 미만 → 결론 금지. 명확히 말하고 해당 영상을 중지하거나 예산을 늘리지 말도록 권고
- 유지율과 판매 연결: 좋은 후크 + 0 구매 → 문제는 랜딩 페이지일 수 있음 (
/mapa-calor landing제안)
랜딩 페이지
- 상단 이탈 (평균 스크롤 < 21%) → 첫 화면 수정: 명확한 헤드라인, 사용 중인 제품 사진, 혜택과 가격을 스크롤 없이 볼 수 있도록 배치. 링크 CTR이 1.5% 이상이면 광고는 사람을 잘 데려오는 것: 병목은 페이지
- 마찰 (분노 클릭 > 5%, 데드 클릭 > 20% 또는 빠른 뒤로가기 > 25%) → Clarity에서 시각적 히트맵 열기 (링크는 보고서에 있음) → 사람들이 클릭하지만 반응이 없는 요소 찾기
- 유지 / 가격-제안 (스크롤 ≥ 30% but 조회 100회당 장바구니 < 4개) → 문제는 제안 또는 가격
- 크리에이티브 (페이지는 괜찮음, CTR < 1.5%) → 광고 후크 변경, 페이지 변경 불필요
- 표본 부족 (< 30 방문) → 결론 금지
- 히트맵 이미지 (어디를 터치하는지, 어디까지 스크롤하는지) Clarity 패널의 Heatmaps에서만 볼 수 있습니다. 스킬은 숫자와 링크를 제공하며, 이미지가 보여주는 내용을 임의로 만들지 않음
항상 최대 3개의 구체적 실행 항목을 영향도 순으로 마무리하고, 이후 측정할 내용을 제시 ("3일 후 /mapa-calor videos를 다시 실행하여 3s 열이 상승했는지 확인")
절대 위반하지 않는 규칙
- 토큰을 절대 출력, 복사, 저장하지 않음.
echo $META_TOKEN실행 금지,.env파일을 소리 내어 읽지 않음, 리포지토리 파일에 토큰을 붙여넣지 않음. 사용자가 채팅에 토큰을 붙여넣으면, 키체인 또는~/.mapa-calor/.env에 저장하고 보안을 위해 나중에 재생성하도록 안내 - 읽기 전용. 이 스킬은 광고를 생성, 일시 중지 또는 수정하지 않음. Meta에서 변경이 필요한 경우, Ads Manager에서 수행할 방법을 설명만 함
- Clarity 할당량 관리 (프로젝트당 하루 10회 호출). 스크립트는 이미 캐시(3시간)를 저장하고 최대 8회로 제한됨. 사용자가 요청하고 호출 1회 소모를 인지한 경우에만
--forzar사용. 동일한 데이터를 다시 확인하려면--solo-cache사용. 남은 호출 수 확인:--cuota - 표본이 작은 경우 결론 내리지 않음 (영상 노출 100 미만, 랜딩 방문 30 미만)
- 스크립트가 실패하면 메시지(이미 스페인어로 해결책 포함)를 읽고 사용자 안내; 일반적인 오류는 README ("일반적인 오류")에 있음