트래킹 호출 코드를 이벤트 계층으로 모으기

페이지는 "무슨 일이 일어났는지"만 알리고 매체별 이름과 조건은 한곳에서 정하는 이벤트 계층을 만들었습니다.

배경과 과제

배경

웨딩 서비스의 Next.js 웹에 광고 매체(Meta, 카카오, 당근, 틱톡, 네이버, 텐핑 등)를 하나씩 붙였습니다.

처음에는 매체 호출을 따로 모으는 구조를 떠올리지 못했습니다. 새 매체는 기존에 GA를 호출하던 곳에 같이 호출했습니다.

매체가 하나씩 늘면서 매체 모듈을 직접 import하는 파일이 126개가 됐습니다. 청첩장 작성 페이지 한 곳에서만 6개 매체를 직접 호출했습니다. 이때 매체 호출을 한곳에서 관리할 필요를 느꼈습니다.

핵심 과제

트래킹을 호출하는 곳마다 페이지가 주인이었습니다. 이벤트 이름 하나가 바뀌면 그 이름을 쓰는 페이지를 모두 찾아 고쳐야 했습니다.

설계 시 고려한 점

  • 매체를 추가할 때도 같았습니다. 새 매체가 받을 사건이 있는 페이지를 하나씩 열어 호출을 넣어야 했습니다.
  • 페이지마다 매체별 이름과 조건을 따로 적다 보니 같은 사건이 매체마다 어긋났습니다. 업체 방문예약 완료는 GA가 5개 카테고리에만, Meta는 항상, 텐핑은 3개 카테고리와 업체 1곳에만 보냈습니다. 카테고리 매핑 표도 2벌이었습니다.
  • 운영 중에 문제로 드러난 적은 없습니다. 위 내용은 코드에서 찾은 불일치입니다.

운영 제약

  • 불일치가 의도였는지 확인할 수 없었습니다. 그래서 동작은 그대로 두고 드러내는 것까지만 했습니다.
  • 매체마다 이벤트 체계가 다릅니다. 표준 이벤트 이름, 메서드 호출, 전환 타입처럼 형식이 달라 사건 하나가 매체 이벤트 하나로 1:1 대응하지 않습니다.

페이지와 매체 사이에 둔 이벤트 계층

페이지는 사건만 알리고, 매체별 변환은 어댑터가 맡는 구조

페이지는 track(사건)만 부릅니다. 이벤트 계층이 등록된 어댑터마다 사건을 넘기고, 어댑터는 그 매체의 이름과 조건으로 바꿔 기존 매체 모듈을 호출합니다.

페이지는 사건만 알리고, 매체별 변환은 어댑터가 맡는 구조청첩장 인트로·작성 페이지와 방문예약 완료 페이지가 track 함수로 사건을 보내면, 이벤트 계층이 GA·Meta·카카오·당근·틱톡·네이버·텐핑 어댑터 7개에 전달하고, 각 어댑터가 기존 매체 모듈을 호출하는 구조페이지이벤트 계층어댑터 목록등록된어댑터마다기존 함수그대로 호출청첩장 인트로인트로 진입청첩장 작성진입·저장 성공방문예약 완료예약 완료사건 카탈로그사건 4종 타입track()어댑터 등록매체 추가 = 한 줄매체 어댑터 7개매체별 이름과 조건기존 매체 모듈바꾸지 않음
페이지는 사건만 알리고, 매체별 변환은 어댑터가 맡는 구조청첩장 인트로·작성 페이지와 방문예약 완료 페이지가 track 함수로 사건을 보내면, 이벤트 계층이 GA·Meta·카카오·당근·틱톡·네이버·텐핑 어댑터 7개에 전달하고, 각 어댑터가 기존 매체 모듈을 호출하는 구조페이지이벤트 계층어댑터 목록등록된어댑터마다기존 함수그대로 호출청첩장 인트로인트로 진입청첩장 작성진입·저장 성공방문예약 완료예약 완료사건 카탈로그사건 4종 타입track()어댑터 등록매체 추가 = 한 줄매체 어댑터 7개매체별 이름과 조건기존 매체 모듈바꾸지 않음

전후 측정 결과

변경 범위
매체 하나를 실제로 추가해 비교했습니다. 바뀌는 파일은 8개에서 5개로, 그중 페이지는 5개에서 0개로 줄었습니다.
페이지 코드
범위 안 5개 페이지에서 매체를 직접 부르던 33줄이 track(사건) 7줄이 됐습니다. 페이지는 어떤 매체가 있는지 모릅니다.
가시성
사건별로 어느 매체에 무엇을 보내는지 매체 파일 하나에서 읽을 수 있습니다. 매체마다 다르던 조건이 한 화면에 드러납니다.

핵심 구현과 판단

1. 기존 구조: 페이지가 매체를 직접 호출

청첩장 저장이 성공하면 페이지가 Meta, 카카오, 당근, 틱톡, 네이버를 하나씩 직접 불렀습니다. 매체마다 이벤트 이름과 호출 방식이 달랐고 생성과 수정 두 곳에 같은 호출이 반복됐습니다.

  • 매체가 늘 때마다 이 목록이 길어지고 같은 사건을 보내는 다른 페이지도 함께 고쳐야 했습니다.

2. 대안 비교

  • 이벤트 이름 상수: 이름 오타는 막을 수 있습니다. 하지만 어느 매체에 어떤 조건으로 보낼지는 여전히 각 페이지가 정합니다.
  • GTM: 매핑을 한곳에 모을 수 있습니다. 하지만 매핑이 코드 밖에 있어 사건이 어느 매체로 가는지 단위 테스트할 수 없습니다.
  • 앱 안의 이벤트 계층(채택): 매핑을 코드에 두고 한곳에서 관리합니다.

3. 이벤트 계층: 페이지는 track() 한 번만 호출

페이지가 매체 함수를 하나씩 부르던 것을 사건 하나를 넘기는 track() 한 번으로 바꿨습니다. 청첩장 저장이 성공하면 페이지는 이제 "저장 성공(생성)" 사건 하나만 넘깁니다.

페이지가 넘길 수 있는 사건은 인트로 진입, 작성 진입, 저장 성공(생성·수정), 방문예약 완료 4가지이고, 하나의 타입으로 정했습니다.

매체 하나가 어댑터 하나입니다. track()이 등록된 어댑터마다 사건을 넘기면, 각 어댑터가 기존 매체 모듈 함수를 부릅니다.

  • 같은 사건이 다른 페이지에서 일어나도 그 페이지는 track() 한 줄만 부르면 됩니다. 어느 매체로 보낼지는 어댑터가 정합니다.
  • 매체를 추가할 때는 어댑터 하나를 만들고 등록 목록에 한 줄을 더합니다. 페이지는 고치지 않습니다.

4. 매체 하나를 실제로 추가해 비교

"매체 추가가 쉬워졌다"를 말로 두지 않고 가짜 매체를 두 구조에 실제로 붙여 바뀐 파일을 셌습니다. 두 구조 모두 모듈 파일, 모듈 export, 초기화 코드 수정을 포함해 같은 조건으로 비교했습니다.

  • 기존 구조: 8개 파일 (모듈 3 + 사건이 일어나는 페이지 5)
  • 이벤트 계층: 5개 파일 (모듈 3 + 어댑터 1 + 등록 1). 페이지는 0개
코드 변경예제 코드로 보는 전후 diff1. 페이지: 매체 5개 호출 → track() 한 줄 · 2. 이벤트 계층: 사건 타입, track(), 어댑터 · 3. 매체 추가: 어댑터 1개 + 등록 한 줄코드 변경 보기

감수한 것과 남은 과제

언제 보낼지는 여전히 페이지가 정합니다. track()은 불린 순간 보냅니다. 저장 API 전에 부르면 그대로 API 전에 나갑니다. 전송 시점은 그 페이지의 업무 흐름이 정할 일이라 계층으로 옮기지 않았습니다.

계층은 매핑에 적힌 대로 보낼 뿐입니다. 같은 이벤트를 두 번 보내도록 적혀 있으면 그대로 두 번 보냅니다. 매핑이 맞는지는 사람이 정합니다.

매체를 추가할 때마다 사건별 매핑을 새로 정해야 합니다. 매체마다 이벤트 체계가 달라 이 매핑 표를 유지하는 비용이 생깁니다.

ASK ME기준 ·이 글 · 트래킹 호출 코드를 이벤트 계층으로 모으기

프로젝트, 담당 범위, 기술적 판단을 물어보세요.

추천 질문

포트폴리오에 작성된 내용으로만 답합니다