콘텐츠로 건너뛰기

사용자 지정 이벤트 만들기

마지막 업데이트 날짜: 2월 12, 2025

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

마케팅 Hub   Enterprise
영업 Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
콘텐츠 Hub   Enterprise

사용자 지정 이벤트를 사용하면 비즈니스에 고유한 이벤트를 정의하고 추적할 수 있습니다. 사용자 지정 이벤트는 이벤트 속성에 연결할 수 있으며, 이를 HubSpot의 여러 도구에서 사용할 수 있습니다.

사용자 지정 이벤트를 만드는 방법에는 여러 가지가 있습니다:

  • API를 통해 보내기: 사용자 지정 이벤트 정의 엔드포인트를 사용하여 이벤트를 만듭니다. 거기에서 사용자 지정 이벤트 보내기 엔드포인트와 함께 이벤트 ID를 사용하여 이벤트 완료를 HubSpot으로 보냅니다.
  • API 없이 웹사이트의 데이터를 캡처합니다:
    • 코드 자바스크립트: 사용자 지정 자바스크립트를 사용하면 코드 편집기를 사용하여 사용자 지정 코드를 HubSpot 추적 스크립트에 삽입할 수 있습니다.
    • 이벤트 시각화 도구 사용(마케팅 허브 엔터프라이즈만 해당): 웹사이트에서 페이지 조회 수 또는 클릭한 요소를 선택하여 추적합니다. 이벤트 시각화 도구로 사용자 지정 이벤트를 만드는 방법에 대해 자세히 알아보세요.
  • 스프레드시트 가져오기: 이벤트 데이터의 스프레드시트를 업로드하여 오프라인 활동을 캡처하거나, 데이터를 다시 채우거나, 모든 도구를 HubSpot과 수동으로 통합할 수 있습니다.
  • 웹훅 설정(Operations Hub Professional 및 Enterprise만 해당): 웹훅이 실행되는 조건과 전송될 데이터를 사용자 지정합니다.

참고: 사용자 지정 이벤트 도구는 이전 이벤트 레거시 도구를 대체합니다. 레거시 도구에서 만든 모든 이벤트는 계속 작동하며, 레거시 도구에서 해당 이벤트를 계속 관리하고 분석할 수 있습니다.

이벤트 생성 프로세스는 두 부분으로 구성됩니다:

  • 사용자 지정 이벤트 속성을 포함하여 HubSpot에서 이벤트 정의하기.
  • 자바스크립트 코드 스니펫을 만들거나 이벤트를 트리거할 API 호출을 정의합니다 .

API를 통해 이벤트 만들기

API를 통해 HubSpot에 데이터를 전송하는 경우 API를 통해 보내기 옵션( )을 사용하거나 사용자 지정 이벤트 정의 엔드포인트를사용하여 이벤트를 만들 수 있습니다. HubSpot의 개발자 문서에서 API 호출을 정의하는 방법에 대해 자세히 알아보세요.

API 호출에 필요한 몇 가지 정보가 필요하며, 이는 HubSpot 내부에서 얻을 수 있습니다:

  • 이벤트 이름: 이벤트의 내부 이름입니다.
  • 속성 이름: 데이터를 전송할 속성의 내부 이름입니다.

API를 통해 데이터를 전송하기 위한 이벤트 생성을 완료합니다:

  • HubSpot으로 데이터 보내기를 선택하고 추적 ID를 복사합니다.
  • 생성을 클릭합니다 .

기존 이벤트의 내부 이벤트 이름과 속성 이름을 찾습니다:

  • HubSpot 계정에서 데이터 관리 > 맞춤형 이벤트로 이동합니다.
  • 사용자 지정 이벤트를 클릭합니다.
  • 이벤트 이름을 클릭합니다. 그러면 이벤트 세부정보 페이지로 이동합니다.
  • 상단의 내부 이름에서 이벤트 이름을 찾습니다.

  • 업데이트할 속성의 내부 이름을 찾으려면 속성 이름을 클릭합니다.
  • 오른쪽 패널에서 코드 아이콘을 클릭한 다음 내부 이름 아래에서 이름을 확인합니다.
참고:
이벤트에 데이터를 전송할 때 아래 제한이 적용됩니다:
  • 속성 이름은 50자로 제한됩니다.
  • URL 및 리퍼러 속성은 최대 1024자, 다른 모든 속성은 최대 256자까지 받을 수 있습니다.
  • 각 이벤트 완료에는 최대 50개의 속성에 대한 데이터가 포함될 수 있습니다.
  • 속성 내부 이름은 문자로 시작해야 하며 소문자 a~z, 숫자 0~9, 밑줄만 포함해야 합니다. 소문자 뒤에 같은 내부 이름을 가진 속성은 중복으로 간주되며, 완료 시에는 속성 중 하나만 사용됩니다.
HTTP API 요청 시 이러한 제한을 초과하면 요청이 실패합니다. JS API 요청 시 이러한 제한을 초과하면 HubSpot은 허용된 길이로 속성 이름 값을 잘라내거나 이벤트 완료당 50개의 속성만 업데이트합니다.

자바스크립트 코드 스니펫으로 이벤트 만들기

  • HubSpot 계정에서 데이터 관리 > 맞춤형 이벤트로 이동합니다.
  • 오른쪽 상단에서 이벤트 만들기를 클릭합니다.
  • 자바스크립트 코드를 선택합니다.

  • 다음을 클릭합니다.
  • 이벤트 이름을 입력하고 선택적으로 이벤트 설명을 입력합니다.
  • 연결된 개체를 선택합니다. 이렇게 하면 이벤트 완료를 연락처, 회사, 거래티켓을 포함한 HubSpot의 다양한 개체에 연결할 수 있습니다.


  • 다음을 클릭합니다.

속성 추가

이벤트가 생성되면 기본 이벤트 속성을 사용할 수 있습니다. 사용자 지정 속성을 직접 만들 수도 있습니다. 이벤트 속성은 다른 CRM 속성과 별도로 저장되며 이벤트에 고유합니다(즉, 계정 설정에서 이러한 속성을 편집할 수 없음).

  • 기본 이벤트 속성 생성을 해제하려면 기본 이벤트 속성을 끄기로 전환합니다.
  • 사용자 지정 속성을 만들려면 해당 속성의 필드 유형을 클릭하여 속성 유형을 선택합니다. 옵션은 다음과 같습니다:
    • 사용자 지정 문자열 속성: 일반 텍스트 문자열인 속성을 만듭니다.
    • 사용자 지정숫자 속성: 숫자 값인 속성을 만듭니다.
    • 사용자 지정 타임스탬프 속성: 날짜 값인 속성을 만듭니다. 데이터를 에포크 밀리초 또는 ISO8601 형식으로 전송해야 합니다.
    • 사용자 지정 열거형 속성: 미리 정의된 값 집합으로 속성을 만듭니다.

    • 속성을 선택했으면 오른쪽 패널에서 속성을 구성합니다:

    • 속성의 이름을 입력하고 속성에 대한 설명을 입력합니다.
    • 열거형 속성의 경우 다음을 클릭하고 속성 레이블값을 입력합니다.
      • 열거형 속성은 단일 또는 다중 선택이 가능합니다. 다중 선택 값을 사용하려면 다중 값 지원 토글을 켭니다.

      • 데이터를 보내기 전에 값과 레이블을 설정해야 합니다. 목록에 없는 데이터를 보내기 전에 이 단계를 완료하지 않으면 해당 데이터를 사용할 수 없습니다. API를 통해 여러 값을 보내려면 세미콜론으로 구분하세요.
참고: 다중 선택 열거형 속성은 가져올 수 없습니다.
    • 완료를 클릭합니다.
  • 다음을 클릭합니다 .
  • 이벤트 및 해당 속성을 설정한 후 자바스크립트 코드 스니펫을 선택하여 웹사이트의 추적 코드에 이 이벤트를 추가할 수 있습니다.

자바스크립트 코드 스니펫으로 이벤트를 만들면 자동으로 HubSpot 추적 코드에 자바스크립트를 추가할 수 있습니다. 이 기능은 추적 코드가 기본적으로 캡처하지 않는 더 복잡한 이벤트 데이터를 캡처하는 데 사용할 수 있습니다.

  • 자바스크립트 코드 스니펫을 선택합니다. 오른쪽 패널의 스니펫을 사용하여 HubSpot에서 이벤트를 추적합니다. 생성된 모든 사용자 지정 속성은 코드 스니펫 내에 미리 정의됩니다.
  • 오른쪽 패널에 텍스트를 입력하여 필요에 따라 스니펫을 수정합니다. 추가하는 모든 코드는 자동으로 HubSpot 추적 코드의 일부로 포함됩니다.
  • 완료했으면 생성을 클릭하여 이벤트를 완료하고 자동으로 추적을 시작합니다.

이벤트 데이터 가져오기

대면 이벤트의 출석 데이터, HubSpot과 통합하지 않은 앱에서 가져온 타임스탬프 데이터, 공급업체의 일회성 리드 또는 캠페인 데이터 또는 기타 이벤트 데이터를 스프레드시트 형식으로 업로드하세요. 이벤트를 사용하면 행동을 캡처한 다음 HubSpot 전체에서 해당 행동을 사용할 수 있습니다.

가져오기는 연락처 레코드를 만들고 업데이트할 수 있습니다. 이벤트 가져오기는 이미 발생한 이벤트에 대해서만 사용할 수 있습니다. 사용자 지정 이벤트 가져오기 파일에는 다음이 포함되어야 합니다:

예제 파일

사용자 지정 이벤트를 가져오려면 다음과 같이 하세요:

  • HubSpot 계정에서 데이터 관리 > 맞춤형 이벤트로 이동합니다.
  • 오른쪽 상단에서 이벤트 만들기를 클릭합니다.
  • 스프레드시트 가져오기를 선택합니다.

  • 다음을 클릭합니다.
  • 이벤트 이름을 입력하고 선택적으로 이벤트 설명을 입력합니다.
  • 연결된 개체를 선택합니다. 현재 가져오기를 통해 만든 이벤트는 연락처에만 연결할 수 있습니다.

  • 열을 이벤트 및 연락처 속성에매핑한다음을 클릭합니다.
  • 가져오기 파일의 이름을 확인합니다.
  • 확인란을 클릭하여 연락처에서 연락을 받을 것으로 예상하고 가져오기 파일에 구매한 목록이 포함되지 않는다는 데 동의합니다. HubSpot의 사용 제한 정책에 대해 자세히 알아보세요.
  • 발생 날짜 속성의 날짜 형식을 선택합니다.
  • 가져오기 마침을 클릭합니다.

웹훅 설정

웹훅을 트리거할 조건을 설정합니다.

  • HubSpot 계정에서 데이터 관리 > 맞춤형 이벤트로 이동합니다.
  • 오른쪽 상단에서 이벤트 만들기를 클릭합니다.
  • 웹후크 설정을 선택합니다.
  • 다음을 클릭합니다.
  • 이벤트 이름을 입력하고 연결된 개체를 선택합니다.



  • 다음을 클릭합니다.
  • 테스트 이벤트를 설정합니다:
    • 웹훅 URL을 복사합니다.
    • 연동하려는 타사 앱의 웹후크 설정 페이지로 이동합니다.
    • 복사한 URL을 붙여넣습니다.
    • 테스트 이벤트 보내기를 클릭합니다.
  • 다음을 클릭합니다.
  • 웹훅의 속성을 검토합니다. 속성 유형 드롭다운 메뉴를 클릭하여 속성 유형을 선택합니다.
  • 다음을 클릭합니다.
  • 타사 웹훅에서 HubSpot 개체 속성과 정확히 일치하는 속성을 선택합니다.

사용자 지정 이벤트 데이터 사용

사용자 지정 이벤트 데이터는 HubSpot의 여러 도구에서 보고 사용할 수 있습니다. 아래에서 이벤트 완료를 볼 수 있는 위치와 해당 데이터를 다른 도구에 통합할 수 있는 방법을 알아보세요.

이벤트 목록, 단일 이벤트 보기 또는 분석 탭의 차트 오른쪽 상단 모서리에 있는 작업 드롭다운을 사용하여 선택한 HubSpot 도구에서 직접 선택한 이벤트를 열 수 있습니다.

사용자 지정 이벤트에 대한 보고서

사용자 지정 이벤트 완료는 사용자 지정 이벤트 도구에서 분석할 수 있으며, 이벤트 데이터는 사용자 지정 보고서 빌더 및 어트리뷰션 보고서에서도 사용할 수 있습니다.

사용자 지정 이벤트 분석에 대해 자세히 알아보세요.

연락처 타임라인에서 이벤트 완료 보기

이벤트 완료는 연락처 기록 타임라인에 채워진 모든 속성과 함께 표시됩니다.

연락처 타임라인에서 이벤트 세부정보를 보려면 다음과 같이 하세요:

  • 사용자 지정 이벤트를 완료한연락처 레코드로 이동합니다.
  • 완료된 이벤트를 기준으로 연락처 타임라인을 필터링하려면 활동 필터링을 클릭한 다음 사용자 지정 이벤트를 선택합니다.
  • 연락처 타임라인에서 이벤트를 클릭하여 확장하면 이벤트 세부정보가 표시됩니다.

워크플로우에서 사용자 지정 이벤트 사용하기

워크플로우에서 이벤트가 발생할 때까지 지연 작업 또는 이벤트 등록 트리거를 사용하여 사용자 지정 이벤트 완료에 따라 지연할 수 있습니다.

  • HubSpot 계정에서 자동화 > 워크플로로 이동합니다.
  • 워크플로우의 이름을 클릭합니다. 또는 새 워크플로를 만드는 방법을 알아보세요.
  • 트리거를 추가하려면 다음과 같이 하세요:
    • 워크플로 편집기에서 트리거 설정을 클릭합니다.
    • 왼쪽 패널에서 이벤트 발생 시기를 선택합니다. 트리거를 설정한 다음 필터 적용을 클릭합니다.
    • 트리거를 더 세분화하려면 세분화 필터 추가를 클릭합니다. 추가 속성을 선택하여 워크플로우에 등록하려는 개체를 세분화할 수 있습니다.
    • 기본적으로 레코드는 등록 트리거를 처음 충족할 때만 워크플로우에 등록됩니다. 재등록을 사용 설정하려면 [객체]를 이 워크플로에 다시 등록해야 하나요? 섹션에서 예, 트리거가 발생할 때마다 다시 등록을 선택합니다.
  • 지연을 추가하려면 다음과 같이 하세요:
    • 워크플로 편집기에서 + 더하기 아이콘을 클릭하여 워크플로 작업을 추가합니다.
    • 오른쪽 패널에서 이벤트가 발생할 때까지 지연을 선택합니다.
    • 지연을 구성합니다:
      • 이벤트 드롭다운 메뉴를 클릭한 다음 사용자 지정 이벤트를 선택합니다.
      • 그런 다음 지연시킬 이벤트 속성을 선택합니다.
      • 이벤트 속성에 대한 필터를 선택합니다.
      • 필터 적용을 클릭합니다.
      • 최대 대기 시간을 선택하거나 가능한 한 오래 지연 확인란을 선택합니다.
  • 저장을 클릭합니다.

참고: 모든 이벤트 등록 트리거는 OR 연산자를 사용하여 구분됩니다. 즉, 이벤트 등록 트리거 중 하나만 발생해야 레코드가 워크플로에 등록됩니다.

그러면 워크플로는 등록된 레코드가 지정된 사용자 지정 이벤트 기준을 충족할 때까지 지연되거나 이벤트가 발생할 때 트리거됩니다.

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