12CODE
지금 읽는 곳 미리보기 모드는 어떻게 켜고 사용하나 1 / 8
12code 라이브러리 아티클 표지. 디버깅 모드(Preview Mode) 200% 활용법: 태그 어시스턴트(Tag Assistant)를 켜고 유저 행동에 따라 태그가 정상 작동(Fired)하는지 검증

디버깅 모드(Preview Mode) 200% 활용법: 태그 어시스턴트(Tag Assistant)를 켜고 유저 행동에 따라 태그가 정상 작동(Fired)하는지 검증

미리보기 모드를 켜지 않고 바로 게시(Publish)하는 습관은, 언젠가 반드시 데이터 사고로 되돌아옵니다.

이 과목 06 / 12편 중급 3분
과목 ID83
트랙STEP 2 중급·실무
모듈2-4. 데이터 분석·퍼포먼스 테크
레슨06
난이도중급
플랫폼Google Tag Manager
발행일2026-08-29
검토일2026-08-29
관련 과목80 · 81 · 82
출처2건
핵심요약5개
01

미리보기 모드는 태그 구성을 배포 전 실시간으로 테스트하는 GTM의 핵심 기능이다

02

미리보기를 켜면 Tag Assistant 창이 열려 실행된 태그와 처리 중인 데이터를 확인할 수 있다

03

태그가 'Fired'인지 'Not Fired'인지로 트리거 조건 충족 여부를 바로 판단할 수 있다

04

모바일 앱·AMP 컨테이너는 이 디버그 인터페이스를 사용할 수 없다

05

미리보기 URL을 공유하면 동료와 같은 디버깅 세션을 함께 볼 수 있다

01

미리보기 모드는 어떻게 켜고 사용하나

tagmanager.google.com에서 컨테이너를 연 뒤 작업공간 탭의 '미리보기' 버튼을 클릭하면, 테스트할 웹사이트 URL을 입력하는 창이 뜹니다. URL을 입력하고 연결하면 새 창에서 실제 사이트가 열리면서 동시에 Tag Assistant 화면이 연결되고, 이후 사용자가 클릭·스크롤 같은 행동을 할 때마다 어떤 태그와 데이터가 발동하는지 실시간으로 하단(또는 별도 창)에 기록됩니다. 이 상태에서 아직 게시(Publish)하지 않은 임시 저장 버전의 설정까지 미리 테스트해볼 수 있다는 점이 핵심입니다.

02

Fired와 Not Fired는 무엇을 의미하나

Tag Assistant 화면에서 각 이벤트를 클릭하면 그 시점에 어떤 태그가 'Tags Fired'(발동됨)로, 어떤 태그가 'Tags Not Fired'(발동 안 됨)로 분류되어 나타납니다. 원하는 태그가 Not Fired로 남아 있다면, 그 태그에 연결된 트리거의 조건이 지금 이 순간 충족되지 않았다는 뜻입니다. 이때는 Not Fired 목록에서 해당 태그를 클릭해 어떤 트리거 조건이 어떻게 평가됐는지(참/거짓)까지 세부적으로 확인할 수 있어, 조건식의 어느 부분이 잘못됐는지 바로 좁혀갈 수 있습니다.

03

데이터레이어·변수 값도 함께 확인할 수 있다

Tag Assistant는 태그 발동 여부뿐 아니라, 그 시점의 데이터레이어 전체 내용과 각 변수가 실제로 어떤 값으로 평가됐는지도 함께 보여줍니다. '변수' 탭에서는 트리거·태그에서 사용 중인 변수들이 현재 어떤 값을 가지고 있는지 목록으로 확인할 수 있고, '데이터 영역' 탭에서는 dataLayer에 쌓인 원본 데이터를 그대로 볼 수 있습니다. 태그는 발동했는데 값이 이상하다면 이 두 탭을 함께 열어 어느 단계에서 값이 잘못 채워졌는지 추적하면 됩니다.

04

모바일 앱·AMP에서는 왜 이 기능을 못 쓰나

GTM의 디버그 인터페이스는 웹 컨테이너를 기준으로 설계되어 있어, 모바일 앱 컨테이너와 AMP 컨테이너에서는 이 방식의 미리보기를 사용할 수 없습니다. 앱 컨테이너는 파이어베이스(Firebase)의 디버그뷰나 별도 로그 도구를 활용해 검증해야 하고, AMP는 AMP 자체의 디버깅 방법을 따로 참고해야 합니다. 웹 사이트를 다루는 이 시리즈에서는 표준 미리보기 모드로 충분하지만, 향후 앱 트래킹까지 다룬다면 이 차이를 미리 알아두는 것이 좋습니다.

05

동료와 디버깅 세션을 공유하는 법

미리보기 모드의 '공유' 메뉴에서는 지금 보고 있는 디버깅 세션에 접근할 수 있는 맞춤 URL을 만들 수 있습니다. 이 URL을 개발자나 다른 마케터에게 전달하면, 같은 화면을 실시간으로 함께 보면서 태그가 왜 발동하지 않는지 실시간으로 논의할 수 있습니다. 원격으로 협업하는 팀에서는 이 기능이 "제 화면에서는 안 되는데요"라는 애매한 커뮤니케이션을 줄이는 데 특히 유용합니다.

06

게시 전 마지막 점검 루틴

새로운 태그나 트리거를 수정한 뒤에는, 관련된 모든 사용자 행동 시나리오(정상 클릭, 예외 상황, 여러 페이지 이동)를 미리보기 모드에서 한 번씩 재현해보고 Fired 상태를 확인한 다음에야 게시하는 습관을 들여야 합니다. 이 점검을 생략하고 바로 게시하면, 실제 사용자 트래픽에서 오류가 발견된 뒤에야 뒤늦게 수정하게 되어 그 사이 발생한 데이터는 이미 손실된 상태로 남습니다.

07

실전에서 자주 마주치는 Not Fired 원인 유형

현장에서 태그가 Not Fired로 남는 원인은 대체로 몇 가지 패턴으로 반복됩니다. 트리거 조건의 값 비교에서 대소문자나 공백이 미세하게 다른 경우, 데이터레이어 push 시점이 태그 실행보다 늦어 값이 아직 안 채워진 경우, 그리고 여러 조건을 '그리고(AND)'로 묶었는데 그중 하나가 실제 상황과 안 맞는 경우가 대표적입니다. 이 세 가지를 먼저 의심하고 하나씩 소거해가면 대부분의 트리거 오류는 빠르게 원인을 좁힐 수 있으며, 원인을 찾은 뒤에는 같은 실수가 다른 태그에도 반복되고 있지 않은지 컨테이너 전체를 한 번 더 훑어보는 것이 안전합니다.

08

태그가 여러 번 중복 발동하는 문제는 어떻게 잡나

반대로 태그가 의도보다 여러 번 발동하는 문제도 미리보기 모드로 확인할 수 있습니다. Tag Assistant의 이벤트 타임라인을 순서대로 넘겨보면서 같은 태그가 짧은 시간 안에 반복해서 Fired로 나타난다면, 트리거 조건이 지나치게 넓게 잡혀 있거나 같은 이벤트에 여러 트리거가 중복으로 연결되어 있을 가능성을 점검해야 합니다. 이 문제를 방치하면 실제보다 부풀려진 전환 수가 보고서에 계속 쌓이게 되고, 광고 입찰 최적화에까지 잘못된 신호로 영향을 줄 수 있습니다.

다음 행동

지금 컨테이너에서 임의로 한 가지 트리거 조건을 살짝 바꿔보고, 미리보기 모드에서 의도한 대로 Fired·Not Fired가 갈리는지 직접 확인해보세요. 이 과정을 몇 번 반복하면 트리거 조건식을 읽는 감각이 빠르게 늘어나고, 이후에는 조건식만 봐도 왜 발동하지 않는지 미리 예측할 수 있게 됩니다.

다음 글 · 레슨 07→가독성 높은 트리거 조건 설정: '일부 클릭' 설정을 활용해 특정 URL 경로(예: /order/order_completion)에서만 작동하는 트리거 짜기

← 이전 글 · 레슨 05 데이터 레이어(Data Layer) 설계와 GTM 변수 연동: 개발자가 밀어준 실시간 매출 데이터를 GTM 맞춤 변수로 파싱하는 법

출처

facts 항목 기준 · 본문 인라인 미표기2건
F-01Google Tag Manager Help Center — 컨테이너 미리보기 및 디버깅공식
F-02OpenAds — 마케터의 GTM활용 가이드 3편업계

플랫폼 기능·심의 기준·가격·법률은 바뀝니다. 이 글은 2026-08-29에 위 출처를 기준으로 확인했습니다.

CHALLENGE

배운 걸 실전 문제로 확인

카테고리별 Level Test로 실무 레벨을 점검해보세요.

챌린지 보기 →
이 과목의 게시글12편
01태그 관리의 혁신: 구글 태그 매니저(GTM)의 작동 매커니즘과 소스코드 수정 없이 광고 스크립트를 제어하는 원리02GTM 3대 구성 요소 완벽 마스터: 태그(Tag: 무엇을 보낼 것인가), 트리거(Trigger: 언제 보낼 것인가), 변수(Variable: 조건)03컨테이너(Container) 개설 및 설치 실무: 자사몰 헤드(head)와 바디(body) 영역에 GTM 기본 소스코드 에러 없이 심는 법04클릭 트리거 엔지니어링: 특정 구매 버튼의 ID(Click ID) 또는 클래스(Click Classes) 값을 추출해 클릭 이벤트 구현하기05데이터 레이어(Data Layer) 설계와 GTM 변수 연동: 개발자가 밀어준 실시간 매출 데이터를 GTM 맞춤 변수로 파싱하는 법06디버깅 모드(Preview Mode) 200% 활용법: 태그 어시스턴트(Tag Assistant)를 켜고 유저 행동에 따라 태그가 정상 작동(Fired)하는지 검증07가독성 높은 트리거 조건 설정: '일부 클릭' 설정을 활용해 특정 URL 경로(예: /order/order_completion)에서만 작동하는 트리거 짜기08제3자 광고 스크립트 통합: 메타 픽셀, 네이버 프리미엄 로그분석, 카카오모먼트 스크립트를 GTM 맞춤 HTML 태그로 단일화 관리09고급 설정 - 서버사이드(Server-side) 추적의 서막: 브라우저 단 태킹의 한계를 극복하기 위한 구글 클라우드 플랫폼(GCP) 연동 기초10버전 관리와 배포(Publish) 프로토콜: 작업 중인 태그의 오류가 라이브 사이트를 깨뜨리지 않도록 버전 이름 지정 및 워크스페이스 관리11트러블슈팅: GTM 디버거에서는 태그가 켜지는데, 실시간 GA4 대시보드에는 데이터가 들어오지 않는 원인 분석 및 즉각 교정12GTM 컨테이너 백업 및 이관: 성공적으로 구축된 태그 세트를 JSON 파일로 익스포트하여 신규 프로젝트에 임포트하는 자동화 루틴 과목 전체 보기 →

MKT TOOLS

실무자를 위한 무료 도구

카피 글자수 검사, CPC·ROAS 계산기, UTM 생성기까지.

워크스페이스 열기 →