HubSpot의 코드 마법사를 사용하여 사용자 지정 동작 이벤트를 만드는 방법

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

사용자 지정 이벤트를 생성하는 방법은 다음과 같습니다: 

• API를 통해 전송: 사용자 정의 이벤트 정의 엔드포인트를사용하여 이벤트를 생성하십시오. 그런 다음 사용자 정의 이벤트 전송 엔드포인트에서 이벤트 ID를 사용하여 이벤트 발생을 HubSpot으로 전송하십시오.
• API 없이 웹사이트에서 데이터 수집하기:
  • 자바스크립트 코드: 사용자 정의 자바스크립트를 사용하여 코드 편집기로 HubSpot 추적 스크립트에 사용자 정의 코드를 삽입할 수 있습니다.
  • 이벤트 시각화 도구 사용(Marketing Hub Enterprise 전용): 웹사이트에서 페이지 뷰 또는 클릭된 요소를 선택하여 추적합니다. 이벤트 시각화 도구를 사용한 사용자 정의 이벤트 생성 방법에 대해 자세히 알아보세요.
• 스프레드시트 가져오기: 오프라인 활동 캡처, 데이터 백필 또는 모든 도구를 HubSpot과 수동으로 통합하기 위해 이벤트 데이터가 포함된 스프레드시트를 업로드하세요.
• 웹훅 설정(DataHub Professional 및 Enterprise 전용): 웹훅 발동 조건과 전송될 데이터를맞춤 설정하세요 . 

참고: 기존 사용자 지정 이벤트 도구에서 생성된 모든 이벤트는 2025년 8월 1일 이후 더 이상 작동하지 않습니다.

이벤트 생성 과정은 두 부분으로 구성됩니다:

• HubSpot에서 이벤트 정의하기(사용자 정의 이벤트 속성 포함).
• 이벤트를 트리거할 자바스크립트 코드 스니펫 생성 또는 API 호출 정의 . 

API를 통한 이벤트 생성

API를 통해 HubSpot으로 데이터를 전송하는 경우,'API로 전송' 옵션 을 사용하거나 사용자 정의 이벤트 정의 엔드포인트를 사용하여 이벤트를 생성할 수 있습니다. HubSpot 개발자 문서에서 API 호출 정의에 대해 자세히 알아보세요.

API 호출을 위해 필요한 몇 가지 정보는 HubSpot 내에서 확인할 수 있습니다:

• 이벤트 이름: 이벤트의 내부 이름입니다. 
• 속성 이름: 데이터를 보낼 속성의 내부 이름입니다.

API를 통해 데이터를 전송할 이벤트 생성을 완료하려면:

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

기존 이벤트의 내부 이벤트 이름 및 속성 이름을 확인하려면:

1. HubSpot 계정에서데이터 관리>이벤트 관리로 이동합니다.
2. 이벤트 이름을 클릭하세요. 그러면 이벤트 세부 정보 페이지로 이동합니다.
3. 상단에서 내부 이름 아래에 있는 이벤트 이름을 찾으세요. 내부 이름을 복사하려면 이름 옆에 있는 복사 아이콘을 클릭하세요. 
   
   
4. 업데이트할 속성의 내부 이름을 찾으려면 속성 이름을 클릭하세요.
5. 오른쪽 패널에서 코드 아이콘을 클릭한 후 '내부 이름' 아래에 표시된 이름을 확인하세요.

자바스크립트 코드 스니펫으로 이벤트 생성하기

1. HubSpot 계정에서데이터 관리>이벤트 관리로 이동하세요.
2. 오른쪽 상단에서이벤트 생성을 클릭한 후 사용자 지정 이벤트 생성을 선택하세요.
3. 자바스크립트 코드를 선택합니다.

4. 이벤트 이름을 입력하고 선택적으로 이벤트 설명을 추가하세요.
5. 연관된 개체를 선택하세요. 이를 통해 이벤트 발생을 연락처, 회사, 거래, 티켓 등 HubSpot의 다양한 개체와 연결할 수 있습니다. 

6. '다음'을 클릭합니다.

속성 추가

이벤트 생성 시 기본 이벤트 속성이 제공됩니다. 사용자 정의 속성도 생성할 수 있습니다. 이벤트 속성은 다른 CRM 속성과 별도로 저장되며 이벤트에 고유합니다(즉, 계정 설정에서 이 속성을 편집할 수 없습니다). 

1. 기본 이벤트 속성 생성을 해제하려면기본 이벤트 속성을 끄도록 토글하세요.
2. 사용자 지정 속성을 생성하려면 속성의 필드 유형을 클릭하여 속성 유형을 선택하십시오. 옵션은 다음과 같습니다. 
   • 사용자 지정 문자열 속성: 일반 텍스트 문자열 속성을 생성합니다. 
   • 사용자 정의 숫자 속성: 숫자 값 속성을 생성합니다.
   • 사용자 지정 타임스탬프 속성: 날짜 값 속성을 생성합니다. 데이터를 에포크 밀리초 또는 ISO8601 형식으로 전송해야 합니다.
   • 사용자 정의 날짜 속성: 날짜 값 속성을 생성합니다.
   • 사용자 정의 부울 속성: 부울 값 속성을 생성합니다. 
   • 사용자 정의 열거형 속성: 미리 정의된 값 집합을 가진 속성을 생성합니다.
3. 속성을 선택한 후 오른쪽 패널에서 속성을 구성하세요:

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

• • • 데이터를 전송하기 전에 값과 레이블을 설정해야 합니다. 목록에 없는 데이터를 전송하기 전에 이 단계를 완료하지 않으면 해당 데이터를 사용할 수 없습니다. API를 통해 여러 값을 전송하려면 세미콜론으로 구분하십시오.

9. 다음 버튼을 클릭하세요.
10. 이벤트 및 속성을 설정한 후, 자바스크립트 코드 스니펫을 선택하여 이 이벤트를 웹사이트의 추적 코드에 추가할 수 있습니다.
11. 완료를 클릭하세요.

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

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

이벤트 데이터 가져오기

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

• 연락처 이메일 주소.
• 타임스탬프발생. 가져오기 파일에서 날짜 속성 형식에 대해 자세히 알아보세요.

예시 파일

사용자 지정 이벤트를 가져오려면:

1. HubSpot 계정에서데이터 관리>이벤트 관리로 이동하세요.
2. 오른쪽 상단에서이벤트 생성을 클릭한 다음사용자 지정 이벤트 생성을 선택합니다.
3. 스프레드시트 가져오기를 선택합니다.
4. 이벤트 이름을 입력하고 선택적으로 이벤트 설명을 입력하세요.
5. 연관 개체를 선택하세요. 현재 가져오기를 통해 생성된 이벤트는 연락처와만 연관될 수 있습니다.
6. 파일을 업로드합니다. 개체 가져오기 방법과 파일 언어를 선택한 후 다음을 클릭합니다.
7. 열을 이벤트 및 연락처 속성에매핑한 후 다음을 클릭합니다.
8. 가져오기 파일의 이름을 확인하세요.
9. 연락처가 귀하의 연락을 기대하고 있으며, 가져오기 파일에 구매한 목록이 포함되어 있지 않다는 데 동의하는 확인란을 클릭하세요. HubSpot의 허용 가능한 사용 정책에 대해 자세히 알아보세요.
10. 발생 날짜 속성의 날짜 형식을 선택하십시오.
11. 가져오기 완료를 클릭합니다.

API를 통해 이벤트 생성

1. HubSpot 계정에서데이터 관리>이벤트 관리로 이동합니다.
2. 오른쪽 상단에서이벤트 생성을 클릭한 다음사용자 지정 이벤트 생성을 선택하십시오.
3. API를 통해 보내기를 선택하세요.

4. 이벤트 이름을 입력하고, 선택적으로 이벤트 설명을 입력하세요. 

5. 사용자 지정 이벤트 속성을 추가하려면:
   • 속성 이름을 입력하세요. 이 이름은내부 이름에도적용됩니다.
   • '필드 유형' 드롭다운 메뉴를 클릭하고 필드 유형을 선택합니다.
   • 선택적으로설명을 추가하세요.
   • 추가 사용자 정의 속성을 더 추가하려면'+ 사용자 정의 속성 추가'를 클릭하세요.
   • 다음 버튼을 클릭하세요.

6. 개체를 연결하려면:
   • '기본 개체 선택' 드롭다운 메뉴를 클릭한 후 관련 개체를 선택하세요. 이를 통해 이벤트 발생을 연락처, 회사, 거래, 티켓 등 다양한 개체와 연결할 수 있습니다.
   • 맞춤 일치 설정에서 이벤트와 개체 레코드 간의 일치 ID를 선택합니다. 일치 ID가 동일한 경우에만 이벤트가 개체 레코드에 연결됩니다. 사용자 정의 일치 ID를 사용하는 경우 선택한 개체 속성은 고유 값을 요구해야 합니다.
7. 다음 버튼을 클릭합니다.
8. HubSpot에서 이벤트를 추적하려면 추적 ID 옆의복사를 클릭하세요.
9. 이벤트 생성을 클릭합니다.

웹훅 설정

웹훅을 트리거할 조건 설정

1. HubSpot 계정에서데이터 관리>이벤트 관리로 이동하십시오.
2. 오른쪽 상단에서이벤트 생성을 클릭한 다음사용자 지정 이벤트 생성을 선택하세요.
3. 웹훅 설정을 선택합니다.
4. 이벤트 이름을 입력하고관련 개체를 선택하세요.
5. '다음'을 클릭하세요.
6. 테스트 이벤트 설정:
   • 웹훅 URL을 복사합니다. 
   • 통합하려는 타사 앱의웹훅 설정 페이지로이동합니다.
   • 복사한 URL을 붙여넣으세요.
   • 테스트 이벤트 보내기를 클릭하세요.
7. '다음'을 클릭하세요.
8. 웹훅 속성을 검토하세요.속성 유형 드롭다운메뉴를 클릭하여 속성 유형을 선택하세요. 

9. '다음'을 클릭합니다.
10. HubSpot 개체 속성과 정확히 일치하는 타사 웹훅의 속성을 선택하십시오. 

사용자 정의 이벤트 데이터 활용

사용자 지정 이벤트 데이터는 HubSpot의 모든 도구에서 확인하고 사용할 수 있습니다. 아래에서 이벤트 발생을 확인하는 위치와 해당 데이터를 다른 도구에 통합하는 방법을 알아보세요.

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

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

사용자 지정 이벤트 발생은 사용자 지정 이벤트 도구에서 분석할 수 있으며, 이벤트 데이터는 사용자 지정 보고서 작성기 및 기여도 보고서에서도 확인할 수 있습니다.

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

연락처 타임라인에서 이벤트 발생 보기

이벤트 발생은 채워진 속성과 함께 연락처 레코드 타임라인에 표시됩니다.

연락처 타임라인에서 이벤트 세부 정보 확인 방법:

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

참고: 웹훅을 사용하여 생성된 사용자 지정 이벤트의 타임라인 활동은 확인할 수 없습니다.

워크플로우에서 사용자 정의 이벤트 사용

워크플로우에서 사용자 정의 이벤트 발생을 기반으로 지연을 설정하려면 이벤트 발생까지 지연 작업 또는 이벤트 등록 트리거를 사용하여 사용자 지정 이벤트 발생에 따라 지연시킬 수 있습니다.

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

참고:모든 이벤트 등록 트리거는 OR 연산자로 분리됩니다. 즉, 레코드가 워크플로에 등록되려면 이벤트 등록 트리거 중 하나만 발생하면 됩니다.

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