이번 업데이트로 다음과 같은 기능이 제공됩니다

  • 고객사가 설정한 특정 조건으로 타겟팅 할 수 있는 ‘커스텀 이벤트’ 기능을 새롭게 추가했습니다.

커스텀 이벤트의 특징

  • 그루비 스크립트에서 일반적으로는 수집하지 않는 행동 데이터를 자유롭게 수집할 수 있습니다.
  • 수집한 정보는 다음과 같이 활용 가능합니다.
    • 세그먼트 타겟팅
    • 온사이트 캠페인의 트리거 조건
  • 이력성 행동 데이터 수집에 적합합니다.
    • 특정 기간에 발생한 이벤트 수집에 유용합니다.
      • 예) 상담 신청 완료, 환불 신청, 리뷰 작성 완료, 쿠폰 사용 등
    • 기간과 무관한 사용자 속성 수집에는 맞지 않습니다.
      • 예) 고객의 생일
  • 사전 설정 과정이 꼭 필요합니다.
    • 이어지는 커스텀 이벤트 설정 방법을 참고하세요.

커스텀 이벤트 설정 방법

커스텀 이벤트를 사용하려면 다음과 같은 작업이 필요합니다.

  1. 그루비 어드민에서 커스텀 이벤트를 정의합니다.
  2. 고객사 사이트에서 정의한 커스텀 이벤트 함수를 호출합니다.

그루비 Admin > 설정 > 커스텀 이벤트: 이벤트 정의

  • 그루비 어드민 페이지 로그인 후 설정 > 커스텀 이벤트 메뉴 탭 클릭
  • 이벤트 설정 영역에서 이벤트명과 데이터 타입을 지정한 후 저장합니다.
    • 이벤트키: 이벤트마다 부여되는 고유한 값입니다. 커스텀 이벤트 함수 호출 시 사용합니다.
    • 이벤트명: 그루비 관리자 화면에 표시되는 이벤트 이름 입니다. 세그먼트 메뉴 또는 트리거 조건에서 이벤트명으로 커스텀 이벤트를 선택합니다.
    • 데이터 타입: 이벤트 키와 함께 저장할 부가 정보의 유형이며, 문자열(String) 혹은 숫자(Int)로 지정할 수 있습니다.
  • 커스텀 이벤트는 최대 30개까지 등록 가능합니다.

고객사 사이트 > 커스텀 이벤트 함수 호출

  • 정의한 커스텀 이벤트를 고객사 사이트에서 호출해야 그루비로 커스텀 이벤트 데이터가 저장됩니다.
  • 정의한 커스텀 이벤트에 맞는 시점에 고객사에서 groobee.customEvent 함수를 호출해 주셔야 합니다.
    • 예) 리뷰 작성 커스텀 이벤트: 고객이 리뷰를 작성하고 등록을 완료한 시점에 그루비 함수 호출
  • groobee.customEvent 함수 호출 방법
    • groobee.customEvent(“eventKey”, “eventValue”)
      • eventKey: 설정에서 커스텀 이벤트 등록 시 부여되는 이벤트키 값
      • eventValue: 설정에서 정의한 데이터 타입에 맞춰 고객사에서 입력하는 이벤트 데이터
        • 이벤트 데이터를 세그먼트 및 트리거 조건으로 사용할 수 있습니다.
    • 예시:
      • groobee.customEvent(“EV0000000000001”, “addCart”);
      • groobee.customEvent(“EV0000000000002”, “80”);

사용 방법 예시 : 쿠폰 사용 커스텀 이벤트

목표: 설정한 기간에 특정 쿠폰을 사용한 고객을 타겟팅

1단계: 이벤트 정의

  • 그루비 어드민에 접속해 설정 > 커스텀 이벤트로 이동합니다.
  • 쿠폰 사용 이벤트를 등록합니다.
  • 어떤 쿠폰을 사용했는지 알 수 있도록 데이터 타입은 문자열을 선택합니다.

2단계: groobee.customEvent 함수 호출

  • 고객사 사이트에서 고객이 쿠폰을 사용할 때 다음과 같은 함수를 호출합니다.
  • groobee.customEvent(“EV1657532669830″, “FreeShipping07”);
    • EV1657532669830: 설정에서 등록한 쿠폰 사용 이벤트의 이벤트키입니다.
    • FreeShipping07: 고객이 사용한 쿠폰 코드입니다.

3단계: 세그먼트 생성

  • 커스텀 이벤트는 활용 범위를 온사이트(Web/Hybrid) 또는 온사이트(Native)로 지정한 경우에만 사용 가능합니다.



  • 시점은 과거, 현재 모두 사용 가능합니다.
    • 과거: 지정한 기간 내 해당 커스텀 이벤트가 일어났던 방문자
    • 현재: 현재 세션에서 해당 커스텀 이벤트가 발생한 방문자​
  • 변수로 커스텀 이벤트를 선택합니다.



  • 쿠폰 사용 커스텀 이벤트를 선택하고, 원하는 조건을 입력합니다.
    • 이번에는 무료 배송 쿠폰을 사용한 고객을 타겟팅하는 예시를 위해 ‘FreeShipping’ 문자열을 포함할 때로 설정하였습니다.
  • 이제 지정한 기간 또는 현재 세션에서 특정 코드의 쿠폰을 사용한 고객을 타겟팅 할 수 있습니다.

번외 1: 트리거 조건으로 활용

  • 커스텀 이벤트는 세그먼트 뿐만 아니라 온사이트 캠페인의 트리거 조건으로도 활용 가능합니다.
  • 트리거 조건은 해당 이벤트가 발생한 타이밍에 캠페인을 실행하는 기능입니다.
    • 트리거를 설정하지 않으면 페이지 이동 시 캠페인이 실행됩니다.
  • 트리거 조건에서도 이벤트 데이터를 조건으로 지정할 수 있습니다.


번외 2: 데이터 타입을 숫자(Int)로 정의하는 경우

  • 이벤트 데이터에 가격이나 횟수 같은 숫자 값을 저장하고 싶을 때 사용합니다.




  • 이벤트 데이터에 가격이나 횟수 같은 숫자 값을 저장하고 싶을 때 사용합니다.




커스텀 이벤트 기능을 활용해
그루비를 더 폭넓게 활용해보세요!