# 커스텀
커스텀에서는 커스텀 이벤트 설정과 커스텀 데이터 설정을 할 수 있습니다.
## **커스텀 이벤트**
### **커스텀 이벤트란?**
커스텀 이벤트 설정 페이지에서는 커스텀 이벤트 생성에 필요한 정보를 입력할 수 있습니다.
{% hint style="info" %}
생성된 커스텀 이벤트는 세그먼트 및 캠페인의 트리거에서 활용 가능합니다.
{% endhint %}
\
커스텀 이벤트 활용을 위해서는 설정 화면에서 이벤트를 생성한 뒤, 고객사 홈페이지에서 해당 이벤트 발생에 따라 그루비에서 제공하는 `groobee.customEvent` 함수를 호출해 주시면 됩니다.
이때 호출하는 시점은 그루비 스크립트가 모두 로드된 이후 호출되어야 합니다.(페이지 로드 이후)
{% hint style="success" %}
이벤트는 캠페인 클릭과 상품 조회와 같은 고객과의 상호 작용을 의미합니다.
커스텀 이벤트를 활용하면 그루비에서 제공하는 기본 이벤트 외 별도 이벤트를 생성하여 타겟팅 등에 활용 할 수 있습니다.
{% endhint %}
### **커스텀 이벤트 사용 절차**
커스텀 이벤트를 사용하려면 다음의 순서를 따르세요.
1. 이벤트 생성: 설정 > 커스텀 이벤트 화면에서 이벤트명과 데이터 타입을 지정한 뒤 저장하세요.
2. 그루비 함수 호출: 그루비 스크립트 함수를 호출하여 이벤트키와 이벤트 내용을 보내세요.
#### **이벤트 생성**
이벤트 설정 영역에서 이벤트명과 데이터 타입을 지정한 후 저장하여 커스텀 이벤트를 생성합니다.
1. 이벤트키: 이벤트마다 부여되는 고유한 값입니다. 생성한 이벤트에 대한 데이터를 그루비에 보낼 때 사용합니다.
2. 이벤트명: 그루비 관리자 화면에서 보여지는 이벤트 이름 입니다. 최대 30자까지 입력 가능합니다.
3. 데이터 타입: 사용할 이벤트의 데이터 형식을 지정합니다. 문자열(String) 혹은 숫자(Int)로 지정하여 사용가능합니다.
{% hint style="warning" %}
이벤트를 생성한 후 그루비 함수를 호출하여 데이터를 그루비에 보내주어야 커스텀 이벤트를 활용한 타겟팅이 가능합니다.
{% endhint %}
#### **그루비 함수 호출**
커스텀 이벤트 함수 요건(이벤트키, 이벤트 내용 포함)에 맞춰 그루비 함수를 호출합니다.
| 역할 | 커스텀 이벤트 | | |
| ---- | ------------------- | ----- | ------ |
| 함수명 | groobee.customEvent | | |
| 파라미터 | eventKey | 이벤트키 | string |
| | eventValue | 이벤트내용 | string |
**작성 예**
```
groobee.customEvent("eventKey1", "addCart");
groobee.customEvent("eventKey2", "scroll 80%");
```
***
## **커스텀 데이터**
### **커스텀 데이터란?**
커스텀 데이터 생성에 필요한 정보를 입력할 수 있습니다.
{% hint style="info" %}
생성된 커스텀 데이터는 세그먼트에서 활용 가능합니다.
{% endhint %}
커스텀 데이터 활용을 위해서는 설정 화면에서 데이터를 생성한 뒤, 그루비에서 제공하는 REST API를 호출해 주시면 됩니다.
{% hint style="success" %}
커스텀 데이터를 활용하면 자체적으로 보유하고 계신 데이터를 그루비와 연동하여 원하는 조건에 맞는 고객을 타겟팅 할 수 있습니다.
{% endhint %}
**예시) 회원 생일월 정보로 월별 생일인 고객에게 생일 혜택 안내하기**
{% hint style="warning" %}
커스텀 데이터 변수는 시점(과거/현재/과거x현재) 선택과 관계없이 캠페인이 고객에게 노출되는 순간을 기준으로 \
설정한 세그먼트 조건과 일치하는 고객을 타겟팅 합니다.
{% endhint %}
### **커스텀 데이터 사용 절차**
커스텀 데이터를 사용하려면 다음의 순서를 따라 주세요.
1. 데이터 생성: 설정 > 커스텀 데이터 화면에서 데이터명과 데이터 타입을 지정한 뒤 저장하세요.
2. REST API 호출: 그루비에서 제공하는 커스텀 데이터 연동 REST API를 호출하여 데이터 키와 데이터 값을 보내세요.
#### **데이터 생성**
데이터 설정 영역에서 데이터키과 데이터 타입을 지정한 후 저장하여 커스텀 데이터를 생성합니다.
1. 데이터키: 데이터마다 부여되는 고유한 값입니다. 데이터를 그루비에 보낼 때 사용합니다.
2. 데이터 타입: 사용할 데이터 형식을 지정합니다. 문자열(String)/숫자(Int)/날짜(Date)로 지정하여 사용가능합니다.
{% hint style="warning" %}
데이터를 생성한 후 그루비에서 제공하는 커스텀 데이터 REST API를 호출하여 데이터 값을 그루비에 보내주어야 커스텀 데이터를 활용한 타겟팅이 가능합니다.
{% endhint %}
#### **REST API 호출**
커스텀 데이터 사용을 위한 REST API 호출 방법은 [개발자 가이드 > 커스텀 데이터](https://docs.groobee.ai/developer-guide/api-guide/custom-data/v2) 를 참고하세요.\
### **활용**
**커스텀 데이터를 활용한 오프사이트 메시지 발송**
온사이트에서 회원으로 로그인한 이력이 없어도 회원 API 연동하여 전화번호를 연동하고, 커스텀 데이터를 설정하여 그루비에서 카카오톡 캠페인, SMS 캠페인 발송이 가능합니다.
{% hint style="warning" %}
\* 세그먼트 만들기에서 커스텀 데이터 변수 단독으로 활용하는 경우에만 사용이 가능합니다.\
(커스텀 데이터 외의 다른 변수와 결합 시에는 사이트에 회원 로그인 이력이 있어야 타겟팅 됩니다.)
{% endhint %}
#### **설정 순서**
* 1\. 회원 API를 통해 회원 ID별 전화번호, 수신 동의 여부 확인(SMS)을 저장합니다.
* 2\. \[설정 > 커스텀 > 커스텀 데이터]에서 사용할 데이터를 설정합니다.
* 3\. \[세그먼트 타겟팅 > 새로운 세그먼트 만들기 > 활용 범위 : 오프사이트 > 변수 유형 : 커스텀 데이터] 선택,\
변수 조건 설정 후 세그먼트를 저장합니다.(\* 다른 변수와 조합시에는 사이트에 회원 로그인 이력이 있어야 타겟팅 됩니다.)
* 4\. 세그먼트 저장 후 \[카카오톡 or SMS 캠페인 만들기 > 캠페인 만들기 1단계 기본 설정 > 타겟 유형 : 세그먼트 > 세그먼트 불러오기]에서 저장한 커스텀 데이터 세그먼트를 변수로 선택한 후 캠페인을 생성하여 발송합니다.
***
## **차이점**
그루비에서 기본으로 제공하는 세그먼트 변수 외에 원하는 조건을 직접 조합하여 고객을 타겟팅 하고자 할 때 사용합니다.
두 방식의 차이점은 아래와 같습니다.
커스텀 데이터
커스텀 이벤트
데이터 연동 방법
REST API & Java Script
Java Script
데이터 연동 시점
원하는 시점
자사 홈페이지에 접속한 고객이 특정 행동을 수행했을 때
활용 범위
세그먼트 타겟팅 변수로 활용
1. 세그먼트 타겟팅 변수로 활용
2. 온사이트 캠페인 생성 시 노출 조건 설정 어드민 캠페인 생성 시 → (옵션 설정>트리거 조건)
***
### **우리 사이트에서는 어떤 방식을 사용해야 하나요?**
자체적으로 보유하고 있는 데이터를 활용해서 고객을 타겟팅 하고 싶어요. 👉 커스텀 데이터 사용
자체적으로 쌓아놓은 데이터는 없지만 그루비와 연계해서 내가 원하는 조건에 맞는 특정 고객들을 타겟팅 하고 싶어요. 👉 커스텀 이벤트 사용
