feat(gtm-guardian): Reorganize skill with dual-platform structure
- Add desktop/ directory for Claude Desktop (Phase 1-5: analysis, design, docs) - Add code/ directory for Claude Code (Phase 6-7: automation, audit) - Create SKILL.md with YAML frontmatter for Desktop compatibility - Create CLAUDE.md for Code automation workflows - Organize references by platform scope with shared files duplicated - Add templates for tagging plan and event taxonomy - Include README.md with overview and usage guide 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
215
custom-skills/22-gtm-guardian/code/references/phase6-audit.md
Normal file
215
custom-skills/22-gtm-guardian/code/references/phase6-audit.md
Normal file
@@ -0,0 +1,215 @@
|
||||
# Phase 6: Progressive Audit & Update
|
||||
|
||||
설정된 GTM Container에 대한 주기적 진단, 유효성 검증, 마이너 업데이트 및 태그 추가.
|
||||
|
||||
## Objectives
|
||||
|
||||
1. GTM 컨테이너 건강 상태 점검
|
||||
2. 태그 발화 및 데이터 정합성 검증
|
||||
3. 최신 요구사항 반영 업데이트
|
||||
4. D.intelligence GTM Toolkit 연계 자동화
|
||||
|
||||
## Audit Schedule
|
||||
|
||||
| Frequency | Scope | Trigger |
|
||||
|-----------|-------|---------|
|
||||
| Weekly | Tag firing validation | 자동 스케줄 |
|
||||
| Monthly | Full container review | 월간 리포트 |
|
||||
| Quarterly | Architecture review | 분기 회의 |
|
||||
| Ad-hoc | Issue investigation | 이슈 발생 시 |
|
||||
|
||||
## Audit Checklist
|
||||
|
||||
### 1. Container Health Check
|
||||
- [ ] 버전 히스토리 확인 (최근 변경사항)
|
||||
- [ ] 미사용 태그/트리거/변수 식별
|
||||
- [ ] 명명 규칙 준수 여부
|
||||
- [ ] 폴더 구조 정리 상태
|
||||
|
||||
### 2. Tag Firing Validation
|
||||
- [ ] 모든 P1 태그 정상 발화
|
||||
- [ ] 트리거 조건 정확성
|
||||
- [ ] 변수 값 정확성
|
||||
- [ ] 차단 트리거 작동
|
||||
|
||||
### 3. Data Quality
|
||||
- [ ] GA4 Realtime 데이터 확인
|
||||
- [ ] 전환 데이터 정합성
|
||||
- [ ] 파라미터 값 검증
|
||||
- [ ] 이상치 탐지
|
||||
|
||||
### 4. Platform Sync
|
||||
- [ ] GA4 ↔ GTM 동기화
|
||||
- [ ] Google Ads 전환 데이터
|
||||
- [ ] Meta Events Manager 상태
|
||||
- [ ] Kakao Pixel 상태
|
||||
|
||||
## D.intelligence GTM Toolkit Integration
|
||||
|
||||
### Repository
|
||||
```
|
||||
https://github.com/ourdigital/dintel-gtm-toolkit
|
||||
```
|
||||
|
||||
### Capabilities
|
||||
|
||||
| Feature | Description | Use Case |
|
||||
|---------|-------------|----------|
|
||||
| Container Analysis | JSON 파싱, 구조 분석 | 컨테이너 리뷰 |
|
||||
| Dependency Mapping | 태그↔트리거↔변수 관계 | 영향도 분석 |
|
||||
| Version Diff | 버전 간 변경사항 비교 | 변경 추적 |
|
||||
| Tag Validation | 발화 상태 자동 검증 | 정기 감사 |
|
||||
|
||||
### Integration Workflow
|
||||
|
||||
```
|
||||
1. GTM Container Export
|
||||
└── JSON 파일 다운로드
|
||||
|
||||
2. D.intel Toolkit Analysis
|
||||
├── python analyze_container.py container.json
|
||||
├── Dependency graph 생성
|
||||
└── Issue detection
|
||||
|
||||
3. Report Generation
|
||||
└── Markdown/HTML 리포트
|
||||
|
||||
4. GTM Guardian Update
|
||||
└── Notion에 리포트 저장
|
||||
```
|
||||
|
||||
### Sample Toolkit Commands
|
||||
|
||||
```bash
|
||||
# Container 분석
|
||||
python analyze_container.py GTM-XXXXXX.json --output report.md
|
||||
|
||||
# 버전 비교
|
||||
python diff_versions.py v1.json v2.json --output diff.md
|
||||
|
||||
# 태그 검증
|
||||
python validate_tags.py container.json --events events.csv
|
||||
|
||||
# 미사용 요소 탐지
|
||||
python find_unused.py container.json --type all
|
||||
```
|
||||
|
||||
## Audit Report Template
|
||||
|
||||
```markdown
|
||||
# GTM Audit Report
|
||||
|
||||
## Summary
|
||||
- **Container**: GTM-XXXXXX
|
||||
- **Audit Date**: YYYY-MM-DD
|
||||
- **Version Reviewed**: XX
|
||||
- **Overall Status**: ✅ Healthy / ⚠️ Needs Attention / ❌ Critical
|
||||
|
||||
## Findings
|
||||
|
||||
### ✅ Passing
|
||||
- [항목]
|
||||
|
||||
### ⚠️ Warnings
|
||||
| Issue | Impact | Recommendation |
|
||||
|-------|--------|----------------|
|
||||
|
||||
### ❌ Critical
|
||||
| Issue | Impact | Action Required |
|
||||
|-------|--------|-----------------|
|
||||
|
||||
## Tag Firing Status
|
||||
|
||||
| Tag | Expected | Actual | Status |
|
||||
|-----|----------|--------|--------|
|
||||
| GA4 - Event - purchase | Thank You | Thank You | ✅ |
|
||||
|
||||
## Data Quality Check
|
||||
|
||||
| Metric | Expected | Actual | Variance |
|
||||
|--------|----------|--------|----------|
|
||||
| Daily Purchases | ~50 | 48 | -4% |
|
||||
|
||||
## Recommendations
|
||||
1.
|
||||
2.
|
||||
|
||||
## Next Steps
|
||||
- [ ]
|
||||
- [ ]
|
||||
|
||||
## Appendix
|
||||
- Container JSON snapshot
|
||||
- D.intel Toolkit output
|
||||
```
|
||||
|
||||
## Update Procedures
|
||||
|
||||
### Minor Update (태그 수정)
|
||||
```
|
||||
1. 변경 필요 태그 식별
|
||||
2. Preview 모드에서 수정
|
||||
3. 테스트 완료
|
||||
4. Publish with version note
|
||||
5. Notion 문서 업데이트
|
||||
```
|
||||
|
||||
### Major Update (신규 태그 추가)
|
||||
```
|
||||
1. Phase 3-4 문서 업데이트
|
||||
2. DataLayer 요구사항 개발팀 전달
|
||||
3. GTM 태그/트리거/변수 설정
|
||||
4. QA 체크리스트 수행
|
||||
5. 단계적 배포
|
||||
6. Notion 문서 업데이트
|
||||
```
|
||||
|
||||
### Emergency Fix
|
||||
```
|
||||
1. 이슈 원인 파악
|
||||
2. 최소 변경으로 수정
|
||||
3. Publish (emergency version note)
|
||||
4. 근본 원인 분석
|
||||
5. 영구 수정 계획
|
||||
```
|
||||
|
||||
## Versioning Best Practices
|
||||
|
||||
### Version Naming
|
||||
```
|
||||
v[Major].[Minor] - [Description]
|
||||
예: v12.1 - Added form_submit event
|
||||
```
|
||||
|
||||
### Version Notes Template
|
||||
```
|
||||
## Changes
|
||||
- Added: [새로 추가된 항목]
|
||||
- Modified: [수정된 항목]
|
||||
- Removed: [삭제된 항목]
|
||||
|
||||
## Reason
|
||||
[변경 이유]
|
||||
|
||||
## Testing
|
||||
- [테스트 항목 및 결과]
|
||||
|
||||
## Rollback Plan
|
||||
[롤백 필요 시 절차]
|
||||
```
|
||||
|
||||
## Monitoring Setup
|
||||
|
||||
### GA4 Alerts
|
||||
- 일일 전환 수 급감 (>30%)
|
||||
- 세션 수 급감 (>50%)
|
||||
- 이벤트 수집 오류
|
||||
|
||||
### Custom Monitoring
|
||||
- DataLayer 오류 로깅
|
||||
- Tag Manager 오류 추적
|
||||
- 서버 사이드 태그 상태 (sGTM 시)
|
||||
|
||||
## Next Phase
|
||||
|
||||
주기적 감사 완료 후 → Phase 7: Lookup App (필요 시)
|
||||
Reference in New Issue
Block a user