UTM 강제화와 Webhook 연동을 통한 마케팅 Attribution 데이터 정합성 확보

Context

Calendly 예약 데이터가 HubSpot CRM으로 전송될 때 UTM 파라미터가 유실되어 모든 유입 경로가 'direct'로 처리되는 Attribution 누락 발생. 오프페이지 콘텐츠의 실제 매출 기여도를 정량적으로 측정할 수 없는 데이터 단절 상태였음.

Technical Solution

• CI 단계에서 Regex 기반 UTM 검증 로직을 구축하여 표준 규격 미준수 링크의 배포를 원천 차단하는 Governance 체계 수립
• Calendly의 invitee.created 이벤트 Webhook을 수신하여 tracking 페이로드 내 UTM 데이터를 추출하는 Handler 설계
• HubSpot API 호출 시 이메일 주소를 idempotencyKey로 활용하여 중복 데이터 생성 및 쓰기 충돌을 방지하는 Idempotent Upsert 구현
• CRM API의 지연 시간으로 인한 Webhook 재시도 누적을 방지하기 위해 빠른 200 OK 응답 후 비동기 큐 처리를 권장하는 최적화 구조 적용
• 원본 Tracking Blob 로그 기록을 통해 기존 레거시 링크의 누락 패턴을 식별하고 소급 수정하는 데이터 정제 프로세스 수행