feat(imweb): 업체 링크로 들어오면 신청 때 유입을 그 업체로 바꿈

광고로 가입한 회원이 업체 링크로 다시 와서 신청해도, 보관 중인 첫 경로(광고)가
남아 신청 때 유입이 광고로 잡혔다. 업체 칸(업체 실적)은 그 업체라 한 줄 안에서
유입과 업체가 어긋났다.

업체 단축 링크가 붙인 UTM(utm_medium=partner)으로 들어오면 첫 경로를 그 업체로
덮어쓴다. 여러 업체를 거치면 마지막 업체 — 업체 실적의 마지막 클릭 규칙과 같다.
화면의 유입 기준은 그대로 하나만 둔다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

backend/src/shared/utils/partner-link.ts

@@ -86,7 +86,10 @@ export function buildEntryUrl(siteUrl: string, code: string): string {
 
 /** UTM 파라미터 접두어 — imweb-header-top.html 의 UTM 스크립트가 읽는다 */
 const UTM_PARAM_PREFIX = 'utm_';
-/** 업체 링크로 온 방문의 매체 값 */
+/**
+ * 업체 링크로 온 방문의 매체 값.
+ * imweb-header-top.html 의 PARTNER_MEDIUM 과 같아야 한다 — 이 값이면 UTM 스크립트가 최초유입을 업체로 덮어쓴다
+ */
 export const PARTNER_UTM_MEDIUM = 'partner';
 
 /**

imweb/README.md

@@ -99,6 +99,9 @@ docker exec -u root moneyguide-backend rm /tmp/members-1.xls
   | 가입 경로 | 그 회원이 가입할 때 기록된 경로 (가입 후 채워진 값은 제외) | naver |
 
   다른 기기에서 신청하면 신청 때 유입은 direct 로 남는다.
+- **업체 링크는 첫 경로보다 우선한다** — 업체 링크(`utm_medium=partner`)로 들어오면 보관 중인 첫 경로를
+  그 업체로 바꾼다. 예) 어제 광고로 들어와 가입 → 오늘 업체 링크로 신청: 가입 경로 광고, 신청 때 유입 업체.
+  여러 업체 링크를 거치면 마지막 업체가 남는다 (업체 실적의 마지막 클릭 규칙과 같다)
 - 백엔드는 아임웹에 실제로 있는 회원인지 확인하고(동기화 전 신규 가입자는 아임웹 API 로 직접 확인),
   회원·상품당 한 건만 남긴다. 이름·연락처는 브라우저 값이 아니라 아임웹 회원 정보를 쓴다
 - 오픈카톡 버튼 클릭은 `POST /api/applications/{id}/kakao-clicks` 로 처음 한 번만 남는다
@@ -145,7 +148,11 @@ docker exec -u root moneyguide-backend rm /tmp/members-1.xls
 - **구매 수**: 결제완료 주문만 센다. 전액 환불되거나 해당 상품 품목이 모두 취소·반품되면 빠진다. 금액은 관리하지 않는다
 - **링크는 지우지 않고 중지**한다 — 중지해도 상품 페이지로 이동은 되지만 클릭·실적은 쌓이지 않는다.
   링크가 있는 업체는 삭제할 수 없다 (실적 기록 보존)
-- 업체 링크로 온 방문은 UTM 스크립트가 업체 UTM 으로 기록하므로, 신청 때 유입·가입 경로 집계에도 업체 이름이 나온다
+- 업체 링크로 온 방문은 UTM 스크립트가 업체 UTM 으로 기록하므로, 신청 때 유입·가입 경로 집계에도 업체 이름이 나온다.
+  먼저 광고 등으로 들어와 첫 경로가 남아 있어도 업체로 덮어쓴다 (Header Code v1.2)
+  - 단, 관리자가 이동 주소에 직접 UTM 을 넣은 링크는 `utm_medium=partner` 가 아니므로 덮어쓰지 않는다
+  - 업체 실적은 **그 상품의** 링크만 세지만 유입은 상품을 가리지 않는다 —
+    A 상품 업체 링크로 들어와 B 상품을 신청하면 신청 때 유입은 업체, 업체 칸은 비어 있다
 - 이동 주소는 아임웹 사이트(www 유무 무관) 안만 허용한다 — 단축 링크가 피싱에 쓰이지 않게.
   사이트 주소는 `IMWEB_SITE_URL`, 비우면 `IMWEB_ADMIN_PAGE_URL` 의 origin
 - 한계

imweb/imweb-header-top.html

@@ -28,7 +28,8 @@
 </script>
 
 <!-- ============================================================
-     [자본주의가이드] UTM 기반 회원가입 유입경로 자동추적  v1.1
+     [자본주의가이드] UTM 기반 회원가입 유입경로 자동추적  v1.2
+     v1.2: 업체 링크(utm_medium=partner) 방문은 보관 중인 최초유입을 덮어쓴다
      설치 위치: 아임웹 관리자 > 환경설정 > SEO(검색엔진최적화)
                 > 고급 > 공통 코드 삽입 > "Header Code"
      대상 필드: 회원가입 사용자 정의 항목 "유입경로(필수)" = join_form_64454
@@ -51,6 +52,7 @@
       HP_ENABLED: true,                  // 홈페이지 항목에도 유입정보 기록 (Open API homePage 로 조회용)
       HP_LABEL: '홈페이지',              // 홈페이지 입력칸을 name/id로 못 찾을 때 라벨로 재탐색
       OWN_HOST: 'moneyguider.co.kr',
+      PARTNER_MEDIUM: 'partner',         // 업체 링크 UTM 의 utm_medium (백엔드 PARTNER_UTM_MEDIUM 과 같아야 한다)
       DEBUG: false                  // true로 바꾸면 콘솔에 로그 출력
     };
 
@@ -253,6 +255,8 @@
       if (t.ref && AUTH_REF.test(t.ref) && !explicitUtm) return;
 
       var isDirect = (t.src === 'direct');
+      // 업체 링크로 온 방문 — 업체 단축 링크가 붙인 UTM 이 주소에 실제로 있을 때만
+      var isPartner = explicitUtm && t.med === CFG.PARTNER_MEDIUM;
 
       // 최종유입: 실제 외부 유입일 때만 갱신 (사이트 내부 이동으로 덮어쓰지 않음)
       if (!isDirect) saveTouch(K_LAST, t);
@@ -260,6 +264,10 @@
       var prev = readTouch(K_FIRST);
       if (!prev) {
         saveTouch(K_FIRST, t);                     // 최초 1회 (또는 보관기간 만료 후 재시작)
+      } else if (isPartner) {
+        // 업체 링크는 이전 유입(광고 등)보다 우선한다 — 신청 때 유입·가입 경로가
+        // 업체 실적(가장 최근에 누른 업체 링크로 귀속)과 같은 업체를 가리키게 한다
+        saveTouch(K_FIRST, t);
       } else if (!isDirect && prev.src === 'direct') {
         saveTouch(K_FIRST, t);                     // 이전 기록이 direct였다면 실제 유입원으로 승격
       }