# GTM 기본 코드 설치하기

GTM은 GA4·광고 픽셀·이벤트를 코드 수정 없이 한 화면에서 관리하는 도구입니다. GTM이 무엇인지 간단히 짚고, 사이트에 한 번 심어야 하는 기본 코드 두 조각(<head> 스크립트·<body> noscript)을 어디에·어떻게 넣고 설치를 확인하는지 가볍게 정리합니다.

- 카테고리: GTM
- 소요 시간: 약 4분
- 난이도: 입문
- 업데이트: 2026.06.05
- 원문: /wiki/playbook/gtm-checklist/gtm-base-code-guide

## 목차

- [GTM이 무엇인가](#what)
- [기본 코드 설치 — head·body](#code)
- [설치 확인](#verify)
- [자주 묻는 질문](#faq)

Google Tag Manager(GTM)는 GA4·광고 픽셀·이벤트를 **코드를 매번 고치지 않고 한 화면에서 관리**하는 도구입니다. 그러려면 먼저 사이트에 **GTM 기본 코드(컨테이너 스니펫)**를 한 번 심어야 합니다. 이 글은 그 기본 코드 두 조각을 어디에·어떻게 넣고 확인하는지만 간단히 정리합니다.

## GTM이 무엇인가

GTM은 사이트와 GA4 사이에 놓이는 ‘**태그 관리 허브**’입니다. 사이트에 GTM 코드를 한 번 심어 두면, 이후 GA4 전송·광고 픽셀·이벤트 추가는 코드를 다시 배포하지 않고 GTM 화면에서 켜고 끕니다. 이때 GTM이 데이터를 주고받는 통로가 `dataLayer`라는 JavaScript 객체이고, GTM 기본 코드를 로드하면 이 `dataLayer`가 준비됩니다.

큰 흐름은 ‘**사이트 → GTM → GA4**’ 한 줄입니다 — 사이트는 신호만 보내고, 어디로 보낼지는 GTM이 정합니다.

## 기본 코드 설치 — head·body

GTM 기본 코드는 **두 조각**이 한 쌍입니다. 둘 다 넣어야 동작하며, 아래 코드의 `GTM-XXXXXX` 자리에 본인 **컨테이너 ID**만 바꿔 넣으면 됩니다(형식은 고정). 컨테이너 ID는 GTM 화면 우측 상단(작업공간 이름 옆)이나 *관리자 > 컨테이너 설치 방법*에서 확인합니다.

**① 스크립트** — 공통 `<head>` 태그 안에 **가능한 한 높은 위치**로.

**공통 <head> 태그 내 (가능한 한 높은 위치)**
```html
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
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-XXXXXX');</script>
<!-- End Google Tag Manager -->
```

**② noscript** — 공통 `<body>` 태그 **시작 부분**에.

**공통 <body> 태그 시작 부분**
```html
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXX"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->
```

> **주의**
>
> **한 페이지에 한 쌍만.** 같은 코드를 여러 번 넣으면 이벤트가 중복 집계됩니다. 공통 레이아웃(헤더·푸터 템플릿)에 한 번만 넣어 모든 페이지가 공유하게 하세요.

## 설치 확인

- **GTM 미리보기(Preview)** — GTM 우측 상단 미리보기로 Tag Assistant를 띄우고 사이트 주소를 입력해 ‘Connected’가 뜨는지 봅니다.
- **개발자 도구** — 콘솔에 `dataLayer`를 입력하면 배열이 나오고, 네트워크 탭에 `gtm.js?id=GTM-XXXXXX` 요청이 보이면 정상 로드된 것입니다.

> **완료**
>
> 여기까지 확인되면 기본 코드 설치는 끝입니다. GA4 구성·이벤트 태그 설정은 이후 GTM 화면에서 이어 갑니다.

## 자주 묻는 질문

### 컨테이너 ID(GTM-XXXXXX)와 측정 ID(G-XXXXXXX)는 같은 건가요?

아닙니다. `GTM-XXXXXX`는 GTM 컨테이너 ID, `G-XXXXXXX`는 GA4 측정 ID입니다. 기본 코드에는 컨테이너 ID(`GTM-`)를 넣고, 측정 ID(`G-`)는 GTM 안의 GA4 태그 설정에 넣습니다.

### 한 조각만 넣어도 되나요?

아닙니다. `<head>` 스크립트와 `<body>` noscript는 한 쌍입니다. 스크립트만 넣고 noscript를 빼먹는 실수가 흔하니 둘 다 넣었는지 확인하세요.

### 코드를 넣었는데 미리보기가 ‘Connected’가 안 됩니다.

보통 ① 컨테이너 ID 오타, ② 캐시된 옛 페이지, ③ 광고 차단 확장프로그램이 `gtm.js`를 막음 중 하나입니다. ID를 다시 확인하고, 캐시를 비운 새 창에서, 차단 확장을 끈 채로 다시 시도해 보세요.

## Navigation

- [전체 플레이북 Markdown sitemap](/wiki/playbook/sitemap.md)

### GTM

- [GTM](/wiki/playbook/gtm-checklist)
- [GTM 기본 코드 설치 가이드](/wiki/playbook/gtm-checklist/gtm-base-code-guide) (현재 문서)
- [GTM 기본 코드 설치 가이드](/wiki/playbook/gtm-checklist/gtm-base-code-guide-client)
