GTM 미리보기 안됨: 연결 실패부터 태그 미작동까지 진단 순서

GTM 미리보기는 태그가 제대로 설치됐는지 확인하는 도구입니다. 그런데 그 미리보기가 열리지 않으면, 원인은 태그가 아니라 미리보기 창과 사이트를 잇는 연결에 있는 경우가 대부분입니다.

GTM 미리보기가 안 될 때는 먼저 어느 단계에서 막혔는지부터 가려야 합니다. 증상은 세 가지 중 하나입니다. 연결 자체가 안 되는 경우, 연결은 되는데 태그가 안 보이는 경우, 태그는 보이는데 실행되지 않는 경우입니다. 증상마다 확인할 곳이 다르기 때문에, 이걸 나누지 않고 태그부터 고치면 시간만 들고 원인은 그대로 남습니다.

아래에서 세 가지 증상별로 원인과 확인 순서를 설명합니다.

1. GTM 미리보기 안됨, 먼저 증상을 3가지로 나누세요

GTM 미리보기 버튼을 누르면 내부에서는 이런 일이 일어납니다.

① 태그 어시스턴트(tagassistant.google.com) 창이 열립니다.
② 입력한 사이트 주소 뒤에 디버그 파라미터(gtm_debug=x)가 붙어서 새 창으로 열립니다.
③ 사이트에 설치된 GTM 컨테이너가 이 파라미터를 읽고, 저장된 워크스페이스 버전을 불러옵니다.
④ 사이트 창과 태그 어시스턴트 창이 서로 통신하면서 실행된 태그를 보여줍니다.

이 네 단계 중 하나라도 끊기면 "미리보기가 안 된다"는 같은 말로 표현됩니다.

하지만 끊긴 위치에 따라 원인이 완전히 다릅니다.

-> 핵심: 표의 위쪽일수록 설치·환경 문제, 아래쪽일수록 설정 문제입니다.

위에서부터 순서대로 확인하면 헛수고를 크게 줄일 수 있습니다.

실무에서 가장 흔한 실수는 1행 증상이 나왔는데 4행 해법(트리거 수정)부터 손대는 경우입니다.

연결이 안 된 상태에서는 트리거를 아무리 고쳐도 미리보기 화면에 아무것도 뜨지 않습니다. 그래서 "고쳤는데도 안 된다"며 설정을 계속 바꾸게 되고, 나중에는 원래 멀쩡하던 태그까지 망가지는 일이 생깁니다.

2. GTM 미리보기 연결 실패: 컨테이너·URL·브라우저 순서로 점검

태그 어시스턴트에 연결 실패 메시지가 뜬다면, 아래 세 구간을 이 순서대로 보세요.

2-1. 컨테이너가 실제로 페이지에 있는지

가장 먼저 볼 것은 지금 열린 페이지에 GTM 코드가 있는지입니다.

당연해 보이지만, 연결 실패 원인으로는 이게 가장 많습니다.

확인 방법은 간단합니다.

• 페이지에서 마우스 오른쪽 버튼 → '페이지 소스 보기' → GTM-으로 검색

• 검색된 컨테이너 ID가 지금 미리보기를 누른 컨테이너 ID와 한 글자도 다르지 않은지 비교

여기서 자주 나오는 상황은 이렇습니다.

① ID 불일치
테스트 계정 컨테이너와 운영 컨테이너를 따로 만들어 두고, 사이트에는 다른 쪽 ID를 넣어 둔 경우입니다. 대행사나 외주 개발사가 바뀐 계정에서 특히 자주 보입니다.

② 일부 페이지에만 설치
메인 페이지에는 코드가 있는데 상품 상세나 결제 페이지 템플릿에는 빠진 경우입니다. 쇼핑몰 빌더를 쓸 때 '공통 영역'이 아닌 특정 페이지 영역에 코드를 넣으면 이렇게 됩니다.

③ 캐시 때문에 옛 페이지가 보이는 경우
코드를 방금 넣었는데 CDN이나 캐시 플러그인이 예전 HTML을 그대로 보여주는 경우입니다. 소스 보기에서 코드가 안 보이면 캐시를 비우고 다시 확인하세요.

④ GTM을 아예 설치할 수 없는 페이지
스마트스토어처럼 외부 스크립트를 넣을 수 없는 구조라면 미리보기는 처음부터 연결되지 않습니다. 이건 설정 문제가 아니라 플랫폼 구조의 문제이니, 다른 측정 방식을 찾아야 합니다.

-> 핵심: 소스 보기에서 컨테이너 ID가 안 나오면, 그 뒤 단계는 볼 필요가 없습니다.

2-2. 디버그 파라미터가 리디렉션에서 사라지는지

컨테이너가 있는데도 연결이 안 된다면, 다음은 URL입니다.

미리보기는 주소에 붙은 gtm_debug=x 파라미터로 디버그 모드를 켭니다. 그런데 사이트가 접속 과정에서 주소를 바꾸면 이 파라미터가 떨어져 나갈 수 있습니다.

대표적인 경우는 이렇습니다.

• http → https로 강제 이동하면서 파라미터를 버리는 경우

• example.com → www.example.com으로 이동하는 경우

• 모바일 감지 후 m. 도메인으로 보내는 경우

• 로그인·성인 인증·국가 선택 페이지를 한 번 거쳐야 하는 경우

확인은 미리보기로 열린 사이트 창의 주소창을 보면 됩니다.

주소 끝에 gtm_debug=x가 남아 있으면 정상입니다. 없어졌다면 리디렉션이 지운 것입니다.

해결 방법은 하나입니다. 태그 어시스턴트에 처음부터 최종 주소를 입력하세요.

http://example.com 대신 리디렉션이 끝난 뒤의 주소, 예를 들어 https://www.example.com/을 그대로 복사해서 넣으면 대부분 해결됩니다.

2-3. 브라우저가 연결을 막고 있는지

URL까지 정상이라면 마지막은 브라우저 환경입니다.

미리보기는 두 개의 창이 서로 통신해야 작동하기 때문에, 브라우저 보안 설정의 영향을 많이 받습니다.

아래 항목을 하나씩 빼 보세요.

실무에서 가장 빠른 방법은 확장 프로그램이 하나도 없는 새 크롬 프로필을 미리보기 전용으로 만들어 두는 것입니다.

이 프로필에서 되고 원래 프로필에서 안 된다면, 원인은 확장 프로그램이나 브라우저 설정으로 좁혀집니다.

한 가지 더 볼 것은 사이트의 콘텐츠 보안 정책(CSP)입니다.

보안 정책이 엄격한 사이트는 허용 목록에 없는 외부 스크립트를 막습니다. 이때 googletagmanager.com이 허용 목록에 없으면 GTM 자체가 실행되지 않습니다. 개발자 도구(F12) → 콘솔 탭에서 'Content Security Policy'가 들어간 빨간 오류가 보이면 이 경우입니다. 이건 마케터가 고칠 수 없으니, 개발 쪽에 허용 도메인 추가를 요청해야 합니다.

3. GTM 미리보기는 연결되는데 태그가 안 보일 때

태그 어시스턴트에 '연결됨'이 뜨는데 방금 만든 태그가 안 보이거나 '실행되지 않음'에 있다면, 이제는 설정 문제입니다.

3-1. 다른 워크스페이스를 미리보고 있지 않은지

미리보기는 버튼을 누른 그 워크스페이스의 저장된 상태를 불러옵니다.

여러 명이 같은 컨테이너를 쓰면 이런 일이 생깁니다.

• A가 '기본 워크스페이스'에서 태그를 만들었습니다.

• B가 '신규 캠페인' 워크스페이스에서 미리보기를 엽니다.

• B의 미리보기에는 A가 만든 태그가 없습니다.

또 하나 흔한 실수가 있습니다. 태그를 수정하고 저장하지 않은 채 미리보기를 누르는 경우입니다.

미리보기는 저장된 내용만 불러옵니다. 태그를 수정한 뒤에는 저장하고, 미리보기 버튼을 다시 눌러 새 세션을 여세요. 이미 열려 있던 미리보기 창은 이전 상태를 그대로 보여줄 수 있습니다.

3-2. 페이지에 컨테이너가 두 개 이상 있지 않은지

한 페이지에 GTM 컨테이너가 두 개 이상 설치된 사이트도 꽤 많습니다.

예전 대행사가 넣은 컨테이너와 지금 쓰는 컨테이너가 함께 남아 있는 경우가 대표적입니다.

이때 태그 어시스턴트는 연결된 컨테이너를 탭으로 따로 보여줍니다. 화면 위쪽에서 지금 작업 중인 컨테이너 ID가 선택돼 있는지 확인하세요. 다른 컨테이너 탭을 보고 있으면 내 태그는 당연히 안 보입니다.

컨테이너가 두 개라는 것 자체도 점검 대상입니다.

같은 픽셀이나 전환 태그가 양쪽 컨테이너에 모두 들어 있다면 전환이 두 번씩 잡힐 수 있습니다. 미리보기 문제를 확인하다가 중복 집계 원인이 같이 나오는 경우가 실무에서 의외로 많습니다.

3-3. 태그가 '실행되지 않음'에 있다면 트리거부터

태그가 목록에는 있는데 실행되지 않았다면, 태그 어시스턴트 왼쪽의 이벤트 타임라인을 보세요.

확인 순서는 이렇습니다.

① 태그가 실행돼야 했던 이벤트(예: 구매 완료 페이지 로드, 버튼 클릭)를 왼쪽 목록에서 클릭합니다.
② 태그를 클릭하면 트리거 조건 옆에 체크(충족) 또는 X(불충족) 표시가 나옵니다.
③ X가 붙은 조건이 실제로 막힌 곳입니다.

자주 나오는 불충족 원인은 다음과 같습니다.

-> 핵심: '실행되지 않음'은 태그가 고장 난 게 아니라 조건이 안 맞았다는 기록입니다. 조건의 X 표시가 답을 알려줍니다.

3-4. 동의 모드 때문에 막혀 있는지

2026년 현재 동의 모드(Consent Mode)를 쓰는 사이트가 많아지면서, 이 원인도 늘었습니다.

쿠키 동의 배너가 있는 사이트에서 테스트하는 사람이 동의를 누르지 않으면, 광고·분석 태그가 동의 대기 상태로 실행되지 않을 수 있습니다.

태그 어시스턴트에서 이벤트를 선택한 뒤 동의(Consent) 탭을 보면 각 동의 항목의 상태가 나옵니다. 태그가 요구하는 항목이 '거부'로 되어 있다면, 트리거가 아니라 동의 상태가 원인입니다. 미리보기 창에서 동의 배너의 '동의'를 누른 뒤 다시 테스트해 보세요.

4. 실무 사례로 보는 GTM 미리보기 진단 순서

4-1. 사례: 결제 완료 페이지에서만 미리보기가 끊긴 경우

한 쇼핑몰에서 구매 전환 태그를 점검하던 중 이런 상황이 있었습니다.

메인 페이지와 상품 페이지에서는 미리보기가 정상으로 연결됐습니다. 그런데 결제를 진행하면 결제 완료 페이지에서 태그 어시스턴트 연결이 끊겼습니다.

처음에는 구매 태그의 트리거 문제로 보고 조건을 여러 번 바꿨지만 결과는 같았습니다.

원인은 트리거가 아니었습니다.

결제 과정이 외부 결제대행(PG) 도메인을 거쳐 다시 쇼핑몰로 돌아오는 구조였고, 돌아오는 주소에 디버그 파라미터가 붙지 않았습니다. 여기에 결제 완료 페이지 템플릿에는 GTM 코드도 빠져 있었습니다.

결국 두 가지를 확인하고 나서야 해결됐습니다.

① 결제 완료 페이지 템플릿에 GTM 코드 추가
② 미리보기 세션을 유지한 상태에서 같은 브라우저로 결제 완료 페이지를 다시 열어 확인

이 사례에서 얻을 기준은 분명합니다.

특정 페이지에서만 미리보기가 끊긴다면, 그 페이지의 소스 보기부터 확인하세요.

트리거는 연결이 된 다음에야 의미가 있습니다. 이 순서만 지켰어도 트리거를 붙잡고 보낸 시간을 대부분 아낄 수 있었습니다.

4-2. 미리보기 안될 때 5분 점검 체크리스트

위 내용을 실제 점검 순서로 정리하면 이렇습니다.

1~4번은 연결, 5~7번은 설정입니다.

1~4번을 통과하지 못하면 5번 이후는 보지 않는 게 원칙입니다.

4-3. 미리보기 통과가 측정 완료를 뜻하지는 않습니다

마지막으로 꼭 짚을 부분이 있습니다.

미리보기에서 태그가 '실행됨'으로 나와도, 그건 브라우저에서 태그가 실행됐다는 뜻일 뿐입니다. 광고 플랫폼이 그 데이터를 제대로 받았는지는 따로 확인해야 합니다.

• 메타 픽셀이라면 이벤트 관리자의 테스트 이벤트 탭

• 구글 광고 전환이라면 전환 액션의 상태

• GA4라면 디버그 뷰

미리보기 확인 후 이 단계까지 봐야 "측정이 된다"고 말할 수 있습니다. 미리보기만 통과시키고 게시했다가, 며칠 뒤 광고 관리자에서 전환이 0건으로 나와 다시 처음부터 점검하는 경우가 실무에서 반복됩니다.

또 하나, 게시 전에 미리보기를 확인하는 것만큼 게시 후 실제 사이트에서 한 번 더 확인하는 것도 중요합니다. 미리보기는 워크스페이스 버전을, 실제 사이트는 게시된 버전을 불러오기 때문에 둘이 다를 수 있습니다.

GTM으로 픽셀을 설치하는 구체적인 태그·트리거 구성은 GTM 메타 픽셀 설치 기준: 태그·트리거·중복 방지 3단계에서, 구글 태그 설치 전체 흐름은 구글 태그 설치 순서: 광고 성과 측정 전 확인할 4단계 기준에서 확인할 수 있습니다.

자주 묻는 질문

Q. GTM 미리보기에서 "연결할 수 없음"이 계속 뜨는 이유는?
가장 흔한 원인은 페이지에 해당 컨테이너 코드가 없거나 ID가 다른 경우입니다. 그다음은 리디렉션으로 디버그 파라미터가 사라지는 경우, 그리고 광고 차단 확장 프로그램이나 팝업 차단입니다. 페이지 소스 보기 → 주소창 파라미터 → 새 브라우저 프로필 순서로 확인하세요.

Q. GTM 미리보기에서 태그를 수정했는데 반영이 안 돼요.
수정 후 저장하지 않았거나, 이전에 열어 둔 미리보기 세션을 계속 보고 있을 가능성이 높습니다. 저장한 뒤 미리보기 버튼을 다시 눌러 새 세션을 여세요. 다른 워크스페이스에서 미리보기를 연 건 아닌지도 확인해야 합니다.

Q. GTM 미리보기는 되는데 실제 사이트에서는 태그가 안 작동하나요?
미리보기는 저장된 워크스페이스 버전을 불러오고, 실제 방문자는 게시된 버전을 봅니다. 따라서 게시(제출)를 하지 않았다면 실제 사이트에는 반영되지 않습니다. 게시 후에는 각 광고 플랫폼의 테스트 도구로 수신 여부까지 확인하세요.

Q. 태그 어시스턴트 확장 프로그램이 꼭 있어야 하나요?
필수는 아닙니다. 확장 프로그램 없이도 미리보기는 새 창으로 열립니다. 다만 확장 프로그램이 다른 확장 프로그램과 충돌하거나 오래된 버전이면 오히려 연결을 방해할 수 있으니, 안 될 때는 끄고 테스트해 보는 게 좋습니다.

Q. 스마트스토어에서도 GTM 미리보기를 쓸 수 있나요?
스마트스토어는 외부 스크립트를 직접 넣을 수 없는 구조라 GTM 설치와 미리보기를 쓸 수 없습니다. 이 경우는 설정으로 해결할 수 없으니 플랫폼이 제공하는 연동 방식으로 측정을 설계해야 합니다. 관련 내용은 스마트스토어 메타 픽셀: 설치 불가 구조에서 전환 잡는 법에서 다뤘습니다.

마무리

GTM 미리보기가 안 되는 문제는 대부분 태그 자체보다 연결 단계에서 생깁니다.

그래서 진단 순서가 중요합니다.

컨테이너가 페이지에 있는지 → URL 파라미터가 살아 있는지 → 브라우저가 막고 있지 않은지를 먼저 확인하세요. 그다음에 워크스페이스, 트리거, 동의 상태를 보면 됩니다.

이 순서를 거꾸로 하면 트리거만 계속 고치다가 시간을 다 쓰게 됩니다.

그리고 미리보기 통과는 끝이 아니라 시작입니다. 광고 플랫폼에서 데이터 수신까지 확인해야 측정 세팅이 끝납니다.

다음에 미리보기가 안 된다면, 위의 7단계 체크리스트를 1번부터 순서대로 확인해 보세요.