# 커스텀 설정

그루비가 기본적으로 수집하는 데이터 외에, 고객사의 서비스 특성에 맞춘 **특정 행동(이벤트)**이나 **고객 정보(데이터)**를 타겟팅에 활용하기 위해 사전 설정하는 페이지입니다.

목적에 따라 이벤트와 데이터 중 적합한 방식을 활용해 주세요.

<table><thead><tr><th width="159.8046875">구분</th><th>이벤트</th><th>데이터</th></tr></thead><tbody><tr><td><strong>목적</strong></td><td>고객의 행동 포착</td><td>고객의 정보 활용</td></tr><tr><td><strong>예시</strong></td><td>"장바구니 버튼 클릭", "동영상 재생"</td><td>"회원 등급", "보유 포인트"</td></tr><tr><td><strong>활용 범위</strong></td><td><p><strong>캠페인</strong></p><ul><li><strong>온사이트 캠페인:</strong> [캠페인 만들기 > 3단계: 옵션 설정 > 커스텀 이벤트]</li><li><strong>오프사이트 캠페인:</strong> [이벤트 트리거 캠페인 만들기 > 1단계: 기본 설정 > 트리거 설정: 이벤트]</li></ul><p><strong>세그먼트</strong></p><ul><li><strong>세그먼트 변수:</strong> [세그먼트 만들기 > 세그먼트 변수 > 커스텀]</li></ul></td><td><p><strong>세그먼트</strong></p><ul><li><strong>세그먼트 변수:</strong> [세그먼트 만들기 > 세그먼트 변수 > 커스텀]</li></ul></td></tr><tr><td><strong>데이터 연동 방식</strong></td><td>Java Script</td><td>REST API &#x26; Java Script</td></tr></tbody></table>

## **이벤트**

고객이 사이트 내에서 수행하는 특정 행동을 정의합니다. 캠페인을 노출하는 시점(Trigger)이나 세그먼트 변수로 활용됩니다.

{% hint style="warning" %}
추가한 이벤트를 사용하기 위해서는, 해당 이벤트 발생 시점에 맞춰 반드시 **그루비 함수**를 호출해야 합니다.\
[**\[스크립트 가이드 > 커스텀 이벤트\]**](/developer-guide/script-guide/custom-event.md) 문서를 참고해 주세요.
{% endhint %}

<figure><img src="/files/aeaJpEt2fv7bQ3x5isv4" alt=""><figcaption></figcaption></figure>

### **1. 이벤트 추가**

<img src="/files/m298wFhvJGy5lqXPZnFd" alt="" data-size="line"> 버튼을 클릭하여 이벤트를 추가해 주세요.

<figure><img src="/files/1A7ifZmr6kEgIvF0FvaY" alt=""><figcaption></figcaption></figure>

* **이벤트 키:** 이벤트 식별을 위한 고유 값이 자동으로 부여됩니다.
* **데이터 타입:** 해당 이벤트 발생 시 수집할 테이터의 형식을 선택해 주세요.
* **이벤트명:** 그루비 어드민(화면)에서 관리자가 식별하기 위한 이름을 입력해 주세요. (문자 구분 없이 최대 50자 입력 가능)

### **2. 검색**

검색창에 **이벤트 키**를 입력하여 원하는 항목을 찾을 수 있습니다.

### **3. 이벤트 리스트**

<figure><img src="/files/vMekxalaEsTJM0D5PGVN" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.1484375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>이벤트 키</strong></td><td>이벤트 식별을 위한 고유 값입니다.</td></tr><tr><td><strong>데이터 타입</strong></td><td> 해당 이벤트 발생 시 수집할 테이터의 형식입니다.</td></tr><tr><td><strong>이벤트명</strong></td><td>이벤트 추가 시 관리자가 식별할 수 있는 명칭입니다.</td></tr><tr><td><strong>활용 여부</strong></td><td><p>해당 이벤트가 현재 캠페인이나 세그먼트에서 사용 중인지 여부를 나타냅니다.</p><ul><li><strong>활용:</strong> 1개 이상 캠페인 또는 세그먼트에서 사용 중인 상태</li><li><strong>미활용:</strong> 어떠한 곳에서도 사용중이지 않은 상태</li></ul></td></tr></tbody></table>

#### **3-1. 관리 도구**

행(Row) 우측의 <img src="/files/pwEMOQ8ecqrBeki2Ldez" alt="" data-size="line"> 아이콘을 클릭하면, 해당 이벤트를 관리할 수 있는 메뉴가 나타납니다.

<figure><img src="/files/y2iatEUOYyncI5Lseek6" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.1796875">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/0XwdQjEr68wmbufloTF3" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 항의 <strong>데이터 타입</strong> 또는 <strong>이벤트명</strong>을 수정합니다. <strong>활용 상태</strong>의 이벤트의 경우 이벤트명만 수정할 수 있습니다.</td></tr><tr><td><img src="/files/IMev3uE8t5yBMwGc1BIj" alt="" data-size="line"> <strong>삭제</strong></td><td>선택한 항목을 영구적으로 삭제합니다. <strong>미활용</strong> 상태의 이벤트만 삭제할 수 있습니다. </td></tr></tbody></table>

***

## **데이터**

고객사가 보유한 고객 정보를 정의합니다. 정의된 데이터는 세그먼트 변수로 활용됩니다.

{% hint style="warning" %}

* 추가한 데이터를 활용하기 위해서는, 그루비에서 제공하는 REST API를 통해 데이터를 전송해야 합니다.\
  [**\[API 가이드 > 커스텀 데이터\]**](/developer-guide/api-guide/custom-data.md) 문서를 참고해 주세요.
* 커스텀 데이터를 변수로 활용하여 만들어진 세그먼트는 시점(과거/현재/과거x현재)과 관계 없이 조건에 부합하는 고객을 타겟팅합니다.&#x20;
  {% endhint %}

{% hint style="success" %}
**비로그인 회원 대상 오프사이트 메시지 발송**

사이트에 방문했지만 **로그인 이력이 없는 고객**이라도, **회원 API**를 통해 전화번호가 연동되어 있다면 커스텀 데이터를 활용해 오프사이트 메시지(카카오톡/SMS)를 발송할 수 있습니다.

**\[조건]**

* 세그먼트 생성 시 **\[커스텀 > 데이터]** 변수를 **단독**으로 사용해야 합니다.\
  (다른 변수와 조합할 경우, 로그인 이력이 있는 고객만 타겟팅 됩니다.)

**\[설정 순서]**

1. 회원 API를 통해 고객 전화번호 및 광고성 정보 수신 동의 여부 연동
2. \[커스텀 > 데이터] 추가
3. 해당 데이터를 변수로 사용한 \[세그먼트] 생성
4. \[캠페인] 생성 시 해당 세그먼트를 불러와 발송
   {% endhint %}

<figure><img src="/files/SkFKGsXFoD0TJf3Ojxga" alt=""><figcaption></figcaption></figure>

### **1. 데이터 추가**

<img src="/files/m298wFhvJGy5lqXPZnFd" alt="" data-size="line"> 버튼을 클릭하여 데이터를 추가해 주세요.

<figure><img src="/files/uwHEk7zCbnLUw6C5gwiK" alt=""><figcaption></figcaption></figure>

* **데이터 키:** 데이터 식별을 위한 고유 값을 입력해 주세요.
* **데이터 타입:** 해당 키에 대한 수집 데이터 형식을 선택해 주세요.

### **2. 검색**

검색창에 **데이터 키**를 입력하여 원하는 항목을 찾을 수 있습니다.

### **3. 데이터 리스트**

<figure><img src="/files/xegJlX8XWTnE72VkaaZF" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.1484375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>데이터 키</strong></td><td>데이터 식별을 위한 고유 값입니다.</td></tr><tr><td><strong>데이터 타입</strong></td><td> 해당 키에 대한 수집 데이터 형식입니다.</td></tr><tr><td><strong>활용 여부</strong></td><td><p>해당 데이터가 현재 세그먼트에서 사용 중인지 여부를 나타냅니다.</p><ul><li><strong>활용:</strong> 1개 이상 세그먼트에서 사용 중인 상태</li><li><strong>미활용:</strong> 어떠한 곳에서도 사용중이지 않은 상태</li></ul></td></tr></tbody></table>

#### **3-1. 관리 도구**

행(Row) 우측의 <img src="/files/pwEMOQ8ecqrBeki2Ldez" alt="" data-size="line"> 아이콘을 클릭하면, 해당 데이터를 관리할 수 있는 메뉴가 나타납니다.

<figure><img src="/files/y2iatEUOYyncI5Lseek6" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.1796875">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/0XwdQjEr68wmbufloTF3" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 항목의 <strong>데이터 키</strong> 또는 <strong>데이터 타입</strong>을 수정합니다. <strong>미활용 상태</strong>의 데이터만 수정할 수 있습니다.</td></tr><tr><td><img src="/files/IMev3uE8t5yBMwGc1BIj" alt="" data-size="line"> <strong>삭제</strong></td><td>선택한 항목을 영구적으로 삭제합니다. <strong>미활용</strong> 상태의 데이터만 삭제할 수 있습니다. </td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.groobee.ai/new-admin/settings/custom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.