From 36589e1763f1920ecb9889ac1b454ec8fcc37257 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:47:52 +0900
Subject: [PATCH 01/30] refactor(analytics): unify GA4 module with taxonomy
 naming
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Rename helpers to match GA4-Data-Taxonomy.md naming convention
  - sendTabChange → sendNavigationTabSelect
  - sendLinkClick → sendLinkOpen (+ linkGroup, sameHostVariant params)
  - sendGAEvent("search") → sendSearchSubmit
  - sendSettingChange → sendSettingsCredentialsSaved / Deleted
  - sendButtonClick("google_login/logout") → sendAuthLoginStart / sendAuthLogout
  - sendError → sendSystemError
- Add sendExtensionOpen: single call emits extension_first_open (최초 1회),
  extension_session_start (새 세션 시), extension_open (매번) in one fetch
- getOrCreateSessionId now returns { sessionId, isNewSession } to support
  session_start detection without an extra storage read
- Restore and add JSDoc for all exported functions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/App.tsx                       |   4 +-
 src/components/Tabs/LinkGroup.tsx |   8 +-
 src/components/TabsLayout.tsx     |   4 +-
 src/utils/analytics.ts            | 295 +++++++++++++++++++++---------
 4 files changed, 218 insertions(+), 93 deletions(-)

diff --git a/src/App.tsx b/src/App.tsx
index 4da3796..f7e617d 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -8,7 +8,7 @@ import { Outlet } from "react-router-dom";
 import { ErrorBoundary } from "react-error-boundary";
 import { Toaster } from "./components/ui/sonner";
 import { PostedTemplatesProvider } from "./contexts/PostedTemplatesContext";
-import { sendPageView } from "./utils/analytics";
+import { sendExtensionOpen } from "./utils/analytics";
 import { debugLog } from "@/utils/logger";
 import "./App.css";
 
@@ -20,7 +20,7 @@ function App() {
       "font-family: Nanum Gothic; color: darkgreen; padding: 6px; border-radius: 4px; font-size:14px",
     );
     debugLog("https://github.com/Turtle-Hwan/LinKU");
-    sendPageView("LinKU Extension - Popup", "chrome-extension://linku/popup");
+    sendExtensionOpen("popup_home", "popup");
   }, []);
 
   return (
diff --git a/src/components/Tabs/LinkGroup.tsx b/src/components/Tabs/LinkGroup.tsx
index 61479f4..c3f375a 100644
--- a/src/components/Tabs/LinkGroup.tsx
+++ b/src/components/Tabs/LinkGroup.tsx
@@ -1,6 +1,6 @@
 import { LinkList, LinkListElement } from "@/constants/LinkList";
 import { getCurrentTab } from "@/utils/chrome";
-import { sendLinkClick } from "@/utils/analytics";
+import { sendLinkOpen } from "@/utils/analytics";
 import React, { use } from "react";
 
 interface LinkGroupProps {
@@ -42,7 +42,7 @@ const GridItem = ({ item, colNum }) => {
     <button
       className={`${colNum} flex flex-row items-center justify-start px-4 py-2 rounded-lg hover:bg-gray-100 transition-colors border border-gray-200 cursor-pointer overflow-hidden`}
       onClick={() => {
-        sendLinkClick(item.label, item.link);
+        sendLinkOpen(item.label, item.link);
         window.open(item.link);
       }}
     >
@@ -72,7 +72,7 @@ const GridItemSameHost = ({ item, colNum }) => {
       <button
         className="w-full h-full px-1 bg-main text-white rounded-lg hover:bg-hover transition-colors cursor-pointer text-sm/[normal] break-keep"
         onClick={() => {
-          sendLinkClick(`${item.label} - ${item.samehost.content}`, item.link);
+          sendLinkOpen(`${item.label} - ${item.samehost.content}`, item.link, undefined, "samehost_primary");
           item.samehost.onClick();
         }}
       >
@@ -83,7 +83,7 @@ const GridItemSameHost = ({ item, colNum }) => {
         <button
           className="w-full h-full px-1 bg-gray-200 text-black rounded-lg hover:bg-gray-300 transition-colors cursor-pointer text-sm/[normal] break-keep"
           onClick={() => {
-            sendLinkClick(`${item.label} - ${item.samehost2.content}`, item.link);
+            sendLinkOpen(`${item.label} - ${item.samehost2.content}`, item.link, undefined, "samehost_secondary");
             item.samehost2.onClick();
           }}
         >
diff --git a/src/components/TabsLayout.tsx b/src/components/TabsLayout.tsx
index 8ac680e..cb6fd3b 100644
--- a/src/components/TabsLayout.tsx
+++ b/src/components/TabsLayout.tsx
@@ -4,7 +4,7 @@ import LinkGroup from "./Tabs/LinkGroup";
 import TodoList from "./Tabs/TodoList/TodoList";
 import TodoCountBadge from "./Tabs/TodoList/TodoCountBadge";
 import Alerts from "./Tabs/Alerts/Alerts";
-import { sendTabChange } from "@/utils/analytics";
+import { sendNavigationTabSelect } from "@/utils/analytics";
 import { useSelectedTemplate } from "@/hooks/useSelectedTemplate";
 
 const TabsLayout = () => {
@@ -17,7 +17,7 @@ const TabsLayout = () => {
       TodoList: "Todo List",
       Alerts: "공지사항"
     };
-    sendTabChange(tabNames[value] || value);
+    sendNavigationTabSelect(tabNames[value] || value);
   };
 
   return (
diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index 882c51e..749af12 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -1,37 +1,51 @@
 /**
  * Google Analytics 4 Measurement Protocol for Chrome Extension
  * Manifest V3 호환 - CSP 제약 없이 Analytics 사용
+ *
+ * 이벤트 네이밍은 GA4-Data-Taxonomy.md 기준을 따른다.
+ * 전송 흐름: 각 헬퍼 → sendGAEvent → GA4 MP endpoint (fetch)
  */
 
 import { getOrCreateClientId } from "./clientId";
 import { getStorage, setStorage } from "./chrome";
-import { debugLog, warnLog, errorLog } from '@/utils/logger';
+import { debugLog, warnLog, errorLog } from "@/utils/logger";
 
-// GA4 이벤트 파라미터 타입 (string, number, boolean만 허용)
+/** GA4 이벤트 파라미터 타입 — string, number, boolean만 허용 */
 type GAEventParam = string | number | boolean;
 
 const GA_ENDPOINT = "https://www.google-analytics.com/mp/collect";
 const GA_DEBUG_ENDPOINT = "https://www.google-analytics.com/debug/mp/collect";
 const MEASUREMENT_ID = "G-ECMY8N9FX4";
 
-// 환경변수에서 API Secret 가져오기
-// 빌드 시 .env에서 주입됨
+/** 빌드 시 .env에서 주입 */
 const API_SECRET = import.meta.env.VITE_GA_API_SECRET;
 
-// 세션 타임아웃: 30분
+/** 세션 타임아웃: 30분 */
 const SESSION_TIMEOUT_MS = 30 * 60 * 1000;
 
-// 환경 구분: development (개발/로컬 빌드) / production (배포)
+/** 환경 구분: development(개발/로컬) / production(배포) */
 const ENVIRONMENT = import.meta.env.VITE_ENVIRONMENT || "production";
 
-// 디버그 모드 (development 환경에서만 활성화)
+/** development 환경에서만 debug endpoint + DebugView 활성화 */
 const DEBUG_MODE = ENVIRONMENT === "development";
 
+// ─── Session management ────────────────────────────────────────────────────
+
+interface SessionResult {
+  sessionId: string;
+  /** 30분 타임아웃을 초과해 새 세션이 생성된 경우 true */
+  isNewSession: boolean;
+}
+
 /**
  * Session ID 생성 및 관리
- * 30분 동안 활동이 없으면 새 세션 시작
+ *
+ * 마지막 활동 기준 30분 이내면 기존 세션을 유지하고 타임스탬프를 갱신한다.
+ * 30분 초과 또는 세션이 없으면 새 timestamp 기반 세션 ID를 생성한다.
+ *
+ * @returns sessionId와 새 세션 여부(isNewSession)를 함께 반환
  */
-async function getOrCreateSessionId(): Promise<string> {
+async function getOrCreateSessionId(): Promise<SessionResult> {
   try {
     const sessionId = await getStorage<string>("sessionId");
     const sessionTimestamp = await getStorage<number>("sessionTimestamp");
@@ -39,34 +53,34 @@ async function getOrCreateSessionId(): Promise<string> {
 
     if (sessionId && sessionTimestamp) {
       const timeSinceLastActivity = now - sessionTimestamp;
-
       if (timeSinceLastActivity < SESSION_TIMEOUT_MS) {
-        // 세션 유지, 타임스탬프 업데이트
         await setStorage({ sessionTimestamp: now });
-        return sessionId;
+        return { sessionId, isNewSession: false };
       }
     }
 
-    // 새 세션 생성 (timestamp 사용)
     const newSessionId = now.toString();
-    await setStorage({
-      sessionId: newSessionId,
-      sessionTimestamp: now,
-    });
+    await setStorage({ sessionId: newSessionId, sessionTimestamp: now });
 
     if (DEBUG_MODE) {
       debugLog("[GA] New Session ID created:", newSessionId);
     }
 
-    return newSessionId;
+    return { sessionId: newSessionId, isNewSession: true };
   } catch (error) {
     errorLog("[GA] Error getting/creating session ID:", error);
-    return Date.now().toString();
+    return { sessionId: Date.now().toString(), isNewSession: false };
   }
 }
 
+// ─── Base sender ──────────────────────────────────────────────────────────
+
 /**
- * Google Analytics 이벤트 전송
+ * Google Analytics 이벤트 전송 (내부 베이스 함수)
+ *
+ * 모든 도메인 헬퍼가 이 함수를 통해 GA4 MP로 이벤트를 전송한다.
+ * API Secret이 없거나 fetch 실패 시 에러를 throw하지 않고 로그만 남긴다.
+ *
  * @param eventName 이벤트 이름 (최대 40자, 영문/숫자/언더스코어)
  * @param eventParams 이벤트 파라미터 객체
  */
@@ -74,12 +88,8 @@ export async function sendGAEvent(
   eventName: string,
   eventParams: Record<string, GAEventParam> = {}
 ): Promise<void> {
-  // API Secret이 없으면 전송하지 않음
   if (!API_SECRET) {
-    warnLog(
-      "[GA] API Secret not configured. Event not sent:",
-      eventName
-    );
+    warnLog("[GA] API Secret not configured. Event not sent:", eventName);
     return;
   }
 
@@ -90,7 +100,7 @@ export async function sendGAEvent(
 
   try {
     const clientId = await getOrCreateClientId();
-    const sessionId = await getOrCreateSessionId();
+    const { sessionId } = await getOrCreateSessionId();
 
     const payload = {
       client_id: clientId,
@@ -99,7 +109,7 @@ export async function sendGAEvent(
           name: eventName,
           params: {
             session_id: sessionId,
-            engagement_time_msec: 100, // GA4에서 권장하는 최소값
+            engagement_time_msec: 100, // GA4 권장 최솟값
             ...(DEBUG_MODE && { debug_mode: 1 }), // DebugView 활성화
             ...eventParams,
           },
@@ -107,16 +117,13 @@ export async function sendGAEvent(
       ],
     };
 
-    // 디버그 모드일 경우 debug endpoint 사용
     const endpoint = DEBUG_MODE ? GA_DEBUG_ENDPOINT : GA_ENDPOINT;
 
     const response = await fetch(
       `${endpoint}?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`,
       {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-        },
+        headers: { "Content-Type": "application/json" },
         body: JSON.stringify(payload),
       }
     );
@@ -126,7 +133,6 @@ export async function sendGAEvent(
       debugLog("[GA] Payload:", JSON.stringify(payload, null, 2));
       debugLog("[GA] Response status:", response.status, response.statusText);
 
-      // Debug endpoint의 응답 확인
       if (response.ok) {
         const debugResponse = await response.json();
         debugLog("[GA] Debug response:", debugResponse);
@@ -138,96 +144,215 @@ export async function sendGAEvent(
   } catch (error) {
     errorLog("[GA] Error sending event:", error);
     if (DEBUG_MODE && error instanceof Error) {
-      debugLog("[GA] Error details:", {
-        message: error.message,
-        stack: error.stack,
-      });
+      debugLog("[GA] Error details:", { message: error.message, stack: error.stack });
     }
   }
 }
 
+// ─── Lifecycle events ─────────────────────────────────────────────────────
+
 /**
- * 페이지뷰 이벤트 전송
- * @param pageTitle 페이지 제목
- * @param pageLocation 페이지 경로 (선택)
+ * popup mount 시 호출하는 lifecycle 통합 함수
+ *
+ * 내부적으로 아래 3가지를 자동 처리한다:
+ * 1. `firstOpenSent` 플래그가 없으면 `extension_first_open` 전송 후 플래그 저장
+ * 2. 새 세션(30분 초과)이면 `extension_session_start` 전송
+ * 3. 매번 `extension_open` 전송
+ *
+ * GA4 MP는 단일 요청에 이벤트 배열을 지원하므로 한 번의 fetch로 처리한다.
+ *
+ * @param screenName 현재 화면 식별자 (예: "popup_home")
+ * @param entryPoint 진입 경로 (예: "popup")
+ */
+export async function sendExtensionOpen(
+  screenName: string,
+  entryPoint: string
+): Promise<void> {
+  if (!API_SECRET) {
+    warnLog("[GA] API Secret not configured. Lifecycle events not sent.");
+    return;
+  }
+
+  try {
+    const clientId = await getOrCreateClientId();
+    const { sessionId, isNewSession } = await getOrCreateSessionId();
+
+    const baseParams: Record<string, GAEventParam> = {
+      session_id: sessionId,
+      engagement_time_msec: 100,
+      screen_name: screenName,
+      entry_point: entryPoint,
+      ...(DEBUG_MODE && { debug_mode: 1 }),
+    };
+
+    const endpoint = DEBUG_MODE ? GA_DEBUG_ENDPOINT : GA_ENDPOINT;
+    const url = `${endpoint}?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`;
+
+    const events: { name: string; params: Record<string, GAEventParam> }[] = [];
+
+    const firstOpenSent = await getStorage<boolean>("firstOpenSent");
+    if (!firstOpenSent) {
+      events.push({ name: "extension_first_open", params: baseParams });
+      await setStorage({ firstOpenSent: true });
+      if (DEBUG_MODE) debugLog("[GA] extension_first_open queued");
+    }
+
+    if (isNewSession) {
+      events.push({ name: "extension_session_start", params: baseParams });
+      if (DEBUG_MODE) debugLog("[GA] extension_session_start queued");
+    }
+
+    events.push({ name: "extension_open", params: baseParams });
+
+    const payload = { client_id: clientId, events };
+
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+    });
+
+    if (DEBUG_MODE) {
+      debugLog("[GA] Lifecycle events sent:", events.map((e) => e.name));
+      debugLog("[GA] Response status:", response.status, response.statusText);
+      if (response.ok) debugLog("[GA] Debug response:", await response.json());
+    }
+  } catch (error) {
+    errorLog("[GA] Error sending lifecycle events:", error);
+  }
+}
+
+// ─── Navigation ───────────────────────────────────────────────────────────
+
+/**
+ * 탭 전환 이벤트 전송
+ * @param tabName 전환한 탭의 사용자 친화적 이름 (예: "링크모음", "공지사항")
+ * @param featureArea 상위 기능 영역 (선택, 예: "links", "alerts")
  */
-export async function sendPageView(
-  pageTitle: string,
-  pageLocation?: string
+export async function sendNavigationTabSelect(
+  tabName: string,
+  featureArea?: string
 ): Promise<void> {
-  await sendGAEvent("page_view", {
-    page_title: pageTitle,
-    page_location: pageLocation || window.location.href || "unknown",
-    page_referrer: document.referrer || "direct",
+  await sendGAEvent("navigation_tab_select", {
+    tab_name: tabName,
+    ...(featureArea && { feature_area: featureArea }),
+  });
+}
+
+// ─── Search ───────────────────────────────────────────────────────────────
+
+/**
+ * 검색 제출 이벤트 전송
+ * @param searchTerm 입력한 검색어
+ * @param searchLocation 검색 UI 위치 (선택, 예: "header")
+ */
+export async function sendSearchSubmit(
+  searchTerm: string,
+  searchLocation?: string
+): Promise<void> {
+  await sendGAEvent("search_submit", {
+    search_term: searchTerm,
+    ...(searchLocation && { search_location: searchLocation }),
   });
 }
 
+// ─── Link ─────────────────────────────────────────────────────────────────
+
 /**
- * 링크 클릭 이벤트 전송
- * @param linkName 클릭한 링크 이름
+ * 링크 열기 이벤트 전송 — LinKU의 핵심 가치 행동을 측정한다
+ * @param linkName 클릭한 링크 이름 (item.label 또는 same-host 버튼 조합 문자열)
  * @param linkUrl 링크 URL
+ * @param linkGroup 링크가 속한 그룹명 (선택)
+ * @param sameHostVariant same-host 버튼 구분자 (선택: "samehost_primary" | "samehost_secondary")
  */
-export async function sendLinkClick(
+export async function sendLinkOpen(
   linkName: string,
-  linkUrl: string
+  linkUrl: string,
+  linkGroup?: string,
+  sameHostVariant?: string
 ): Promise<void> {
-  await sendGAEvent("link_click", {
+  await sendGAEvent("link_open", {
     link_name: linkName,
     link_url: linkUrl,
+    ...(linkGroup && { link_group: linkGroup }),
+    ...(sameHostVariant && { same_host_variant: sameHostVariant }),
   });
 }
 
+// ─── Auth ─────────────────────────────────────────────────────────────────
+
 /**
- * 탭 전환 이벤트 전송
- * @param tabName 전환한 탭 이름
+ * 로그인 시작 이벤트 전송
+ * @param provider 인증 제공자 (예: "google")
+ * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
  */
-export async function sendTabChange(tabName: string): Promise<void> {
-  await sendGAEvent("tab_change", {
-    tab_name: tabName,
+export async function sendAuthLoginStart(
+  provider: string,
+  uiLocation: string
+): Promise<void> {
+  await sendGAEvent("auth_login_start", {
+    provider,
+    ui_location: uiLocation,
   });
 }
 
 /**
- * 버튼 클릭 이벤트 전송
- * @param buttonName 클릭한 버튼 이름
- * @param buttonLocation 버튼 위치 (선택)
+ * 로그아웃 이벤트 전송
+ * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
  */
-export async function sendButtonClick(
-  buttonName: string,
-  buttonLocation?: string
-): Promise<void> {
-  await sendGAEvent("button_click", {
-    button_name: buttonName,
-    ...(buttonLocation && { button_location: buttonLocation }),
-  });
+export async function sendAuthLogout(uiLocation: string): Promise<void> {
+  await sendGAEvent("auth_logout", { ui_location: uiLocation });
+}
+
+// ─── Settings ─────────────────────────────────────────────────────────────
+
+/** eCampus 인증정보 저장 완료 이벤트 전송 */
+export async function sendSettingsCredentialsSaved(): Promise<void> {
+  await sendGAEvent("settings_credentials_saved", { result: "success" });
 }
 
+/** eCampus 인증정보 삭제 완료 이벤트 전송 */
+export async function sendSettingsCredentialsDeleted(): Promise<void> {
+  await sendGAEvent("settings_credentials_deleted", { result: "success" });
+}
+
+// ─── System ───────────────────────────────────────────────────────────────
+
 /**
- * 설정 변경 이벤트 전송
- * @param settingName 변경한 설정 이름
- * @param settingValue 변경된 값
+ * 런타임 오류 이벤트 전송
+ * @param errorCode 에러 식별 코드 (예: "network_error", "auth_required")
+ * @param errorMessage 사람이 읽는 에러 설명
+ * @param screenName 에러가 발생한 화면 (선택)
  */
-export async function sendSettingChange(
-  settingName: string,
-  settingValue: string
+export async function sendSystemError(
+  errorCode: string,
+  errorMessage: string,
+  screenName?: string
 ): Promise<void> {
-  await sendGAEvent("setting_change", {
-    setting_name: settingName,
-    setting_value: settingValue,
+  await sendGAEvent("system_error", {
+    error_code: errorCode,
+    error_message: errorMessage,
+    ...(screenName && { screen_name: screenName }),
   });
 }
 
+// ─── Generic button click ─────────────────────────────────────────────────
+
 /**
- * 에러 발생 이벤트 전송
- * @param errorMessage 에러 메시지
- * @param errorLocation 에러 발생 위치
+ * 버튼 클릭 이벤트 전송
+ *
+ * taxonomy 관점에서 제품 의미가 큰 버튼은 개별 이벤트(sendAuthLoginStart 등)로 승격하고,
+ * 당장 별도 이벤트가 없는 header 버튼 등 범용 클릭에만 사용한다.
+ *
+ * @param buttonName 버튼 식별 이름 (예: "settings_icon", "labs_icon")
+ * @param buttonLocation 버튼이 위치한 UI (선택, 예: "header", "settings_dialog")
  */
-export async function sendError(
-  errorMessage: string,
-  errorLocation: string
+export async function sendButtonClick(
+  buttonName: string,
+  buttonLocation?: string
 ): Promise<void> {
-  await sendGAEvent("error", {
-    error_message: errorMessage,
-    error_location: errorLocation,
+  await sendGAEvent("button_click", {
+    button_name: buttonName,
+    ...(buttonLocation && { button_location: buttonLocation }),
   });
 }

From a3da33f75279bfa72a220384042124b381c03e0c Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:48:40 +0900
Subject: [PATCH 02/30] refactor(app): update GA4 comment to reflect lifecycle
 events

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/App.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/App.tsx b/src/App.tsx
index f7e617d..b0661e3 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -13,7 +13,7 @@ import { debugLog } from "@/utils/logger";
 import "./App.css";
 
 function App() {
-  // Google Analytics: Extension 열릴 때 페이지뷰 전송
+  // GA4: popup mount 시 first_open / session_start / extension_open 자동 전송
   useEffect(() => {
     debugLog(
       "%c여길 열어보시다니...\n이 참에 직접 코드 기여도 해주시는 건 어떤가요?",

From 7cbf159673bd674a33981c504892e02ca194d728 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:48:47 +0900
Subject: [PATCH 03/30] refactor(settings): use auth and settings taxonomy
 events
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- sendButtonClick("google_login") → sendAuthLoginStart("google", ...)
- sendButtonClick("google_logout") → sendAuthLogout(...)
- sendSettingChange("credentials", "saved") → sendSettingsCredentialsSaved()
- sendSettingChange("credentials", "deleted") → sendSettingsCredentialsDeleted()

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/SettingsDialog.tsx | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/src/components/SettingsDialog.tsx b/src/components/SettingsDialog.tsx
index 3826d12..4ad7748 100644
--- a/src/components/SettingsDialog.tsx
+++ b/src/components/SettingsDialog.tsx
@@ -11,7 +11,13 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { Avatar, AvatarImage, AvatarFallback } from "@/components/ui/avatar";
 import { Input } from "@/components/ui/input";
 import { DialogDescription } from "@radix-ui/react-dialog";
-import { sendSettingChange, sendButtonClick } from "@/utils/analytics";
+import {
+  sendButtonClick,
+  sendAuthLoginStart,
+  sendAuthLogout,
+  sendSettingsCredentialsSaved,
+  sendSettingsCredentialsDeleted,
+} from "@/utils/analytics";
 import {
   saveECampusCredentials,
   loadECampusCredentials,
@@ -83,7 +89,7 @@ const ECampusCredential = () => {
       await saveECampusCredentials(savedId, savedPassword);
 
       setHasCredentials(true);
-      sendSettingChange("credentials", "saved");
+      sendSettingsCredentialsSaved();
       toast.success("인증 정보가 저장되었습니다.");
 
       // 2. 로그인 검증 (백그라운드)
@@ -110,7 +116,7 @@ const ECampusCredential = () => {
       setSavedId("");
       setSavedPassword("");
       setHasCredentials(false);
-      sendSettingChange("credentials", "deleted");
+      sendSettingsCredentialsDeleted();
       toast.success("인증 정보가 삭제되었습니다.");
     } catch (error) {
       errorLog("[Settings] Delete credentials error:", error);
@@ -243,7 +249,7 @@ const GoogleOAuthSection = () => {
 
   const handleGoogleLogin = async () => {
     setIsLoading(true);
-    sendButtonClick("google_login", "settings_dialog");
+    sendAuthLoginStart("google", "settings_dialog");
 
     try {
       const result = await startGoogleLogin();
@@ -310,7 +316,7 @@ const GoogleOAuthSection = () => {
   };
 
   const handleLogout = async () => {
-    sendButtonClick("google_logout", "settings_dialog");
+    sendAuthLogout("settings_dialog");
 
     await logout();
     setLoggedIn(false);

From 62c155c9155630d04c25bf1aae2975e2fd63483e Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:49:56 +0900
Subject: [PATCH 04/30] refactor(main-layout): use sendSearchSubmit for header
 search

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/MainLayout.tsx | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/components/MainLayout.tsx b/src/components/MainLayout.tsx
index 8807b01..36c7275 100644
--- a/src/components/MainLayout.tsx
+++ b/src/components/MainLayout.tsx
@@ -6,7 +6,7 @@ import { Input } from "./ui/input";
 import { Search, Settings, FlaskConical } from "lucide-react";
 import SettingsDialog from "./SettingsDialog";
 import LabsDialog from "./LabsDialog";
-import { sendButtonClick, sendGAEvent } from "@/utils/analytics";
+import { sendButtonClick, sendSearchSubmit } from "@/utils/analytics";
 
 const MainLayout = () => {
   return (
@@ -41,10 +41,7 @@ const Header = () => {
             onChange={(e) => setText((e.target as HTMLInputElement).value)}
             onKeyDown={(e) => {
               if (e.key === "Enter") {
-                sendGAEvent("search", {
-                  search_term: text,
-                  search_location: "header"
-                });
+                sendSearchSubmit(text, "header");
                 window.open(
                   `https://search.konkuk.ac.kr/main.do?keyword=${text}`
                 );

From aa3db6ac3bdf778a599b475dd00e9aea8894089a Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:52:37 +0900
Subject: [PATCH 05/30] feat(analytics): add new taxonomy event helpers

Auth: sendAuthLoginSuccess, sendAuthLoginFail,
      sendAuthEmailVerificationStart, sendAuthEmailVerificationSuccess

Template (editor): sendTemplateEditorOpen, sendTemplateItemAdd,
      sendTemplateSaveSuccess/Fail, sendTemplateSyncSuccess/Fail,
      sendTemplatePublishSuccess/Fail, sendTemplateApply

Template (gallery): sendTemplateGalleryOpen, sendTemplateGallerySearch,
      sendTemplateGallerySortChange, sendTemplateCloneSuccess/Fail,
      sendTemplateLikeToggle

Alerts: sendAlertsViewOpen, sendAlertsItemOpen
Todo: sendTodoViewOpen, sendTodoItemCreate, sendTodoItemComplete, sendTodoItemDelete

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/utils/analytics.ts | 357 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 357 insertions(+)

diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index 749af12..3c65275 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -356,3 +356,360 @@ export async function sendButtonClick(
     ...(buttonLocation && { button_location: buttonLocation }),
   });
 }
+
+// ─── Auth (success / fail) ────────────────────────────────────────────────
+
+/**
+ * 로그인 성공 이벤트 전송
+ * @param provider 인증 제공자 (예: "google")
+ * @param isGuest 게스트 계정 여부
+ */
+export async function sendAuthLoginSuccess(
+  provider: string,
+  isGuest: boolean
+): Promise<void> {
+  await sendGAEvent("auth_login_success", {
+    provider,
+    is_guest: isGuest,
+  });
+}
+
+/**
+ * 로그인 실패 이벤트 전송
+ * @param provider 인증 제공자 (예: "google")
+ * @param errorCode 에러 식별 코드
+ * @param errorMessage 사람이 읽는 에러 설명
+ */
+export async function sendAuthLoginFail(
+  provider: string,
+  errorCode: string,
+  errorMessage: string
+): Promise<void> {
+  await sendGAEvent("auth_login_fail", {
+    provider,
+    error_code: errorCode,
+    error_message: errorMessage,
+  });
+}
+
+/**
+ * 이메일 인증 시작 이벤트 전송 (게스트 → 정회원 전환 시작)
+ * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
+ */
+export async function sendAuthEmailVerificationStart(
+  uiLocation: string
+): Promise<void> {
+  await sendGAEvent("auth_email_verification_start", {
+    ui_location: uiLocation,
+  });
+}
+
+/**
+ * 이메일 인증 완료 이벤트 전송 (게스트 → 정회원 전환 완료)
+ * @param domainType 인증된 이메일 도메인 유형 (예: "konkuk.ac.kr")
+ */
+export async function sendAuthEmailVerificationSuccess(
+  domainType: string
+): Promise<void> {
+  await sendGAEvent("auth_email_verification_success", { domain_type: domainType });
+}
+
+// ─── Template ─────────────────────────────────────────────────────────────
+
+/**
+ * 템플릿 에디터 진입 이벤트 전송
+ * @param templateOrigin 템플릿 출처 ("default" | "owned" | "cloned" | "posted" | "local_only")
+ * @param templateId 템플릿 식별자 (선택)
+ */
+export async function sendTemplateEditorOpen(
+  templateOrigin: string,
+  templateId?: number
+): Promise<void> {
+  await sendGAEvent("template_editor_open", {
+    template_origin: templateOrigin,
+    ...(templateId !== undefined && { template_id: templateId }),
+  });
+}
+
+/**
+ * 템플릿 아이템 추가 이벤트 전송
+ * @param addMethod 추가 방식 (예: "drag", "button")
+ * @param templateId 템플릿 식별자 (선택)
+ */
+export async function sendTemplateItemAdd(
+  addMethod: string,
+  templateId?: number
+): Promise<void> {
+  await sendGAEvent("template_item_add", {
+    add_method: addMethod,
+    ...(templateId !== undefined && { template_id: templateId }),
+  });
+}
+
+/**
+ * 템플릿 로컬 저장 성공 이벤트 전송
+ * @param templateId 템플릿 식별자
+ * @param templateOrigin 템플릿 출처
+ * @param itemCount 저장된 아이템 수
+ */
+export async function sendTemplateSaveSuccess(
+  templateId: number,
+  templateOrigin: string,
+  itemCount: number
+): Promise<void> {
+  await sendGAEvent("template_save_success", {
+    template_id: templateId,
+    template_origin: templateOrigin,
+    item_count: itemCount,
+  });
+}
+
+/**
+ * 템플릿 로컬 저장 실패 이벤트 전송
+ * @param templateId 템플릿 식별자
+ * @param errorCode 에러 식별 코드
+ * @param errorMessage 사람이 읽는 에러 설명
+ */
+export async function sendTemplateSaveFail(
+  templateId: number,
+  errorCode: string,
+  errorMessage: string
+): Promise<void> {
+  await sendGAEvent("template_save_fail", {
+    template_id: templateId,
+    error_code: errorCode,
+    error_message: errorMessage,
+  });
+}
+
+/**
+ * 템플릿 서버 동기화 성공 이벤트 전송
+ * @param templateId 템플릿 식별자
+ * @param itemCount 동기화된 아이템 수
+ */
+export async function sendTemplateSyncSuccess(
+  templateId: number,
+  itemCount: number
+): Promise<void> {
+  await sendGAEvent("template_sync_success", {
+    template_id: templateId,
+    item_count: itemCount,
+  });
+}
+
+/**
+ * 템플릿 서버 동기화 실패 이벤트 전송
+ * @param templateId 템플릿 식별자
+ * @param errorCode 에러 식별 코드
+ * @param errorMessage 사람이 읽는 에러 설명
+ */
+export async function sendTemplateSyncFail(
+  templateId: number,
+  errorCode: string,
+  errorMessage: string
+): Promise<void> {
+  await sendGAEvent("template_sync_fail", {
+    template_id: templateId,
+    error_code: errorCode,
+    error_message: errorMessage,
+  });
+}
+
+/**
+ * 템플릿 갤러리 게시 성공 이벤트 전송
+ * @param templateId 템플릿 식별자
+ * @param itemCount 게시된 아이템 수
+ */
+export async function sendTemplatePublishSuccess(
+  templateId: number,
+  itemCount: number
+): Promise<void> {
+  await sendGAEvent("template_publish_success", {
+    template_id: templateId,
+    item_count: itemCount,
+  });
+}
+
+/**
+ * 템플릿 갤러리 게시 실패 이벤트 전송
+ * @param templateId 템플릿 식별자
+ * @param errorCode 에러 식별 코드
+ * @param errorMessage 사람이 읽는 에러 설명
+ */
+export async function sendTemplatePublishFail(
+  templateId: number,
+  errorCode: string,
+  errorMessage: string
+): Promise<void> {
+  await sendGAEvent("template_publish_fail", {
+    template_id: templateId,
+    error_code: errorCode,
+    error_message: errorMessage,
+  });
+}
+
+/**
+ * 템플릿 메인 화면 적용 이벤트 전송 — 핵심 가치 행동
+ * @param templateId 템플릿 식별자
+ * @param templateOrigin 템플릿 출처
+ * @param isDefault 기본 템플릿 여부
+ */
+export async function sendTemplateApply(
+  templateId: number,
+  templateOrigin: string,
+  isDefault: boolean
+): Promise<void> {
+  await sendGAEvent("template_apply", {
+    template_id: templateId,
+    template_origin: templateOrigin,
+    is_default: isDefault,
+  });
+}
+
+// ─── Template Gallery ──────────────────────────────────────────────────────
+
+/**
+ * 템플릿 갤러리 진입 이벤트 전송
+ * @param entryPoint 진입 경로 (예: "settings_dialog", "popup")
+ */
+export async function sendTemplateGalleryOpen(entryPoint: string): Promise<void> {
+  await sendGAEvent("template_gallery_open", { entry_point: entryPoint });
+}
+
+/**
+ * 갤러리 검색 이벤트 전송
+ * @param queryLength 검색어 길이
+ * @param sortOption 현재 정렬 옵션
+ */
+export async function sendTemplateGallerySearch(
+  queryLength: number,
+  sortOption: string
+): Promise<void> {
+  await sendGAEvent("template_gallery_search", {
+    query_length: queryLength,
+    sort_option: sortOption,
+  });
+}
+
+/**
+ * 갤러리 정렬 변경 이벤트 전송
+ * @param sortOption 선택한 정렬 옵션
+ */
+export async function sendTemplateGallerySortChange(sortOption: string): Promise<void> {
+  await sendGAEvent("template_gallery_sort_change", { sort_option: sortOption });
+}
+
+/**
+ * 갤러리 템플릿 복제 성공 이벤트 전송
+ * @param postedTemplateId 게시된 템플릿 식별자
+ * @param authorIdPresent 작성자 ID 포함 여부
+ */
+export async function sendTemplateCloneSuccess(
+  postedTemplateId: number,
+  authorIdPresent: boolean
+): Promise<void> {
+  await sendGAEvent("template_clone_success", {
+    posted_template_id: postedTemplateId,
+    author_id_present: authorIdPresent,
+  });
+}
+
+/**
+ * 갤러리 템플릿 복제 실패 이벤트 전송
+ * @param postedTemplateId 게시된 템플릿 식별자
+ * @param errorCode 에러 식별 코드
+ */
+export async function sendTemplateCloneFail(
+  postedTemplateId: number,
+  errorCode: string
+): Promise<void> {
+  await sendGAEvent("template_clone_fail", {
+    posted_template_id: postedTemplateId,
+    error_code: errorCode,
+  });
+}
+
+/**
+ * 좋아요 토글 이벤트 전송
+ * @param postedTemplateId 게시된 템플릿 식별자
+ * @param liked 좋아요 여부 (true: 좋아요, false: 취소)
+ */
+export async function sendTemplateLikeToggle(
+  postedTemplateId: number,
+  liked: boolean
+): Promise<void> {
+  await sendGAEvent("template_like_toggle", {
+    posted_template_id: postedTemplateId,
+    liked,
+  });
+}
+
+// ─── Alerts ───────────────────────────────────────────────────────────────
+
+/**
+ * 공지사항 탭 진입 이벤트 전송
+ * @param viewMode 현재 보기 모드 (예: "all", "my")
+ * @param category 선택된 카테고리
+ */
+export async function sendAlertsViewOpen(
+  viewMode: string,
+  category: string
+): Promise<void> {
+  await sendGAEvent("alerts_view_open", { view_mode: viewMode, category });
+}
+
+/**
+ * 공지사항 아이템 클릭 이벤트 전송
+ * @param alertId 공지 식별자
+ * @param category 공지 카테고리
+ * @param source 공지 출처 (예: "konkuk", "ecampus")
+ */
+export async function sendAlertsItemOpen(
+  alertId: string | number,
+  category: string,
+  source: string
+): Promise<void> {
+  await sendGAEvent("alerts_item_open", {
+    alert_id: String(alertId),
+    category,
+    source,
+  });
+}
+
+// ─── Todo ─────────────────────────────────────────────────────────────────
+
+/**
+ * Todo 탭 진입 이벤트 전송
+ * @param todoCount 현재 Todo 아이템 수
+ */
+export async function sendTodoViewOpen(todoCount: number): Promise<void> {
+  await sendGAEvent("todo_view_open", { todo_count: todoCount });
+}
+
+/**
+ * Todo 아이템 생성 이벤트 전송
+ * @param source 생성 경로 (예: "dialog")
+ * @param hasDueDate 마감일 설정 여부
+ */
+export async function sendTodoItemCreate(
+  source: string,
+  hasDueDate: boolean
+): Promise<void> {
+  await sendGAEvent("todo_item_create", { source, has_due_date: hasDueDate });
+}
+
+/**
+ * Todo 아이템 완료 토글 이벤트 전송
+ * @param itemType Todo 유형 (예: "custom", "ecampus")
+ */
+export async function sendTodoItemComplete(itemType: string): Promise<void> {
+  await sendGAEvent("todo_item_complete", { item_type: itemType });
+}
+
+/**
+ * Todo 아이템 삭제 이벤트 전송
+ * @param itemType Todo 유형 (예: "custom", "ecampus")
+ */
+export async function sendTodoItemDelete(itemType: string): Promise<void> {
+  await sendGAEvent("todo_item_delete", { item_type: itemType });
+}

From 76a424b26404754d4830912cdd118ada25249f54 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:57:14 +0900
Subject: [PATCH 06/30] feat(template-editor): add template lifecycle GA4
 events
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

EditorHeader: save/sync/publish success+fail events with templateId,
  origin (owned|cloned), itemCount, errorCode, errorMessage
EditorPage: extension_editor_open on mount (origin derived from route params),
  template_item_add on staging→canvas drag
TemplateListPage: template_apply with origin (default|owned|cloned)
  and isDefault flag

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../Editor/EditorHeader/EditorHeader.tsx      | 44 +++++++++++--------
 src/pages/EditorPage.tsx                      | 10 ++++-
 src/pages/TemplateListPage.tsx                |  8 +++-
 3 files changed, 41 insertions(+), 21 deletions(-)

diff --git a/src/components/Editor/EditorHeader/EditorHeader.tsx b/src/components/Editor/EditorHeader/EditorHeader.tsx
index 15d07eb..326ef78 100644
--- a/src/components/Editor/EditorHeader/EditorHeader.tsx
+++ b/src/components/Editor/EditorHeader/EditorHeader.tsx
@@ -19,6 +19,14 @@ import {
 import { getTemplate } from '@/apis/templates';
 import { areTemplatesEqual } from '@/utils/templateUtils';
 import { debugLog, errorLog } from '@/utils/logger';
+import {
+  sendTemplateSaveSuccess,
+  sendTemplateSaveFail,
+  sendTemplateSyncSuccess,
+  sendTemplateSyncFail,
+  sendTemplatePublishSuccess,
+  sendTemplatePublishFail,
+} from '@/utils/analytics';
 
 export const EditorHeader = () => {
   const { state, dispatch } = useEditorContext();
@@ -100,24 +108,18 @@ export const EditorHeader = () => {
 
       dispatch({ type: 'SAVE_SUCCESS', payload: savedTemplate });
 
+      const origin = savedTemplate.cloned ? 'cloned' : 'owned';
+      sendTemplateSaveSuccess(savedTemplate.templateId, origin, savedTemplate.items.length);
+
       toast.success('저장 완료', {
         description: '템플릿이 로컬에 저장되었습니다.',
       });
     } catch (error) {
       errorLog('[EditorHeader] Save failed:', error);
-      dispatch({
-        type: 'SAVE_FAILED',
-        payload:
-          error instanceof Error
-            ? error.message
-            : '저장 중 오류가 발생했습니다.',
-      });
-      toast.error('저장 실패', {
-        description:
-          error instanceof Error
-            ? error.message
-            : '저장 중 오류가 발생했습니다.',
-      });
+      const errMsg = error instanceof Error ? error.message : '저장 중 오류가 발생했습니다.';
+      dispatch({ type: 'SAVE_FAILED', payload: errMsg });
+      sendTemplateSaveFail(state.template.templateId, 'save_error', errMsg);
+      toast.error('저장 실패', { description: errMsg });
     }
   };
 
@@ -145,15 +147,18 @@ export const EditorHeader = () => {
 
     if (result.success && result.data) {
       dispatch({ type: 'SYNC_SUCCESS', payload: result.data });
+      sendTemplateSyncSuccess(
+        state.template.templateId,
+        result.data.items?.length ?? state.template.items.length
+      );
       toast.success('동기화 완료', {
         description: '템플릿이 서버에 동기화되었습니다.',
       });
     } else {
       const errorMsg = result.error || '동기화에 실패했습니다.';
       dispatch({ type: 'SYNC_FAILED', payload: errorMsg });
-      toast.error('동기화 실패', {
-        description: errorMsg,
-      });
+      sendTemplateSyncFail(state.template.templateId, 'sync_failed', errorMsg);
+      toast.error('동기화 실패', { description: errorMsg });
     }
   };
 
@@ -170,13 +175,14 @@ export const EditorHeader = () => {
 
     if (result.success) {
       await loadPostedTemplates();
+      sendTemplatePublishSuccess(state.template.templateId, currentItems.length);
       toast.success('게시 완료', {
         description: '템플릿이 공개 갤러리에 게시되었습니다.',
       });
     } else {
-      toast.error('게시 실패', {
-        description: result.error || '게시에 실패했습니다.',
-      });
+      const errMsg = result.error || '게시에 실패했습니다.';
+      sendTemplatePublishFail(state.template.templateId, 'publish_failed', errMsg);
+      toast.error('게시 실패', { description: errMsg });
     }
   };
 
diff --git a/src/pages/EditorPage.tsx b/src/pages/EditorPage.tsx
index e261697..768deb4 100644
--- a/src/pages/EditorPage.tsx
+++ b/src/pages/EditorPage.tsx
@@ -5,7 +5,7 @@
  */
 
 import { useParams, useSearchParams } from 'react-router-dom';
-import { useState } from 'react';
+import { useState, useEffect } from 'react';
 import { DndContext, DragEndEvent, DragStartEvent, DragOverlay, PointerSensor, useSensor, useSensors } from '@dnd-kit/core';
 import { EditorProvider } from '@/contexts/EditorContext';
 import { useEditorContext } from '@/hooks/useEditorContext';
@@ -17,6 +17,7 @@ import { DragOverlayPreview } from '@/components/Editor/EditorCanvas/DragOverlay
 import { gridToPixelPosition, pixelToGridPosition, clampToGridBounds, resolveCollisions } from '@/utils/template';
 import { toast } from 'sonner';
 import type { TemplateItem } from '@/types/api';
+import { sendTemplateEditorOpen, sendTemplateItemAdd } from '@/utils/analytics';
 
 /**
  * Drag item data for DragOverlay
@@ -68,6 +69,7 @@ const EditorContent = () => {
       if (over && over.id === 'canvas-area') {
         const itemId = parseInt(draggedId.replace('staging-', ''));
         dispatch({ type: 'MOVE_TO_CANVAS', payload: itemId });
+        sendTemplateItemAdd('drag', state.template?.templateId);
       }
       return;
     }
@@ -188,6 +190,12 @@ export const EditorPage = () => {
   const [searchParams] = useSearchParams();
   const startFrom = searchParams.get('from') as 'default' | 'empty' | null;
 
+  useEffect(() => {
+    const origin = templateId ? 'owned' : startFrom === 'default' ? 'default' : 'local_only';
+    sendTemplateEditorOpen(origin, templateId ? parseInt(templateId) : undefined);
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
   return (
     <EditorProvider
       templateId={templateId ? parseInt(templateId) : undefined}
diff --git a/src/pages/TemplateListPage.tsx b/src/pages/TemplateListPage.tsx
index 97f1b9e..ffb0d14 100644
--- a/src/pages/TemplateListPage.tsx
+++ b/src/pages/TemplateListPage.tsx
@@ -35,6 +35,7 @@ import { areItemsEqual } from '@/utils/templateUtils';
 import { LinkList } from '@/constants/LinkList';
 import { isLoggedIn } from '@/utils/oauth';
 import { warnLog, errorLog } from '@/utils/logger';
+import { sendTemplateApply } from '@/utils/analytics';
 
 export const TemplateListPage = () => {
   const navigate = useNavigate();
@@ -307,7 +308,12 @@ export const TemplateListPage = () => {
       const targetId = templateId === 0 ? null : templateId;
       await selectTemplate(targetId);
 
-      const message = templateId === 0
+      const isDefault = templateId === 0;
+      const isCloned = clonedTemplates.some((t) => t.templateId === templateId);
+      const origin = isDefault ? 'default' : isCloned ? 'cloned' : 'owned';
+      sendTemplateApply(templateId, origin, isDefault);
+
+      const message = isDefault
         ? '기본 템플릿이 적용되었습니다.'
         : `"${templateName}" 템플릿이 메인 화면에 적용되었습니다.`;
 

From 89697a9f8939bca8c045822ad5015db99e257eab Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:58:19 +0900
Subject: [PATCH 07/30] feat(auth): add login/verification result GA4 events

SettingsDialog: auth_login_success (with is_guest flag) and
  auth_login_fail (error_code: login_failed | exception) after
  startGoogleLogin resolves
EmailVerificationDialog: auth_email_verification_start when dialog
  opens, auth_email_verification_success after verifyEmailCode succeeds

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/EmailVerificationDialog.tsx | 9 ++++++++-
 src/components/SettingsDialog.tsx          | 7 +++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/src/components/EmailVerificationDialog.tsx b/src/components/EmailVerificationDialog.tsx
index 805da7d..13a0aa5 100644
--- a/src/components/EmailVerificationDialog.tsx
+++ b/src/components/EmailVerificationDialog.tsx
@@ -3,7 +3,7 @@
  * 건국대 이메일 인증 다이얼로그
  */
 
-import { useState } from 'react';
+import { useState, useEffect } from 'react';
 import { toast } from 'sonner';
 import { Mail, ArrowLeft, Loader2 } from 'lucide-react';
 import {
@@ -22,6 +22,7 @@ import {
   validateAuthCode,
 } from '@/utils/formValidation';
 import { errorLog } from '@/utils/logger';
+import { sendAuthEmailVerificationStart, sendAuthEmailVerificationSuccess } from '@/utils/analytics';
 
 interface EmailVerificationDialogProps {
   open: boolean;
@@ -43,6 +44,11 @@ export function EmailVerificationDialog({
   const [authCode, setAuthCode] = useState('');
   const [isLoading, setIsLoading] = useState(false);
 
+  // 다이얼로그가 열릴 때 인증 시작 이벤트 전송
+  useEffect(() => {
+    if (open) sendAuthEmailVerificationStart('settings_dialog');
+  }, [open]);
+
   // Full email address
   const kuMail = emailId ? `${emailId}${EMAIL_DOMAIN}` : '';
 
@@ -102,6 +108,7 @@ export function EmailVerificationDialog({
         toast.success('이메일 인증이 완료되었습니다!');
         // Store verified email
         await chrome.storage.local.set({ kuMail });
+        sendAuthEmailVerificationSuccess('konkuk.ac.kr');
         // Trigger re-login to get member token
         onVerificationComplete();
         handleClose();
diff --git a/src/components/SettingsDialog.tsx b/src/components/SettingsDialog.tsx
index 4ad7748..8599d6b 100644
--- a/src/components/SettingsDialog.tsx
+++ b/src/components/SettingsDialog.tsx
@@ -14,6 +14,8 @@ import { DialogDescription } from "@radix-ui/react-dialog";
 import {
   sendButtonClick,
   sendAuthLoginStart,
+  sendAuthLoginSuccess,
+  sendAuthLoginFail,
   sendAuthLogout,
   sendSettingsCredentialsSaved,
   sendSettingsCredentialsDeleted,
@@ -260,21 +262,26 @@ const GoogleOAuthSection = () => {
         // Check if this is a guest (requires signup)
         if (result.response.requiresSignup) {
           setIsGuest(true);
+          sendAuthLoginSuccess("google", true);
           // Auto-open email verification dialog for guests
           setShowEmailVerification(true);
           toast.info("건국대 이메일 인증이 필요합니다.");
         } else {
           setIsGuest(false);
           setUserProfile(result.response.profile);
+          sendAuthLoginSuccess("google", false);
           toast.success("로그인 성공!");
         }
       } else {
+        sendAuthLoginFail("google", "login_failed", result.error || "알 수 없는 오류");
         toast.error("로그인 실패", {
           description: result.error,
         });
       }
     } catch (error) {
       errorLog("Login error:", error);
+      const errMsg = error instanceof Error ? error.message : "로그인 중 오류가 발생했습니다.";
+      sendAuthLoginFail("google", "exception", errMsg);
       toast.error("오류", {
         description: "로그인 중 오류가 발생했습니다.",
       });

From 42f51af66c632e34e98e58b5d330691a9fed93ab Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 14:59:34 +0900
Subject: [PATCH 08/30] feat(alerts): add alerts GA4 events

Alerts: alerts_view_open on mount (viewMode, category resolved from storage)
AlertItem: alerts_item_open on click (alertId, category, source: general|department)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/Tabs/Alerts/AlertItem.tsx | 9 ++++++---
 src/components/Tabs/Alerts/Alerts.tsx    | 5 +++++
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/src/components/Tabs/Alerts/AlertItem.tsx b/src/components/Tabs/Alerts/AlertItem.tsx
index df8b9c1..038c9ba 100644
--- a/src/components/Tabs/Alerts/AlertItem.tsx
+++ b/src/components/Tabs/Alerts/AlertItem.tsx
@@ -1,6 +1,7 @@
 import type { Alert, AlertCategory } from "@/types/api";
 import { ExternalLink, Calendar } from "lucide-react";
 import { cn } from "@/lib/utils";
+import { sendAlertsItemOpen } from "@/utils/analytics";
 
 interface AlertItemProps {
   alert: Alert;
@@ -39,9 +40,11 @@ const AlertItem = ({ alert }: AlertItemProps) => {
   };
 
   const handleClick = () => {
-    if (alert.url) {
-      window.open(alert.url, "_blank");
-    }
+    if (!alert.url) return;
+    const category = "category" in alert ? String(alert.category) : "department";
+    const source = "department" in alert ? "department" : "general";
+    sendAlertsItemOpen(alert.alertId, category, source);
+    window.open(alert.url, "_blank");
   };
 
   const isClickable = Boolean(alert.url);
diff --git a/src/components/Tabs/Alerts/Alerts.tsx b/src/components/Tabs/Alerts/Alerts.tsx
index aa0a95b..cd99103 100644
--- a/src/components/Tabs/Alerts/Alerts.tsx
+++ b/src/components/Tabs/Alerts/Alerts.tsx
@@ -9,6 +9,7 @@ import AlertFilter from "./AlertFilter";
 import MyAlertsView from "./MyAlertsView";
 import { Badge } from "@/components/ui/badge";
 import { errorLog } from '@/utils/logger';
+import { sendAlertsViewOpen } from '@/utils/analytics';
 
 type AlertViewMode = "all" | "my";
 
@@ -85,6 +86,10 @@ const Alerts = () => {
       }
 
       setIsInitialized(true);
+
+      const resolvedViewMode = (savedViewMode === "my" && !loginStatus) ? "all" : (savedViewMode || "all");
+      const resolvedCategory = savedCategory || "전체";
+      sendAlertsViewOpen(resolvedViewMode, resolvedCategory);
     };
     initialize();
   }, []);

From 34657e515c4d07013d3e400230160a333e885ccf Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 15:02:36 +0900
Subject: [PATCH 09/30] feat(todo): add todo GA4 events
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

TodoList: todo_view_open after initial load (1회, useRef guard),
  todo_item_complete and todo_item_delete on custom todo actions
TodoAddDialog: todo_item_create after addCustomTodo succeeds
  (source: "dialog", has_due_date: always true by form validation)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/Tabs/TodoList/TodoAddDialog.tsx |  2 ++
 src/components/Tabs/TodoList/TodoList.tsx      | 14 ++++++++++++--
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/src/components/Tabs/TodoList/TodoAddDialog.tsx b/src/components/Tabs/TodoList/TodoAddDialog.tsx
index a1aac40..c33b6fb 100644
--- a/src/components/Tabs/TodoList/TodoAddDialog.tsx
+++ b/src/components/Tabs/TodoList/TodoAddDialog.tsx
@@ -12,6 +12,7 @@ import { DialogDescription } from "@radix-ui/react-dialog";
 import { addCustomTodo } from "@/utils/todo/customTodo";
 import { toast } from "sonner";
 import { errorLog } from '@/utils/logger';
+import { sendTodoItemCreate } from '@/utils/analytics';
 
 interface TodoAddDialogProps {
   open: boolean;
@@ -56,6 +57,7 @@ const TodoAddDialog = ({ open, onOpenChange, onSuccess }: TodoAddDialogProps) =>
         dueTime,
         subject.trim() || undefined
       );
+      sendTodoItemCreate("dialog", Boolean(dueDate));
       toast.success("할 일이 추가되었습니다.");
 
       // 폼 초기화
diff --git a/src/components/Tabs/TodoList/TodoList.tsx b/src/components/Tabs/TodoList/TodoList.tsx
index 9d349b9..59d396b 100644
--- a/src/components/Tabs/TodoList/TodoList.tsx
+++ b/src/components/Tabs/TodoList/TodoList.tsx
@@ -1,4 +1,4 @@
-import { useState, useEffect, useCallback, useMemo } from "react";
+import { useState, useEffect, useCallback, useMemo, useRef } from "react";
 import {
   eCampusTodoListAPI,
   eCampusGoLectureAPI,
@@ -22,6 +22,7 @@ import { ArrowUpDown } from "lucide-react";
 import { toast } from "sonner";
 import KUGoodjob from "@/assets/KU_goodjob.png";
 import { errorLog } from '@/utils/logger';
+import { sendTodoViewOpen, sendTodoItemComplete, sendTodoItemDelete } from '@/utils/analytics';
 
 type SortMethod = 'dday-asc' | 'dday-desc';
 
@@ -44,6 +45,7 @@ function parseDDay(dDay: string): number {
 }
 
 const TodoList = () => {
+  const viewOpenSentRef = useRef(false);
   const [isLoading, setIsLoading] = useState(true);
   const [ecampusTodos, setECampusTodos] = useState<ECampusTodoItem[]>([]);
   const [customTodos, setCustomTodos] = useState<TodoItemType[]>([]);
@@ -164,14 +166,20 @@ const TodoList = () => {
       setShowLoginModal(true);
     } finally {
       setIsLoading(false);
+      // 탭 진입 이벤트는 최초 로드 완료 시 1회만 전송
+      if (!viewOpenSentRef.current) {
+        viewOpenSentRef.current = true;
+        sendTodoViewOpen(allTodos.length);
+      }
     }
-  }, [fetchTodoList, tryLoginWithSavedCredentials, loadCustomTodos]);
+  }, [fetchTodoList, tryLoginWithSavedCredentials, loadCustomTodos, allTodos.length]);
 
   // 초기 로드 시 Todo 목록 가져오기
   useEffect(() => {
     loadTodoList();
   }, [loadTodoList]);
 
+
   // 정렬 방식 불러오기
   useEffect(() => {
     const loadSortMethod = async () => {
@@ -197,6 +205,7 @@ const TodoList = () => {
     try {
       await toggleCustomTodo(id);
       await loadCustomTodos();
+      sendTodoItemComplete("custom");
     } catch (error) {
       errorLog("Failed to toggle todo:", error);
       toast.error("상태 변경에 실패했습니다.");
@@ -208,6 +217,7 @@ const TodoList = () => {
     try {
       await deleteCustomTodo(id);
       await loadCustomTodos();
+      sendTodoItemDelete("custom");
       toast.success("할 일이 삭제되었습니다.");
     } catch (error) {
       errorLog("Failed to delete todo:", error);

From 4bacea8c852555644cb6892ddc222dfcdbb06ed2 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 15:05:35 +0900
Subject: [PATCH 10/30] feat(gallery): add gallery GA4 events

- template_gallery_open on mount (entry_point: "popup")
- template_gallery_search on debounced query (query_length, sort_option)
- template_gallery_sort_change on sort dropdown select
- template_clone_success (posted_template_id, author_id_present) after clone
- template_clone_fail (posted_template_id, error_code) on error
- template_like_toggle (posted_template_id, liked) after like resolves

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/pages/GalleryPage.tsx | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/src/pages/GalleryPage.tsx b/src/pages/GalleryPage.tsx
index d5ad2e2..4c0e4e4 100644
--- a/src/pages/GalleryPage.tsx
+++ b/src/pages/GalleryPage.tsx
@@ -22,6 +22,14 @@ import { Button } from '@/components/ui/button';
 import { useToast } from '@/components/ui/use-toast';
 import { isLoggedIn } from '@/utils/oauth';
 import { errorLog } from '@/utils/logger';
+import {
+  sendTemplateGalleryOpen,
+  sendTemplateGallerySearch,
+  sendTemplateGallerySortChange,
+  sendTemplateCloneSuccess,
+  sendTemplateCloneFail,
+  sendTemplateLikeToggle,
+} from '@/utils/analytics';
 
 type SortOption = 'newest' | 'oldest' | 'most-liked' | 'most-used';
 
@@ -56,6 +64,11 @@ export const GalleryPage = () => {
   const searchTimeoutRef = useRef<NodeJS.Timeout | null>(null);
   const cloneInProgressRef = useRef<number | null>(null);
 
+  // GA4: 갤러리 진입 이벤트 (mount 1회)
+  useEffect(() => {
+    sendTemplateGalleryOpen('popup');
+  }, []);
+
   // Check login status
   useEffect(() => {
     const checkAuth = async () => {
@@ -82,6 +95,9 @@ export const GalleryPage = () => {
 
     searchTimeoutRef.current = setTimeout(() => {
       setDebouncedQuery(searchQuery);
+      if (searchQuery.trim()) {
+        sendTemplateGallerySearch(searchQuery.trim().length, sort);
+      }
     }, 300);
 
     return () => {
@@ -244,7 +260,7 @@ export const GalleryPage = () => {
               : t
           )
         );
-
+        sendTemplateCloneSuccess(id, Boolean(template.ownerId));
         toast({
           title: '복제 완료',
           description: `"${template.name}" 템플릿이 내 템플릿에 추가되었습니다.`,
@@ -254,6 +270,7 @@ export const GalleryPage = () => {
       }
     } catch (error) {
       errorLog('Failed to clone template:', error);
+      sendTemplateCloneFail(id, error instanceof Error ? error.message : 'clone_failed');
       toast({
         title: '복제 실패',
         description: error instanceof Error ? error.message : '템플릿 복제에 실패했습니다.',
@@ -290,6 +307,7 @@ export const GalleryPage = () => {
               : t
           )
         );
+        sendTemplateLikeToggle(template.postedTemplateId, result.data.isLiked);
       } else {
         throw new Error(result.error?.message || '좋아요 처리에 실패했습니다.');
       }
@@ -350,7 +368,10 @@ export const GalleryPage = () => {
             {SORT_OPTIONS.map((option) => (
               <DropdownMenuItem
                 key={option.value}
-                onClick={() => setSort(option.value)}
+                onClick={() => {
+                  setSort(option.value);
+                  sendTemplateGallerySortChange(option.value);
+                }}
                 className={sort === option.value ? 'bg-accent' : ''}
               >
                 {option.label}

From 982e1fc3ed062d2ba59b74e8791423d2f4eeabf5 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 15:17:56 +0900
Subject: [PATCH 11/30] fix(analytics): connect missing sendTemplateItemAdd and
 sendSystemError call sites
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

ItemPropertiesPanel: sendTemplateItemAdd('button', templateItemId) in
  handleMoveToCanvas — covers the button path alongside the existing drag path
App: connect sendSystemError to ErrorBoundary onError so uncaught React
  errors are reported as system_error events (error_code: react_error_boundary)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/App.tsx                                                 | 6 +++++-
 .../Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx      | 2 ++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/App.tsx b/src/App.tsx
index b0661e3..652af73 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -8,7 +8,7 @@ import { Outlet } from "react-router-dom";
 import { ErrorBoundary } from "react-error-boundary";
 import { Toaster } from "./components/ui/sonner";
 import { PostedTemplatesProvider } from "./contexts/PostedTemplatesContext";
-import { sendExtensionOpen } from "./utils/analytics";
+import { sendExtensionOpen, sendSystemError } from "./utils/analytics";
 import { debugLog } from "@/utils/logger";
 import "./App.css";
 
@@ -25,6 +25,10 @@ function App() {
 
   return (
     <ErrorBoundary
+      onError={(error: unknown) => {
+        const msg = error instanceof Error ? error.message : String(error);
+        sendSystemError("react_error_boundary", msg, "popup_home");
+      }}
       fallback={
         <div className="w-[500px] h-[600px] flex items-center justify-center p-8">
           <div className="text-center space-y-4">
diff --git a/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx b/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
index 794ebcb..c874c32 100644
--- a/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
+++ b/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
@@ -16,6 +16,7 @@ import { validateLinkForm } from '@/utils/formValidation';
 import { IconGrid } from '@/components/Editor/shared/IconGrid';
 import type { TemplateIcon, TemplateItem } from '@/types/api';
 import { InputGroup } from '@/components/Editor/shared/InputGroup';
+import { sendTemplateItemAdd } from '@/utils/analytics';
 
 export const ItemPropertiesPanel = () => {
   const { state, dispatch } = useEditorContext();
@@ -156,6 +157,7 @@ const ItemPropertiesPanelForm = ({
   const handleMoveToCanvas = () => {
     if (!isFromStaging) return;
     dispatch({ type: 'MOVE_TO_CANVAS', payload: selectedItem.templateItemId });
+    sendTemplateItemAdd('button', selectedItem.templateItemId);
     toast.success('아이템이 캔버스에 추가되었습니다.');
   };
 

From 166e38f89704659eec06ad0672716f5c4ab30025 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 17:57:44 +0900
Subject: [PATCH 12/30] fix(gallery): include sort in search debounce effect
 deps
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

'sort'를 useEffect 의존성에 추가해 stale 클로저로 인한 잘못된
sort_option 전송 방지 및 eslint exhaustive-deps 경고 제거.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/pages/GalleryPage.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pages/GalleryPage.tsx b/src/pages/GalleryPage.tsx
index 4c0e4e4..e5dd66d 100644
--- a/src/pages/GalleryPage.tsx
+++ b/src/pages/GalleryPage.tsx
@@ -105,7 +105,7 @@ export const GalleryPage = () => {
         clearTimeout(searchTimeoutRef.current);
       }
     };
-  }, [searchQuery]);
+  }, [searchQuery, sort]);
 
   // Load templates
   const loadTemplates = useCallback(async (pageNum: number, reset: boolean = false) => {

From 7601a521341c34df89c674abcc1d85fe8d9d198a Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 17:58:35 +0900
Subject: [PATCH 13/30] fix(todo): isolate view_open analytics from fetch loop
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

sendTodoViewOpen 전송을 별도 useEffect로 분리해 loadTodoList의
useCallback deps에서 allTodos.length를 제거함. 기존 구조에서는
setECampusTodos → allTodos 변경 → loadTodoList 재계산 → useEffect
재실행으로 eCampus API가 불필요하게 재호출되는 문제가 있었음.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/Tabs/TodoList/TodoList.tsx | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/src/components/Tabs/TodoList/TodoList.tsx b/src/components/Tabs/TodoList/TodoList.tsx
index 59d396b..015a8ab 100644
--- a/src/components/Tabs/TodoList/TodoList.tsx
+++ b/src/components/Tabs/TodoList/TodoList.tsx
@@ -166,19 +166,21 @@ const TodoList = () => {
       setShowLoginModal(true);
     } finally {
       setIsLoading(false);
-      // 탭 진입 이벤트는 최초 로드 완료 시 1회만 전송
-      if (!viewOpenSentRef.current) {
-        viewOpenSentRef.current = true;
-        sendTodoViewOpen(allTodos.length);
-      }
     }
-  }, [fetchTodoList, tryLoginWithSavedCredentials, loadCustomTodos, allTodos.length]);
+  }, [fetchTodoList, tryLoginWithSavedCredentials, loadCustomTodos]);
 
   // 초기 로드 시 Todo 목록 가져오기
   useEffect(() => {
     loadTodoList();
   }, [loadTodoList]);
 
+  // 탭 진입 이벤트 — 로딩 완료 후 1회만 전송
+  useEffect(() => {
+    if (!isLoading && !viewOpenSentRef.current) {
+      viewOpenSentRef.current = true;
+      sendTodoViewOpen(ecampusTodos.length + customTodos.length);
+    }
+  }, [isLoading, ecampusTodos.length, customTodos.length]);
 
   // 정렬 방식 불러오기
   useEffect(() => {

From ed7c9cc4f710f464a975a39775caf00e4a9e90fe Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 17:58:58 +0900
Subject: [PATCH 14/30] fix(alerts): classify department alerts by category
 whitelist
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

standardCategories 집합으로 category 필드를 검사해 학과명이 들어온
경우를 학과 공지(source=department)로 정확히 분류함. 기존에는
department 필드 유무만 확인해 category에 학과명이 들어온 형태를
general로 잘못 보고했음.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/Tabs/Alerts/AlertItem.tsx | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/components/Tabs/Alerts/AlertItem.tsx b/src/components/Tabs/Alerts/AlertItem.tsx
index 038c9ba..be6a8b3 100644
--- a/src/components/Tabs/Alerts/AlertItem.tsx
+++ b/src/components/Tabs/Alerts/AlertItem.tsx
@@ -41,8 +41,14 @@ const AlertItem = ({ alert }: AlertItemProps) => {
 
   const handleClick = () => {
     if (!alert.url) return;
-    const category = "category" in alert ? String(alert.category) : "department";
-    const source = "department" in alert ? "department" : "general";
+    // category 필드가 표준 카테고리 외 값(학과명)이면 학과 공지로 분류
+    const isDept =
+      "department" in alert ||
+      ("category" in alert && !standardCategories.has(alert.category));
+    const source = isDept ? "department" : "general";
+    const category = isDept
+      ? ("category" in alert ? String(alert.category) : alert.department.name)
+      : String(alert.category);
     sendAlertsItemOpen(alert.alertId, category, source);
     window.open(alert.url, "_blank");
   };

From 47e25f1bc49c9110d3ed3e1da780470cd60efc6e Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 17:59:40 +0900
Subject: [PATCH 15/30] refactor(analytics): align cloneFail with other fail
 helpers
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

sendTemplateCloneFail에 errorMessage 선택 파라미터를 추가해
sendTemplateSaveFail, sendTemplateSyncFail 등 다른 fail 헬퍼와
시그니처를 통일함. 호출부에서 error.message를 errorCode로 넘기던
잘못된 패턴도 수정.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/pages/GalleryPage.tsx | 2 +-
 src/utils/analytics.ts    | 5 ++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/pages/GalleryPage.tsx b/src/pages/GalleryPage.tsx
index e5dd66d..5dff075 100644
--- a/src/pages/GalleryPage.tsx
+++ b/src/pages/GalleryPage.tsx
@@ -270,7 +270,7 @@ export const GalleryPage = () => {
       }
     } catch (error) {
       errorLog('Failed to clone template:', error);
-      sendTemplateCloneFail(id, error instanceof Error ? error.message : 'clone_failed');
+      sendTemplateCloneFail(id, 'clone_failed', error instanceof Error ? error.message : undefined);
       toast({
         title: '복제 실패',
         description: error instanceof Error ? error.message : '템플릿 복제에 실패했습니다.',
diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index 3c65275..2007bd2 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -618,14 +618,17 @@ export async function sendTemplateCloneSuccess(
  * 갤러리 템플릿 복제 실패 이벤트 전송
  * @param postedTemplateId 게시된 템플릿 식별자
  * @param errorCode 에러 식별 코드
+ * @param errorMessage 사람이 읽는 에러 설명 (선택)
  */
 export async function sendTemplateCloneFail(
   postedTemplateId: number,
-  errorCode: string
+  errorCode: string,
+  errorMessage?: string
 ): Promise<void> {
   await sendGAEvent("template_clone_fail", {
     posted_template_id: postedTemplateId,
     error_code: errorCode,
+    ...(errorMessage && { error_message: errorMessage }),
   });
 }
 

From aec831222f0623c16d355c9c23fa90b8a9ef5632 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 18:12:32 +0900
Subject: [PATCH 16/30] refactor(analytics): remove sendGAEvent export and
 improve inline comments
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

taxonomy 강제를 위해 sendGAEvent의 export를 제거함. 모든 이벤트 정의는
이 파일 안에서만 이루어지므로 외부에서 직접 호출할 이유가 없음.

모듈 상단 JSDoc에 설계 원칙·도메인 헬퍼 목록·전송 흐름 추가.
getOrCreateSessionId, sendGAEvent, sendExtensionOpen 세 함수에
비자명한 동작(세션 fallback 부작용, engagement_time_msec 이유,
lifecycle 이벤트 배열 누적 조건)에 대한 인라인 주석 추가.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/utils/analytics.ts | 56 +++++++++++++++++++++++++++++++++---------
 1 file changed, 44 insertions(+), 12 deletions(-)

diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index 2007bd2..b77843e 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -1,9 +1,34 @@
 /**
  * Google Analytics 4 Measurement Protocol for Chrome Extension
- * Manifest V3 호환 - CSP 제약 없이 Analytics 사용
+ * Manifest V3 호환 — CSP 제약 없이 직접 fetch로 이벤트를 전송한다.
  *
- * 이벤트 네이밍은 GA4-Data-Taxonomy.md 기준을 따른다.
- * 전송 흐름: 각 헬퍼 → sendGAEvent → GA4 MP endpoint (fetch)
+ * ## 설계 원칙
+ * 이벤트 네이밍과 파라미터는 GA4-Data-Taxonomy.md 기준을 따른다.
+ * 모든 이벤트 정의는 이 파일 안에서만 이루어지며, 호출 지점(call site)은
+ * 아래 도메인 헬퍼만 import해서 사용한다. sendGAEvent를 외부에서 직접
+ * 호출하면 taxonomy 강제(naming enforcement)가 깨지므로 export하지 않는다.
+ *
+ * ## 도메인 헬퍼 목록
+ * - Lifecycle  : sendExtensionOpen
+ * - Navigation : sendNavigationTabSelect
+ * - Search     : sendSearchSubmit
+ * - Link       : sendLinkOpen
+ * - Auth       : sendAuthLoginStart, sendAuthLoginSuccess, sendAuthLoginFail,
+ *                sendAuthLogout, sendAuthEmailVerificationStart/Success
+ * - Settings   : sendSettingsCredentialsSaved, sendSettingsCredentialsDeleted
+ * - Template   : sendTemplateEditorOpen, sendTemplateItemAdd,
+ *                sendTemplateSaveSuccess/Fail, sendTemplateSyncSuccess/Fail,
+ *                sendTemplatePublishSuccess/Fail, sendTemplateApply
+ * - Gallery    : sendTemplateGalleryOpen, sendTemplateGallerySearch,
+ *                sendTemplateGallerySortChange, sendTemplateCloneSuccess/Fail,
+ *                sendTemplateLikeToggle
+ * - Alerts     : sendAlertsViewOpen, sendAlertsItemOpen
+ * - Todo       : sendTodoViewOpen, sendTodoItemCreate,
+ *                sendTodoItemComplete, sendTodoItemDelete
+ * - Generic    : sendButtonClick (header 버튼 등 별도 이벤트가 없는 범용 클릭)
+ *
+ * ## 전송 흐름
+ * 각 헬퍼 → sendGAEvent (internal) → GA4 MP endpoint (fetch)
  */
 
 import { getOrCreateClientId } from "./clientId";
@@ -51,6 +76,7 @@ async function getOrCreateSessionId(): Promise<SessionResult> {
     const sessionTimestamp = await getStorage<number>("sessionTimestamp");
     const now = Date.now();
 
+    // 세션이 존재하고 30분 이내라면 타임스탬프만 갱신해 세션 유지
     if (sessionId && sessionTimestamp) {
       const timeSinceLastActivity = now - sessionTimestamp;
       if (timeSinceLastActivity < SESSION_TIMEOUT_MS) {
@@ -59,6 +85,7 @@ async function getOrCreateSessionId(): Promise<SessionResult> {
       }
     }
 
+    // 세션 없음 또는 타임아웃 → 새 세션 생성
     const newSessionId = now.toString();
     await setStorage({ sessionId: newSessionId, sessionTimestamp: now });
 
@@ -68,6 +95,7 @@ async function getOrCreateSessionId(): Promise<SessionResult> {
 
     return { sessionId: newSessionId, isNewSession: true };
   } catch (error) {
+    // storage 접근 실패 시 fallback — 이 세션은 저장되지 않아 다음 호출에서도 새 세션으로 취급됨
     errorLog("[GA] Error getting/creating session ID:", error);
     return { sessionId: Date.now().toString(), isNewSession: false };
   }
@@ -76,15 +104,15 @@ async function getOrCreateSessionId(): Promise<SessionResult> {
 // ─── Base sender ──────────────────────────────────────────────────────────
 
 /**
- * Google Analytics 이벤트 전송 (내부 베이스 함수)
+ * GA4 MP 이벤트 전송 — 모든 도메인 헬퍼의 내부 베이스 함수
  *
- * 모든 도메인 헬퍼가 이 함수를 통해 GA4 MP로 이벤트를 전송한다.
+ * 이 함수는 파일 외부에 export되지 않는다. 호출 지점에서는 도메인 헬퍼만 사용할 것.
  * API Secret이 없거나 fetch 실패 시 에러를 throw하지 않고 로그만 남긴다.
  *
  * @param eventName 이벤트 이름 (최대 40자, 영문/숫자/언더스코어)
  * @param eventParams 이벤트 파라미터 객체
  */
-export async function sendGAEvent(
+async function sendGAEvent(
   eventName: string,
   eventParams: Record<string, GAEventParam> = {}
 ): Promise<void> {
@@ -109,8 +137,8 @@ export async function sendGAEvent(
           name: eventName,
           params: {
             session_id: sessionId,
-            engagement_time_msec: 100, // GA4 권장 최솟값
-            ...(DEBUG_MODE && { debug_mode: 1 }), // DebugView 활성화
+            engagement_time_msec: 100, // GA4 세션 참여도 집계를 위한 권장 최솟값
+            ...(DEBUG_MODE && { debug_mode: 1 }), // GA4 DebugView에서 실시간 확인용
             ...eventParams,
           },
         },
@@ -133,6 +161,7 @@ export async function sendGAEvent(
       debugLog("[GA] Payload:", JSON.stringify(payload, null, 2));
       debugLog("[GA] Response status:", response.status, response.statusText);
 
+      // debug endpoint는 응답 본문에 검증 결과를 포함하므로 파싱해서 출력
       if (response.ok) {
         const debugResponse = await response.json();
         debugLog("[GA] Debug response:", debugResponse);
@@ -177,6 +206,7 @@ export async function sendExtensionOpen(
     const clientId = await getOrCreateClientId();
     const { sessionId, isNewSession } = await getOrCreateSessionId();
 
+    // 모든 lifecycle 이벤트에 공통으로 붙는 파라미터
     const baseParams: Record<string, GAEventParam> = {
       session_id: sessionId,
       engagement_time_msec: 100,
@@ -188,8 +218,10 @@ export async function sendExtensionOpen(
     const endpoint = DEBUG_MODE ? GA_DEBUG_ENDPOINT : GA_ENDPOINT;
     const url = `${endpoint}?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`;
 
+    // 전송할 이벤트를 조건에 따라 배열로 누적 — GA4 MP는 단일 요청에 이벤트 배열 지원
     const events: { name: string; params: Record<string, GAEventParam> }[] = [];
 
+    // 기기 최초 설치 후 첫 실행에만 1회 전송 (chrome.storage에 플래그 영구 저장)
     const firstOpenSent = await getStorage<boolean>("firstOpenSent");
     if (!firstOpenSent) {
       events.push({ name: "extension_first_open", params: baseParams });
@@ -197,11 +229,13 @@ export async function sendExtensionOpen(
       if (DEBUG_MODE) debugLog("[GA] extension_first_open queued");
     }
 
+    // 30분 비활동 후 새 세션이 생성된 경우에만 전송
     if (isNewSession) {
       events.push({ name: "extension_session_start", params: baseParams });
       if (DEBUG_MODE) debugLog("[GA] extension_session_start queued");
     }
 
+    // 팝업 열릴 때마다 항상 전송
     events.push({ name: "extension_open", params: baseParams });
 
     const payload = { client_id: clientId, events };
@@ -341,8 +375,8 @@ export async function sendSystemError(
 /**
  * 버튼 클릭 이벤트 전송
  *
- * taxonomy 관점에서 제품 의미가 큰 버튼은 개별 이벤트(sendAuthLoginStart 등)로 승격하고,
- * 당장 별도 이벤트가 없는 header 버튼 등 범용 클릭에만 사용한다.
+ * 제품 의미가 큰 버튼은 개별 이벤트(sendAuthLoginStart 등)로 승격하고,
+ * 별도 이벤트가 없는 header 버튼 등 범용 클릭에만 사용한다.
  *
  * @param buttonName 버튼 식별 이름 (예: "settings_icon", "labs_icon")
  * @param buttonLocation 버튼이 위치한 UI (선택, 예: "header", "settings_dialog")
@@ -357,8 +391,6 @@ export async function sendButtonClick(
   });
 }
 
-// ─── Auth (success / fail) ────────────────────────────────────────────────
-
 /**
  * 로그인 성공 이벤트 전송
  * @param provider 인증 제공자 (예: "google")

From 2ad373d5826386f888a02ea352d2ec96e97c65ca Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Mon, 27 Apr 2026 19:03:36 +0900
Subject: [PATCH 17/30] fix(analytics): route all events to production endpoint
 for DebugView
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

/debug/mp/collect는 페이로드 유효성 검증만 하고 GA4에 기록하지 않아
DebugView에 이벤트가 나타나지 않는 문제가 있었음.

DebugView 표시는 엔드포인트가 아닌 debug_mode: 1 파라미터로 제어되므로
항상 /mp/collect(production endpoint)로 전송하도록 수정함.
GA_DEBUG_ENDPOINT 상수도 함께 제거.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/utils/analytics.ts | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index b77843e..da816f4 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -39,7 +39,6 @@ import { debugLog, warnLog, errorLog } from "@/utils/logger";
 type GAEventParam = string | number | boolean;
 
 const GA_ENDPOINT = "https://www.google-analytics.com/mp/collect";
-const GA_DEBUG_ENDPOINT = "https://www.google-analytics.com/debug/mp/collect";
 const MEASUREMENT_ID = "G-ECMY8N9FX4";
 
 /** 빌드 시 .env에서 주입 */
@@ -145,10 +144,8 @@ async function sendGAEvent(
       ],
     };
 
-    const endpoint = DEBUG_MODE ? GA_DEBUG_ENDPOINT : GA_ENDPOINT;
-
     const response = await fetch(
-      `${endpoint}?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`,
+      `${GA_ENDPOINT}?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`,
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -215,8 +212,7 @@ export async function sendExtensionOpen(
       ...(DEBUG_MODE && { debug_mode: 1 }),
     };
 
-    const endpoint = DEBUG_MODE ? GA_DEBUG_ENDPOINT : GA_ENDPOINT;
-    const url = `${endpoint}?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`;
+    const url = `${GA_ENDPOINT}?measurement_id=${MEASUREMENT_ID}&api_secret=${API_SECRET}`;
 
     // 전송할 이벤트를 조건에 따라 배열로 누적 — GA4 MP는 단일 요청에 이벤트 배열 지원
     const events: { name: string; params: Record<string, GAEventParam> }[] = [];

From 666cfb6e053f15744ef23cde3c9d06d9e56120e4 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 02:56:32 +0900
Subject: [PATCH 18/30] docs(taxonomy): sync GA4-Data-Taxonomy with current
 implementation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

모든 이벤트 상태를 '신규 제안' 대신 '구현됨' / '미구현'으로 명확히 표기.
주요 변경사항:
- 구현된 이벤트 전체를 '구현됨'으로 업데이트
- template_clone_fail 파라미터에 error_message? 추가 반영
- navigation_tab_select에서 ui_location 미전송 명시
- button_click을 Core Product Events에 추가
- 'Current Event Mapping'을 'Migration History'로 대체
  (구 이벤트는 이미 모두 제거됐으므로 이력 표로 정리)
- MVP Recommendation 표에 상태 컬럼 추가
- Identity Model에 DebugView 동작 방식 설명 추가

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/GA4-Data-Taxonomy.md | 215 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 215 insertions(+)
 create mode 100644 docs/GA4-Data-Taxonomy.md

diff --git a/docs/GA4-Data-Taxonomy.md b/docs/GA4-Data-Taxonomy.md
new file mode 100644
index 0000000..821ae99
--- /dev/null
+++ b/docs/GA4-Data-Taxonomy.md
@@ -0,0 +1,215 @@
+# GA4 Data Taxonomy
+
+이 문서는 LinKU의 Chrome Extension 환경에서 `GA4 Measurement Protocol`만 사용해
+기본적인 제품 분석과 retention 분석을 가능하게 하기 위한 이벤트 taxonomy다.
+
+모든 이벤트는 `src/utils/analytics.ts`의 도메인 헬퍼를 통해 전송된다.
+이 문서는 "무엇을 왜 측정할 것인가"와 **현재 구현 상태**를 함께 정의한다.
+
+## Goals
+
+| 목표 | 분석 질문 | 핵심 지표 |
+| --- | --- | --- |
+| Retention 파악 | 사용자가 설치/첫 사용 후 다시 돌아오는가 | first-open cohort retention, weekly returning users |
+| 핵심 가치 행동 파악 | 어떤 행동이 LinKU의 핵심 가치를 보여주는가 | link click rate, template apply rate, alert/todo usage |
+| 기능 채택 파악 | 사용자가 어떤 기능을 실제로 쓰는가 | feature adoption by domain |
+| 템플릿 기능 성과 파악 | 템플릿 생성/저장/동기화/게시 흐름이 잘 작동하는가 | editor conversion funnel |
+| 계정 연동 파악 | 로그인/이메일 인증이 사용성에 어떤 영향을 주는가 | login start -> success, guest -> verified |
+
+## Principles
+
+| 원칙 | 설명 |
+| --- | --- |
+| MP-only | `gtag.js` 없이 Measurement Protocol만 유지한다 |
+| 제품 중심 naming | GA4 자동 이벤트 흉내보다 LinKU 제품 행위를 이름으로 정의한다 |
+| Low-cardinality first | 리포트와 Explore에서 바로 쓰기 쉽도록 고정된 enum 파라미터를 우선 사용한다 |
+| One action, one event | 버튼 클릭 자체보다 제품 의미가 있는 행동을 우선 이벤트로 올린다 |
+| Outcome + context | 이벤트 이름은 행동, 파라미터는 맥락으로 설계한다 |
+| Single module | 모든 이벤트 정의는 `analytics.ts` 안에서만 이루어진다. 호출 지점은 도메인 헬퍼만 import한다 |
+
+## Identity Model
+
+| 항목 | 정책 |
+| --- | --- |
+| User key | `client_id`를 기기/브라우저 단위 식별자로 사용 |
+| Session key | 30분 inactivity 기준 `session_id` 사용 |
+| Logged-in identity | 당장은 별도 `user_id` 없이 유지, 필요 시 추후 회원 ID 해시 검토 |
+| Environment | `VITE_ENVIRONMENT=development` 일 때 `debug_mode: 1` 파라미터 포함, production endpoint로 전송해 GA4 DebugView에서 확인 |
+
+## Recommended Event Naming
+
+| Prefix | 용도 | 예시 |
+| --- | --- | --- |
+| `extension_` | 확장 프로그램 lifecycle | `extension_first_open` |
+| `navigation_` | 화면/탭/진입 | `navigation_tab_select` |
+| `link_` | 핵심 링크 사용 | `link_open` |
+| `template_` | 템플릿 생성/편집/배포 | `template_publish_success` |
+| `auth_` | 로그인/인증 | `auth_login_success` |
+| `alerts_` | 공지 기능 | `alerts_item_open` |
+| `todo_` | Todo 기능 | `todo_item_create` |
+| `labs_` | Labs 기능 | `labs_feature_use` |
+| `settings_` | 설정 변경 | `settings_credentials_saved` |
+| `system_` | 오류/상태 | `system_error` |
+
+## Global Parameters
+
+아래 파라미터는 가능한 한 여러 이벤트에서 공통적으로 재사용한다.
+
+| Param | 타입 | 설명 | 예시 |
+| --- | --- | --- | --- |
+| `screen_name` | string | 현재 화면/페이지 | `popup_home`, `template_editor` |
+| `entry_point` | string | 진입 경로 | `popup`, `settings_dialog`, `gallery_page` |
+| `feature_area` | string | 상위 기능 영역 | `links`, `templates`, `alerts`, `todo`, `labs`, `auth` |
+| `ui_location` | string | UI 내 위치 | `header`, `tab_bar`, `card_action`, `dialog` |
+| `template_id` | number | 템플릿 식별자 | `12345` |
+| `template_origin` | string | 템플릿 출처 | `default`, `owned`, `cloned`, `posted`, `local_only` |
+| `result` | string | 성공/실패/취소 | `success`, `fail`, `cancel` |
+| `error_code` | string | 실패 코드 | `network_error`, `auth_required` |
+| `error_message` | string | 사람이 읽는 에러 설명 | `sync_failed` |
+| `is_logged_in` | boolean | 로그인 상태 | `true` |
+| `is_guest` | boolean | 게스트 회원 여부 | `false` |
+
+> **구현 상태 표기**
+> - `구현됨` — `analytics.ts`에 헬퍼 함수가 존재하고 call site에 연결됨
+> - `미구현` — taxonomy에 정의됐으나 아직 헬퍼/call site 없음
+
+## Lifecycle Events
+
+Retention과 기본 활성 사용자 분석을 위해 가장 먼저 도입해야 할 이벤트군이다.
+`sendExtensionOpen(screenName, entryPoint)` 한 번 호출로 아래 세 이벤트를 자동 처리한다.
+
+| Event Name | 상태 | 목적 | Trigger | 주요 Params | 우선순위 |
+| --- | --- | --- | --- | --- | --- |
+| `extension_first_open` | 구현됨 | 첫 사용 cohort 정의 | `firstOpenSent` 플래그 없을 때 1회 | `screen_name`, `entry_point` | P0 |
+| `extension_session_start` | 구현됨 | 재방문/세션 기준 정의 | 30분 초과로 새 `session_id` 생성 시 | `screen_name`, `entry_point` | P0 |
+| `extension_open` | 구현됨 | 실제 사용 시작 기록 | popup mount 시 매번 | `screen_name`, `entry_point` | P0 |
+| `extension_close` | 미구현 | 세션 종료 추정 보조 | popup unload/visibility 종료 시 가능하면 | `screen_name` | P2 |
+
+## Core Product Events
+
+LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측정하기 위한 이벤트다.
+
+| Event Name | 상태 | 목적 | 주요 Params | 비고 |
+| --- | --- | --- | --- | --- |
+| `navigation_tab_select` | 구현됨 | 어떤 탭이 실제로 사용되는지 | `tab_name`, `feature_area?` | `ui_location`은 미전송 |
+| `search_submit` | 구현됨 | 검색 기능 사용률 측정 | `search_term`, `search_location?` | |
+| `link_open` | 구현됨 | LinKU 핵심 가치 행동 | `link_name`, `link_url`, `link_group?`, `same_host_variant?` | same-host 버튼은 `samehost_primary` / `samehost_secondary`로 구분 |
+| `banner_open` | 미구현 | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | |
+| `button_click` | 구현됨 | 범용 버튼 클릭 (header 등) | `button_name`, `button_location?` | 제품 의미가 큰 버튼은 개별 이벤트로 승격, header 잡버튼에만 사용 |
+
+## Account / Auth Events
+
+| Event Name | 상태 | 목적 | 주요 Params | 우선순위 |
+| --- | --- | --- | --- | --- |
+| `auth_login_start` | 구현됨 | 로그인 의도 파악 | `provider`, `ui_location` | P1 |
+| `auth_login_success` | 구현됨 | 실제 로그인 성공률 측정 | `provider`, `is_guest` | P1 |
+| `auth_login_fail` | 구현됨 | 로그인 장애 파악 | `provider`, `error_code`, `error_message` | P1 |
+| `auth_logout` | 구현됨 | 로그아웃 행동 파악 | `ui_location` | P2 |
+| `auth_email_verification_start` | 구현됨 | 게스트 → 회원 전환 시작점 | `ui_location` | P1 |
+| `auth_email_verification_success` | 구현됨 | 회원 전환 완료 | `domain_type` | P1 |
+
+## Template Events
+
+템플릿 기능은 LinKU의 차별화 기능이라 별도 도메인으로 관리한다.
+
+| Event Name | 상태 | 목적 | 주요 Params | 우선순위 |
+| --- | --- | --- | --- | --- |
+| `template_editor_open` | 구현됨 | 에디터 진입률 측정 | `template_origin`, `template_id?` | P1 |
+| `template_create_start` | 미구현 | 새 템플릿 생성 진입 | `template_origin`=`default\|empty` | P1 |
+| `template_name_edit` | 미구현 | 에디터 사용성 파악 | `template_id` | P3 |
+| `template_item_add` | 구현됨 | 에디터 내 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | P1 |
+| `template_item_update` | 미구현 | 링크/아이콘/속성 수정 | `update_type`, `template_id` | P2 |
+| `template_item_delete` | 미구현 | 아이템 삭제 행위 | `delete_source`, `template_id` | P2 |
+| `template_save_success` | 구현됨 | 로컬 저장 완료 | `template_id`, `template_origin`, `item_count` | P0 |
+| `template_save_fail` | 구현됨 | 저장 실패 원인 파악 | `template_id`, `error_code`, `error_message` | P1 |
+| `template_sync_success` | 구현됨 | 서버 동기화 성공 | `template_id`, `item_count` | P0 |
+| `template_sync_fail` | 구현됨 | 동기화 실패 | `template_id`, `error_code`, `error_message` | P1 |
+| `template_publish_success` | 구현됨 | 갤러리 게시 성공 | `template_id`, `item_count` | P0 |
+| `template_publish_fail` | 구현됨 | 게시 실패 | `template_id`, `error_code`, `error_message` | P1 |
+| `template_apply` | 구현됨 | 실제 메인 화면 적용 행동 | `template_id`, `template_origin`, `is_default` | P0 |
+| `template_delete` | 미구현 | 템플릿 삭제 | `template_id`, `template_origin`, `sync_status` | P2 |
+| `template_gallery_open` | 구현됨 | 갤러리 진입 | `entry_point` | P1 |
+| `template_gallery_search` | 구현됨 | 갤러리 검색 사용 | `query_length`, `sort_option` | P2 |
+| `template_gallery_sort_change` | 구현됨 | 정렬 변경 | `sort_option` | P3 |
+| `template_clone_success` | 구현됨 | 공개 템플릿 복제 성공 | `posted_template_id`, `author_id_present` | P1 |
+| `template_clone_fail` | 구현됨 | 복제 실패 | `posted_template_id`, `error_code`, `error_message?` | P2 |
+| `template_like_toggle` | 구현됨 | 좋아요 사용 | `posted_template_id`, `liked` | P2 |
+
+## Alerts / Todo / Labs Events
+
+기본 수준의 크롬 확장 프로그램 분석을 위해 보조 기능도 최소한의 adoption 이벤트는 남겨야 한다.
+
+| Event Name | 상태 | 목적 | 주요 Params | 우선순위 |
+| --- | --- | --- | --- | --- |
+| `alerts_view_open` | 구현됨 | 공지 탭 사용 여부 | `view_mode`(`all`\|`my`), `category` | P2 |
+| `alerts_item_open` | 구현됨 | 공지 클릭률 | `alert_id`, `category`, `source`(`general`\|`department`) | P2 |
+| `alerts_subscription_change` | 미구현 | 개인화 기능 사용 | `category`, `result` | P3 |
+| `todo_view_open` | 구현됨 | Todo 기능 사용 여부 | `todo_count` | P2 |
+| `todo_item_create` | 구현됨 | Todo 입력 | `source`, `has_due_date` | P2 |
+| `todo_item_complete` | 구현됨 | Todo 완료율 | `item_type`(`custom`\|`ecampus`) | P2 |
+| `todo_item_delete` | 구현됨 | Todo 삭제 | `item_type`(`custom`\|`ecampus`) | P3 |
+| `labs_view_open` | 미구현 | Labs 진입 | `feature_name` | P3 |
+| `labs_feature_use` | 미구현 | Labs 세부 기능 사용 | `feature_name`, `result` | P3 |
+
+## Settings / System Events
+
+| Event Name | 상태 | 목적 | 주요 Params | 우선순위 |
+| --- | --- | --- | --- | --- |
+| `settings_open` | 미구현 | 설정 진입 측정 | `entry_point` | P2 |
+| `settings_credentials_saved` | 구현됨 | eCampus 계정 저장 | `result`=`success` | P1 |
+| `settings_credentials_deleted` | 구현됨 | eCampus 계정 삭제 | `result`=`success` | P2 |
+| `system_error` | 구현됨 | runtime 오류 집계 | `error_code`, `error_message`, `screen_name?` | P1 |
+
+## Migration History
+
+구 이벤트에서 현재 taxonomy로의 전환 이력이다. 구 이벤트는 모두 제거됐다.
+
+| 구 이벤트 | 대체된 이벤트 |
+| --- | --- |
+| `page_view` | `extension_open` (+ `extension_first_open`, `extension_session_start` 자동 처리) |
+| `search` | `search_submit` |
+| `tab_change` | `navigation_tab_select` |
+| `link_click` | `link_open` |
+| `setting_change` | `settings_credentials_saved`, `settings_credentials_deleted` |
+| `error` | `system_error` |
+| `button_click("google_login")` | `auth_login_start` + `auth_login_success` / `auth_login_fail` |
+| `button_click("google_logout")` | `auth_logout` |
+
+## MVP Recommendation
+
+가장 먼저 붙일 이벤트 묶음이다. 이 정도면 GA4 Explore에서 기본 retention과 핵심 사용 흐름을 볼 수 있다.
+
+| 순위 | 이벤트 | 상태 |
+| --- | --- | --- |
+| P0 | `extension_first_open` | 구현됨 |
+| P0 | `extension_session_start` | 구현됨 |
+| P0 | `extension_open` | 구현됨 |
+| P0 | `link_open` | 구현됨 |
+| P0 | `template_save_success` | 구현됨 |
+| P0 | `template_sync_success` | 구현됨 |
+| P0 | `template_publish_success` | 구현됨 |
+| P0 | `template_apply` | 구현됨 |
+| P1 | `auth_login_start` | 구현됨 |
+| P1 | `auth_login_success` | 구현됨 |
+| P1 | `auth_email_verification_success` | 구현됨 |
+| P1 | `template_editor_open` | 구현됨 |
+| P1 | `template_item_add` | 구현됨 |
+| P1 | `system_error` | 구현됨 |
+
+## Suggested Explore Reports
+
+| 리포트 | 포함 이벤트 |
+| --- | --- |
+| First-open retention cohort | `extension_first_open` → `extension_open` |
+| Session-based return cohort | `extension_session_start` |
+| Core action retention | `extension_first_open` cohort + `link_open` return condition |
+| Template funnel | `template_editor_open` → `template_item_add` → `template_save_success` → `template_sync_success` → `template_publish_success` |
+| Auth funnel | `auth_login_start` → `auth_login_success` → `auth_email_verification_success` |
+
+## Non-Goals
+
+| 항목 | 이유 |
+| --- | --- |
+| 모든 버튼을 다 추적 | 분석 가치보다 cardinality와 유지보수 비용이 큼 |
+| GA4 자동 이벤트 완전 복제 | MP-only에서는 비용 대비 효과가 낮음 |
+| 처음부터 모든 기능 100% 추적 | retention과 핵심 가치 행동부터 붙이는 편이 낫다 |

From d428c9f91941c0679feee0841a8c24bdc2f5e4c9 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:08:11 +0900
Subject: [PATCH 19/30] docs(taxonomy): remove extension_close from lifecycle
 events
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

MV3에서 popup close 시 async fetch 신뢰성 문제로 수집 불가.
세션 종료 추정은 session_id 30분 타임아웃으로 충분하며
정의된 Explore Reports에서도 사용처가 없어 제거.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/GA4-Data-Taxonomy.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/GA4-Data-Taxonomy.md b/docs/GA4-Data-Taxonomy.md
index 821ae99..cccd643 100644
--- a/docs/GA4-Data-Taxonomy.md
+++ b/docs/GA4-Data-Taxonomy.md
@@ -83,7 +83,6 @@ Retention과 기본 활성 사용자 분석을 위해 가장 먼저 도입해야
 | `extension_first_open` | 구현됨 | 첫 사용 cohort 정의 | `firstOpenSent` 플래그 없을 때 1회 | `screen_name`, `entry_point` | P0 |
 | `extension_session_start` | 구현됨 | 재방문/세션 기준 정의 | 30분 초과로 새 `session_id` 생성 시 | `screen_name`, `entry_point` | P0 |
 | `extension_open` | 구현됨 | 실제 사용 시작 기록 | popup mount 시 매번 | `screen_name`, `entry_point` | P0 |
-| `extension_close` | 미구현 | 세션 종료 추정 보조 | popup unload/visibility 종료 시 가능하면 | `screen_name` | P2 |
 
 ## Core Product Events
 

From 897efb177647b5e52112f3d20a84b89ba76d19d9 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:19:35 +0900
Subject: [PATCH 20/30] fix(analytics): remove response.json() call on
 production endpoint
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

/mp/collect는 204 No Content를 반환하므로 response.json() 호출 시
SyntaxError가 throw되어 catch 블록으로 빠지면서 실제 전송은 성공했음에도
[GA] Error sending event 로그가 찍히는 문제 수정.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/utils/analytics.ts | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index da816f4..813965f 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -156,16 +156,8 @@ async function sendGAEvent(
     if (DEBUG_MODE) {
       debugLog("[GA] Event sent:", eventName, eventParams);
       debugLog("[GA] Payload:", JSON.stringify(payload, null, 2));
+      // production endpoint(/mp/collect)는 204 No Content를 반환하므로 response.json() 호출 불가
       debugLog("[GA] Response status:", response.status, response.statusText);
-
-      // debug endpoint는 응답 본문에 검증 결과를 포함하므로 파싱해서 출력
-      if (response.ok) {
-        const debugResponse = await response.json();
-        debugLog("[GA] Debug response:", debugResponse);
-      } else {
-        const errorText = await response.text();
-        errorLog("[GA] Response error:", errorText);
-      }
     }
   } catch (error) {
     errorLog("[GA] Error sending event:", error);
@@ -245,7 +237,6 @@ export async function sendExtensionOpen(
     if (DEBUG_MODE) {
       debugLog("[GA] Lifecycle events sent:", events.map((e) => e.name));
       debugLog("[GA] Response status:", response.status, response.statusText);
-      if (response.ok) debugLog("[GA] Debug response:", await response.json());
     }
   } catch (error) {
     errorLog("[GA] Error sending lifecycle events:", error);

From cae17c64c10d0fd8bdb456fe1af12cdb6e637e45 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:42:33 +0900
Subject: [PATCH 21/30] feat(analytics): add remaining taxonomy event helpers
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

미구현 상태였던 이벤트들의 헬퍼 함수 추가:
- template_create_start, template_name_edit, template_item_update,
  template_item_delete, template_delete
- settings_open
- banner_open
- alerts_subscription_change
- labs_view_open, labs_feature_use

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/utils/analytics.ts | 138 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 135 insertions(+), 3 deletions(-)

diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index 813965f..9c1ee04 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -16,15 +16,19 @@
  * - Auth       : sendAuthLoginStart, sendAuthLoginSuccess, sendAuthLoginFail,
  *                sendAuthLogout, sendAuthEmailVerificationStart/Success
  * - Settings   : sendSettingsCredentialsSaved, sendSettingsCredentialsDeleted
- * - Template   : sendTemplateEditorOpen, sendTemplateItemAdd,
+ * - Template   : sendTemplateEditorOpen, sendTemplateCreateStart,
+ *                sendTemplateNameEdit, sendTemplateItemAdd,
+ *                sendTemplateItemUpdate, sendTemplateItemDelete,
  *                sendTemplateSaveSuccess/Fail, sendTemplateSyncSuccess/Fail,
- *                sendTemplatePublishSuccess/Fail, sendTemplateApply
+ *                sendTemplatePublishSuccess/Fail, sendTemplateApply, sendTemplateDelete
  * - Gallery    : sendTemplateGalleryOpen, sendTemplateGallerySearch,
  *                sendTemplateGallerySortChange, sendTemplateCloneSuccess/Fail,
  *                sendTemplateLikeToggle
- * - Alerts     : sendAlertsViewOpen, sendAlertsItemOpen
+ * - Banner     : sendBannerOpen
+ * - Alerts     : sendAlertsViewOpen, sendAlertsItemOpen, sendAlertsSubscriptionChange
  * - Todo       : sendTodoViewOpen, sendTodoItemCreate,
  *                sendTodoItemComplete, sendTodoItemDelete
+ * - Labs       : sendLabsViewOpen, sendLabsFeatureUse
  * - Generic    : sendButtonClick (header 버튼 등 별도 이벤트가 없는 범용 클릭)
  *
  * ## 전송 흐름
@@ -327,6 +331,14 @@ export async function sendAuthLogout(uiLocation: string): Promise<void> {
 
 // ─── Settings ─────────────────────────────────────────────────────────────
 
+/**
+ * 설정 다이얼로그 진입 이벤트 전송
+ * @param entryPoint 진입 경로 (예: "header")
+ */
+export async function sendSettingsOpen(entryPoint: string): Promise<void> {
+  await sendGAEvent("settings_open", { entry_point: entryPoint });
+}
+
 /** eCampus 인증정보 저장 완료 이벤트 전송 */
 export async function sendSettingsCredentialsSaved(): Promise<void> {
   await sendGAEvent("settings_credentials_saved", { result: "success" });
@@ -567,6 +579,74 @@ export async function sendTemplatePublishFail(
   });
 }
 
+/**
+ * 새 템플릿 만들기 진입 이벤트 전송
+ * @param templateOrigin 생성 출처 ("default" | "empty")
+ */
+export async function sendTemplateCreateStart(templateOrigin: string): Promise<void> {
+  await sendGAEvent("template_create_start", { template_origin: templateOrigin });
+}
+
+/**
+ * 템플릿 이름 편집 이벤트 전송
+ *
+ * 매 keystroke가 아닌 타이핑 정지 후(debounce) 호출해야 한다.
+ * @param templateId 편집 중인 템플릿 식별자 (선택)
+ */
+export async function sendTemplateNameEdit(templateId?: number): Promise<void> {
+  await sendGAEvent("template_name_edit", {
+    ...(templateId !== undefined && { template_id: templateId }),
+  });
+}
+
+/**
+ * 템플릿 아이템 속성 저장 이벤트 전송
+ * @param updateType 업데이트 유형 (예: "properties")
+ * @param templateId 템플릿 식별자 (선택)
+ */
+export async function sendTemplateItemUpdate(
+  updateType: string,
+  templateId?: number
+): Promise<void> {
+  await sendGAEvent("template_item_update", {
+    update_type: updateType,
+    ...(templateId !== undefined && { template_id: templateId }),
+  });
+}
+
+/**
+ * 템플릿 아이템 삭제 이벤트 전송
+ * @param deleteSource 삭제 경로 ("canvas" = 임시저장으로 이동, "staging" = 영구 삭제)
+ * @param templateId 템플릿 식별자 (선택)
+ */
+export async function sendTemplateItemDelete(
+  deleteSource: string,
+  templateId?: number
+): Promise<void> {
+  await sendGAEvent("template_item_delete", {
+    delete_source: deleteSource,
+    ...(templateId !== undefined && { template_id: templateId }),
+  });
+}
+
+/**
+ * 템플릿 삭제 이벤트 전송
+ * @param templateId 템플릿 식별자
+ * @param templateOrigin 템플릿 출처 ("owned" | "cloned")
+ * @param syncStatus 동기화 상태 ("local" | "synced")
+ */
+export async function sendTemplateDelete(
+  templateId: number,
+  templateOrigin: string,
+  syncStatus: string
+): Promise<void> {
+  await sendGAEvent("template_delete", {
+    template_id: templateId,
+    template_origin: templateOrigin,
+    sync_status: syncStatus,
+  });
+}
+
 /**
  * 템플릿 메인 화면 적용 이벤트 전송 — 핵심 가치 행동
  * @param templateId 템플릿 식별자
@@ -680,6 +760,24 @@ export async function sendAlertsViewOpen(
   await sendGAEvent("alerts_view_open", { view_mode: viewMode, category });
 }
 
+/**
+ * 배너 클릭 이벤트 전송
+ * @param bannerId 배너 식별자 (이미지 파일명)
+ * @param bannerTitle 배너 제목 (alt 텍스트)
+ * @param bannerPosition 배너 위치 (슬라이드 인덱스, 0-based)
+ */
+export async function sendBannerOpen(
+  bannerId: string,
+  bannerTitle: string,
+  bannerPosition: number
+): Promise<void> {
+  await sendGAEvent("banner_open", {
+    banner_id: bannerId,
+    banner_title: bannerTitle,
+    banner_position: bannerPosition,
+  });
+}
+
 /**
  * 공지사항 아이템 클릭 이벤트 전송
  * @param alertId 공지 식별자
@@ -698,6 +796,18 @@ export async function sendAlertsItemOpen(
   });
 }
 
+/**
+ * 학과 구독 변경 이벤트 전송
+ * @param category 구독 변경된 학과명
+ * @param result 변경 결과 ("subscribe" | "unsubscribe")
+ */
+export async function sendAlertsSubscriptionChange(
+  category: string,
+  result: string
+): Promise<void> {
+  await sendGAEvent("alerts_subscription_change", { category, result });
+}
+
 // ─── Todo ─────────────────────────────────────────────────────────────────
 
 /**
@@ -735,3 +845,25 @@ export async function sendTodoItemComplete(itemType: string): Promise<void> {
 export async function sendTodoItemDelete(itemType: string): Promise<void> {
   await sendGAEvent("todo_item_delete", { item_type: itemType });
 }
+
+// ─── Labs ─────────────────────────────────────────────────────────────────
+
+/** Labs 다이얼로그 진입 이벤트 전송 */
+export async function sendLabsViewOpen(): Promise<void> {
+  await sendGAEvent("labs_view_open", {});
+}
+
+/**
+ * Labs 개별 기능 사용 이벤트 전송
+ * @param featureName 사용한 기능 식별자 (예: "qr_generator", "library_seat")
+ * @param result 결과 (선택, 예: "success", "fail")
+ */
+export async function sendLabsFeatureUse(
+  featureName: string,
+  result?: string
+): Promise<void> {
+  await sendGAEvent("labs_feature_use", {
+    feature_name: featureName,
+    ...(result && { result }),
+  });
+}

From 3917fda413d481ccf5a95b0626808c1825c71797 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:44:50 +0900
Subject: [PATCH 22/30] feat(analytics): connect banner, settings_open,
 template create/delete events
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- banner_open: ImageCarousel 배너 클릭 시 img/alt/position 전송
- settings_open: MainLayout 설정 아이콘 클릭 시 전송
- template_create_start: 기본/빈 템플릿 생성 진입 시 origin 구분 전송
- template_delete: 로컬/서버 삭제 성공 후 origin·sync_status 전송

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/MainLayout.tsx         |  3 ++-
 src/components/Tabs/ImageCarousel.tsx | 10 +++++++---
 src/pages/TemplateListPage.tsx        | 10 +++++++++-
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/src/components/MainLayout.tsx b/src/components/MainLayout.tsx
index 36c7275..ffccfdb 100644
--- a/src/components/MainLayout.tsx
+++ b/src/components/MainLayout.tsx
@@ -6,7 +6,7 @@ import { Input } from "./ui/input";
 import { Search, Settings, FlaskConical } from "lucide-react";
 import SettingsDialog from "./SettingsDialog";
 import LabsDialog from "./LabsDialog";
-import { sendButtonClick, sendSearchSubmit } from "@/utils/analytics";
+import { sendButtonClick, sendSearchSubmit, sendSettingsOpen } from "@/utils/analytics";
 
 const MainLayout = () => {
   return (
@@ -62,6 +62,7 @@ const Header = () => {
             className="w-5 h-5 text-gray-600 cursor-pointer"
             onClick={() => {
               sendButtonClick("settings_icon", "header");
+              sendSettingsOpen("header");
               setShowSettings(true);
             }}
           />
diff --git a/src/components/Tabs/ImageCarousel.tsx b/src/components/Tabs/ImageCarousel.tsx
index 7748499..a9a8177 100644
--- a/src/components/Tabs/ImageCarousel.tsx
+++ b/src/components/Tabs/ImageCarousel.tsx
@@ -4,6 +4,7 @@ import Autoplay from "embla-carousel-autoplay";
 import { ChevronLeft, ChevronRight } from "lucide-react";
 import { BannerItemType, getBannersAPI } from "@/apis";
 import { IMAGE_URL } from "@/constants/URL";
+import { sendBannerOpen } from "@/utils/analytics";
 
 const bannerPromise = getBannersAPI();
 
@@ -48,7 +49,7 @@ const ImageCarousel = () => {
       <div className="overflow-hidden" ref={emblaRef}>
         <div className="embla__container flex">
           {imageList.map((item, idx) => (
-            <Image key={idx} item={item} />
+            <Image key={idx} item={item} position={idx} />
           ))}
         </div>
       </div>
@@ -83,13 +84,16 @@ const ImageCarousel = () => {
   );
 };
 
-const Image = ({ item }: { item: BannerItemType }) => {
+const Image = ({ item, position }: { item: BannerItemType; position: number }) => {
   return (
     <div className="embla__slide flex-[0_0_100%] min-w-0">
       <img
         src={`${IMAGE_URL}/banners/${item.img}`}
         alt={item.alt}
-        onClick={() => window.open(item.link)}
+        onClick={() => {
+          sendBannerOpen(item.img, item.alt, position);
+          window.open(item.link);
+        }}
         className="w-full h-full object-cover cursor-pointer"
       />
     </div>
diff --git a/src/pages/TemplateListPage.tsx b/src/pages/TemplateListPage.tsx
index ffb0d14..3419b54 100644
--- a/src/pages/TemplateListPage.tsx
+++ b/src/pages/TemplateListPage.tsx
@@ -35,7 +35,7 @@ import { areItemsEqual } from '@/utils/templateUtils';
 import { LinkList } from '@/constants/LinkList';
 import { isLoggedIn } from '@/utils/oauth';
 import { warnLog, errorLog } from '@/utils/logger';
-import { sendTemplateApply } from '@/utils/analytics';
+import { sendTemplateApply, sendTemplateCreateStart, sendTemplateDelete } from '@/utils/analytics';
 
 export const TemplateListPage = () => {
   const navigate = useNavigate();
@@ -291,10 +291,12 @@ export const TemplateListPage = () => {
   }, [activeTab, userLoggedIn, postedTemplates.length, loadPostedTemplates]);
 
   const handleCreateFromDefault = () => {
+    sendTemplateCreateStart('default');
     navigate('/editor?from=default');
   };
 
   const handleCreateEmpty = () => {
+    sendTemplateCreateStart('empty');
     navigate('/editor?from=empty');
   };
 
@@ -345,6 +347,9 @@ export const TemplateListPage = () => {
       if (syncStatus === 'local') {
         deleteTemplateFromLocalStorage(templateId);
 
+        const origin = clonedTemplates.some(t => t.templateId === templateId) ? 'cloned' : 'owned';
+        sendTemplateDelete(templateId, origin, 'local');
+
         toast({
           title: '삭제 완료',
           description: '로컬 템플릿이 삭제되었습니다.',
@@ -368,6 +373,9 @@ export const TemplateListPage = () => {
         // Also delete from localStorage if exists
         deleteTemplateFromLocalStorage(templateId);
 
+        const origin = clonedTemplates.some(t => t.templateId === templateId) ? 'cloned' : 'owned';
+        sendTemplateDelete(templateId, origin, 'synced');
+
         toast({
           title: '삭제 완료',
           description: '템플릿이 서버와 로컬에서 삭제되었습니다.',

From 89f5e883c4188139908cb016de28c1b3cb501994 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:46:01 +0900
Subject: [PATCH 23/30] feat(analytics): connect template editor item events
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- template_name_edit: 1초 debounce 후 전송 (keystroke 과다 방지)
- template_item_update: 아이템 속성 저장 성공 시 전송
- template_item_delete: 영구삭제(staging) / 캔버스→임시저장(canvas) 구분 전송

templateId를 ItemPropertiesPanelForm props로 추가해 이벤트 맥락 제공.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/Editor/EditorHeader/EditorHeader.tsx       | 8 ++++++++
 .../Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx    | 8 +++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/src/components/Editor/EditorHeader/EditorHeader.tsx b/src/components/Editor/EditorHeader/EditorHeader.tsx
index 326ef78..4c901d9 100644
--- a/src/components/Editor/EditorHeader/EditorHeader.tsx
+++ b/src/components/Editor/EditorHeader/EditorHeader.tsx
@@ -2,6 +2,7 @@
  * Editor Header - Top bar with template name, save, and publish controls
  */
 
+import { useRef } from 'react';
 import { useEditorContext } from '@/hooks/useEditorContext';
 import { Input } from '@/components/ui/input';
 import { SaveButton } from './SaveButton';
@@ -26,6 +27,7 @@ import {
   sendTemplateSyncFail,
   sendTemplatePublishSuccess,
   sendTemplatePublishFail,
+  sendTemplateNameEdit,
 } from '@/utils/analytics';
 
 export const EditorHeader = () => {
@@ -33,9 +35,15 @@ export const EditorHeader = () => {
   const { syncToServer } = useTemplateSync();
   const { publishTemplate } = useTemplatePublish();
   const { loadPostedTemplates } = usePostedTemplates();
+  const nameEditDebounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
   const handleNameChange = (e: React.ChangeEvent<HTMLInputElement>) => {
     dispatch({ type: 'UPDATE_TEMPLATE_NAME', payload: e.target.value });
+    // 타이핑 중 이벤트 과다 전송 방지 — 1초 debounce
+    if (nameEditDebounceRef.current) clearTimeout(nameEditDebounceRef.current);
+    nameEditDebounceRef.current = setTimeout(() => {
+      sendTemplateNameEdit(state.template?.templateId);
+    }, 1000);
   };
 
   const handleSave = async () => {
diff --git a/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx b/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
index c874c32..d65e91d 100644
--- a/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
+++ b/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
@@ -16,7 +16,7 @@ import { validateLinkForm } from '@/utils/formValidation';
 import { IconGrid } from '@/components/Editor/shared/IconGrid';
 import type { TemplateIcon, TemplateItem } from '@/types/api';
 import { InputGroup } from '@/components/Editor/shared/InputGroup';
-import { sendTemplateItemAdd } from '@/utils/analytics';
+import { sendTemplateItemAdd, sendTemplateItemUpdate, sendTemplateItemDelete } from '@/utils/analytics';
 
 export const ItemPropertiesPanel = () => {
   const { state, dispatch } = useEditorContext();
@@ -49,6 +49,7 @@ export const ItemPropertiesPanel = () => {
       key={selectedItem.templateItemId}
       selectedItem={selectedItem}
       isFromStaging={isFromStaging}
+      templateId={state.template?.templateId}
       defaultIcons={state.defaultIcons}
       userIcons={state.userIcons}
       dispatch={dispatch}
@@ -59,6 +60,7 @@ export const ItemPropertiesPanel = () => {
 interface ItemPropertiesPanelFormProps {
   selectedItem: TemplateItem;
   isFromStaging: boolean;
+  templateId: number | undefined;
   defaultIcons: ReturnType<typeof useEditorContext>['state']['defaultIcons'];
   userIcons: ReturnType<typeof useEditorContext>['state']['userIcons'];
   dispatch: ReturnType<typeof useEditorContext>['dispatch'];
@@ -67,6 +69,7 @@ interface ItemPropertiesPanelFormProps {
 const ItemPropertiesPanelForm = ({
   selectedItem,
   isFromStaging,
+  templateId,
   defaultIcons,
   userIcons,
   dispatch,
@@ -139,6 +142,7 @@ const ItemPropertiesPanelForm = ({
       },
     });
 
+    sendTemplateItemUpdate('properties', templateId);
     toast.success('변경사항이 저장되었습니다.');
   };
 
@@ -146,10 +150,12 @@ const ItemPropertiesPanelForm = ({
     if (isFromStaging) {
       // Permanently delete from staging
       dispatch({ type: 'REMOVE_FROM_STAGING', payload: selectedItem.templateItemId });
+      sendTemplateItemDelete('staging', templateId);
       toast.info('아이템이 영구 삭제되었습니다.');
     } else {
       // Move canvas item to staging
       dispatch({ type: 'MOVE_TO_STAGING', payload: selectedItem.templateItemId });
+      sendTemplateItemDelete('canvas', templateId);
       toast.info('아이템이 임시 저장 공간으로 이동되었습니다.');
     }
   };

From ad2675eb19e5fc83d6a8ee45cd476b24d4fdaa89 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:48:05 +0900
Subject: [PATCH 24/30] feat(analytics): connect labs and alerts subscription
 events
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- labs_view_open: LabsDialog 진입 시 전송
- labs_feature_use: QR 생성 성공/실패, 도서관 열람실 클릭 시 전송
- alerts_subscription_change: 학과 구독/취소 성공 시 category·result 전송

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/Labs/LibrarySeatSection.tsx         | 2 ++
 src/components/Labs/QRGeneratorSection.tsx         | 3 +++
 src/components/LabsDialog.tsx                      | 6 ++++++
 src/components/Tabs/Alerts/SubscriptionManager.tsx | 3 +++
 4 files changed, 14 insertions(+)

diff --git a/src/components/Labs/LibrarySeatSection.tsx b/src/components/Labs/LibrarySeatSection.tsx
index d146da5..2fa6e02 100644
--- a/src/components/Labs/LibrarySeatSection.tsx
+++ b/src/components/Labs/LibrarySeatSection.tsx
@@ -10,6 +10,7 @@ import {
 } from '@/apis';
 import { LibrarySeatRoom } from '@/types/api';
 import { loadECampusCredentials } from '@/utils/credentials';
+import { sendLabsFeatureUse } from '@/utils/analytics';
 
 const LibrarySeatSection = () => {
   const [rooms, setRooms] = useState<LibrarySeatRoom[]>([]);
@@ -75,6 +76,7 @@ const LibrarySeatSection = () => {
   }, [fetchSeatRooms]);
 
   const handleOpenRoom = (roomId: number) => {
+    sendLabsFeatureUse('library_seat', 'success');
     openLibraryReservationPage(roomId);
   };
 
diff --git a/src/components/Labs/QRGeneratorSection.tsx b/src/components/Labs/QRGeneratorSection.tsx
index 83d2194..54f9334 100644
--- a/src/components/Labs/QRGeneratorSection.tsx
+++ b/src/components/Labs/QRGeneratorSection.tsx
@@ -5,6 +5,7 @@ import { Label } from "@/components/ui/label";
 import { Info, Download, Check, Upload, X } from "lucide-react";
 import QRCode from "qrcode";
 import { warnLog } from '@/utils/logger';
+import { sendLabsFeatureUse } from '@/utils/analytics';
 
 // LinKU 로고 (public/assets/icon128.png) - 고해상도 사용
 const LINKU_LOGO_URL = "/assets/icon128.png";
@@ -120,9 +121,11 @@ const QRGeneratorSection = () => {
         const dataUrl = await generateQRWithLogo(activeUrl, logoSrc);
         setQrDataUrl(dataUrl);
         setError("");
+        sendLabsFeatureUse('qr_generator', 'success');
       } catch {
         setError("QR 코드 생성에 실패했습니다");
         setQrDataUrl("");
+        sendLabsFeatureUse('qr_generator', 'fail');
       } finally {
         setIsGenerating(false);
       }
diff --git a/src/components/LabsDialog.tsx b/src/components/LabsDialog.tsx
index 803e55c..89c7969 100644
--- a/src/components/LabsDialog.tsx
+++ b/src/components/LabsDialog.tsx
@@ -1,3 +1,4 @@
+import { useEffect } from "react";
 import {
   Dialog,
   DialogContent,
@@ -9,6 +10,7 @@ import { ScrollArea } from "@/components/ui/scroll-area";
 import ServerClockSection from "./Labs/ServerClockSection";
 import QRGeneratorSection from "./Labs/QRGeneratorSection";
 import LibrarySeatSection from "./Labs/LibrarySeatSection";
+import { sendLabsViewOpen } from "@/utils/analytics";
 
 interface LabsDialogProps {
   open: boolean;
@@ -16,6 +18,10 @@ interface LabsDialogProps {
 }
 
 const LabsDialog = ({ open, onOpenChange }: LabsDialogProps) => {
+  useEffect(() => {
+    if (open) sendLabsViewOpen();
+  }, [open]);
+
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
       <DialogContent className="max-w-md">
diff --git a/src/components/Tabs/Alerts/SubscriptionManager.tsx b/src/components/Tabs/Alerts/SubscriptionManager.tsx
index eefe5f8..cf7466d 100644
--- a/src/components/Tabs/Alerts/SubscriptionManager.tsx
+++ b/src/components/Tabs/Alerts/SubscriptionManager.tsx
@@ -9,6 +9,7 @@ import type { Department, Subscription } from "@/types/api";
 import { Check, Plus, X } from "lucide-react";
 import { toast } from "sonner";
 import { errorLog } from '@/utils/logger';
+import { sendAlertsSubscriptionChange } from '@/utils/analytics';
 
 interface SubscriptionManagerProps {
   onUpdate?: () => void;
@@ -61,6 +62,7 @@ const SubscriptionManager = ({ onUpdate }: SubscriptionManagerProps) => {
       const result = await subscribeDepartment(departmentId);
 
       if (result.success) {
+        sendAlertsSubscriptionChange(departmentName, 'subscribe');
         toast.success(`${departmentName} 구독이 완료되었습니다.`);
         await fetchData();
         onUpdate?.();
@@ -79,6 +81,7 @@ const SubscriptionManager = ({ onUpdate }: SubscriptionManagerProps) => {
       const result = await unsubscribeDepartment(departmentId);
 
       if (result.success) {
+        sendAlertsSubscriptionChange(departmentName, 'unsubscribe');
         toast.success(`${departmentName} 구독이 취소되었습니다.`);
         await fetchData();
         onUpdate?.();

From ce13ad494f9c08933012967831d233b18a409087 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:48:29 +0900
Subject: [PATCH 25/30] docs(taxonomy): mark all remaining events as
 implemented
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

banner_open, template_create_start, template_name_edit,
template_item_update, template_item_delete, template_delete,
settings_open, alerts_subscription_change, labs_view_open,
labs_feature_use 모두 구현 완료.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/GA4-Data-Taxonomy.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/GA4-Data-Taxonomy.md b/docs/GA4-Data-Taxonomy.md
index cccd643..ffcdb27 100644
--- a/docs/GA4-Data-Taxonomy.md
+++ b/docs/GA4-Data-Taxonomy.md
@@ -93,7 +93,7 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | `navigation_tab_select` | 구현됨 | 어떤 탭이 실제로 사용되는지 | `tab_name`, `feature_area?` | `ui_location`은 미전송 |
 | `search_submit` | 구현됨 | 검색 기능 사용률 측정 | `search_term`, `search_location?` | |
 | `link_open` | 구현됨 | LinKU 핵심 가치 행동 | `link_name`, `link_url`, `link_group?`, `same_host_variant?` | same-host 버튼은 `samehost_primary` / `samehost_secondary`로 구분 |
-| `banner_open` | 미구현 | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | |
+| `banner_open` | 구현됨 | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | |
 | `button_click` | 구현됨 | 범용 버튼 클릭 (header 등) | `button_name`, `button_location?` | 제품 의미가 큰 버튼은 개별 이벤트로 승격, header 잡버튼에만 사용 |
 
 ## Account / Auth Events
@@ -114,11 +114,11 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | Event Name | 상태 | 목적 | 주요 Params | 우선순위 |
 | --- | --- | --- | --- | --- |
 | `template_editor_open` | 구현됨 | 에디터 진입률 측정 | `template_origin`, `template_id?` | P1 |
-| `template_create_start` | 미구현 | 새 템플릿 생성 진입 | `template_origin`=`default\|empty` | P1 |
-| `template_name_edit` | 미구현 | 에디터 사용성 파악 | `template_id` | P3 |
+| `template_create_start` | 구현됨 | 새 템플릿 생성 진입 | `template_origin`=`default\|empty` | P1 |
+| `template_name_edit` | 구현됨 | 에디터 사용성 파악 | `template_id` | P3 |
 | `template_item_add` | 구현됨 | 에디터 내 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | P1 |
-| `template_item_update` | 미구현 | 링크/아이콘/속성 수정 | `update_type`, `template_id` | P2 |
-| `template_item_delete` | 미구현 | 아이템 삭제 행위 | `delete_source`, `template_id` | P2 |
+| `template_item_update` | 구현됨 | 링크/아이콘/속성 수정 | `update_type`, `template_id` | P2 |
+| `template_item_delete` | 구현됨 | 아이템 삭제 행위 | `delete_source`, `template_id` | P2 |
 | `template_save_success` | 구현됨 | 로컬 저장 완료 | `template_id`, `template_origin`, `item_count` | P0 |
 | `template_save_fail` | 구현됨 | 저장 실패 원인 파악 | `template_id`, `error_code`, `error_message` | P1 |
 | `template_sync_success` | 구현됨 | 서버 동기화 성공 | `template_id`, `item_count` | P0 |
@@ -126,7 +126,7 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | `template_publish_success` | 구현됨 | 갤러리 게시 성공 | `template_id`, `item_count` | P0 |
 | `template_publish_fail` | 구현됨 | 게시 실패 | `template_id`, `error_code`, `error_message` | P1 |
 | `template_apply` | 구현됨 | 실제 메인 화면 적용 행동 | `template_id`, `template_origin`, `is_default` | P0 |
-| `template_delete` | 미구현 | 템플릿 삭제 | `template_id`, `template_origin`, `sync_status` | P2 |
+| `template_delete` | 구현됨 | 템플릿 삭제 | `template_id`, `template_origin`, `sync_status` | P2 |
 | `template_gallery_open` | 구현됨 | 갤러리 진입 | `entry_point` | P1 |
 | `template_gallery_search` | 구현됨 | 갤러리 검색 사용 | `query_length`, `sort_option` | P2 |
 | `template_gallery_sort_change` | 구현됨 | 정렬 변경 | `sort_option` | P3 |
@@ -142,19 +142,19 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | --- | --- | --- | --- | --- |
 | `alerts_view_open` | 구현됨 | 공지 탭 사용 여부 | `view_mode`(`all`\|`my`), `category` | P2 |
 | `alerts_item_open` | 구현됨 | 공지 클릭률 | `alert_id`, `category`, `source`(`general`\|`department`) | P2 |
-| `alerts_subscription_change` | 미구현 | 개인화 기능 사용 | `category`, `result` | P3 |
+| `alerts_subscription_change` | 구현됨 | 개인화 기능 사용 | `category`, `result` | P3 |
 | `todo_view_open` | 구현됨 | Todo 기능 사용 여부 | `todo_count` | P2 |
 | `todo_item_create` | 구현됨 | Todo 입력 | `source`, `has_due_date` | P2 |
 | `todo_item_complete` | 구현됨 | Todo 완료율 | `item_type`(`custom`\|`ecampus`) | P2 |
 | `todo_item_delete` | 구현됨 | Todo 삭제 | `item_type`(`custom`\|`ecampus`) | P3 |
-| `labs_view_open` | 미구현 | Labs 진입 | `feature_name` | P3 |
-| `labs_feature_use` | 미구현 | Labs 세부 기능 사용 | `feature_name`, `result` | P3 |
+| `labs_view_open` | 구현됨 | Labs 진입 | `feature_name` | P3 |
+| `labs_feature_use` | 구현됨 | Labs 세부 기능 사용 | `feature_name`, `result` | P3 |
 
 ## Settings / System Events
 
 | Event Name | 상태 | 목적 | 주요 Params | 우선순위 |
 | --- | --- | --- | --- | --- |
-| `settings_open` | 미구현 | 설정 진입 측정 | `entry_point` | P2 |
+| `settings_open` | 구현됨 | 설정 진입 측정 | `entry_point` | P2 |
 | `settings_credentials_saved` | 구현됨 | eCampus 계정 저장 | `result`=`success` | P1 |
 | `settings_credentials_deleted` | 구현됨 | eCampus 계정 삭제 | `result`=`success` | P2 |
 | `system_error` | 구현됨 | runtime 오류 집계 | `error_code`, `error_message`, `screen_name?` | P1 |

From db97c0bb081f4ae68300f7d4d948146426dbda30 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 03:51:51 +0900
Subject: [PATCH 26/30] docs(taxonomy): add full event reference table (47
 events)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

구현된 전체 47개 이벤트를 알파벳 순으로 정리한 레퍼런스 표 추가.
이벤트명 / 수집 목적 / 수집 속성 / 사용 코드 / 잔존이슈 포함.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/GA4-Data-Taxonomy.md | 57 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/docs/GA4-Data-Taxonomy.md b/docs/GA4-Data-Taxonomy.md
index ffcdb27..931ab96 100644
--- a/docs/GA4-Data-Taxonomy.md
+++ b/docs/GA4-Data-Taxonomy.md
@@ -212,3 +212,60 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | 모든 버튼을 다 추적 | 분석 가치보다 cardinality와 유지보수 비용이 큼 |
 | GA4 자동 이벤트 완전 복제 | MP-only에서는 비용 대비 효과가 낮음 |
 | 처음부터 모든 기능 100% 추적 | retention과 핵심 가치 행동부터 붙이는 편이 낫다 |
+
+---
+
+## 구현된 이벤트 전체 레퍼런스
+
+`src/utils/analytics.ts`에 정의된 헬퍼 기준 알파벳 순 정리.
+모든 헬퍼는 `sendGAEvent` (internal) → GA4 MP `/mp/collect`로 전송된다.
+
+| 이벤트명 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 / 잔존이슈 |
+| --- | --- | --- | --- | --- |
+| `alerts_item_open` | 공지 클릭률 측정 | `alert_id`, `category`, `source` | `AlertItem.tsx · handleClick` | - |
+| `alerts_subscription_change` | 학과 구독 변경 파악 | `category`, `result`(`subscribe`\|`unsubscribe`) | `SubscriptionManager.tsx · handleSubscribe`, `handleUnsubscribe` | - |
+| `alerts_view_open` | 공지 탭 사용 여부 | `view_mode`, `category` | `Alerts.tsx · initialize()` | - |
+| `auth_email_verification_start` | 게스트→회원 전환 시작점 | `ui_location` | `EmailVerificationDialog.tsx · useEffect([open])` | 다이얼로그 재진입마다 전송 → funnel 시작 수 과집계 가능 |
+| `auth_email_verification_success` | 회원 전환 완료 | `domain_type` | `EmailVerificationDialog.tsx · handleVerifyCode` | - |
+| `auth_login_fail` | 로그인 장애 파악 | `provider`, `error_code`, `error_message` | `SettingsDialog.tsx · handleGoogleLogin` (결과·예외 분기) | - |
+| `auth_login_start` | 로그인 의도 파악 | `provider`, `ui_location` | `SettingsDialog.tsx · handleGoogleLogin` | - |
+| `auth_login_success` | 실제 로그인 성공률 측정 | `provider`, `is_guest` | `SettingsDialog.tsx · handleGoogleLogin` | - |
+| `auth_logout` | 로그아웃 행동 파악 | `ui_location` | `SettingsDialog.tsx · handleLogout` | - |
+| `banner_open` | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | `ImageCarousel.tsx · Image onClick` | - |
+| `button_click` | 미승격 버튼 범용 클릭 | `button_name`, `button_location?` | `MainLayout.tsx` (logo·labs·settings·github), `SettingsDialog.tsx` (password_toggle·open_template_editor·open_template_list) | 제품 의미 큰 버튼은 개별 이벤트로 승격 권장 |
+| `extension_first_open` | 첫 사용 cohort 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | `firstOpenSent` 플래그로 기기당 1회 보장 |
+| `extension_open` | 실제 사용 시작 기록 | `screen_name`, `entry_point` | `App.tsx · useEffect → sendExtensionOpen` | - |
+| `extension_session_start` | 세션 기준 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | 30분 inactivity 초과 시에만 전송 |
+| `labs_feature_use` | Labs 기능 사용 측정 | `feature_name`, `result?` | `QRGeneratorSection.tsx · regenerate()`, `LibrarySeatSection.tsx · handleOpenRoom` | ServerClockSection 미연결 (passive 기능, 사용 정의 불명확) |
+| `labs_view_open` | Labs 탭 진입 파악 | (없음) | `LabsDialog.tsx · useEffect([open])` | - |
+| `link_open` | LinKU 핵심 가치 행동 측정 | `link_name`, `link_url`, `link_group?`, `same_host_variant?` | `LinkGroup.tsx · GridItem onClick`, `GridItemSameHost onClick` | - |
+| `navigation_tab_select` | 탭 사용 패턴 파악 | `tab_name`, `feature_area?` | `TabsLayout.tsx · handleTabChange` | taxonomy 정의 `ui_location` 파라미터 미전송 |
+| `search_submit` | 검색 기능 사용률 측정 | `search_term`, `search_location?` | `MainLayout.tsx · Header onKeyDown(Enter)` | - |
+| `settings_credentials_deleted` | eCampus 계정 삭제 파악 | `result`(=`success`) | `SettingsDialog.tsx · deleteCredentials` | - |
+| `settings_credentials_saved` | eCampus 계정 저장 파악 | `result`(=`success`) | `SettingsDialog.tsx · saveCredentials` | - |
+| `settings_open` | 설정 진입 측정 | `entry_point` | `MainLayout.tsx · Settings onClick` | - |
+| `system_error` | runtime 오류 집계 | `error_code`, `error_message`, `screen_name?` | `App.tsx · ErrorBoundary onError` | React 렌더 오류만 포착, network/API 오류 미포착 |
+| `template_apply` | 메인 화면 적용 — 핵심 가치 행동 | `template_id`, `template_origin`, `is_default` | `TemplateListPage.tsx · handleApplyTemplate` | - |
+| `template_clone_fail` | 복제 실패 파악 | `posted_template_id`, `error_code`, `error_message?` | `GalleryPage.tsx · handleClone catch` | - |
+| `template_clone_success` | 공개 템플릿 복제 성공 | `posted_template_id`, `author_id_present` | `GalleryPage.tsx · handleClone` | - |
+| `template_create_start` | 새 템플릿 생성 진입 | `template_origin`(`default`\|`empty`) | `TemplateListPage.tsx · handleCreateFromDefault`, `handleCreateEmpty` | - |
+| `template_delete` | 템플릿 삭제 파악 | `template_id`, `template_origin`, `sync_status` | `TemplateListPage.tsx · handleDeleteTemplate` | - |
+| `template_editor_open` | 에디터 진입률 측정 | `template_origin`, `template_id?` | `EditorPage.tsx · EditorPage useEffect` | `cloned` origin 미분류 — templateId 있으면 모두 `owned` 처리됨 |
+| `template_gallery_open` | 갤러리 진입 | `entry_point` | `GalleryPage.tsx · useEffect([])` | - |
+| `template_gallery_search` | 갤러리 검색 사용률 | `query_length`, `sort_option` | `GalleryPage.tsx · debounce useEffect([searchQuery, sort])` | - |
+| `template_gallery_sort_change` | 정렬 변경 행동 파악 | `sort_option` | `GalleryPage.tsx · DropdownMenuItem onClick` | - |
+| `template_item_add` | 에디터 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | `EditorPage.tsx · handleDragEnd`, `ItemPropertiesPanel.tsx · handleMoveToCanvas` | - |
+| `template_item_delete` | 아이템 삭제 행위 | `delete_source`(`canvas`\|`staging`), `template_id?` | `ItemPropertiesPanel.tsx · handleDelete` | `canvas`: 임시저장 이동, `staging`: 영구삭제 |
+| `template_item_update` | 아이템 속성 수정 측정 | `update_type`, `template_id?` | `ItemPropertiesPanel.tsx · handleSave` | `update_type` 항상 `"properties"` — 이름/URL/아이콘/크기 세분화 미지원 |
+| `template_like_toggle` | 좋아요 사용 파악 | `posted_template_id`, `liked` | `GalleryPage.tsx · handleLike` | - |
+| `template_name_edit` | 에디터 이름 편집 파악 | `template_id?` | `EditorHeader.tsx · handleNameChange` | 1초 debounce 적용 (keystroke 과다 방지) |
+| `template_publish_fail` | 게시 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handlePublish` | - |
+| `template_publish_success` | 갤러리 게시 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handlePublish` | - |
+| `template_save_fail` | 저장 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSave` | draft 저장 실패 시 `template_id=0` 전송 (ID 생성 전) |
+| `template_save_success` | 로컬 저장 완료 | `template_id`, `template_origin`, `item_count` | `EditorHeader.tsx · handleSave` | - |
+| `template_sync_fail` | 동기화 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSyncToServer` | - |
+| `template_sync_success` | 서버 동기화 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handleSyncToServer` | - |
+| `todo_item_complete` | Todo 완료율 측정 | `item_type` | `TodoList.tsx · handleToggleTodo` | `custom` 타입만 전송 (eCampus todo는 완료 토글 UI 없음) |
+| `todo_item_create` | Todo 입력 파악 | `source`, `has_due_date` | `TodoAddDialog.tsx · handleSubmit` | - |
+| `todo_item_delete` | Todo 삭제 파악 | `item_type` | `TodoList.tsx · handleDeleteTodo` | `custom` 타입만 전송 (eCampus todo는 삭제 UI 없음) |
+| `todo_view_open` | Todo 기능 사용 여부 | `todo_count` | `TodoList.tsx · useEffect([isLoading, ...])` | `viewOpenSentRef`로 최초 1회 보장 |

From f10a01a925fb57c25c8e7e8685f5d480a0ef086e Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 11:10:04 +0900
Subject: [PATCH 27/30] refactor(analytics): apply taxonomy convention, restore
 legacy events, remove duplicates and noise
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 레거시 이벤트 5건 복구 (v1.5.46 연속성 유지)
  · link_open → link_click (sendLinkOpen → sendLinkClick)
  · navigation_tab_select → tab_change (sendNavigationTabSelect → sendTabChange)
  · system_error → error (sendSystemError → sendError)
  · page_view 재도입 (App.tsx에서 sendExtensionOpen과 함께 호출)
  · setting_change 재도입 (sendSettingsCredentialsSaved/Deleted 내부에서 병렬 발송)

- 신규 이벤트 41건에 MP_ prefix + camelCase 컨벤션 적용
  · 이벤트명 형식: MP_{object}_{action}
  · 복합어 camelCase: MP_authLogin_start, MP_templateEditor_view 등
  · 파라미터 정합성: author_id_present → is_author_id_present, liked → is_liked,
    subscription result → subscription_result

- 중복 트래킹 3건 제거
  · settings_icon 클릭: sendSettingsOpen 제거 (button_click 레거시로 대체, 직접 중복)
  · labs_icon 클릭: sendButtonClick 제거 (labs_open이 다이얼로그 진입 시점 포착, 간접 중복)
  · open_template_editor 클릭: sendButtonClick 제거 (editor_view가 진입 포착, 간접 중복)

- P3 이벤트 2건 제거 (분석 가치 낮음)
  · template_name_edit (결과는 template_save_success에 함축됨)
  · template_gallery_sort_change (gallery_search의 sort_option 파라미터에 포함됨)

- EditorHeader.tsx에서 debounce ref 제거 (template_name_edit 제거에 따라)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/App.tsx                                   |   5 +-
 .../Editor/EditorHeader/EditorHeader.tsx      |   9 -
 src/components/LabsDialog.tsx                 |   4 +-
 src/components/MainLayout.tsx                 |   8 +-
 src/components/SettingsDialog.tsx             |   2 -
 src/components/Tabs/Alerts/Alerts.tsx         |   4 +-
 src/components/Tabs/LinkGroup.tsx             |   8 +-
 src/components/Tabs/TodoList/TodoList.tsx     |   4 +-
 src/components/TabsLayout.tsx                 |   4 +-
 src/pages/EditorPage.tsx                      |   4 +-
 src/pages/GalleryPage.tsx                     |   6 +-
 src/utils/analytics.ts                        | 456 +++++++++---------
 12 files changed, 256 insertions(+), 258 deletions(-)

diff --git a/src/App.tsx b/src/App.tsx
index 652af73..8fbe3b5 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -8,7 +8,7 @@ import { Outlet } from "react-router-dom";
 import { ErrorBoundary } from "react-error-boundary";
 import { Toaster } from "./components/ui/sonner";
 import { PostedTemplatesProvider } from "./contexts/PostedTemplatesContext";
-import { sendExtensionOpen, sendSystemError } from "./utils/analytics";
+import { sendExtensionOpen, sendPageView, sendError } from "./utils/analytics";
 import { debugLog } from "@/utils/logger";
 import "./App.css";
 
@@ -21,13 +21,14 @@ function App() {
     );
     debugLog("https://github.com/Turtle-Hwan/LinKU");
     sendExtensionOpen("popup_home", "popup");
+    sendPageView("LinKU Extension - Popup");
   }, []);
 
   return (
     <ErrorBoundary
       onError={(error: unknown) => {
         const msg = error instanceof Error ? error.message : String(error);
-        sendSystemError("react_error_boundary", msg, "popup_home");
+        sendError("react_error_boundary", msg, "popup_home");
       }}
       fallback={
         <div className="w-[500px] h-[600px] flex items-center justify-center p-8">
diff --git a/src/components/Editor/EditorHeader/EditorHeader.tsx b/src/components/Editor/EditorHeader/EditorHeader.tsx
index 4c901d9..1a259ea 100644
--- a/src/components/Editor/EditorHeader/EditorHeader.tsx
+++ b/src/components/Editor/EditorHeader/EditorHeader.tsx
@@ -2,7 +2,6 @@
  * Editor Header - Top bar with template name, save, and publish controls
  */
 
-import { useRef } from 'react';
 import { useEditorContext } from '@/hooks/useEditorContext';
 import { Input } from '@/components/ui/input';
 import { SaveButton } from './SaveButton';
@@ -27,7 +26,6 @@ import {
   sendTemplateSyncFail,
   sendTemplatePublishSuccess,
   sendTemplatePublishFail,
-  sendTemplateNameEdit,
 } from '@/utils/analytics';
 
 export const EditorHeader = () => {
@@ -35,15 +33,8 @@ export const EditorHeader = () => {
   const { syncToServer } = useTemplateSync();
   const { publishTemplate } = useTemplatePublish();
   const { loadPostedTemplates } = usePostedTemplates();
-  const nameEditDebounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-
   const handleNameChange = (e: React.ChangeEvent<HTMLInputElement>) => {
     dispatch({ type: 'UPDATE_TEMPLATE_NAME', payload: e.target.value });
-    // 타이핑 중 이벤트 과다 전송 방지 — 1초 debounce
-    if (nameEditDebounceRef.current) clearTimeout(nameEditDebounceRef.current);
-    nameEditDebounceRef.current = setTimeout(() => {
-      sendTemplateNameEdit(state.template?.templateId);
-    }, 1000);
   };
 
   const handleSave = async () => {
diff --git a/src/components/LabsDialog.tsx b/src/components/LabsDialog.tsx
index 89c7969..ed49f11 100644
--- a/src/components/LabsDialog.tsx
+++ b/src/components/LabsDialog.tsx
@@ -10,7 +10,7 @@ import { ScrollArea } from "@/components/ui/scroll-area";
 import ServerClockSection from "./Labs/ServerClockSection";
 import QRGeneratorSection from "./Labs/QRGeneratorSection";
 import LibrarySeatSection from "./Labs/LibrarySeatSection";
-import { sendLabsViewOpen } from "@/utils/analytics";
+import { sendLabsOpen } from "@/utils/analytics";
 
 interface LabsDialogProps {
   open: boolean;
@@ -19,7 +19,7 @@ interface LabsDialogProps {
 
 const LabsDialog = ({ open, onOpenChange }: LabsDialogProps) => {
   useEffect(() => {
-    if (open) sendLabsViewOpen();
+    if (open) sendLabsOpen();
   }, [open]);
 
   return (
diff --git a/src/components/MainLayout.tsx b/src/components/MainLayout.tsx
index ffccfdb..0ec4df4 100644
--- a/src/components/MainLayout.tsx
+++ b/src/components/MainLayout.tsx
@@ -6,7 +6,7 @@ import { Input } from "./ui/input";
 import { Search, Settings, FlaskConical } from "lucide-react";
 import SettingsDialog from "./SettingsDialog";
 import LabsDialog from "./LabsDialog";
-import { sendButtonClick, sendSearchSubmit, sendSettingsOpen } from "@/utils/analytics";
+import { sendButtonClick, sendSearchSubmit } from "@/utils/analytics";
 
 const MainLayout = () => {
   return (
@@ -53,16 +53,12 @@ const Header = () => {
         <div className="flex items-center gap-2 shrink-0">
           <FlaskConical
             className="w-5 h-5 text-gray-600 cursor-pointer"
-            onClick={() => {
-              sendButtonClick("labs_icon", "header");
-              setShowLabs(true);
-            }}
+            onClick={() => setShowLabs(true)}
           />
           <Settings
             className="w-5 h-5 text-gray-600 cursor-pointer"
             onClick={() => {
               sendButtonClick("settings_icon", "header");
-              sendSettingsOpen("header");
               setShowSettings(true);
             }}
           />
diff --git a/src/components/SettingsDialog.tsx b/src/components/SettingsDialog.tsx
index 8599d6b..0b002c4 100644
--- a/src/components/SettingsDialog.tsx
+++ b/src/components/SettingsDialog.tsx
@@ -454,8 +454,6 @@ const GoogleOAuthSection = () => {
 
 const TemplateEditorSection = () => {
   const handleOpenEditor = () => {
-    sendButtonClick("open_template_editor", "settings_dialog");
-
     // 새 탭에서 템플릿 에디터 열기
     chrome.tabs.create({
       url: chrome.runtime.getURL('index.html#/editor')
diff --git a/src/components/Tabs/Alerts/Alerts.tsx b/src/components/Tabs/Alerts/Alerts.tsx
index cd99103..3adde02 100644
--- a/src/components/Tabs/Alerts/Alerts.tsx
+++ b/src/components/Tabs/Alerts/Alerts.tsx
@@ -9,7 +9,7 @@ import AlertFilter from "./AlertFilter";
 import MyAlertsView from "./MyAlertsView";
 import { Badge } from "@/components/ui/badge";
 import { errorLog } from '@/utils/logger';
-import { sendAlertsViewOpen } from '@/utils/analytics';
+import { sendAlertsView } from '@/utils/analytics';
 
 type AlertViewMode = "all" | "my";
 
@@ -89,7 +89,7 @@ const Alerts = () => {
 
       const resolvedViewMode = (savedViewMode === "my" && !loginStatus) ? "all" : (savedViewMode || "all");
       const resolvedCategory = savedCategory || "전체";
-      sendAlertsViewOpen(resolvedViewMode, resolvedCategory);
+      sendAlertsView(resolvedViewMode, resolvedCategory);
     };
     initialize();
   }, []);
diff --git a/src/components/Tabs/LinkGroup.tsx b/src/components/Tabs/LinkGroup.tsx
index c3f375a..8408469 100644
--- a/src/components/Tabs/LinkGroup.tsx
+++ b/src/components/Tabs/LinkGroup.tsx
@@ -1,6 +1,6 @@
 import { LinkList, LinkListElement } from "@/constants/LinkList";
 import { getCurrentTab } from "@/utils/chrome";
-import { sendLinkOpen } from "@/utils/analytics";
+import { sendLinkClick } from "@/utils/analytics";
 import React, { use } from "react";
 
 interface LinkGroupProps {
@@ -42,7 +42,7 @@ const GridItem = ({ item, colNum }) => {
     <button
       className={`${colNum} flex flex-row items-center justify-start px-4 py-2 rounded-lg hover:bg-gray-100 transition-colors border border-gray-200 cursor-pointer overflow-hidden`}
       onClick={() => {
-        sendLinkOpen(item.label, item.link);
+        sendLinkClick(item.label, item.link);
         window.open(item.link);
       }}
     >
@@ -72,7 +72,7 @@ const GridItemSameHost = ({ item, colNum }) => {
       <button
         className="w-full h-full px-1 bg-main text-white rounded-lg hover:bg-hover transition-colors cursor-pointer text-sm/[normal] break-keep"
         onClick={() => {
-          sendLinkOpen(`${item.label} - ${item.samehost.content}`, item.link, undefined, "samehost_primary");
+          sendLinkClick(`${item.label} - ${item.samehost.content}`, item.link, undefined, "samehost_primary");
           item.samehost.onClick();
         }}
       >
@@ -83,7 +83,7 @@ const GridItemSameHost = ({ item, colNum }) => {
         <button
           className="w-full h-full px-1 bg-gray-200 text-black rounded-lg hover:bg-gray-300 transition-colors cursor-pointer text-sm/[normal] break-keep"
           onClick={() => {
-            sendLinkOpen(`${item.label} - ${item.samehost2.content}`, item.link, undefined, "samehost_secondary");
+            sendLinkClick(`${item.label} - ${item.samehost2.content}`, item.link, undefined, "samehost_secondary");
             item.samehost2.onClick();
           }}
         >
diff --git a/src/components/Tabs/TodoList/TodoList.tsx b/src/components/Tabs/TodoList/TodoList.tsx
index 015a8ab..cd313c5 100644
--- a/src/components/Tabs/TodoList/TodoList.tsx
+++ b/src/components/Tabs/TodoList/TodoList.tsx
@@ -22,7 +22,7 @@ import { ArrowUpDown } from "lucide-react";
 import { toast } from "sonner";
 import KUGoodjob from "@/assets/KU_goodjob.png";
 import { errorLog } from '@/utils/logger';
-import { sendTodoViewOpen, sendTodoItemComplete, sendTodoItemDelete } from '@/utils/analytics';
+import { sendTodoView, sendTodoItemComplete, sendTodoItemDelete } from '@/utils/analytics';
 
 type SortMethod = 'dday-asc' | 'dday-desc';
 
@@ -178,7 +178,7 @@ const TodoList = () => {
   useEffect(() => {
     if (!isLoading && !viewOpenSentRef.current) {
       viewOpenSentRef.current = true;
-      sendTodoViewOpen(ecampusTodos.length + customTodos.length);
+      sendTodoView(ecampusTodos.length + customTodos.length);
     }
   }, [isLoading, ecampusTodos.length, customTodos.length]);
 
diff --git a/src/components/TabsLayout.tsx b/src/components/TabsLayout.tsx
index cb6fd3b..8ac680e 100644
--- a/src/components/TabsLayout.tsx
+++ b/src/components/TabsLayout.tsx
@@ -4,7 +4,7 @@ import LinkGroup from "./Tabs/LinkGroup";
 import TodoList from "./Tabs/TodoList/TodoList";
 import TodoCountBadge from "./Tabs/TodoList/TodoCountBadge";
 import Alerts from "./Tabs/Alerts/Alerts";
-import { sendNavigationTabSelect } from "@/utils/analytics";
+import { sendTabChange } from "@/utils/analytics";
 import { useSelectedTemplate } from "@/hooks/useSelectedTemplate";
 
 const TabsLayout = () => {
@@ -17,7 +17,7 @@ const TabsLayout = () => {
       TodoList: "Todo List",
       Alerts: "공지사항"
     };
-    sendNavigationTabSelect(tabNames[value] || value);
+    sendTabChange(tabNames[value] || value);
   };
 
   return (
diff --git a/src/pages/EditorPage.tsx b/src/pages/EditorPage.tsx
index 768deb4..b436540 100644
--- a/src/pages/EditorPage.tsx
+++ b/src/pages/EditorPage.tsx
@@ -17,7 +17,7 @@ import { DragOverlayPreview } from '@/components/Editor/EditorCanvas/DragOverlay
 import { gridToPixelPosition, pixelToGridPosition, clampToGridBounds, resolveCollisions } from '@/utils/template';
 import { toast } from 'sonner';
 import type { TemplateItem } from '@/types/api';
-import { sendTemplateEditorOpen, sendTemplateItemAdd } from '@/utils/analytics';
+import { sendTemplateEditorView, sendTemplateItemAdd } from '@/utils/analytics';
 
 /**
  * Drag item data for DragOverlay
@@ -192,7 +192,7 @@ export const EditorPage = () => {
 
   useEffect(() => {
     const origin = templateId ? 'owned' : startFrom === 'default' ? 'default' : 'local_only';
-    sendTemplateEditorOpen(origin, templateId ? parseInt(templateId) : undefined);
+    sendTemplateEditorView(origin, templateId ? parseInt(templateId) : undefined);
   // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
 
diff --git a/src/pages/GalleryPage.tsx b/src/pages/GalleryPage.tsx
index 5dff075..e390163 100644
--- a/src/pages/GalleryPage.tsx
+++ b/src/pages/GalleryPage.tsx
@@ -23,9 +23,8 @@ import { useToast } from '@/components/ui/use-toast';
 import { isLoggedIn } from '@/utils/oauth';
 import { errorLog } from '@/utils/logger';
 import {
-  sendTemplateGalleryOpen,
+  sendTemplateGalleryView,
   sendTemplateGallerySearch,
-  sendTemplateGallerySortChange,
   sendTemplateCloneSuccess,
   sendTemplateCloneFail,
   sendTemplateLikeToggle,
@@ -66,7 +65,7 @@ export const GalleryPage = () => {
 
   // GA4: 갤러리 진입 이벤트 (mount 1회)
   useEffect(() => {
-    sendTemplateGalleryOpen('popup');
+    sendTemplateGalleryView('popup');
   }, []);
 
   // Check login status
@@ -370,7 +369,6 @@ export const GalleryPage = () => {
                 key={option.value}
                 onClick={() => {
                   setSort(option.value);
-                  sendTemplateGallerySortChange(option.value);
                 }}
                 className={sort === option.value ? 'bg-accent' : ''}
               >
diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index 9c1ee04..4f74290 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -2,37 +2,42 @@
  * Google Analytics 4 Measurement Protocol for Chrome Extension
  * Manifest V3 호환 — CSP 제약 없이 직접 fetch로 이벤트를 전송한다.
  *
- * ## 설계 원칙
- * 이벤트 네이밍과 파라미터는 GA4-Data-Taxonomy.md 기준을 따른다.
- * 모든 이벤트 정의는 이 파일 안에서만 이루어지며, 호출 지점(call site)은
- * 아래 도메인 헬퍼만 import해서 사용한다. sendGAEvent를 외부에서 직접
- * 호출하면 taxonomy 강제(naming enforcement)가 깨지므로 export하지 않는다.
+ * ## 이벤트 분류
+ *
+ * ### 레거시 이벤트 (v1.5.46 이전부터 수집, 연속성 유지)
+ * - page_view     : sendPageView
+ * - link_click    : sendLinkClick
+ * - tab_change    : sendTabChange
+ * - button_click  : sendButtonClick
+ * - setting_change: sendSettingChange (settings_credentials_saved/deleted 내부에서 병렬 발송)
+ * - error         : sendError
  *
- * ## 도메인 헬퍼 목록
+ * ### 신규 이벤트 (택소노미 정립 후 — `MP_` prefix)
  * - Lifecycle  : sendExtensionOpen
- * - Navigation : sendNavigationTabSelect
  * - Search     : sendSearchSubmit
- * - Link       : sendLinkOpen
  * - Auth       : sendAuthLoginStart, sendAuthLoginSuccess, sendAuthLoginFail,
  *                sendAuthLogout, sendAuthEmailVerificationStart/Success
- * - Settings   : sendSettingsCredentialsSaved, sendSettingsCredentialsDeleted
- * - Template   : sendTemplateEditorOpen, sendTemplateCreateStart,
- *                sendTemplateNameEdit, sendTemplateItemAdd,
- *                sendTemplateItemUpdate, sendTemplateItemDelete,
+ * - Settings   : sendSettingsOpen, sendSettingsCredentialsSaved, sendSettingsCredentialsDeleted
+ * - System     : sendError
+ * - Template   : sendTemplateEditorView, sendTemplateCreateStart,
+ *                sendTemplateItemAdd, sendTemplateItemUpdate, sendTemplateItemDelete,
  *                sendTemplateSaveSuccess/Fail, sendTemplateSyncSuccess/Fail,
  *                sendTemplatePublishSuccess/Fail, sendTemplateApply, sendTemplateDelete
- * - Gallery    : sendTemplateGalleryOpen, sendTemplateGallerySearch,
- *                sendTemplateGallerySortChange, sendTemplateCloneSuccess/Fail,
- *                sendTemplateLikeToggle
+ * - Gallery    : sendTemplateGalleryView, sendTemplateGallerySearch,
+ *                sendTemplateCloneSuccess/Fail, sendTemplateLikeToggle
  * - Banner     : sendBannerOpen
- * - Alerts     : sendAlertsViewOpen, sendAlertsItemOpen, sendAlertsSubscriptionChange
- * - Todo       : sendTodoViewOpen, sendTodoItemCreate,
- *                sendTodoItemComplete, sendTodoItemDelete
- * - Labs       : sendLabsViewOpen, sendLabsFeatureUse
- * - Generic    : sendButtonClick (header 버튼 등 별도 이벤트가 없는 범용 클릭)
+ * - Alerts     : sendAlertsView, sendAlertsItemOpen, sendAlertsSubscriptionChange
+ * - Todo       : sendTodoView, sendTodoItemCreate, sendTodoItemComplete, sendTodoItemDelete
+ * - Labs       : sendLabsOpen, sendLabsFeatureUse
+ * - Generic    : sendButtonClick (별도 이벤트 없는 범용 클릭)
+ *
+ * ## 설계 원칙
+ * - sendGAEvent는 외부에 export하지 않는다. 호출 지점은 도메인 헬퍼만 import할 것
+ * - MP_ prefix: 택소노미 정립 이전(레거시) / 이후 이벤트를 구분한다
+ * - 이벤트 네이밍과 파라미터 패턴: docs/GA4-Data-Taxonomy.md 기준을 따른다
  *
  * ## 전송 흐름
- * 각 헬퍼 → sendGAEvent (internal) → GA4 MP endpoint (fetch)
+ * 각 헬퍼 → sendGAEvent (internal) → GA4 MP /mp/collect (fetch)
  */
 
 import { getOrCreateClientId } from "./clientId";
@@ -247,56 +252,40 @@ export async function sendExtensionOpen(
   }
 }
 
-// ─── Navigation ───────────────────────────────────────────────────────────
+// ─── Legacy events (v1.5.46 이전 수집 — 연속성 유지) ──────────────────────
 
 /**
- * 탭 전환 이벤트 전송
- * @param tabName 전환한 탭의 사용자 친화적 이름 (예: "링크모음", "공지사항")
- * @param featureArea 상위 기능 영역 (선택, 예: "links", "alerts")
- */
-export async function sendNavigationTabSelect(
-  tabName: string,
-  featureArea?: string
-): Promise<void> {
-  await sendGAEvent("navigation_tab_select", {
-    tab_name: tabName,
-    ...(featureArea && { feature_area: featureArea }),
-  });
-}
-
-// ─── Search ───────────────────────────────────────────────────────────────
-
-/**
- * 검색 제출 이벤트 전송
- * @param searchTerm 입력한 검색어
- * @param searchLocation 검색 UI 위치 (선택, 예: "header")
- */
-export async function sendSearchSubmit(
-  searchTerm: string,
-  searchLocation?: string
-): Promise<void> {
-  await sendGAEvent("search_submit", {
-    search_term: searchTerm,
-    ...(searchLocation && { search_location: searchLocation }),
+ * 페이지뷰 이벤트 전송 (레거시)
+ *
+ * popup 진입 시 sendExtensionOpen과 함께 호출한다.
+ * @param pageTitle 페이지 제목
+ * @param pageLocation 페이지 경로 (선택)
+ */
+export async function sendPageView(
+  pageTitle: string,
+  pageLocation?: string
+): Promise<void> {
+  await sendGAEvent("page_view", {
+    page_title: pageTitle,
+    page_location: pageLocation || "chrome-extension://linku/popup",
+    page_referrer: document.referrer || "direct",
   });
 }
 
-// ─── Link ─────────────────────────────────────────────────────────────────
-
 /**
- * 링크 열기 이벤트 전송 — LinKU의 핵심 가치 행동을 측정한다
+ * 링크 클릭 이벤트 전송 (레거시) — LinKU의 핵심 가치 행동을 측정한다
  * @param linkName 클릭한 링크 이름 (item.label 또는 same-host 버튼 조합 문자열)
  * @param linkUrl 링크 URL
  * @param linkGroup 링크가 속한 그룹명 (선택)
  * @param sameHostVariant same-host 버튼 구분자 (선택: "samehost_primary" | "samehost_secondary")
  */
-export async function sendLinkOpen(
+export async function sendLinkClick(
   linkName: string,
   linkUrl: string,
   linkGroup?: string,
   sameHostVariant?: string
 ): Promise<void> {
-  await sendGAEvent("link_open", {
+  await sendGAEvent("link_click", {
     link_name: linkName,
     link_url: linkUrl,
     ...(linkGroup && { link_group: linkGroup }),
@@ -304,89 +293,89 @@ export async function sendLinkOpen(
   });
 }
 
-// ─── Auth ─────────────────────────────────────────────────────────────────
-
 /**
- * 로그인 시작 이벤트 전송
- * @param provider 인증 제공자 (예: "google")
- * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
+ * 탭 전환 이벤트 전송 (레거시)
+ * @param tabName 전환한 탭의 사용자 친화적 이름 (예: "링크모음", "공지사항")
+ * @param featureArea 상위 기능 영역 (선택, 예: "links", "alerts")
  */
-export async function sendAuthLoginStart(
-  provider: string,
-  uiLocation: string
+export async function sendTabChange(
+  tabName: string,
+  featureArea?: string
 ): Promise<void> {
-  await sendGAEvent("auth_login_start", {
-    provider,
-    ui_location: uiLocation,
+  await sendGAEvent("tab_change", {
+    tab_name: tabName,
+    ...(featureArea && { feature_area: featureArea }),
   });
 }
 
 /**
- * 로그아웃 이벤트 전송
- * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
- */
-export async function sendAuthLogout(uiLocation: string): Promise<void> {
-  await sendGAEvent("auth_logout", { ui_location: uiLocation });
-}
-
-// ─── Settings ─────────────────────────────────────────────────────────────
-
-/**
- * 설정 다이얼로그 진입 이벤트 전송
- * @param entryPoint 진입 경로 (예: "header")
+ * 버튼 클릭 이벤트 전송 (레거시)
+ *
+ * 제품 의미가 큰 버튼은 개별 MP_ 이벤트로 승격하고,
+ * 별도 이벤트가 없는 header 버튼 등 범용 클릭에만 사용한다.
+ *
+ * @param buttonName 버튼 식별 이름 (예: "settings_icon", "labs_icon")
+ * @param buttonLocation 버튼이 위치한 UI (선택, 예: "header", "settings_dialog")
  */
-export async function sendSettingsOpen(entryPoint: string): Promise<void> {
-  await sendGAEvent("settings_open", { entry_point: entryPoint });
-}
-
-/** eCampus 인증정보 저장 완료 이벤트 전송 */
-export async function sendSettingsCredentialsSaved(): Promise<void> {
-  await sendGAEvent("settings_credentials_saved", { result: "success" });
-}
-
-/** eCampus 인증정보 삭제 완료 이벤트 전송 */
-export async function sendSettingsCredentialsDeleted(): Promise<void> {
-  await sendGAEvent("settings_credentials_deleted", { result: "success" });
+export async function sendButtonClick(
+  buttonName: string,
+  buttonLocation?: string
+): Promise<void> {
+  await sendGAEvent("button_click", {
+    button_name: buttonName,
+    ...(buttonLocation && { button_location: buttonLocation }),
+  });
 }
 
-// ─── System ───────────────────────────────────────────────────────────────
-
 /**
- * 런타임 오류 이벤트 전송
+ * 런타임 오류 이벤트 전송 (레거시)
  * @param errorCode 에러 식별 코드 (예: "network_error", "auth_required")
  * @param errorMessage 사람이 읽는 에러 설명
  * @param screenName 에러가 발생한 화면 (선택)
  */
-export async function sendSystemError(
+export async function sendError(
   errorCode: string,
   errorMessage: string,
   screenName?: string
 ): Promise<void> {
-  await sendGAEvent("system_error", {
+  await sendGAEvent("error", {
     error_code: errorCode,
     error_message: errorMessage,
     ...(screenName && { screen_name: screenName }),
   });
 }
 
-// ─── Generic button click ─────────────────────────────────────────────────
+// ─── Search ───────────────────────────────────────────────────────────────
 
 /**
- * 버튼 클릭 이벤트 전송
- *
- * 제품 의미가 큰 버튼은 개별 이벤트(sendAuthLoginStart 등)로 승격하고,
- * 별도 이벤트가 없는 header 버튼 등 범용 클릭에만 사용한다.
- *
- * @param buttonName 버튼 식별 이름 (예: "settings_icon", "labs_icon")
- * @param buttonLocation 버튼이 위치한 UI (선택, 예: "header", "settings_dialog")
+ * 검색 제출 이벤트 전송
+ * @param searchTerm 입력한 검색어
+ * @param searchLocation 검색 UI 위치 (선택, 예: "header")
  */
-export async function sendButtonClick(
-  buttonName: string,
-  buttonLocation?: string
+export async function sendSearchSubmit(
+  searchTerm: string,
+  searchLocation?: string
 ): Promise<void> {
-  await sendGAEvent("button_click", {
-    button_name: buttonName,
-    ...(buttonLocation && { button_location: buttonLocation }),
+  await sendGAEvent("MP_search_submit", {
+    search_term: searchTerm,
+    ...(searchLocation && { search_location: searchLocation }),
+  });
+}
+
+// ─── Auth ─────────────────────────────────────────────────────────────────
+
+/**
+ * 로그인 시작 이벤트 전송
+ * @param provider 인증 제공자 (예: "google")
+ * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
+ */
+export async function sendAuthLoginStart(
+  provider: string,
+  uiLocation: string
+): Promise<void> {
+  await sendGAEvent("MP_authLogin_start", {
+    provider,
+    ui_location: uiLocation,
   });
 }
 
@@ -399,7 +388,7 @@ export async function sendAuthLoginSuccess(
   provider: string,
   isGuest: boolean
 ): Promise<void> {
-  await sendGAEvent("auth_login_success", {
+  await sendGAEvent("MP_authLogin_success", {
     provider,
     is_guest: isGuest,
   });
@@ -416,13 +405,21 @@ export async function sendAuthLoginFail(
   errorCode: string,
   errorMessage: string
 ): Promise<void> {
-  await sendGAEvent("auth_login_fail", {
+  await sendGAEvent("MP_authLogin_fail", {
     provider,
     error_code: errorCode,
     error_message: errorMessage,
   });
 }
 
+/**
+ * 로그아웃 이벤트 전송
+ * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
+ */
+export async function sendAuthLogout(uiLocation: string): Promise<void> {
+  await sendGAEvent("MP_auth_logout", { ui_location: uiLocation });
+}
+
 /**
  * 이메일 인증 시작 이벤트 전송 (게스트 → 정회원 전환 시작)
  * @param uiLocation 버튼이 위치한 UI (예: "settings_dialog")
@@ -430,7 +427,7 @@ export async function sendAuthLoginFail(
 export async function sendAuthEmailVerificationStart(
   uiLocation: string
 ): Promise<void> {
-  await sendGAEvent("auth_email_verification_start", {
+  await sendGAEvent("MP_authEmailVerification_start", {
     ui_location: uiLocation,
   });
 }
@@ -442,7 +439,41 @@ export async function sendAuthEmailVerificationStart(
 export async function sendAuthEmailVerificationSuccess(
   domainType: string
 ): Promise<void> {
-  await sendGAEvent("auth_email_verification_success", { domain_type: domainType });
+  await sendGAEvent("MP_authEmailVerification_success", { domain_type: domainType });
+}
+
+// ─── Settings ─────────────────────────────────────────────────────────────
+
+/**
+ * 설정 다이얼로그 진입 이벤트 전송
+ * @param entryPoint 진입 경로 (예: "header")
+ */
+export async function sendSettingsOpen(entryPoint: string): Promise<void> {
+  await sendGAEvent("MP_settings_open", { entry_point: entryPoint });
+}
+
+/**
+ * eCampus 인증정보 저장 완료 이벤트 전송
+ *
+ * 레거시 연속성을 위해 `setting_change`와 신규 `MP_settingsCredentials_save`를 병렬 전송한다.
+ */
+export async function sendSettingsCredentialsSaved(): Promise<void> {
+  // 레거시 이벤트 — v1.5.46 이전 데이터와의 연속성 유지
+  await sendGAEvent("setting_change", { setting_name: "credentials", setting_value: "saved" });
+  // 신규 이벤트
+  await sendGAEvent("MP_settingsCredentials_save", { result: "success" });
+}
+
+/**
+ * eCampus 인증정보 삭제 완료 이벤트 전송
+ *
+ * 레거시 연속성을 위해 `setting_change`와 신규 `MP_settingsCredentials_delete`를 병렬 전송한다.
+ */
+export async function sendSettingsCredentialsDeleted(): Promise<void> {
+  // 레거시 이벤트 — v1.5.46 이전 데이터와의 연속성 유지
+  await sendGAEvent("setting_change", { setting_name: "credentials", setting_value: "deleted" });
+  // 신규 이벤트
+  await sendGAEvent("MP_settingsCredentials_delete", { result: "success" });
 }
 
 // ─── Template ─────────────────────────────────────────────────────────────
@@ -452,16 +483,24 @@ export async function sendAuthEmailVerificationSuccess(
  * @param templateOrigin 템플릿 출처 ("default" | "owned" | "cloned" | "posted" | "local_only")
  * @param templateId 템플릿 식별자 (선택)
  */
-export async function sendTemplateEditorOpen(
+export async function sendTemplateEditorView(
   templateOrigin: string,
   templateId?: number
 ): Promise<void> {
-  await sendGAEvent("template_editor_open", {
+  await sendGAEvent("MP_templateEditor_view", {
     template_origin: templateOrigin,
     ...(templateId !== undefined && { template_id: templateId }),
   });
 }
 
+/**
+ * 새 템플릿 만들기 진입 이벤트 전송
+ * @param templateOrigin 생성 출처 ("default" | "empty")
+ */
+export async function sendTemplateCreateStart(templateOrigin: string): Promise<void> {
+  await sendGAEvent("MP_template_createStart", { template_origin: templateOrigin });
+}
+
 /**
  * 템플릿 아이템 추가 이벤트 전송
  * @param addMethod 추가 방식 (예: "drag", "button")
@@ -471,12 +510,42 @@ export async function sendTemplateItemAdd(
   addMethod: string,
   templateId?: number
 ): Promise<void> {
-  await sendGAEvent("template_item_add", {
+  await sendGAEvent("MP_templateItem_add", {
     add_method: addMethod,
     ...(templateId !== undefined && { template_id: templateId }),
   });
 }
 
+/**
+ * 템플릿 아이템 속성 저장 이벤트 전송
+ * @param updateType 업데이트 유형 (예: "properties")
+ * @param templateId 템플릿 식별자 (선택)
+ */
+export async function sendTemplateItemUpdate(
+  updateType: string,
+  templateId?: number
+): Promise<void> {
+  await sendGAEvent("MP_templateItem_update", {
+    update_type: updateType,
+    ...(templateId !== undefined && { template_id: templateId }),
+  });
+}
+
+/**
+ * 템플릿 아이템 삭제 이벤트 전송
+ * @param deleteSource 삭제 경로 ("canvas" = 임시저장으로 이동, "staging" = 영구 삭제)
+ * @param templateId 템플릿 식별자 (선택)
+ */
+export async function sendTemplateItemDelete(
+  deleteSource: string,
+  templateId?: number
+): Promise<void> {
+  await sendGAEvent("MP_templateItem_delete", {
+    delete_source: deleteSource,
+    ...(templateId !== undefined && { template_id: templateId }),
+  });
+}
+
 /**
  * 템플릿 로컬 저장 성공 이벤트 전송
  * @param templateId 템플릿 식별자
@@ -488,7 +557,7 @@ export async function sendTemplateSaveSuccess(
   templateOrigin: string,
   itemCount: number
 ): Promise<void> {
-  await sendGAEvent("template_save_success", {
+  await sendGAEvent("MP_templateSave_success", {
     template_id: templateId,
     template_origin: templateOrigin,
     item_count: itemCount,
@@ -506,7 +575,7 @@ export async function sendTemplateSaveFail(
   errorCode: string,
   errorMessage: string
 ): Promise<void> {
-  await sendGAEvent("template_save_fail", {
+  await sendGAEvent("MP_templateSave_fail", {
     template_id: templateId,
     error_code: errorCode,
     error_message: errorMessage,
@@ -522,7 +591,7 @@ export async function sendTemplateSyncSuccess(
   templateId: number,
   itemCount: number
 ): Promise<void> {
-  await sendGAEvent("template_sync_success", {
+  await sendGAEvent("MP_templateSync_success", {
     template_id: templateId,
     item_count: itemCount,
   });
@@ -539,7 +608,7 @@ export async function sendTemplateSyncFail(
   errorCode: string,
   errorMessage: string
 ): Promise<void> {
-  await sendGAEvent("template_sync_fail", {
+  await sendGAEvent("MP_templateSync_fail", {
     template_id: templateId,
     error_code: errorCode,
     error_message: errorMessage,
@@ -555,7 +624,7 @@ export async function sendTemplatePublishSuccess(
   templateId: number,
   itemCount: number
 ): Promise<void> {
-  await sendGAEvent("template_publish_success", {
+  await sendGAEvent("MP_templatePublish_success", {
     template_id: templateId,
     item_count: itemCount,
   });
@@ -572,7 +641,7 @@ export async function sendTemplatePublishFail(
   errorCode: string,
   errorMessage: string
 ): Promise<void> {
-  await sendGAEvent("template_publish_fail", {
+  await sendGAEvent("MP_templatePublish_fail", {
     template_id: templateId,
     error_code: errorCode,
     error_message: errorMessage,
@@ -580,52 +649,20 @@ export async function sendTemplatePublishFail(
 }
 
 /**
- * 새 템플릿 만들기 진입 이벤트 전송
- * @param templateOrigin 생성 출처 ("default" | "empty")
- */
-export async function sendTemplateCreateStart(templateOrigin: string): Promise<void> {
-  await sendGAEvent("template_create_start", { template_origin: templateOrigin });
-}
-
-/**
- * 템플릿 이름 편집 이벤트 전송
- *
- * 매 keystroke가 아닌 타이핑 정지 후(debounce) 호출해야 한다.
- * @param templateId 편집 중인 템플릿 식별자 (선택)
- */
-export async function sendTemplateNameEdit(templateId?: number): Promise<void> {
-  await sendGAEvent("template_name_edit", {
-    ...(templateId !== undefined && { template_id: templateId }),
-  });
-}
-
-/**
- * 템플릿 아이템 속성 저장 이벤트 전송
- * @param updateType 업데이트 유형 (예: "properties")
- * @param templateId 템플릿 식별자 (선택)
- */
-export async function sendTemplateItemUpdate(
-  updateType: string,
-  templateId?: number
-): Promise<void> {
-  await sendGAEvent("template_item_update", {
-    update_type: updateType,
-    ...(templateId !== undefined && { template_id: templateId }),
-  });
-}
-
-/**
- * 템플릿 아이템 삭제 이벤트 전송
- * @param deleteSource 삭제 경로 ("canvas" = 임시저장으로 이동, "staging" = 영구 삭제)
- * @param templateId 템플릿 식별자 (선택)
+ * 템플릿 메인 화면 적용 이벤트 전송 — 핵심 가치 행동
+ * @param templateId 템플릿 식별자
+ * @param templateOrigin 템플릿 출처
+ * @param isDefault 기본 템플릿 여부
  */
-export async function sendTemplateItemDelete(
-  deleteSource: string,
-  templateId?: number
+export async function sendTemplateApply(
+  templateId: number,
+  templateOrigin: string,
+  isDefault: boolean
 ): Promise<void> {
-  await sendGAEvent("template_item_delete", {
-    delete_source: deleteSource,
-    ...(templateId !== undefined && { template_id: templateId }),
+  await sendGAEvent("MP_template_apply", {
+    template_id: templateId,
+    template_origin: templateOrigin,
+    is_default: isDefault,
   });
 }
 
@@ -640,39 +677,21 @@ export async function sendTemplateDelete(
   templateOrigin: string,
   syncStatus: string
 ): Promise<void> {
-  await sendGAEvent("template_delete", {
+  await sendGAEvent("MP_template_delete", {
     template_id: templateId,
     template_origin: templateOrigin,
     sync_status: syncStatus,
   });
 }
 
-/**
- * 템플릿 메인 화면 적용 이벤트 전송 — 핵심 가치 행동
- * @param templateId 템플릿 식별자
- * @param templateOrigin 템플릿 출처
- * @param isDefault 기본 템플릿 여부
- */
-export async function sendTemplateApply(
-  templateId: number,
-  templateOrigin: string,
-  isDefault: boolean
-): Promise<void> {
-  await sendGAEvent("template_apply", {
-    template_id: templateId,
-    template_origin: templateOrigin,
-    is_default: isDefault,
-  });
-}
-
 // ─── Template Gallery ──────────────────────────────────────────────────────
 
 /**
  * 템플릿 갤러리 진입 이벤트 전송
  * @param entryPoint 진입 경로 (예: "settings_dialog", "popup")
  */
-export async function sendTemplateGalleryOpen(entryPoint: string): Promise<void> {
-  await sendGAEvent("template_gallery_open", { entry_point: entryPoint });
+export async function sendTemplateGalleryView(entryPoint: string): Promise<void> {
+  await sendGAEvent("MP_templateGallery_view", { entry_point: entryPoint });
 }
 
 /**
@@ -684,32 +703,24 @@ export async function sendTemplateGallerySearch(
   queryLength: number,
   sortOption: string
 ): Promise<void> {
-  await sendGAEvent("template_gallery_search", {
+  await sendGAEvent("MP_templateGallery_search", {
     query_length: queryLength,
     sort_option: sortOption,
   });
 }
 
-/**
- * 갤러리 정렬 변경 이벤트 전송
- * @param sortOption 선택한 정렬 옵션
- */
-export async function sendTemplateGallerySortChange(sortOption: string): Promise<void> {
-  await sendGAEvent("template_gallery_sort_change", { sort_option: sortOption });
-}
-
 /**
  * 갤러리 템플릿 복제 성공 이벤트 전송
  * @param postedTemplateId 게시된 템플릿 식별자
- * @param authorIdPresent 작성자 ID 포함 여부
+ * @param isAuthorIdPresent 작성자 ID 포함 여부
  */
 export async function sendTemplateCloneSuccess(
   postedTemplateId: number,
-  authorIdPresent: boolean
+  isAuthorIdPresent: boolean
 ): Promise<void> {
-  await sendGAEvent("template_clone_success", {
+  await sendGAEvent("MP_templateClone_success", {
     posted_template_id: postedTemplateId,
-    author_id_present: authorIdPresent,
+    is_author_id_present: isAuthorIdPresent,
   });
 }
 
@@ -724,7 +735,7 @@ export async function sendTemplateCloneFail(
   errorCode: string,
   errorMessage?: string
 ): Promise<void> {
-  await sendGAEvent("template_clone_fail", {
+  await sendGAEvent("MP_templateClone_fail", {
     posted_template_id: postedTemplateId,
     error_code: errorCode,
     ...(errorMessage && { error_message: errorMessage }),
@@ -734,15 +745,15 @@ export async function sendTemplateCloneFail(
 /**
  * 좋아요 토글 이벤트 전송
  * @param postedTemplateId 게시된 템플릿 식별자
- * @param liked 좋아요 여부 (true: 좋아요, false: 취소)
+ * @param isLiked 좋아요 여부 (true: 좋아요, false: 취소)
  */
 export async function sendTemplateLikeToggle(
   postedTemplateId: number,
-  liked: boolean
+  isLiked: boolean
 ): Promise<void> {
-  await sendGAEvent("template_like_toggle", {
+  await sendGAEvent("MP_template_likeToggle", {
     posted_template_id: postedTemplateId,
-    liked,
+    is_liked: isLiked,
   });
 }
 
@@ -753,11 +764,11 @@ export async function sendTemplateLikeToggle(
  * @param viewMode 현재 보기 모드 (예: "all", "my")
  * @param category 선택된 카테고리
  */
-export async function sendAlertsViewOpen(
+export async function sendAlertsView(
   viewMode: string,
   category: string
 ): Promise<void> {
-  await sendGAEvent("alerts_view_open", { view_mode: viewMode, category });
+  await sendGAEvent("MP_alerts_view", { view_mode: viewMode, category });
 }
 
 /**
@@ -771,7 +782,7 @@ export async function sendBannerOpen(
   bannerTitle: string,
   bannerPosition: number
 ): Promise<void> {
-  await sendGAEvent("banner_open", {
+  await sendGAEvent("MP_banner_open", {
     banner_id: bannerId,
     banner_title: bannerTitle,
     banner_position: bannerPosition,
@@ -782,14 +793,14 @@ export async function sendBannerOpen(
  * 공지사항 아이템 클릭 이벤트 전송
  * @param alertId 공지 식별자
  * @param category 공지 카테고리
- * @param source 공지 출처 (예: "konkuk", "ecampus")
+ * @param source 공지 출처 ("general" | "department")
  */
 export async function sendAlertsItemOpen(
   alertId: string | number,
   category: string,
   source: string
 ): Promise<void> {
-  await sendGAEvent("alerts_item_open", {
+  await sendGAEvent("MP_alertsItem_open", {
     alert_id: String(alertId),
     category,
     source,
@@ -799,13 +810,16 @@ export async function sendAlertsItemOpen(
 /**
  * 학과 구독 변경 이벤트 전송
  * @param category 구독 변경된 학과명
- * @param result 변경 결과 ("subscribe" | "unsubscribe")
+ * @param subscriptionResult 변경 결과 ("subscribe" | "unsubscribe")
  */
 export async function sendAlertsSubscriptionChange(
   category: string,
-  result: string
+  subscriptionResult: string
 ): Promise<void> {
-  await sendGAEvent("alerts_subscription_change", { category, result });
+  await sendGAEvent("MP_alertsSubscription_update", {
+    category,
+    subscription_result: subscriptionResult,
+  });
 }
 
 // ─── Todo ─────────────────────────────────────────────────────────────────
@@ -814,8 +828,8 @@ export async function sendAlertsSubscriptionChange(
  * Todo 탭 진입 이벤트 전송
  * @param todoCount 현재 Todo 아이템 수
  */
-export async function sendTodoViewOpen(todoCount: number): Promise<void> {
-  await sendGAEvent("todo_view_open", { todo_count: todoCount });
+export async function sendTodoView(todoCount: number): Promise<void> {
+  await sendGAEvent("MP_todo_view", { todo_count: todoCount });
 }
 
 /**
@@ -827,7 +841,7 @@ export async function sendTodoItemCreate(
   source: string,
   hasDueDate: boolean
 ): Promise<void> {
-  await sendGAEvent("todo_item_create", { source, has_due_date: hasDueDate });
+  await sendGAEvent("MP_todoItem_create", { source, has_due_date: hasDueDate });
 }
 
 /**
@@ -835,7 +849,7 @@ export async function sendTodoItemCreate(
  * @param itemType Todo 유형 (예: "custom", "ecampus")
  */
 export async function sendTodoItemComplete(itemType: string): Promise<void> {
-  await sendGAEvent("todo_item_complete", { item_type: itemType });
+  await sendGAEvent("MP_todoItem_complete", { item_type: itemType });
 }
 
 /**
@@ -843,14 +857,14 @@ export async function sendTodoItemComplete(itemType: string): Promise<void> {
  * @param itemType Todo 유형 (예: "custom", "ecampus")
  */
 export async function sendTodoItemDelete(itemType: string): Promise<void> {
-  await sendGAEvent("todo_item_delete", { item_type: itemType });
+  await sendGAEvent("MP_todoItem_delete", { item_type: itemType });
 }
 
 // ─── Labs ─────────────────────────────────────────────────────────────────
 
 /** Labs 다이얼로그 진입 이벤트 전송 */
-export async function sendLabsViewOpen(): Promise<void> {
-  await sendGAEvent("labs_view_open", {});
+export async function sendLabsOpen(): Promise<void> {
+  await sendGAEvent("MP_labs_open", {});
 }
 
 /**
@@ -862,7 +876,7 @@ export async function sendLabsFeatureUse(
   featureName: string,
   result?: string
 ): Promise<void> {
-  await sendGAEvent("labs_feature_use", {
+  await sendGAEvent("MP_labsFeature_use", {
     feature_name: featureName,
     ...(result && { result }),
   });

From 757357a8c2f1520e6af1a9ef07ed696cf02fde3b Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Tue, 28 Apr 2026 17:42:26 +0900
Subject: [PATCH 28/30] docs(taxonomy): update event reference tables for new
 MP_ naming convention
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- GA4-Data-Taxonomy.md
  · Migration History 2단계로 분리 (v1.5.46→GA4-MP, 컨벤션 정립)
  · 이벤트 레퍼런스 표를 레거시/신규 두 그룹으로 재구성
  · 신규 이벤트 39개 MP_ prefix 및 새 이름 반영
  · 제거된 이벤트 2건(template_name_edit, template_gallery_sort_change) 명시

- GA4-Taxonmy_Conventioning.md
  · 동일 구조로 레거시/신규 분리 재작성
  · 항목 컬럼 유지 (트래킹 시점 단문 설명)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/GA4-Data-Taxonomy.md         | 154 +++++++++++++++++++-----------
 docs/GA4-Taxonmy_Conventioning.md |  61 ++++++++++++
 2 files changed, 157 insertions(+), 58 deletions(-)
 create mode 100644 docs/GA4-Taxonmy_Conventioning.md

diff --git a/docs/GA4-Data-Taxonomy.md b/docs/GA4-Data-Taxonomy.md
index 931ab96..e0b79e7 100644
--- a/docs/GA4-Data-Taxonomy.md
+++ b/docs/GA4-Data-Taxonomy.md
@@ -161,18 +161,49 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 
 ## Migration History
 
-구 이벤트에서 현재 taxonomy로의 전환 이력이다. 구 이벤트는 모두 제거됐다.
+### v1.5.46 → GA4-MP 브랜치 (최초 택소노미 도입)
 
 | 구 이벤트 | 대체된 이벤트 |
 | --- | --- |
-| `page_view` | `extension_open` (+ `extension_first_open`, `extension_session_start` 자동 처리) |
-| `search` | `search_submit` |
-| `tab_change` | `navigation_tab_select` |
-| `link_click` | `link_open` |
-| `setting_change` | `settings_credentials_saved`, `settings_credentials_deleted` |
-| `error` | `system_error` |
-| `button_click("google_login")` | `auth_login_start` + `auth_login_success` / `auth_login_fail` |
-| `button_click("google_logout")` | `auth_logout` |
+| `page_view` | 유지 (sendExtensionOpen과 함께 sendPageView 병렬 호출) |
+| `search` | `MP_search_submit` |
+| `tab_change` | 유지 (sendTabChange — 연속성 보존) |
+| `link_click` | 유지 (sendLinkClick — 연속성 보존, 파라미터 link_group/same_host_variant 추가) |
+| `setting_change` | 유지 + `MP_settingsCredentials_save` / `MP_settingsCredentials_delete` 병렬 발송 |
+| `error` | 유지 (sendError — 연속성 보존, 파라미터 error_code/screen_name 추가) |
+| `button_click("google_login")` | `MP_authLogin_start` + `MP_authLogin_success` / `MP_authLogin_fail` |
+| `button_click("google_logout")` | `MP_auth_logout` |
+
+### 택소노미 컨벤션 정립 (이번 작업)
+
+| 구 이벤트명 | 신규 이벤트명 | 사유 |
+| --- | --- | --- |
+| `search_submit` | `MP_search_submit` | MP_ prefix 적용 |
+| `auth_login_start/success/fail` | `MP_authLogin_start/success/fail` | prefix + camelCase trio |
+| `auth_email_verification_start/success` | `MP_authEmailVerification_start/success` | prefix + camelCase |
+| `auth_logout` | `MP_auth_logout` | prefix 적용 |
+| `settings_open` | `MP_settings_open` | prefix 적용 |
+| `settings_credentials_saved/deleted` | `MP_settingsCredentials_save/delete` | prefix + camelCase + 과거형 제거 |
+| `template_editor_open` | `MP_templateEditor_view` | prefix + _view 진입 컨벤션 |
+| `template_create_start` | `MP_template_createStart` | prefix + camelCase action |
+| `template_item_add/update/delete` | `MP_templateItem_add/update/delete` | prefix + camelCase object |
+| `template_save/sync/publish_success/fail` | `MP_templateSave/Sync/Publish_success/fail` | prefix + camelCase trio |
+| `template_apply` | `MP_template_apply` | prefix 적용 |
+| `template_delete` | `MP_template_delete` | prefix 적용 |
+| `template_gallery_open` | `MP_templateGallery_view` | prefix + _view 진입 컨벤션 |
+| `template_gallery_search` | `MP_templateGallery_search` | prefix + camelCase object |
+| `template_gallery_sort_change` | **제거** | P3 — gallery_search의 sort_option에 흡수 |
+| `template_clone_success/fail` | `MP_templateClone_success/fail` | prefix + camelCase |
+| `template_like_toggle` | `MP_template_likeToggle` | prefix + camelCase action |
+| `template_name_edit` | **제거** | P3 — 분석 활용도 낮음, save_success에 함축 |
+| `alerts_view_open` | `MP_alerts_view` | prefix + _view 진입 컨벤션 |
+| `alerts_item_open` | `MP_alertsItem_open` | prefix + camelCase object |
+| `alerts_subscription_change` | `MP_alertsSubscription_update` | prefix + _change 레거시 전용 규칙 |
+| `todo_view_open` | `MP_todo_view` | prefix + _view 진입 컨벤션 |
+| `todo_item_create/complete/delete` | `MP_todoItem_create/complete/delete` | prefix + camelCase object |
+| `labs_view_open` | `MP_labs_open` | prefix + _open 다이얼로그 컨벤션 |
+| `labs_feature_use` | `MP_labsFeature_use` | prefix + camelCase object |
+| `banner_open` | `MP_banner_open` | prefix 적용 |
 
 ## MVP Recommendation
 
@@ -220,52 +251,59 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 `src/utils/analytics.ts`에 정의된 헬퍼 기준 알파벳 순 정리.
 모든 헬퍼는 `sendGAEvent` (internal) → GA4 MP `/mp/collect`로 전송된다.
 
-| 이벤트명 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 / 잔존이슈 |
-| --- | --- | --- | --- | --- |
-| `alerts_item_open` | 공지 클릭률 측정 | `alert_id`, `category`, `source` | `AlertItem.tsx · handleClick` | - |
-| `alerts_subscription_change` | 학과 구독 변경 파악 | `category`, `result`(`subscribe`\|`unsubscribe`) | `SubscriptionManager.tsx · handleSubscribe`, `handleUnsubscribe` | - |
-| `alerts_view_open` | 공지 탭 사용 여부 | `view_mode`, `category` | `Alerts.tsx · initialize()` | - |
-| `auth_email_verification_start` | 게스트→회원 전환 시작점 | `ui_location` | `EmailVerificationDialog.tsx · useEffect([open])` | 다이얼로그 재진입마다 전송 → funnel 시작 수 과집계 가능 |
-| `auth_email_verification_success` | 회원 전환 완료 | `domain_type` | `EmailVerificationDialog.tsx · handleVerifyCode` | - |
-| `auth_login_fail` | 로그인 장애 파악 | `provider`, `error_code`, `error_message` | `SettingsDialog.tsx · handleGoogleLogin` (결과·예외 분기) | - |
-| `auth_login_start` | 로그인 의도 파악 | `provider`, `ui_location` | `SettingsDialog.tsx · handleGoogleLogin` | - |
-| `auth_login_success` | 실제 로그인 성공률 측정 | `provider`, `is_guest` | `SettingsDialog.tsx · handleGoogleLogin` | - |
-| `auth_logout` | 로그아웃 행동 파악 | `ui_location` | `SettingsDialog.tsx · handleLogout` | - |
-| `banner_open` | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | `ImageCarousel.tsx · Image onClick` | - |
-| `button_click` | 미승격 버튼 범용 클릭 | `button_name`, `button_location?` | `MainLayout.tsx` (logo·labs·settings·github), `SettingsDialog.tsx` (password_toggle·open_template_editor·open_template_list) | 제품 의미 큰 버튼은 개별 이벤트로 승격 권장 |
-| `extension_first_open` | 첫 사용 cohort 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | `firstOpenSent` 플래그로 기기당 1회 보장 |
-| `extension_open` | 실제 사용 시작 기록 | `screen_name`, `entry_point` | `App.tsx · useEffect → sendExtensionOpen` | - |
-| `extension_session_start` | 세션 기준 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | 30분 inactivity 초과 시에만 전송 |
-| `labs_feature_use` | Labs 기능 사용 측정 | `feature_name`, `result?` | `QRGeneratorSection.tsx · regenerate()`, `LibrarySeatSection.tsx · handleOpenRoom` | ServerClockSection 미연결 (passive 기능, 사용 정의 불명확) |
-| `labs_view_open` | Labs 탭 진입 파악 | (없음) | `LabsDialog.tsx · useEffect([open])` | - |
-| `link_open` | LinKU 핵심 가치 행동 측정 | `link_name`, `link_url`, `link_group?`, `same_host_variant?` | `LinkGroup.tsx · GridItem onClick`, `GridItemSameHost onClick` | - |
-| `navigation_tab_select` | 탭 사용 패턴 파악 | `tab_name`, `feature_area?` | `TabsLayout.tsx · handleTabChange` | taxonomy 정의 `ui_location` 파라미터 미전송 |
-| `search_submit` | 검색 기능 사용률 측정 | `search_term`, `search_location?` | `MainLayout.tsx · Header onKeyDown(Enter)` | - |
-| `settings_credentials_deleted` | eCampus 계정 삭제 파악 | `result`(=`success`) | `SettingsDialog.tsx · deleteCredentials` | - |
-| `settings_credentials_saved` | eCampus 계정 저장 파악 | `result`(=`success`) | `SettingsDialog.tsx · saveCredentials` | - |
-| `settings_open` | 설정 진입 측정 | `entry_point` | `MainLayout.tsx · Settings onClick` | - |
-| `system_error` | runtime 오류 집계 | `error_code`, `error_message`, `screen_name?` | `App.tsx · ErrorBoundary onError` | React 렌더 오류만 포착, network/API 오류 미포착 |
-| `template_apply` | 메인 화면 적용 — 핵심 가치 행동 | `template_id`, `template_origin`, `is_default` | `TemplateListPage.tsx · handleApplyTemplate` | - |
-| `template_clone_fail` | 복제 실패 파악 | `posted_template_id`, `error_code`, `error_message?` | `GalleryPage.tsx · handleClone catch` | - |
-| `template_clone_success` | 공개 템플릿 복제 성공 | `posted_template_id`, `author_id_present` | `GalleryPage.tsx · handleClone` | - |
-| `template_create_start` | 새 템플릿 생성 진입 | `template_origin`(`default`\|`empty`) | `TemplateListPage.tsx · handleCreateFromDefault`, `handleCreateEmpty` | - |
-| `template_delete` | 템플릿 삭제 파악 | `template_id`, `template_origin`, `sync_status` | `TemplateListPage.tsx · handleDeleteTemplate` | - |
-| `template_editor_open` | 에디터 진입률 측정 | `template_origin`, `template_id?` | `EditorPage.tsx · EditorPage useEffect` | `cloned` origin 미분류 — templateId 있으면 모두 `owned` 처리됨 |
-| `template_gallery_open` | 갤러리 진입 | `entry_point` | `GalleryPage.tsx · useEffect([])` | - |
-| `template_gallery_search` | 갤러리 검색 사용률 | `query_length`, `sort_option` | `GalleryPage.tsx · debounce useEffect([searchQuery, sort])` | - |
-| `template_gallery_sort_change` | 정렬 변경 행동 파악 | `sort_option` | `GalleryPage.tsx · DropdownMenuItem onClick` | - |
-| `template_item_add` | 에디터 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | `EditorPage.tsx · handleDragEnd`, `ItemPropertiesPanel.tsx · handleMoveToCanvas` | - |
-| `template_item_delete` | 아이템 삭제 행위 | `delete_source`(`canvas`\|`staging`), `template_id?` | `ItemPropertiesPanel.tsx · handleDelete` | `canvas`: 임시저장 이동, `staging`: 영구삭제 |
-| `template_item_update` | 아이템 속성 수정 측정 | `update_type`, `template_id?` | `ItemPropertiesPanel.tsx · handleSave` | `update_type` 항상 `"properties"` — 이름/URL/아이콘/크기 세분화 미지원 |
-| `template_like_toggle` | 좋아요 사용 파악 | `posted_template_id`, `liked` | `GalleryPage.tsx · handleLike` | - |
-| `template_name_edit` | 에디터 이름 편집 파악 | `template_id?` | `EditorHeader.tsx · handleNameChange` | 1초 debounce 적용 (keystroke 과다 방지) |
-| `template_publish_fail` | 게시 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handlePublish` | - |
-| `template_publish_success` | 갤러리 게시 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handlePublish` | - |
-| `template_save_fail` | 저장 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSave` | draft 저장 실패 시 `template_id=0` 전송 (ID 생성 전) |
-| `template_save_success` | 로컬 저장 완료 | `template_id`, `template_origin`, `item_count` | `EditorHeader.tsx · handleSave` | - |
-| `template_sync_fail` | 동기화 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSyncToServer` | - |
-| `template_sync_success` | 서버 동기화 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handleSyncToServer` | - |
-| `todo_item_complete` | Todo 완료율 측정 | `item_type` | `TodoList.tsx · handleToggleTodo` | `custom` 타입만 전송 (eCampus todo는 완료 토글 UI 없음) |
-| `todo_item_create` | Todo 입력 파악 | `source`, `has_due_date` | `TodoAddDialog.tsx · handleSubmit` | - |
-| `todo_item_delete` | Todo 삭제 파악 | `item_type` | `TodoList.tsx · handleDeleteTodo` | `custom` 타입만 전송 (eCampus todo는 삭제 UI 없음) |
-| `todo_view_open` | Todo 기능 사용 여부 | `todo_count` | `TodoList.tsx · useEffect([isLoading, ...])` | `viewOpenSentRef`로 최초 1회 보장 |
+### 레거시 이벤트 (v1.5.46~, MP_ prefix 없음, 연속성 유지)
+
+| 이벤트명 | 항목 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 |
+| --- | --- | --- | --- | --- | --- |
+| `button_click` | 버튼 클릭 | 미승격 버튼 범용 클릭 | `button_name`, `button_location?` | `MainLayout.tsx` (logo·settings·github), `SettingsDialog.tsx` (password_toggle·open_template_list) | 제품 의미 큰 버튼은 개별 MP_ 이벤트로 승격 |
+| `error` | 렌더 오류 발생 | runtime 오류 집계 | `error_code`, `error_message`, `screen_name?` | `App.tsx · ErrorBoundary onError` | React 렌더 오류만 포착 |
+| `link_click` | 링크 클릭 | LinKU 핵심 가치 행동 측정 | `link_name`, `link_url`, `link_group?`, `same_host_variant?` | `LinkGroup.tsx · GridItem onClick`, `GridItemSameHost onClick` | - |
+| `page_view` | 팝업 열기 | 실제 사용 시작 기록 (레거시) | `page_title`, `page_location`, `page_referrer` | `App.tsx · useEffect → sendPageView` | sendExtensionOpen과 함께 호출 |
+| `setting_change` | 계정 정보 변경 | eCampus 자격증명 변경 파악 (레거시) | `setting_name`, `setting_value` | `SettingsDialog.tsx` 내부 병렬 발송 | MP_settingsCredentials_* 와 동시 발화 |
+| `tab_change` | 탭 선택 | 탭 사용 패턴 파악 | `tab_name`, `feature_area?` | `TabsLayout.tsx · handleTabChange` | - |
+
+### 신규 이벤트 (택소노미 정립 후, MP_ prefix)
+
+| 이벤트명 | 항목 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 |
+| --- | --- | --- | --- | --- | --- |
+| `extension_first_open` | 최초 실행 | 첫 사용 cohort 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | `firstOpenSent` 플래그로 기기당 1회 보장 |
+| `extension_open` | 팝업 열기 | 실제 사용 시작 기록 | `screen_name`, `entry_point` | `App.tsx · useEffect → sendExtensionOpen` | - |
+| `extension_session_start` | 세션 시작 | 세션 기준 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | 30분 inactivity 초과 시에만 전송 |
+| `MP_alerts_view` | 공지 탭 진입 | 공지 탭 사용 여부 | `view_mode`, `category` | `Alerts.tsx · initialize()` | - |
+| `MP_alertsItem_open` | 공지 클릭 | 공지 클릭률 측정 | `alert_id`, `category`, `source` | `AlertItem.tsx · handleClick` | - |
+| `MP_alertsSubscription_update` | 구독 변경 | 학과 구독 변경 파악 | `category`, `subscription_result`(`subscribe`\|`unsubscribe`) | `SubscriptionManager.tsx · handleSubscribe`, `handleUnsubscribe` | - |
+| `MP_authEmailVerification_start` | 이메일 인증 시작 | 게스트→회원 전환 시작점 | `ui_location` | `EmailVerificationDialog.tsx · useEffect([open])` | 다이얼로그 재진입마다 전송 → funnel 시작 수 과집계 가능 |
+| `MP_authEmailVerification_success` | 이메일 인증 완료 | 회원 전환 완료 | `domain_type` | `EmailVerificationDialog.tsx · handleVerifyCode` | - |
+| `MP_authLogin_fail` | 로그인 실패 | 로그인 장애 파악 | `provider`, `error_code`, `error_message` | `SettingsDialog.tsx · handleGoogleLogin` (결과·예외 분기) | - |
+| `MP_authLogin_start` | 로그인 시도 | 로그인 의도 파악 | `provider`, `ui_location` | `SettingsDialog.tsx · handleGoogleLogin` | - |
+| `MP_authLogin_success` | 로그인 성공 | 실제 로그인 성공률 측정 | `provider`, `is_guest` | `SettingsDialog.tsx · handleGoogleLogin` | - |
+| `MP_auth_logout` | 로그아웃 | 로그아웃 행동 파악 | `ui_location` | `SettingsDialog.tsx · handleLogout` | - |
+| `MP_banner_open` | 배너 클릭 | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | `ImageCarousel.tsx · Image onClick` | - |
+| `MP_labsFeature_use` | Labs 기능 사용 | Labs 기능 사용 측정 | `feature_name`, `result?` | `QRGeneratorSection.tsx · regenerate()`, `LibrarySeatSection.tsx · handleOpenRoom` | ServerClockSection 미연결 |
+| `MP_labs_open` | Labs 다이얼로그 진입 | Labs 탭 진입 파악 | (없음) | `LabsDialog.tsx · useEffect([open])` | - |
+| `MP_search_submit` | 검색 실행 | 검색 기능 사용률 측정 | `search_term`, `search_location?` | `MainLayout.tsx · Header onKeyDown(Enter)` | - |
+| `MP_settings_open` | 설정 열기 | 설정 진입 측정 | `entry_point` | `MainLayout.tsx · Settings onClick` | button_click(settings_icon)과 중복 없음 (sendSettingsOpen 직접 중복 제거됨) |
+| `MP_settingsCredentials_delete` | 계정 정보 삭제 | eCampus 계정 삭제 파악 | `result`(=`success`) | `SettingsDialog.tsx · deleteCredentials` | setting_change 레거시와 병렬 발송 |
+| `MP_settingsCredentials_save` | 계정 정보 저장 | eCampus 계정 저장 파악 | `result`(=`success`) | `SettingsDialog.tsx · saveCredentials` | setting_change 레거시와 병렬 발송 |
+| `MP_template_apply` | 템플릿 적용 | 메인 화면 적용 — 핵심 가치 행동 | `template_id`, `template_origin`, `is_default` | `TemplateListPage.tsx · handleApplyTemplate` | - |
+| `MP_template_createStart` | 템플릿 생성 시작 | 새 템플릿 생성 진입 | `template_origin`(`default`\|`empty`) | `TemplateListPage.tsx · handleCreateFromDefault`, `handleCreateEmpty` | - |
+| `MP_template_delete` | 템플릿 삭제 | 템플릿 삭제 파악 | `template_id`, `template_origin`, `sync_status` | `TemplateListPage.tsx · handleDeleteTemplate` | - |
+| `MP_template_likeToggle` | 좋아요 토글 | 좋아요 사용 파악 | `posted_template_id`, `is_liked` | `GalleryPage.tsx · handleLike` | - |
+| `MP_templateClone_fail` | 복제 실패 | 복제 실패 파악 | `posted_template_id`, `error_code`, `error_message?` | `GalleryPage.tsx · handleClone catch` | - |
+| `MP_templateClone_success` | 복제 성공 | 공개 템플릿 복제 성공 | `posted_template_id`, `is_author_id_present` | `GalleryPage.tsx · handleClone` | - |
+| `MP_templateEditor_view` | 에디터 진입 | 에디터 진입률 측정 | `template_origin`, `template_id?` | `EditorPage.tsx · EditorPage useEffect` | `cloned` origin 미분류 — templateId 있으면 모두 `owned` 처리됨 |
+| `MP_templateGallery_search` | 갤러리 검색 | 갤러리 검색 사용률 | `query_length`, `sort_option` | `GalleryPage.tsx · debounce useEffect([searchQuery, sort])` | - |
+| `MP_templateGallery_view` | 갤러리 진입 | 갤러리 진입 파악 | `entry_point` | `GalleryPage.tsx · useEffect([])` | - |
+| `MP_templateItem_add` | 아이템 추가 | 에디터 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | `EditorPage.tsx · handleDragEnd`, `ItemPropertiesPanel.tsx · handleMoveToCanvas` | - |
+| `MP_templateItem_delete` | 아이템 삭제 | 아이템 삭제 행위 | `delete_source`(`canvas`\|`staging`), `template_id?` | `ItemPropertiesPanel.tsx · handleDelete` | `canvas`: 임시저장 이동, `staging`: 영구삭제 |
+| `MP_templateItem_update` | 아이템 속성 수정 | 아이템 속성 수정 측정 | `update_type`, `template_id?` | `ItemPropertiesPanel.tsx · handleSave` | `update_type` 항상 `"properties"` — 향후 세분화 시 개선 가능 |
+| `MP_templatePublish_fail` | 게시 실패 | 게시 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handlePublish` | - |
+| `MP_templatePublish_success` | 게시 성공 | 갤러리 게시 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handlePublish` | - |
+| `MP_templateSave_fail` | 저장 실패 | 저장 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSave` | draft 저장 실패 시 `template_id=0` 전송 (ID 생성 전) |
+| `MP_templateSave_success` | 저장 성공 | 로컬 저장 완료 | `template_id`, `template_origin`, `item_count` | `EditorHeader.tsx · handleSave` | - |
+| `MP_templateSync_fail` | 동기화 실패 | 동기화 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSyncToServer` | - |
+| `MP_templateSync_success` | 동기화 성공 | 서버 동기화 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handleSyncToServer` | - |
+| `MP_todoItem_complete` | Todo 완료 체크 | Todo 완료율 측정 | `item_type` | `TodoList.tsx · handleToggleTodo` | `custom` 타입만 전송 (eCampus todo는 완료 토글 UI 없음) |
+| `MP_todoItem_create` | Todo 추가 | Todo 입력 파악 | `source`, `has_due_date` | `TodoAddDialog.tsx · handleSubmit` | - |
+| `MP_todoItem_delete` | Todo 삭제 | Todo 삭제 파악 | `item_type` | `TodoList.tsx · handleDeleteTodo` | `custom` 타입만 전송 (eCampus todo는 삭제 UI 없음) |
+| `MP_todo_view` | Todo 탭 진입 | Todo 기능 사용 여부 | `todo_count` | `TodoList.tsx · useEffect([isLoading, ...])` | `viewOpenSentRef`로 최초 1회 보장 |
diff --git a/docs/GA4-Taxonmy_Conventioning.md b/docs/GA4-Taxonmy_Conventioning.md
new file mode 100644
index 0000000..c109e87
--- /dev/null
+++ b/docs/GA4-Taxonmy_Conventioning.md
@@ -0,0 +1,61 @@
+## 구현된 이벤트 전체 레퍼런스
+
+`src/utils/analytics.ts`에 정의된 헬퍼 기준 알파벳 순 정리.
+모든 헬퍼는 `sendGAEvent` (internal) → GA4 MP `/mp/collect`로 전송된다.
+
+### 레거시 이벤트 (v1.5.46~, 연속성 유지)
+
+| 이벤트명 | 항목 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 / 잔존이슈 |
+| --- | --- | --- | --- | --- | --- |
+| `button_click` | 버튼 클릭 | 미승격 버튼 범용 클릭 | `button_name`, `button_location?` | `MainLayout.tsx` (logo·settings·github), `SettingsDialog.tsx` (password_toggle·open_template_list) | 제품 의미 큰 버튼은 개별 MP_ 이벤트로 승격 권장 |
+| `error` | 렌더 오류 발생 | runtime 오류 집계 | `error_code`, `error_message`, `screen_name?` | `App.tsx · ErrorBoundary onError` | React 렌더 오류만 포착, network/API 오류 미포착 |
+| `link_click` | 링크 클릭 | LinKU 핵심 가치 행동 측정 | `link_name`, `link_url`, `link_group?`, `same_host_variant?` | `LinkGroup.tsx · GridItem onClick`, `GridItemSameHost onClick` | - |
+| `page_view` | 팝업 열기 | 실제 사용 시작 기록 (레거시) | `page_title`, `page_location`, `page_referrer` | `App.tsx · useEffect → sendPageView` | sendExtensionOpen과 함께 호출 |
+| `setting_change` | 계정 정보 변경 | eCampus 자격증명 변경 (레거시) | `setting_name`, `setting_value` | `SettingsDialog.tsx` 내부 병렬 발송 | MP_settingsCredentials_* 와 동시 발화 |
+| `tab_change` | 탭 선택 | 탭 사용 패턴 파악 | `tab_name`, `feature_area?` | `TabsLayout.tsx · handleTabChange` | - |
+
+### 신규 이벤트 (택소노미 정립 후, MP_ prefix)
+
+| 이벤트명 | 항목 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 / 잔존이슈 |
+| --- | --- | --- | --- | --- | --- |
+| `extension_first_open` | 최초 실행 | 첫 사용 cohort 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | `firstOpenSent` 플래그로 기기당 1회 보장 |
+| `extension_open` | 팝업 열기 | 실제 사용 시작 기록 | `screen_name`, `entry_point` | `App.tsx · useEffect → sendExtensionOpen` | - |
+| `extension_session_start` | 세션 시작 | 세션 기준 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | 30분 inactivity 초과 시에만 전송 |
+| `MP_alerts_view` | 공지 탭 진입 | 공지 탭 사용 여부 | `view_mode`, `category` | `Alerts.tsx · initialize()` | - |
+| `MP_alertsItem_open` | 공지 클릭 | 공지 클릭률 측정 | `alert_id`, `category`, `source` | `AlertItem.tsx · handleClick` | - |
+| `MP_alertsSubscription_update` | 구독 변경 | 학과 구독 변경 파악 | `category`, `subscription_result`(`subscribe`\|`unsubscribe`) | `SubscriptionManager.tsx · handleSubscribe`, `handleUnsubscribe` | - |
+| `MP_authEmailVerification_start` | 이메일 인증 시작 | 게스트→회원 전환 시작점 | `ui_location` | `EmailVerificationDialog.tsx · useEffect([open])` | 다이얼로그 재진입마다 전송 → funnel 시작 수 과집계 가능 |
+| `MP_authEmailVerification_success` | 이메일 인증 완료 | 회원 전환 완료 | `domain_type` | `EmailVerificationDialog.tsx · handleVerifyCode` | - |
+| `MP_authLogin_fail` | 로그인 실패 | 로그인 장애 파악 | `provider`, `error_code`, `error_message` | `SettingsDialog.tsx · handleGoogleLogin` (결과·예외 분기) | - |
+| `MP_authLogin_start` | 로그인 시도 | 로그인 의도 파악 | `provider`, `ui_location` | `SettingsDialog.tsx · handleGoogleLogin` | - |
+| `MP_authLogin_success` | 로그인 성공 | 실제 로그인 성공률 측정 | `provider`, `is_guest` | `SettingsDialog.tsx · handleGoogleLogin` | - |
+| `MP_auth_logout` | 로그아웃 | 로그아웃 행동 파악 | `ui_location` | `SettingsDialog.tsx · handleLogout` | - |
+| `MP_banner_open` | 배너 클릭 | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | `ImageCarousel.tsx · Image onClick` | - |
+| `MP_labsFeature_use` | Labs 기능 사용 | Labs 기능 사용 측정 | `feature_name`, `result?` | `QRGeneratorSection.tsx · regenerate()`, `LibrarySeatSection.tsx · handleOpenRoom` | ServerClockSection 미연결 (passive 기능) |
+| `MP_labs_open` | Labs 다이얼로그 진입 | Labs 탭 진입 파악 | (없음) | `LabsDialog.tsx · useEffect([open])` | - |
+| `MP_search_submit` | 검색 실행 | 검색 기능 사용률 측정 | `search_term`, `search_location?` | `MainLayout.tsx · Header onKeyDown(Enter)` | - |
+| `MP_settings_open` | 설정 열기 | 설정 진입 측정 | `entry_point` | `MainLayout.tsx · Settings onClick` | - |
+| `MP_settingsCredentials_delete` | 계정 정보 삭제 | eCampus 계정 삭제 파악 | `result`(=`success`) | `SettingsDialog.tsx · deleteCredentials` | setting_change 레거시와 병렬 발송 |
+| `MP_settingsCredentials_save` | 계정 정보 저장 | eCampus 계정 저장 파악 | `result`(=`success`) | `SettingsDialog.tsx · saveCredentials` | setting_change 레거시와 병렬 발송 |
+| `MP_template_apply` | 템플릿 적용 | 메인 화면 적용 — 핵심 가치 행동 | `template_id`, `template_origin`, `is_default` | `TemplateListPage.tsx · handleApplyTemplate` | - |
+| `MP_template_createStart` | 템플릿 생성 시작 | 새 템플릿 생성 진입 | `template_origin`(`default`\|`empty`) | `TemplateListPage.tsx · handleCreateFromDefault`, `handleCreateEmpty` | - |
+| `MP_template_delete` | 템플릿 삭제 | 템플릿 삭제 파악 | `template_id`, `template_origin`, `sync_status` | `TemplateListPage.tsx · handleDeleteTemplate` | - |
+| `MP_template_likeToggle` | 좋아요 토글 | 좋아요 사용 파악 | `posted_template_id`, `is_liked` | `GalleryPage.tsx · handleLike` | - |
+| `MP_templateClone_fail` | 복제 실패 | 복제 실패 파악 | `posted_template_id`, `error_code`, `error_message?` | `GalleryPage.tsx · handleClone catch` | - |
+| `MP_templateClone_success` | 복제 성공 | 공개 템플릿 복제 성공 | `posted_template_id`, `is_author_id_present` | `GalleryPage.tsx · handleClone` | - |
+| `MP_templateEditor_view` | 에디터 진입 | 에디터 진입률 측정 | `template_origin`, `template_id?` | `EditorPage.tsx · EditorPage useEffect` | `cloned` origin 미분류 — templateId 있으면 모두 `owned` 처리됨 |
+| `MP_templateGallery_search` | 갤러리 검색 | 갤러리 검색 사용률 | `query_length`, `sort_option` | `GalleryPage.tsx · debounce useEffect([searchQuery, sort])` | - |
+| `MP_templateGallery_view` | 갤러리 진입 | 갤러리 진입 파악 | `entry_point` | `GalleryPage.tsx · useEffect([])` | - |
+| `MP_templateItem_add` | 아이템 추가 | 에디터 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | `EditorPage.tsx · handleDragEnd`, `ItemPropertiesPanel.tsx · handleMoveToCanvas` | - |
+| `MP_templateItem_delete` | 아이템 삭제 | 아이템 삭제 행위 | `delete_source`(`canvas`\|`staging`), `template_id?` | `ItemPropertiesPanel.tsx · handleDelete` | `canvas`: 임시저장 이동, `staging`: 영구삭제 |
+| `MP_templateItem_update` | 아이템 속성 수정 | 아이템 속성 수정 측정 | `update_type`, `template_id?` | `ItemPropertiesPanel.tsx · handleSave` | `update_type` 항상 `"properties"` — 향후 세분화 시 개선 가능 |
+| `MP_templatePublish_fail` | 게시 실패 | 게시 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handlePublish` | - |
+| `MP_templatePublish_success` | 게시 성공 | 갤러리 게시 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handlePublish` | - |
+| `MP_templateSave_fail` | 저장 실패 | 저장 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSave` | draft 저장 실패 시 `template_id=0` 전송 (ID 생성 전) |
+| `MP_templateSave_success` | 저장 성공 | 로컬 저장 완료 | `template_id`, `template_origin`, `item_count` | `EditorHeader.tsx · handleSave` | - |
+| `MP_templateSync_fail` | 동기화 실패 | 동기화 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSyncToServer` | - |
+| `MP_templateSync_success` | 동기화 성공 | 서버 동기화 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handleSyncToServer` | - |
+| `MP_todoItem_complete` | Todo 완료 체크 | Todo 완료율 측정 | `item_type` | `TodoList.tsx · handleToggleTodo` | `custom` 타입만 전송 (eCampus todo는 완료 토글 UI 없음) |
+| `MP_todoItem_create` | Todo 추가 | Todo 입력 파악 | `source`, `has_due_date` | `TodoAddDialog.tsx · handleSubmit` | - |
+| `MP_todoItem_delete` | Todo 삭제 | Todo 삭제 파악 | `item_type` | `TodoList.tsx · handleDeleteTodo` | `custom` 타입만 전송 (eCampus todo는 삭제 UI 없음) |
+| `MP_todo_view` | Todo 탭 진입 | Todo 기능 사용 여부 | `todo_count` | `TodoList.tsx · useEffect([isLoading, ...])` | `viewOpenSentRef`로 최초 1회 보장 |

From a895b9c1d081e29ce8dacb0c48bd872426c06449 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Wed, 29 Apr 2026 01:44:10 +0900
Subject: [PATCH 29/30] fix: address GA4 review feedback

---
 .../ItemPropertiesPanel.tsx                   |  2 +-
 src/pages/EditorPage.tsx                      | 39 ++++++++++++++-----
 src/utils/analytics.ts                        | 12 +++++-
 3 files changed, 40 insertions(+), 13 deletions(-)

diff --git a/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx b/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
index d65e91d..babf93b 100644
--- a/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
+++ b/src/components/Editor/ItemPropertiesPanel/ItemPropertiesPanel.tsx
@@ -163,7 +163,7 @@ const ItemPropertiesPanelForm = ({
   const handleMoveToCanvas = () => {
     if (!isFromStaging) return;
     dispatch({ type: 'MOVE_TO_CANVAS', payload: selectedItem.templateItemId });
-    sendTemplateItemAdd('button', selectedItem.templateItemId);
+    sendTemplateItemAdd('button', templateId);
     toast.success('아이템이 캔버스에 추가되었습니다.');
   };
 
diff --git a/src/pages/EditorPage.tsx b/src/pages/EditorPage.tsx
index b436540..4de5ec9 100644
--- a/src/pages/EditorPage.tsx
+++ b/src/pages/EditorPage.tsx
@@ -5,7 +5,7 @@
  */
 
 import { useParams, useSearchParams } from 'react-router-dom';
-import { useState, useEffect } from 'react';
+import { useState, useEffect, useRef } from 'react';
 import { DndContext, DragEndEvent, DragStartEvent, DragOverlay, PointerSensor, useSensor, useSensors } from '@dnd-kit/core';
 import { EditorProvider } from '@/contexts/EditorContext';
 import { useEditorContext } from '@/hooks/useEditorContext';
@@ -27,9 +27,30 @@ type DragItemData =
   | { type: 'staging-item'; item: TemplateItem }
   | (TemplateItem & { type?: 'canvas-item' });
 
-const EditorContent = () => {
+interface EditorContentProps {
+  routeTemplateId?: number;
+  startFrom?: 'default' | 'empty';
+}
+
+const EditorContent = ({ routeTemplateId, startFrom }: EditorContentProps) => {
   const { state, dispatch } = useEditorContext();
   const [activeDragItem, setActiveDragItem] = useState<DragItemData | null>(null);
+  const hasSentEditorView = useRef(false);
+
+  useEffect(() => {
+    if (hasSentEditorView.current || !state.template) return;
+
+    const origin = routeTemplateId
+      ? state.template.cloned
+        ? 'cloned'
+        : 'owned'
+      : startFrom === 'default'
+        ? 'default'
+        : 'local_only';
+
+    sendTemplateEditorView(origin, routeTemplateId);
+    hasSentEditorView.current = true;
+  }, [routeTemplateId, startFrom, state.template]);
 
   // Configure drag sensors
   const sensors = useSensors(
@@ -189,19 +210,17 @@ export const EditorPage = () => {
   const { templateId } = useParams<{ templateId: string }>();
   const [searchParams] = useSearchParams();
   const startFrom = searchParams.get('from') as 'default' | 'empty' | null;
-
-  useEffect(() => {
-    const origin = templateId ? 'owned' : startFrom === 'default' ? 'default' : 'local_only';
-    sendTemplateEditorView(origin, templateId ? parseInt(templateId) : undefined);
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
+  const parsedTemplateId = templateId ? parseInt(templateId) : undefined;
 
   return (
     <EditorProvider
-      templateId={templateId ? parseInt(templateId) : undefined}
+      templateId={parsedTemplateId}
       startFrom={startFrom || undefined}
     >
-      <EditorContent />
+      <EditorContent
+        routeTemplateId={parsedTemplateId}
+        startFrom={startFrom || undefined}
+      />
     </EditorProvider>
   );
 };
diff --git a/src/utils/analytics.ts b/src/utils/analytics.ts
index 4f74290..491dcd4 100644
--- a/src/utils/analytics.ts
+++ b/src/utils/analytics.ts
@@ -218,11 +218,11 @@ export async function sendExtensionOpen(
     // 전송할 이벤트를 조건에 따라 배열로 누적 — GA4 MP는 단일 요청에 이벤트 배열 지원
     const events: { name: string; params: Record<string, GAEventParam> }[] = [];
 
-    // 기기 최초 설치 후 첫 실행에만 1회 전송 (chrome.storage에 플래그 영구 저장)
+    // 기기 최초 설치 후 첫 실행에만 1회 전송 (전송 성공 후 chrome.storage에 플래그 저장)
     const firstOpenSent = await getStorage<boolean>("firstOpenSent");
+    const shouldMarkFirstOpenSent = !firstOpenSent;
     if (!firstOpenSent) {
       events.push({ name: "extension_first_open", params: baseParams });
-      await setStorage({ firstOpenSent: true });
       if (DEBUG_MODE) debugLog("[GA] extension_first_open queued");
     }
 
@@ -243,6 +243,14 @@ export async function sendExtensionOpen(
       body: JSON.stringify(payload),
     });
 
+    if (!response.ok) {
+      throw new Error(`GA lifecycle request failed: ${response.status} ${response.statusText}`);
+    }
+
+    if (shouldMarkFirstOpenSent) {
+      await setStorage({ firstOpenSent: true });
+    }
+
     if (DEBUG_MODE) {
       debugLog("[GA] Lifecycle events sent:", events.map((e) => e.name));
       debugLog("[GA] Response status:", response.status, response.statusText);

From 4c8cc50830297114514197eb2be649ac5094c705 Mon Sep 17 00:00:00 2001
From: fast1597 <fast1597@gmail.com>
Date: Wed, 29 Apr 2026 02:10:22 +0900
Subject: [PATCH 30/30] fix: address GA4 taxonomy review

---
 docs/GA4-Data-Taxonomy.md         | 14 +++----
 docs/GA4-Taxonmy_Conventioning.md | 61 -------------------------------
 src/pages/GalleryPage.tsx         |  4 +-
 3 files changed, 8 insertions(+), 71 deletions(-)
 delete mode 100644 docs/GA4-Taxonmy_Conventioning.md

diff --git a/docs/GA4-Data-Taxonomy.md b/docs/GA4-Data-Taxonomy.md
index e0b79e7..d7deab9 100644
--- a/docs/GA4-Data-Taxonomy.md
+++ b/docs/GA4-Data-Taxonomy.md
@@ -128,11 +128,11 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | `template_apply` | 구현됨 | 실제 메인 화면 적용 행동 | `template_id`, `template_origin`, `is_default` | P0 |
 | `template_delete` | 구현됨 | 템플릿 삭제 | `template_id`, `template_origin`, `sync_status` | P2 |
 | `template_gallery_open` | 구현됨 | 갤러리 진입 | `entry_point` | P1 |
-| `template_gallery_search` | 구현됨 | 갤러리 검색 사용 | `query_length`, `sort_option` | P2 |
-| `template_gallery_sort_change` | 구현됨 | 정렬 변경 | `sort_option` | P3 |
-| `template_clone_success` | 구현됨 | 공개 템플릿 복제 성공 | `posted_template_id`, `author_id_present` | P1 |
+| `template_gallery_search` | 구현됨 | 갤러리 검색 및 정렬 사용 | `query_length`, `sort_option` | P2 |
+| `template_gallery_sort_change` | 통합됨 | 정렬 변경 | `template_gallery_search`의 `sort_option`으로 통합 | P3 |
+| `template_clone_success` | 구현됨 | 공개 템플릿 복제 성공 | `posted_template_id`, `is_author_id_present` | P1 |
 | `template_clone_fail` | 구현됨 | 복제 실패 | `posted_template_id`, `error_code`, `error_message?` | P2 |
-| `template_like_toggle` | 구현됨 | 좋아요 사용 | `posted_template_id`, `liked` | P2 |
+| `template_like_toggle` | 구현됨 | 좋아요 사용 | `posted_template_id`, `is_liked` | P2 |
 
 ## Alerts / Todo / Labs Events
 
@@ -183,7 +183,7 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | `auth_email_verification_start/success` | `MP_authEmailVerification_start/success` | prefix + camelCase |
 | `auth_logout` | `MP_auth_logout` | prefix 적용 |
 | `settings_open` | `MP_settings_open` | prefix 적용 |
-| `settings_credentials_saved/deleted` | `MP_settingsCredentials_save/delete` | prefix + camelCase + 과거형 제거 |
+| `settings_credentials_saved/deleted` | `MP_settingsCredentials_save/delete` | prefix + camelCase, 이벤트명은 동작형 save/delete 사용 |
 | `template_editor_open` | `MP_templateEditor_view` | prefix + _view 진입 컨벤션 |
 | `template_create_start` | `MP_template_createStart` | prefix + camelCase action |
 | `template_item_add/update/delete` | `MP_templateItem_add/update/delete` | prefix + camelCase object |
@@ -291,8 +291,8 @@ LinKU의 가장 기본 가치인 "교내외 링크를 빠르게 연다"를 측
 | `MP_template_likeToggle` | 좋아요 토글 | 좋아요 사용 파악 | `posted_template_id`, `is_liked` | `GalleryPage.tsx · handleLike` | - |
 | `MP_templateClone_fail` | 복제 실패 | 복제 실패 파악 | `posted_template_id`, `error_code`, `error_message?` | `GalleryPage.tsx · handleClone catch` | - |
 | `MP_templateClone_success` | 복제 성공 | 공개 템플릿 복제 성공 | `posted_template_id`, `is_author_id_present` | `GalleryPage.tsx · handleClone` | - |
-| `MP_templateEditor_view` | 에디터 진입 | 에디터 진입률 측정 | `template_origin`, `template_id?` | `EditorPage.tsx · EditorPage useEffect` | `cloned` origin 미분류 — templateId 있으면 모두 `owned` 처리됨 |
-| `MP_templateGallery_search` | 갤러리 검색 | 갤러리 검색 사용률 | `query_length`, `sort_option` | `GalleryPage.tsx · debounce useEffect([searchQuery, sort])` | - |
+| `MP_templateEditor_view` | 에디터 진입 | 에디터 진입률 측정 | `template_origin`, `template_id?` | `EditorPage.tsx · EditorContent useEffect` | 기존 템플릿은 로드된 `template.cloned` 값으로 `owned`/`cloned` 구분 |
+| `MP_templateGallery_search` | 갤러리 검색/정렬 | 갤러리 검색 및 정렬 사용률 | `query_length`, `sort_option` | `GalleryPage.tsx · debounce useEffect([searchQuery, sort])` | 검색어가 없어도 정렬 변경 시 `query_length=0`으로 전송 |
 | `MP_templateGallery_view` | 갤러리 진입 | 갤러리 진입 파악 | `entry_point` | `GalleryPage.tsx · useEffect([])` | - |
 | `MP_templateItem_add` | 아이템 추가 | 에디터 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | `EditorPage.tsx · handleDragEnd`, `ItemPropertiesPanel.tsx · handleMoveToCanvas` | - |
 | `MP_templateItem_delete` | 아이템 삭제 | 아이템 삭제 행위 | `delete_source`(`canvas`\|`staging`), `template_id?` | `ItemPropertiesPanel.tsx · handleDelete` | `canvas`: 임시저장 이동, `staging`: 영구삭제 |
diff --git a/docs/GA4-Taxonmy_Conventioning.md b/docs/GA4-Taxonmy_Conventioning.md
deleted file mode 100644
index c109e87..0000000
--- a/docs/GA4-Taxonmy_Conventioning.md
+++ /dev/null
@@ -1,61 +0,0 @@
-## 구현된 이벤트 전체 레퍼런스
-
-`src/utils/analytics.ts`에 정의된 헬퍼 기준 알파벳 순 정리.
-모든 헬퍼는 `sendGAEvent` (internal) → GA4 MP `/mp/collect`로 전송된다.
-
-### 레거시 이벤트 (v1.5.46~, 연속성 유지)
-
-| 이벤트명 | 항목 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 / 잔존이슈 |
-| --- | --- | --- | --- | --- | --- |
-| `button_click` | 버튼 클릭 | 미승격 버튼 범용 클릭 | `button_name`, `button_location?` | `MainLayout.tsx` (logo·settings·github), `SettingsDialog.tsx` (password_toggle·open_template_list) | 제품 의미 큰 버튼은 개별 MP_ 이벤트로 승격 권장 |
-| `error` | 렌더 오류 발생 | runtime 오류 집계 | `error_code`, `error_message`, `screen_name?` | `App.tsx · ErrorBoundary onError` | React 렌더 오류만 포착, network/API 오류 미포착 |
-| `link_click` | 링크 클릭 | LinKU 핵심 가치 행동 측정 | `link_name`, `link_url`, `link_group?`, `same_host_variant?` | `LinkGroup.tsx · GridItem onClick`, `GridItemSameHost onClick` | - |
-| `page_view` | 팝업 열기 | 실제 사용 시작 기록 (레거시) | `page_title`, `page_location`, `page_referrer` | `App.tsx · useEffect → sendPageView` | sendExtensionOpen과 함께 호출 |
-| `setting_change` | 계정 정보 변경 | eCampus 자격증명 변경 (레거시) | `setting_name`, `setting_value` | `SettingsDialog.tsx` 내부 병렬 발송 | MP_settingsCredentials_* 와 동시 발화 |
-| `tab_change` | 탭 선택 | 탭 사용 패턴 파악 | `tab_name`, `feature_area?` | `TabsLayout.tsx · handleTabChange` | - |
-
-### 신규 이벤트 (택소노미 정립 후, MP_ prefix)
-
-| 이벤트명 | 항목 | 수집 목적 | 수집 속성 | 사용 코드 | 비고 / 잔존이슈 |
-| --- | --- | --- | --- | --- | --- |
-| `extension_first_open` | 최초 실행 | 첫 사용 cohort 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | `firstOpenSent` 플래그로 기기당 1회 보장 |
-| `extension_open` | 팝업 열기 | 실제 사용 시작 기록 | `screen_name`, `entry_point` | `App.tsx · useEffect → sendExtensionOpen` | - |
-| `extension_session_start` | 세션 시작 | 세션 기준 정의 | `screen_name`, `entry_point` | `App.tsx · sendExtensionOpen` 내부 자동 처리 | 30분 inactivity 초과 시에만 전송 |
-| `MP_alerts_view` | 공지 탭 진입 | 공지 탭 사용 여부 | `view_mode`, `category` | `Alerts.tsx · initialize()` | - |
-| `MP_alertsItem_open` | 공지 클릭 | 공지 클릭률 측정 | `alert_id`, `category`, `source` | `AlertItem.tsx · handleClick` | - |
-| `MP_alertsSubscription_update` | 구독 변경 | 학과 구독 변경 파악 | `category`, `subscription_result`(`subscribe`\|`unsubscribe`) | `SubscriptionManager.tsx · handleSubscribe`, `handleUnsubscribe` | - |
-| `MP_authEmailVerification_start` | 이메일 인증 시작 | 게스트→회원 전환 시작점 | `ui_location` | `EmailVerificationDialog.tsx · useEffect([open])` | 다이얼로그 재진입마다 전송 → funnel 시작 수 과집계 가능 |
-| `MP_authEmailVerification_success` | 이메일 인증 완료 | 회원 전환 완료 | `domain_type` | `EmailVerificationDialog.tsx · handleVerifyCode` | - |
-| `MP_authLogin_fail` | 로그인 실패 | 로그인 장애 파악 | `provider`, `error_code`, `error_message` | `SettingsDialog.tsx · handleGoogleLogin` (결과·예외 분기) | - |
-| `MP_authLogin_start` | 로그인 시도 | 로그인 의도 파악 | `provider`, `ui_location` | `SettingsDialog.tsx · handleGoogleLogin` | - |
-| `MP_authLogin_success` | 로그인 성공 | 실제 로그인 성공률 측정 | `provider`, `is_guest` | `SettingsDialog.tsx · handleGoogleLogin` | - |
-| `MP_auth_logout` | 로그아웃 | 로그아웃 행동 파악 | `ui_location` | `SettingsDialog.tsx · handleLogout` | - |
-| `MP_banner_open` | 배너 클릭 | 배너 클릭 효율 측정 | `banner_id`, `banner_title`, `banner_position` | `ImageCarousel.tsx · Image onClick` | - |
-| `MP_labsFeature_use` | Labs 기능 사용 | Labs 기능 사용 측정 | `feature_name`, `result?` | `QRGeneratorSection.tsx · regenerate()`, `LibrarySeatSection.tsx · handleOpenRoom` | ServerClockSection 미연결 (passive 기능) |
-| `MP_labs_open` | Labs 다이얼로그 진입 | Labs 탭 진입 파악 | (없음) | `LabsDialog.tsx · useEffect([open])` | - |
-| `MP_search_submit` | 검색 실행 | 검색 기능 사용률 측정 | `search_term`, `search_location?` | `MainLayout.tsx · Header onKeyDown(Enter)` | - |
-| `MP_settings_open` | 설정 열기 | 설정 진입 측정 | `entry_point` | `MainLayout.tsx · Settings onClick` | - |
-| `MP_settingsCredentials_delete` | 계정 정보 삭제 | eCampus 계정 삭제 파악 | `result`(=`success`) | `SettingsDialog.tsx · deleteCredentials` | setting_change 레거시와 병렬 발송 |
-| `MP_settingsCredentials_save` | 계정 정보 저장 | eCampus 계정 저장 파악 | `result`(=`success`) | `SettingsDialog.tsx · saveCredentials` | setting_change 레거시와 병렬 발송 |
-| `MP_template_apply` | 템플릿 적용 | 메인 화면 적용 — 핵심 가치 행동 | `template_id`, `template_origin`, `is_default` | `TemplateListPage.tsx · handleApplyTemplate` | - |
-| `MP_template_createStart` | 템플릿 생성 시작 | 새 템플릿 생성 진입 | `template_origin`(`default`\|`empty`) | `TemplateListPage.tsx · handleCreateFromDefault`, `handleCreateEmpty` | - |
-| `MP_template_delete` | 템플릿 삭제 | 템플릿 삭제 파악 | `template_id`, `template_origin`, `sync_status` | `TemplateListPage.tsx · handleDeleteTemplate` | - |
-| `MP_template_likeToggle` | 좋아요 토글 | 좋아요 사용 파악 | `posted_template_id`, `is_liked` | `GalleryPage.tsx · handleLike` | - |
-| `MP_templateClone_fail` | 복제 실패 | 복제 실패 파악 | `posted_template_id`, `error_code`, `error_message?` | `GalleryPage.tsx · handleClone catch` | - |
-| `MP_templateClone_success` | 복제 성공 | 공개 템플릿 복제 성공 | `posted_template_id`, `is_author_id_present` | `GalleryPage.tsx · handleClone` | - |
-| `MP_templateEditor_view` | 에디터 진입 | 에디터 진입률 측정 | `template_origin`, `template_id?` | `EditorPage.tsx · EditorPage useEffect` | `cloned` origin 미분류 — templateId 있으면 모두 `owned` 처리됨 |
-| `MP_templateGallery_search` | 갤러리 검색 | 갤러리 검색 사용률 | `query_length`, `sort_option` | `GalleryPage.tsx · debounce useEffect([searchQuery, sort])` | - |
-| `MP_templateGallery_view` | 갤러리 진입 | 갤러리 진입 파악 | `entry_point` | `GalleryPage.tsx · useEffect([])` | - |
-| `MP_templateItem_add` | 아이템 추가 | 에디터 핵심 편집 행위 | `add_method`(`drag`\|`button`), `template_id?` | `EditorPage.tsx · handleDragEnd`, `ItemPropertiesPanel.tsx · handleMoveToCanvas` | - |
-| `MP_templateItem_delete` | 아이템 삭제 | 아이템 삭제 행위 | `delete_source`(`canvas`\|`staging`), `template_id?` | `ItemPropertiesPanel.tsx · handleDelete` | `canvas`: 임시저장 이동, `staging`: 영구삭제 |
-| `MP_templateItem_update` | 아이템 속성 수정 | 아이템 속성 수정 측정 | `update_type`, `template_id?` | `ItemPropertiesPanel.tsx · handleSave` | `update_type` 항상 `"properties"` — 향후 세분화 시 개선 가능 |
-| `MP_templatePublish_fail` | 게시 실패 | 게시 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handlePublish` | - |
-| `MP_templatePublish_success` | 게시 성공 | 갤러리 게시 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handlePublish` | - |
-| `MP_templateSave_fail` | 저장 실패 | 저장 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSave` | draft 저장 실패 시 `template_id=0` 전송 (ID 생성 전) |
-| `MP_templateSave_success` | 저장 성공 | 로컬 저장 완료 | `template_id`, `template_origin`, `item_count` | `EditorHeader.tsx · handleSave` | - |
-| `MP_templateSync_fail` | 동기화 실패 | 동기화 실패 파악 | `template_id`, `error_code`, `error_message` | `EditorHeader.tsx · handleSyncToServer` | - |
-| `MP_templateSync_success` | 동기화 성공 | 서버 동기화 성공 | `template_id`, `item_count` | `EditorHeader.tsx · handleSyncToServer` | - |
-| `MP_todoItem_complete` | Todo 완료 체크 | Todo 완료율 측정 | `item_type` | `TodoList.tsx · handleToggleTodo` | `custom` 타입만 전송 (eCampus todo는 완료 토글 UI 없음) |
-| `MP_todoItem_create` | Todo 추가 | Todo 입력 파악 | `source`, `has_due_date` | `TodoAddDialog.tsx · handleSubmit` | - |
-| `MP_todoItem_delete` | Todo 삭제 | Todo 삭제 파악 | `item_type` | `TodoList.tsx · handleDeleteTodo` | `custom` 타입만 전송 (eCampus todo는 삭제 UI 없음) |
-| `MP_todo_view` | Todo 탭 진입 | Todo 기능 사용 여부 | `todo_count` | `TodoList.tsx · useEffect([isLoading, ...])` | `viewOpenSentRef`로 최초 1회 보장 |
diff --git a/src/pages/GalleryPage.tsx b/src/pages/GalleryPage.tsx
index e390163..ed9566d 100644
--- a/src/pages/GalleryPage.tsx
+++ b/src/pages/GalleryPage.tsx
@@ -94,9 +94,7 @@ export const GalleryPage = () => {
 
     searchTimeoutRef.current = setTimeout(() => {
       setDebouncedQuery(searchQuery);
-      if (searchQuery.trim()) {
-        sendTemplateGallerySearch(searchQuery.trim().length, sort);
-      }
+      sendTemplateGallerySearch(searchQuery.trim().length, sort);
     }, 300);
 
     return () => {