chore: GTM 메타 픽셀, 커스텀 이벤트 추가

[WonJuneKim]

💡 작업 내용

• GTM 내 MetalPixel 설정
• GTM, Amplitude 커스텀 이벤트 추가
• QA 사이트에서는 트래킹이 작동하지않도록 설정

💡 자세한 설명

✅ index.html

• 운영 서포터즈 측에서 제공해주신 메타 픽셀 기본 코드를 삽입하였습니다.
• 추적되는 이벤트는 PageView(페이지 조회), Lead(모집 알림 신청 버튼 클릭 시), CompleteRegistration(지원 완료 시) 로 파악되었습니다.

✅ analytics.ts

• 기본적으로 Amplitude에 커스텀 데이터를 보내기 위해 설정하였으며, 필요 시 GTM 설정을 통해 얻은 데이터를 GTM에 전달할 수 있습니다.

이벤트	설명	파라미터
recruitment_alert_click	모집 알림 신청 버튼 클릭	generation, button_text
apply_start	지원하러 가기 버튼 클릭	source
apply_step_view	지원 단계 진입	step, job_family
apply_step_complete	지원 단계 완료	step, job_family
apply_complete	지원 완료	job_family, conversion

• 주의 사항
  • trackEvent는 GTM + Amplitude 모두에 전송합니다.
  • Meta Pixel은 별도로 fbq() 호출이 필요합니다.
  • Meta Pixel도 analytics.ts 에서 동적 로드하는 방식을 사용합니다.

✅ QA, localhost에서 트래킹 제거

환경	도메인	기본 트래킹	디버그 모드
운영	ject.kr	활성화	-
QA	qa.ject.kr	비활성화	VITE_ANALYTICS_DEBUG=true로 활성화 가능
로컬	localhost	비활성화	VITE_ANALYTICS_DEBUG=true로 활성화 가능

해당 설정을 통해

✅ 기타 사용법

• 이탈 지점 분석 방법

apply_step_view는 있는데 apply_step_complete가 없으면 해당 단계에서 이탈한 것입니다.

예시:

이메일인증 view: 100명
이메일인증 complete: 80명
→ 이메일인증 단계에서 20명 이탈 (20%)

> 실제 QA 사이트에서 커스텀 액션이 capture 된 예시

✅ 환경 변수 관리(2026/01/01 10:55 추가)

환경 변수는 다음의 값을 사용합니다. (로컬에서 빌드 시 .env에 추가, github secrets에는 등록됨)
-VITE_META_PIXEL_ID : Meta Pixel의 ID 값

• VITE_GTM_ID: Google Tag Manger의 ID 값(현재 GTM은 별도로 사용하지 않는 것으로 파악됨)
• VITE_AMPLITUDE_API_KEY: Amplitude의 API Key 값(Amplitude 로그인 시에도 확인 가능)
• VITE_ANALYTICS_DEBUG : QA 사이트에서 트래킹 테스트를 위한 값이며, 기본 값은 false(사용안함)

qa.ject.kr 에서 데이터 수집 테스트 진행 시 Vercel 내부 환경 변수에서 해당 값을 true 로 바꿔주세요!

📗 참고 자료 (선택)

📢 리뷰 요구 사항 (선택)

✅ 셀프 체크리스트

• 머지할 브랜치 확인했나요?
• 이슈는 close 했나요?
• Reviewers, Labels, Projects를 등록했나요?
• 기능이 잘 동작하나요?
• 불필요한 코드는 제거했나요?

closes #345

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
ject-official-web-site-client-web	Ready	Preview, Comment	Jan 1, 2026 11:26am

[kimdonggu42]

앞으로 사용자 행동 분석하기 좋을 것 같아요. 이탈 지점 파악도 수월해질 것 같습니다!

[WonJuneKim]

앞으로 사용자 행동 분석하기 좋을 것 같아요. 이탈 지점 파악도 수월해질 것 같습니다!

@kimdonggu42 관련해서 환경 변수 사용법과 실제 데이터 검출된 예시도 추가했습니다!