From c21a1014c1622ebd78238805392064ddb431fa8f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=9C=A4=ED=98=81=EC=A4=80?= Date: Tue, 3 Nov 2026 16:36:33 +0900 Subject: [PATCH] fix: connect analytics events without duplicate pageviews --- AGENTS.md | 1 + docs/analytics.md | 14 ++++++++++++++ index.html | 4 ++-- src/layouts/RootLayout.tsx | 22 +--------------------- src/lib/analytics.ts | 14 ++++---------- 5 files changed, 22 insertions(+), 33 deletions(-) create mode 100644 docs/analytics.md diff --git a/AGENTS.md b/AGENTS.md index a92468c..6a76579 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -146,6 +146,7 @@ publishDate: "2025-12-01" # optional - 예약 발행 - hydration 관련 변경 후에는 `pnpm build`, `pnpm preview`로 `Loading...`, Suspense hidden segment, React hydration warning이 없는지 확인 ### Page Views +- `page_view`는 GA4 자동 측정(초기 로드·브라우저 History 변화)에서만 전송합니다. 앱이나 GTM 맞춤 이벤트 태그에서 중복 발행하지 않습니다. - Google Apps Script API로 GA 데이터 조회 - `usePageViews()` 훅: sessionStorage 캐시 (TTL 15분) - 메모리 + sessionStorage 이중 캐시 diff --git a/docs/analytics.md b/docs/analytics.md new file mode 100644 index 0000000..ff82122 --- /dev/null +++ b/docs/analytics.md @@ -0,0 +1,14 @@ +# 블로그 분석 이벤트 + +GTM 웹 컨테이너는 `GTM-T7H7JNZ5`를 사용한다. GA4 측정 ID는 `G-SW73FSL7LQ`를 유지한다. GTM 웹 컨테이너의 Google 태그가 초기 페이지 조회와 SPA History 변화를 측정한다. 앱은 `page_view`를 직접 발행하지 않는다. + +GTM 맞춤 이벤트 트리거는 아래 이벤트 이름에 정확히 일치시킨다. 전체 이벤트 정규식이나 History Change 트리거를 이 이벤트 태그에 연결하지 않는다. + +| 이벤트 | 발생 시점 | 데이터 영역의 매개변수 | +|---|---|---| +| `view_post` | 게시글 화면 진입 | `post_title`, `post_slug` | +| `search` | 검색 창에서 검색 결과 선택 | `search_term`, `result_count` | + +앱이 두 이벤트와 함께 `page_location`·`page_title`을 데이터 영역에 전달하고, GA4 이벤트 태그에서 이 값을 연결해 SPA 이동 전 주소에 이벤트가 연결되지 않도록 한다. 페이지뷰용 GA4 이벤트 태그를 추가하지 않는다. + +게시 후 첫 접속, 게시글 이동, 검색 결과 이동, 뒤로 가기에서 `page_view`가 화면당 한 번 전송되는지 확인한다. `view_post`에는 글 제목·slug, `search`에는 검색어·결과 수가 전달되는지도 실제 수집 요청으로 확인한다. 전송 요청과 GA4 표준 보고서 반영은 별도로 확인한다. diff --git a/index.html b/index.html index ffdf3b9..6918b85 100644 --- a/index.html +++ b/index.html @@ -19,7 +19,7 @@ new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); - })(window,document,'script','dataLayer','GTM-NZLJVG36'); + })(window,document,'script','dataLayer','GTM-T7H7JNZ5');