HubSpot 추적 코드 설치
마지막 업데이트 날짜: 2025년 12월 3일
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
HubSpot 추적 코드는 각 HubSpot 계정에 고유하며, HubSpot이 귀사의 웹사이트 트래픽을 모니터링할 수 있게 합니다. 추적 코드는 HubSpot 블로그 페이지, 랜딩 페이지 및 웹사이트 페이지에 자동으로 포함됩니다.
외부 호스팅 페이지(즉, HubSpot에 속하지 않는 페이지)가 있는 경우 해당 페이지의 분석 데이터를 수집하려면 HubSpot 추적 코드를 수동으로 설치해야 합니다.
추적 코드를 통해 웹사이트 방문자를 추적하는 방법에 대해 자세히 알아보세요.
사용하는 경우 HubSpot 추적 코드를 사용하면 방문자의 데이터가가 수집되어 웹사이트 트래픽 모니터링에 활용됩니다. HubSpot은 또한 수집된 특정 데이터를 Breeze Intelligence 상업용 데이터셋을 포함한 HubSpot 제품 및 서비스 개선에 사용합니다. 계정 설정으로 이동하여 HubSpot과의 데이터 공유를 비활성화할 수 있습니다. HubSpot 추적 코드가 수집하는 데이터에 대해 자세히 알아보세요.
참고:
- 한 페이지에 여러 개의 HubSpot 추적 코드를 설치해서는 안 됩니다. 여러 개의 HubSpot 추적 코드가 설치된 경우, 페이지에 가장 먼저 로드된 코드가 실행되며 이후의 HubSpot 추적 코드는 로드되지 않습니다.
- IT 관리자나 웹 개발자가 코드를 설치하는 경우, 해당 담당자는HubSpot 사용자 계정이 있어야 합니다.
- 단일 페이지 애플리케이션을 사용하는 경우 추적 설정을 위해 개발자 문서를 참조하십시오.
- 도메인 전체 또는 하위 도메인을 외부에서 호스팅하는 경우, HubSpot 설정에도 해당 도메인 및/또는 하위 도메인을 추가해야 합니다.
- 추적 코드는 AMP 사이트에서 지원되지 않습니다.
- 외부 사이트에서 WordPress를 사용하는 경우 HubSpot All-in-One Marketing - Forms, Pop-ups, Live Chat WordPress 플러그인을 설치하여 사용하는 것이 좋습니다. 이 플러그인은 WordPress 사이트에 HubSpot 추적 코드를 설치합니다.
- 방문자가 광고 차단기를 설치한 경우 추적 코드에 방해가 될 수 있습니다.
HubSpot 추적 코드 복사하기
- HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
- 추적 및 분석설정으로 이동하세요:
-
Marketing Starter 또는 HubSpot 무료 도구만 사용 가능한 계정의 경우, 왼쪽 사이드바 메뉴에서 추적 코드로 이동하세요.
- 기타 모든구독 유형의경우, 왼쪽 사이드바 메뉴에서 추적 및 분석 > 추적 코드로 이동하세요.
-
- 임베드 코드 섹션에서 복사를 클릭하거나 내 웹 개발자에게 이메일을 클릭하여 추적 코드를 사이트에 설치할 팀원에게 보내세요.

- 웹사이트에 추적 코드를 설치하세요.
웹사이트에 추적 코드 설치
추적 코드를 설치하려면 사이트 각 페이지의 HTML 코드에서 닫는 </body> 태그 앞에 코드를 붙여넣으세요. 추적 코드 설치 후에는 설치 확인 방법과 코드 문제 해결 방법을 알아보세요.
동시에 대부분의 콘텐츠 관리 시스템(CMS)과 개발자는 사이트의 모든 페이지에 코드를 설치할 수 있습니다(예: 모든 페이지에서 참조되는 푸터 파일). 개발자에게 이 작업을 수행하는 방법을 문의하세요.
HubSpot에서 호스팅되지 않는 페이지에 추적 코드를 추가한 후에는 해당 외부 사이트 도메인을 보고서 설정에 추가하여 HubSpot 분석에 포함시켜야 합니다.
특정 콘텐츠 관리 시스템을 사용하는 경우 다음 섹션도 도움이 될 수 있습니다.
WordPress 웹사이트에 추적 코드 설치하기
HubSpot 올인원 마케팅 - 양식, 팝업, 라이브 채팅 WordPress 플러그인을 설치하여 사용하는 것이 좋습니다. 이 플러그인은 WordPress 웹사이트에 HubSpot 추적 코드를 자동으로 설치해 줍니다.
HubSpot WordPress 플러그인을 설치할 수 없는 경우에만 HubSpot 추적 코드를 수동으로 설치할 수 있습니다:
- 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
- WordPress 계정에 로그인하세요.
- 왼쪽 사이드바 메뉴에서 외관 > 편집기로 이동합니다.
- 편집기 오른쪽의 테마 파일 목록에서 'Footer'를 선택하세요.
- 추적 코드를 붙여넣고 '파일 업데이트'를 선택하세요.
![]()
- 추적 코드를 수동으로 설치하고 HubSpot Marketing Hub 구독을 보유하고 있는 경우, HubSpot은 분석에서 WordPress 게시물과 페이지를 구분할 수 없습니다.
- 웹사이트가 WordPress.com에서 호스팅되는 경우, 비즈니스 플랜을 사용하지 않는 한 웹사이트에 HubSpot 추적 코드를 추가할 수 없습니다. 다른 플랜(예: 프리미엄, 개인)은사용자가 자바스크립트 코드를 추가하는 것을 허용하지 않습니다.
Shopify 사이트에 추적 코드 설치하기
참고: Shopify(데이터 동기화) 통합을 설치하면 HubSpot 추적 코드가 Shopify 스토어에 자동으로 추가됩니다.
- 위 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
- Shopify 관리자 대시보드에 로그인하세요.
- 왼쪽 사이드바 메뉴에서 온라인 스토어 > 테마로 이동합니다.
- 작업 드롭다운 메뉴를 클릭하고 코드 편집을 선택하세요.
- 사용 중인 테마의 theme.liquid 파일을 선택하세요.

- 이 파일의 </body> 태그 바로 앞에 HubSpot 추적 코드를 붙여넣으세요.
- 오른쪽 상단에서 저장을 클릭합니다.
Drupal 사이트에 추적 코드 설치
- 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
- Drupal 관리자 대시보드에 로그인합니다.
- 메인 탐색 메뉴에서 구조로 이동합니다.
- 블록을 클릭하세요.

- + 블록 추가를 클릭합니다.
- 새 블록의 필드를 입력하세요. 추적 코드를 [ 블록 본문 ] 필드에 붙여넣은 후 [ 블록 저장]을 클릭하세요.
Magento 사이트에 추적 코드 설치
위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요. 그런 다음 헤더 HTML에 타사 JavaScript 코드를 설치하는 방법에 대한 지침은 Magento의 디자인 사용자 가이드를 따르세요.
Wix 사이트에 추적 코드 설치하기
Wix의 앱 마켓을 사용하여 페이지에 HTML 위젯을 추가하세요:
- 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
- 사이트 대시보드에서설정으로 이동합니다.
- 고급 섹션에서사용자 정의 코드탭을 클릭합니다.
- 오른쪽 상단의+ 사용자 정의 코드 추가를클릭합니다.
- 텍스트 상자에 추적 코드를 붙여넣으세요.
- 새 도구의 이름을 HubSpot 추적 코드로 설정하세요.
- '코드 추가 대상 페이지' 에서 '모든 페이지' 라디오 버튼을 클릭하고
드롭다운 메뉴에서 '새 페이지마다 코드 로드'를 선택하세요. '코드 위치' 섹션에서 '본문 - 끝' 라디오 버튼을 클릭하세요. - 코드 배치 섹션에서 본문 - 끝 옵션을 선택합니다.
- 변경 사항을 저장하려면 적용을 클릭하세요.
Joomla 사이트에 추적 코드 설치하기
Joomla 사이트에 HubSpot 추적 코드를 추가하는 방법은 두 가지입니다. 두 방법 모두 위 단계에 따라 HubSpot 추적 코드를 복사해야 합니다.
Joomla 확장 프로그램 디렉터리에서 확장 프로그램을 선택한 후 HubSpot 추적 코드를 붙여넣을 수 있습니다. 또는 아래 단계를 따라 추적 코드를 설치할 수 있습니다:
- 관리자로 Joomla 계정에 로그인하세요.
- 메인 네비게이션 메뉴에서 확장 기능 > 템플릿 > 템플릿으로 이동합니다.
- 사용 중인 템플릿 이름을 클릭하고 왼쪽 사이드바 메뉴에서 index.php를 선택합니다.
- HubSpot 추적 코드를 </body> 태그 바로 위에 붙여넣으세요.
- 저장을 클릭하세요.
Squarespace 사이트에 추적 코드 설치
- 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
- Squarespace 계정에 로그인하세요.
- 왼쪽 사이드바 메뉴에서 설정으로 이동합니다.
- 메뉴의 웹사이트 섹션에서 고급으로 이동한 다음 코드 삽입을 선택합니다.
- 헤더 필드에 추적 코드를 붙여넣으세요.
- 왼쪽 상단에서 저장을 클릭하세요.
Google 태그 관리자를 사용하여 추적 코드 설치
- 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
- 새 브라우저 탭이나 창에서 Google 태그 관리자 계정에 로그인하세요.
- 컨테이너를 선택하세요.
- 왼쪽 사이드바 메뉴에서 태그로 이동합니다.
- 새 항목을 클릭합니다.

- '태그 구성'을 클릭하세요.
- 태그 유형에서 사용자 정의 HTML 태그를 선택하세요. 그런 다음 태그에 이름을 지정하세요.
- HTML 필드에 추적 코드를 붙여넣으세요.
- 태그 구성 아래에서 트리거를 클릭하여 실행 규칙을 설정하세요. 실행 규칙을 설정하지 않으면 태그가 실행되지 않으며 HubSpot 분석 데이터가 수집되지 않습니다.
- Google 태그 관리자 코드가 설치된 모든 페이지에서 태그가 실행되도록 하려면(권장) '모든 페이지' 옵션을 선택하세요.

- 새 태그를 저장하려면 저장을 클릭하세요.
- 오른쪽 상단에서 '게시'를 클릭하여 컨테이너와 태그를 저장하세요.

- 아직 설치하지 않았다면 웹사이트에 Google 태그 관리자를 설치하세요.
데이터를 HubSpot 페이지 유형별로 분류하기 위한 추가 코드
var _hsq = window._hsq = window._hsq || [];
_hsq.push(['setContentType', 'CONTENT_TYPE']);
콘텐츠 유형 CONTENT_TYPE 텍스트를 크레딧을 부여할 콘텐츠 유형에 대한 표현식으로 대체하세요.
- 웹사이트 페이지 콘텐츠 유형에 크레딧을 부여하려면
standard-page또는site-page표현식을 사용하십시오. - 랜딩 페이지 콘텐츠 유형에 크레딧을 할당하려면
'landing-page'표현식을 사용하세요. - 목록 페이지콘텐츠 유형에 크레딧을 할당하려면
'listing-page'표현식을 사용하세요. - 블로그 게시물콘텐츠 유형에 크레딧을 할당하려면
'blog-post'표현식을 사용하십시오. - 지식 문서콘텐츠 유형에 크레딧을 할당하려면
knowledge-article표현식을 사용하십시오.
추가하면 외부 페이지와 관련된 데이터가 코드에서 선택한 페이지 유형으로 분류됩니다. 이 코드의 작동 방식은 개발자 문서를 참조하십시오.
