배경과 과제
배경
웨딩 서비스의 Next.js 웹에 광고 매체(Meta, 카카오, 당근, 틱톡, 네이버, 텐핑 등)를 하나씩 붙였습니다.
처음에는 매체 호출을 따로 모으는 구조를 떠올리지 못했습니다. 새 매체는 기존에 GA를 호출하던 곳에 같이 호출했습니다.
매체가 하나씩 늘면서 매체 모듈을 직접 import하는 파일이 126개가 됐습니다. 청첩장 작성 페이지 한 곳에서만 6개 매체를 직접 호출했습니다. 이때 매체 호출을 한곳에서 관리할 필요를 느꼈습니다.
핵심 과제
트래킹을 호출하는 곳마다 페이지가 주인이었습니다. 이벤트 이름 하나가 바뀌면 그 이름을 쓰는 페이지를 모두 찾아 고쳐야 했습니다.
설계 시 고려한 점
- 매체를 추가할 때도 같았습니다. 새 매체가 받을 사건이 있는 페이지를 하나씩 열어 호출을 넣어야 했습니다.
- 페이지마다 매체별 이름과 조건을 따로 적다 보니 같은 사건이 매체마다 어긋났습니다. 업체 방문예약 완료는 GA가 5개 카테고리에만, Meta는 항상, 텐핑은 3개 카테고리와 업체 1곳에만 보냈습니다. 카테고리 매핑 표도 2벌이었습니다.
- 운영 중에 문제로 드러난 적은 없습니다. 위 내용은 코드에서 찾은 불일치입니다.
운영 제약
- 불일치가 의도였는지 확인할 수 없었습니다. 그래서 동작은 그대로 두고 드러내는 것까지만 했습니다.
- 매체마다 이벤트 체계가 다릅니다. 표준 이벤트 이름, 메서드 호출, 전환 타입처럼 형식이 달라 사건 하나가 매체 이벤트 하나로 1:1 대응하지 않습니다.
페이지와 매체 사이에 둔 이벤트 계층
페이지는 사건만 알리고, 매체별 변환은 어댑터가 맡는 구조
페이지는 track(사건)만 부릅니다. 이벤트 계층이 등록된 어댑터마다 사건을 넘기고, 어댑터는 그 매체의 이름과 조건으로 바꿔 기존 매체 모듈을 호출합니다.
전후 측정 결과
- 변경 범위
- 매체 하나를 실제로 추가해 비교했습니다. 바뀌는 파일은 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개
감수한 것과 남은 과제
언제 보낼지는 여전히 페이지가 정합니다. track()은 불린 순간 보냅니다. 저장 API 전에 부르면 그대로 API 전에 나갑니다. 전송 시점은 그 페이지의 업무 흐름이 정할 일이라 계층으로 옮기지 않았습니다.
계층은 매핑에 적힌 대로 보낼 뿐입니다. 같은 이벤트를 두 번 보내도록 적혀 있으면 그대로 두 번 보냅니다. 매핑이 맞는지는 사람이 정합니다.
매체를 추가할 때마다 사건별 매핑을 새로 정해야 합니다. 매체마다 이벤트 체계가 달라 이 매핑 표를 유지하는 비용이 생깁니다.