콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

HubSpot 추적 코드 설치

마지막 업데이트 날짜: 2026년 4월 14일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

요약

HubSpot 추적 코드는 각 HubSpot 계정에 고유하며, HubSpot이 귀하의 웹사이트 트래픽을 모니터링할 수 있게 해줍니다. 이 추적 코드는 HubSpot 블로그 페이지, 랜딩 페이지 및 웹사이트 페이지에 자동으로 포함됩니다.

외부 호스팅 페이지(즉, HubSpot에 속하지 않은 페이지)가 있는 경우, 해당 페이지의 분석 데이터를 수집하려면 HubSpot 추적 코드를 수동으로 설치해야 합니다. 또한 개발자와 협력하여 추가 코드를 설치하여 데이터를 HubSpot 페이지 유형별로 분류할 수도 있습니다. 추적 코드를 통해 웹사이트 방문자를 추적하는 방법에 대해 자세히 알아보세요.

다음 기능을 사용하는 경우 HubSpot 추적 코드 사용하면 방문자의 데이터 가 수집되어 웹사이트 트래픽을 모니터링하는 데 사용됩니다. 또한 HubSpot은 HubSpot 추적 코드를 통해 수집된 특정 데이터를 사용하여 Breeze Intelligence 상용 데이터 세트를 포함한 HubSpot의 제품 및 서비스를 개선합니다. 계정 설정으로 이동하여 해당 계정에 대한 HubSpot과의 데이터 공유를 비활성화할 수 있습니다. HubSpot 추적 코드가 수집하는 데이터에 대해 자세히 알아보세요.

참고:

  • 한 페이지에 여러 개의 HubSpot 추적 코드를 설치해서는 됩니다. 여러 개의 HubSpot 추적 코드가 설치된 경우, 페이지에서 가장 먼저 로드된 코드가 실행되며, 그 이후의 HubSpot 추적 코드는 로드되지 않습니다.
  • IT 관리자나 웹 개발자가 코드를 설치하는 경우, 해당 담당자는HubSpot 사용자 계정을 보유하고 있어야 합니다.
  • 단일 페이지 애플리케이션(SPA)을 사용하는 경우, 개발자 문서를 참조하여 추적을 설정하십시오.
  • 전체 도메인 또는 하위 도메인을 외부에서 호스팅하는 경우, HubSpot의 설정에 해당 도메인 및/또는 하위 도메인을 추가해야 합니다.
  • AMP 사이트에서는 추적 코드가 지원되지 않습니다.
  • 외부 사이트에서 WordPress를 사용하는 경우, HubSpot All-in-One Marketing - Forms, Pop-ups, Live Chat WordPress 플러그인을 설치하여 사용하는 것이 좋습니다. 이 플러그인은 WordPress 사이트에 HubSpot 추적 코드를 설치합니다.
  • 방문자가 광고 차단기를 설치한 경우, 추적 코드의 작동에 지장을 줄 수 있습니다.

 

HubSpot 추적 코드 복사 방법

  1. HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
  2. 추적 및 분석설정으로 이동하세요:
    • 그 외의 모든구독 플랜의경우, 왼쪽 사이드바 메뉴에서 '추적 및 분석 ' > '추적 코드 '로 이동하세요.
  3. '임베드 코드' 섹션에서 '복사'를 클릭하거나 '웹 개발자에게 이메일 보내기'를 클릭하여 사이트에 추적 코드를 설치할 팀원에게 코드를 전송하세요.

    The "Tracking code installation" settings, showing the "Embed code" section and highlighting the "Copy" button below the embed code.
  4. 웹사이트에 추적 코드를 설치하세요.

웹사이트에 HubSpot 추적 코드 설치 방법

추적 코드를 설치하려면 사이트의 각 페이지 HTML 코드에서 닫는 </body> 태그 바로 앞에 코드를 붙여넣으십시오. 추적 코드를 설치한 후에는 설치 확인 방법과 코드 문제 해결 방법을 알아보십시오.

동시에, 대부분의 콘텐츠 관리 시스템(CMS)과 개발자는 모든 페이지에서 참조되는 푸터 파일과 같이 사이트의 모든 페이지에 코드를 설치할 수 있습니다. 개발자에게 이 작업을 지원하는 방법에 대해 문의해 보십시오.

HubSpot에서 호스팅되지 않는 페이지에 추적 코드를 추가한 후에는, 해당 외부 사이트 도메인을 보고서 설정에 추가하여 HubSpot 분석에 포함시켜야 합니다. 

특정 콘텐츠 관리 시스템을 사용하는 경우 다음 섹션이 도움이 될 수 있습니다.

참고: 모든 웹사이트의 구조가 다르기 때문에, 이 단계들이 HTML 코드에 접근하는 정확한 방법과 일치하지 않을 수 있습니다. 사이트의 HTML 코드에 접근하는 방법을 잘 모르겠다면, 웹마스터, IT 부서 또는 개발자에게 문의하여 이 문서를 보여주십시오.
 

WordPress 웹사이트에 HubSpot 추적 코드를 설치하는 방법

HubSpot All-in-One Marketing - Forms, Pop-ups, Live Chat WordPress 플러그인을 설치하여 사용하는 것을 강력히 권장합니다. 이 플러그인은 WordPress 웹사이트에 HubSpot 추적 코드를 자동으로 설치해 줍니다.

HubSpot WordPress 플러그인을 설치할 수 없는 경우에만 HubSpot 추적 코드를 수동으로 설치할 수 있습니다:

  1. 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
  2. WordPress 계정에 로그인합니다.
  3. 왼쪽 사이드바 메뉴에서 '외관 > 편집기'로 이동합니다.
  4. 편집기 오른쪽의 테마 파일 목록에서 'Footer'를 선택합니다.
  5. 추적 코드를 붙여넣고 '파일 업데이트'를 선택하세요.

참고:
  • 추적 코드를 수동으로 설치하고 HubSpot Marketing Hub 구독을 보유하고 있는 경우, HubSpot은 분석에서 WordPress 게시물과 페이지를 구분할 수 없습니다.
  • 웹사이트가 WordPress.com에서 호스팅되는 경우, 비즈니스 플랜을 이용하지 않는 한 웹사이트에 HubSpot 추적 코드를 추가할 수 없습니다. 다른 플랜(예: 프리미엄, 개인)에서는사용자가 JavaScript 코드를 추가할 수 없습니다.

Shopify 사이트에 HubSpot 추적 코드를 설치하는 방법

참고: Shopify(데이터 동기화) 통합 기능을 설치하면 HubSpot 추적 코드가 Shopify 스토어에 자동으로 추가됩니다. 


  1. 위 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하세요.
  2. Shopify 관리자 대시보드에 로그인하세요.
  3. 왼쪽 사이드바 메뉴에서 '온라인 스토어' > '테마'로 이동하세요.
  4. '작업' 드롭다운 메뉴를 클릭하고 '코드 편집'을 선택하세요.
  5. 사용 중인 테마의 theme.liquid 파일을 선택하세요.

  1. 이 파일에서 </body> 태그 바로 앞에 HubSpot 추적 코드를 붙여넣으세요.
  2. 오른쪽 상단에서 '저장'을 클릭합니다.

Drupal 사이트에 HubSpot 추적 코드 설치 방법

  1. 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하십시오.
  2. Drupal 관리자 대시보드에 로그인합니다.
  3. 메인 탐색 메뉴에서 '구조'로 이동합니다.
  4. '블록'을 클릭합니다.

  1. '+ 블록 추가'를 클릭합니다.
  2. 새 블록의 필드를 입력합니다. '블록 본문' 필드에 추적 코드를 붙여넣은 다음 '블록 저장'을 클릭합니다.

Magento 사이트에 HubSpot 추적 코드 설치 방법

위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하십시오. 그런 다음 헤더 HTML에 타사 JavaScript 코드를 설치하는 방법에 대한 지침을 확인하려면 Magento의 디자인 사용자 가이드를 따르십시오.

Wix 사이트에 HubSpot 추적 코드를 설치하는 방법

Wix의 앱 마켓을 사용하여 페이지에 HTML 위젯을 추가하세요:

  1. 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하십시오.
  2. 사이트 대시보드에서'설정'으로 이동합니다.
  3. '고급' 섹션에서'사용자 지정 코드' 탭을 클릭합니다.
  4. 오른쪽 상단의'+ 사용자 지정 코드 추가'를클릭합니다.
  5. 텍스트 상자에 추적 코드를 붙여넣으세요. 
  6. 새 도구의 이름을 'HubSpot 추적 코드'로 설정하세요.
  7. '페이지에 코드 추가' 아래에서 '모든 페이지' 라디오 버튼을 클릭하고 드롭다운 메뉴를 사용하여 '새 페이지마다 코드 로드'를 선택하세요.
  8. '코드 배치 위치' 섹션에서 '본문 - 끝' 옵션의 라디오 버튼을 클릭합니다.
  9. '적용'을 클릭 하여 변경 사항을 저장합니다.
Wix 웹사이트에서 라이브 채팅이나 봇을 사용하는 경우, 위의 단계를 따라 모든 페이지에 채팅 플로우를 추가하거나, 개발자와 협력하여 채팅 위젯 SDK를 사용하여 특정 페이지를 대상으로 설정할 수 있습니다. .widget-refresh 메서드를 사용하여 페이지마다 다른 채팅 플로우를 지정하세요. 자세한 내용은 HubSpot 개발자 문서에서 확인하세요. 
 

Joomla 사이트에 HubSpot 추적 코드를 설치하는 방법

Joomla 사이트에 HubSpot 추적 코드를 추가하는 방법에는 두 가지가 있습니다. 두 방법 모두 먼저 위 단계에 따라 HubSpot 추적 코드를 복사해야 합니다.

Joomla 확장 프로그램 디렉토리에서 HubSpot 추적 코드를 붙여넣을 수 있는 확장 프로그램을 선택할 수 있습니다. 또는 아래 단계를 따라 추적 코드를 설치할 수도 있습니다:

  1. 관리자 계정으로 Joomla 계정에 로그인하십시오.
  2. 메인 탐색 메뉴에서 확장 기능 > 템플릿 > 템플릿으로 이동합니다.
  3. 템플릿 이름을 클릭하고 왼쪽 사이드바 메뉴에서 index.php를 선택합니다.
  4. </body> 태그 바로 위에 HubSpot 추적 코드를 붙여 넣으세요.
  5. '저장'을 클릭합니다.

Squarespace 사이트에 HubSpot 추적 코드를 설치하는 방법

  1. 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하십시오.
  2. Squarespace 계정에 로그인합니다.
  3. 왼쪽 사이드바 메뉴에서 설정으로 이동합니다.
  4. 메뉴의 웹사이트 섹션에서 고급으로 이동한 다음 코드 삽입을 선택합니다.
  5. 추적 코드를 헤더 필드에 붙여넣으세요.
  6. 왼쪽 상단에서 '저장'을 클릭하세요.

Google 태그 매니저를 사용하여 HubSpot 추적 코드를 설치하는 방법

  1. 위의 단계를 따라 HubSpot 계정에서 HubSpot 추적 코드를 복사하십시오.
  2. 새 브라우저 탭이나 창에서 Google 태그 관리자 계정에 로그인합니다.
  3. 컨테이너를 선택합니다.
  4. 왼쪽 사이드바 메뉴에서 태그로 이동합니다.
  5. '새로 만들기' 클릭합니다.

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

  1. 저장을 클릭하여 새 태그를 저장합니다.
  2. 오른쪽 상단에서 '게시'를 클릭하여 컨테이너와 태그를 저장합니다.

  1. 아직 설치하지 않았다면 웹사이트에 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' 표현식을 사용하십시오.

추가되면 외부 페이지와 관련된 데이터는 코드에서 선택한 페이지 유형으로 분류됩니다. 개발자 문서에서 이 코드의 작동 방식을 확인하세요.

이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.