# 그루비 가이드

이커머스 개인화 마케팅을 위한 단 하나의 솔루션, 그루비\
그루비는 고객 개인화 여정에 필요한 모든 기능을 제공합니다.

목표 고객의 특성을 고려한 **세그먼테이션**과 **타겟팅**을 통해 맞춤형 고객 경험을 제공하고 **다양한 캠페인**을 진행해 보세요.

## **그루비 시작하기**

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>그루비 이해하기</strong></td><td>도움말을 확인하여 그루비에 대해 알아봅니다.</td><td></td><td><a href="/pages/Vjcw7x51m3hhUHinoOkk">/pages/Vjcw7x51m3hhUHinoOkk</a></td><td><a href="/files/eclerR1a7iF9MtU5nkSl">/files/eclerR1a7iF9MtU5nkSl</a></td></tr><tr><td><strong>개인화 마케팅</strong></td><td>그루비를 활용해 개인화 마케팅을 진행해 보세요.</td><td></td><td><a href="/pages/XD11BoYcivIqj9AjpMCD">/pages/XD11BoYcivIqj9AjpMCD</a></td><td><a href="/files/M25HOqERInBet9XssOAf">/files/M25HOqERInBet9XssOAf</a></td></tr><tr><td><strong>그루비 개발자 가이드</strong></td><td>그루비의 스크립트 및 API 문서 가이드를 확인할 수 있습니다.</td><td></td><td><a href="https://docs.groobee.ai/developer-guide/script-guide">https://docs.groobee.ai/developer-guide/script-guide</a></td><td><a href="/files/Dafvr72TaoWryx6QD1ox">/files/Dafvr72TaoWryx6QD1ox</a></td></tr></tbody></table>

## **그루비 콘텐츠 ✨**

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>제품소개서 신청</strong></td><td>제품소개서를 받아보고 싶다면 신청해 보세요!</td><td><a href="/files/gXEOVak4TxlFP3r2Gb91">/files/gXEOVak4TxlFP3r2Gb91</a></td><td><a href="https://groobee.net/introduction/">https://groobee.net/introduction/</a></td></tr><tr><td><strong>업데이트 기능</strong></td><td>업데이트 된 그루비의 기능을 알아보세요.  </td><td><a href="/files/kknlHwUrAIIgGCPgJh8A">/files/kknlHwUrAIIgGCPgJh8A</a></td><td><a href="https://groobee.net/groobee/update/">https://groobee.net/groobee/update/</a></td></tr><tr><td><strong>인사이트</strong></td><td>마케터를 위한 인사이트를 공유드립니다.</td><td><a href="/files/cJh1l8q6qadhuLNXLVIk">/files/cJh1l8q6qadhuLNXLVIk</a></td><td><a href="https://groobee.net/blog/">https://groobee.net/blog/</a></td></tr></tbody></table>

**👇 다음 그루비 가이드를 읽고 마케팅을 시작해 보세요!**


# 대시보드

## **대시보드란?**

* 대시보드는 사이트의 주요 지표 및 운영 현황을 기간 별로 확인할 수 있는 기능을 제공합니다.
* 방문 수, 주문 수, 주문 전환율, 전환 금액 등의 핵심 데이터를 한눈에 파악할 수 있습니다.
* 온사이트 캠페인과 AI 상품 추천 캠페인의 진행 상황을 확인하실 수 있습니다.

<img src="/files/13ag2R6G8phsrvQpXoPz" alt="" width="563">

1. 사이트 현황
   * 방문수, 주문수, 주문 전환율, 전환 금액 등 사이트의 핵심 지표를 확인할 수 있습니다.
   * 데이터 추이에서 꺽은 선 차트를 통해 방문수 및 주문수 등의 변화를 시각적으로 확인할 수 있습니다.
2. 캠페인 현황
   * 온사이트 및 AI 상품 추천 캠페인의 진행 상황을 확인할 수 있습니다.
3. 최근 활동
   * 온사이트, 오프사이트, 설정 등 어드민 활동 내역을 확인할 수 있습니다.
4. 그루비 콘텐츠
   * 그루비에서 제공하는 보도자료와 마케팅 활용 정보 등의 다양한 콘텐츠를 확인하실 수 있습니다.

### **사이트 현황**

<img src="/files/xm5V95kQFm38ogZLBm3O" alt="" width="563">

ⓐ 기간 선택

* 오늘 : 00시부터 현재 시간 기준 직전 시간 00분까지의 데이터를 확인합니다.\
  예를 들어, 08시 35분에 확인 시 08시 00분까지의 데이터를 확인할 수 있습니다.
* 주간 : D-7부터 D-1까지의 데이터를 확인합니다.
* 월간 : D-30부터 D-1까지의 데이터를 확인합니다.

ⓑ 사이트 현황

* 방문 수 : 쿠키 ID 기준 방문 횟수입니다.\
  ※ 사용자가 30분 이상 활동이 없으면 세션이 종료되며, 세션이 종료된 후 같은 쿠키 ID 재방문 시 방문 수는 +1로 새롭게 집계됩니다.
* 주문 수 : 세션 내 캠페인이 노출된 후 상품이 주문된 횟수입니다.
* 주문 전환율 : 세션 내 캠페인 노출 후 주문 수 / 노출 수 \* 100 입니다.
* 전환 금액 : 세션 내 캠페인이 노출 후 상품이 주문된 금액의 합계입니다.

ⓒ 데이터 추이

* 방문 수, 주문 수, 주문 전환율, 전환 금액의 변화를 그래프로 제공합니다.
* 일반적으로 사이트의 자체 접속 통계보다 10\~20% 낮게 집계될 수 있습니다.

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}

{% hint style="warning" %}
외부 결제 시스템을 이용하는 경우, 일부 전환 데이터가 반영되지 않을 가능성이 있습니다.
{% endhint %}

{% hint style="warning" %}
데이터 집계 방식은 GA 세션과 동일하지만, 사이트별 환경 및 고객 행동에 따라 차이가 발생할 수 있습니다.
{% endhint %}

### **캠페인 현황**

![](/files/mA3DGCj7j5eCexIjQsfk)

ⓐ 온사이트 캠페인

* 진행 중인 온사이트 캠페인 개수를 확인하실 수 있습니다.
* 캠페인 노출 및 클릭 수를 확인 가능합니다.
* 효과가 높은 TOP 3 캠페인 랭킹을 제공하고 있습니다.

ⓑ AI 상품 추천 캠페인

* 진행 중인 AI 추천 캠페인의 개수를 확인하실 수 있습니다.
* 노출 및 클릭 수를 확인 가능합니다.
* 가장 성과가 좋은 TOP 3 캠페인을 제공하고 있습니다.

### **최근 활동**

<img src="/files/yO9rlOZk6zPhrQBAxygj" alt="" width="188">

• 최근 활동에서는 어드민에서 수행한 주요 작업과 변경 이력을 확인할 수 있습니다.

※ 최근 활동 유형

<img src="/files/uqtbudPTLwyTjPyXV3xU" alt="" width="375">

※ 최근 활동 확인

<table data-header-hidden><thead><tr><th width="64.2890625"></th><th width="331.87890625"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/2tjUNOKHGoFC1KbWSQyz" alt=""></p></td><td>캠페인을 생성하였습니다.</td><td>새로운 캠페인을 추가하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/epL1hQQg6emNxZNfCARP" alt=""></p></td><td>캠페인을 수정하였습니다.</td><td>특정 캠페인을 수정하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/cYmhqjJBsMew4oXnyseP" alt=""></p></td><td>캠페인을 삭제하였습니다.</td><td>특정 캠페인을 삭제하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/aZWy1XeSHL9TcWXeeLLz" alt=""></p></td><td>캠페인을 진행하였습니다.</td><td>특정 캠페인을 진행하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/Y7B7oziuLy4HbMV2q9v6" alt=""></p></td><td>캠페인을 중지하였습니다.</td><td>특정 캠페인을 중지하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/lJASRxQCWOHKhNW60EJl" alt=""></p></td><td>캠페인을 보관하였습니다.</td><td>특정 캠페인을 보관하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/KJqDkyU5e0wFF9LGRnHl" alt=""></p></td><td>캠페인이 자동 종료되었습니다.</td><td>특정 캠페인을 자동 종료되었을 때 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/ZFm7XkzeT6N4fGn2AYC7" alt=""></p></td><td>캠페인 분석 리포트 파일을 다운로드하였습니다.</td><td>특정 캠페인의 분석 리포트를 다운로드하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/p1So19g0r0ILjM8xLeTv" alt=""></p></td><td>회원 리스트를 다운로드하였습니다.</td><td>회원 리스트를 다운로드하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/5Rq6xH4IdVfkkEbXK0VG" alt=""></p></td><td>온사이트 캠페인의 제외 조건을 설정하였습니다.</td><td>온사이트 캠페인에서 제외 조건을 설정하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/EuAJZdFUZT46EvhbL3UY" alt=""></p></td><td>캠페인을 발송하였습니다.</td><td>캠페인을 발송하면 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/9Oj51OEjVISmclqTw9ho" alt=""></p></td><td>설정을 변경하였습니다.</td><td>설정을 변경하면 확인할 수 있습니다.</td></tr></tbody></table>

### **그루비 콘텐츠**

<img src="/files/SUKY9rsdXZ78RK8FOtH5" alt="" width="563">

그루비에서 제공하는 보도자료와 마케팅 활용 정보 등의 다양한 콘텐츠를 확인하고, 관련 자료를 다운로드 받을 수 있습니다.


# 실시간

## **실시간이란?**

* 실시간 페이지에서는 사이트에 설치된 스크립트를 통해 실시간으로 수집되는 방문자 행동 데이터를 조회할 수 있습니다.
* 데이터가 조회된다면 스크립트 정상 설치가 정상적으로 설치된 것으로 확인될 수 있습니다.
* 사이트에 방문한 고객이 지금 취하고 있는 행동을 실시간 페이지에서 확인하세요.

### **실시간 구성** <a href="#id-3109112587" id="id-3109112587"></a>

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/sthtvtj4pl/1750037422447/image.png" alt="" width="563"><figcaption></figcaption></figure>

1. 최근 30분 순방문자 수: 중복을 제외하고 집계된 최근 30분 사이트 방문자 수입니다.
2. 조회 조건: 조회 하고자 하는 항목을 선택하여 실시간 데이터를 조회할 수 있습니다.\
   선택한 조건으로 조회하기 버튼은 사용 후 10초 후 다시 조할 수 있습니다.

<table><thead><tr><th width="141.18359375">방문자 행동 필터</th><th width="282.8671875">설명</th><th>이미지</th></tr></thead><tbody><tr><td>행동 유형</td><td>13가지 행동 유형을 선택할 수 있습니다. </td><td><img src="https://files.helpdocs.io/p92xn84cjv/articles/sthtvtj4pl/1750041464608/image.png" alt=""></td></tr><tr><td>접속 유형</td><td>3가지 접속 유형을 선택할 수 있습니다.</td><td><img src="https://files.helpdocs.io/p92xn84cjv/articles/sthtvtj4pl/1750041486828/image.png" alt=""></td></tr></tbody></table>

<br>

**실시간 방문자 행동 리스트**

* 최근 수집된 데이터 중 조회 조건에 맞는 데이터가 최대 100개까지 표시됩니다.
* 스크립트가 설치되지 않았거나, 최근 수집된 데이터가 0개인 경우 조회 결과가 없을 수 있습니다.
* 데이터 항목은 다음과 같습니다

<table><thead><tr><th width="137.3515625">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td>행동 유형</td><td>13가지 행동 유형 해당하는 행동이 표시됩니다.</td></tr><tr><td>행동 내용</td><td>행동 유형의 세부 내용이 표시됩니다.<br>행동 데이터가 수집되었더라도, 세부 데이터를 수집하지 않는 경우 '데이터 없음'으로 표시될 수 있습니다.</td></tr><tr><td>회원 ID</td><td>로그인 회원은 ID가 표시되고, 그 외에는 '비로그인'으로 표시됩니다.</td></tr><tr><td>세션 행동 수</td><td>・ 한 세션 내에서 특정 방문자의 행동이 기록된 순서를 의미합니다.<br>예를 들어, 어떤 방문자가 메인→ 카테고리 → 상품 상세 순서로 사이트를 탐색한 경우 해당 방문자의 상품 상세 세션 행동 수는 3입니다.</td></tr><tr><td>플랫폼</td><td>・ 방문자가 이용 중인 플랫폼이 표시됩니다.<br>・ 웹/하이브리드 : PC 웹, 모바일 웹, 모바일 앱(하이브리드) 방문자<br>네이티브 : 모바일 앱(네이티브) 방문자</td></tr><tr><td>접속 유형</td><td>방문자의 접속 디바이스가 표시됩니다.</td></tr><tr><td>기록된 시간</td><td>행동 데이터가 수집된 시간이 표시됩니다. 리스트는 기록된 시간을 기준으로 내림차순(최근순) 정렬됩니다.</td></tr></tbody></table>

\
\ <br>

### **실시간 방문자 행동 상세** <a href="#detail" id="detail"></a>

실시간 방문자 행동 리스트에서 하나의 행을 선택하여 '실시간 방문자 행동 상세'를 확인할 수 있습니다.

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/sthtvtj4pl/1750048320468/image.png" alt="" width="563"><figcaption></figcaption></figure>

1. 방문자 정보

* 방문자에 대한 자세한 정보를 확인할 수 있습니다.
* 방문자 정보는 PC 웹, 모바일 웹, 모바일 앱(하이브리드) 방문자의 경우 쿠키 ID를 기준으로 수집됩니다.
* 총 세션, 총 행동 수는 스크립트 첫 설치 시점 이후 방문할 때마다 누적 수집된 값입니다.

2. 세션 내 행동 흐름

* 선택한 행동이 기록된 세션 내 방문자의 전체 행동 흐름을 시간 순서대로 확인할 수 있습니다.
* 나열된 항목 중 하나를 클릭하면 선택된 항목이 변경되며, 바로 오른쪽 '행동 상세 정보'도 이에 맞춰 변경됩니다.

3. 행동 상세 정보

'세션 내 행동 흐름'에서 선택되어 있는 행동의 상세 정보가 표시됩니다.


# 데이터 모니터링

그루비의 데이터 모니터링에 대해 이해합니다.

## **데이터 모니터링이란?**

* 데이터 모니터링은 온사이트 및 오프사이트 캠페인에 대한 다양한 실 데이터를 조회하고 다운로드할 수 있는 기능을 제공합니다.
* 캠페인 데이터를 쿠키나 회원 ID를 기준으로 조회할 수 있으며, 캠페인 결과 데이터를 모니터링하는 데 활용됩니다.
* 조회할 수 있는 데이터의 유형은 총 네 가지입니다.
  * 온사이트 캠페인 (쿠키 기준): 진행한 온사이트 캠페인 데이터를 쿠키를 기반으로 조회하고, 다운로드할 수 있습니다.
  * 온사이트 캠페인 내역: 설정한 기간의 온사이트 캠페인 데이터를 조회하고, 다운로드할 수 있습니다.
  * 온/오프사이트 캠페인 (ID 기준): 회원 ID를 기준으로 온사이트와 오프사이트 캠페인 데이터를 조회하고, 다운로드할 수 있습니다.
  * 오프사이트 캠페인 내역: 푸시 알림, 카카오톡, SMS 캠페인과 같은 오프사이트 캠페인의 발송 완료 내역을 조회하고, 다운로드할 수 있습니다.
* 각 유형별 조회 조건을 확인하여 조회하여 진행한 캠페인의 실제 데이터를 모니터링을 할 수 있습니다.

자세한 내용은 [데이터 모니터링 조회하기](/new-admin/monitoring/view) 문서를 확인해 주세요.


# 데이터 조회하기

## **데이터 모니터링 데이터 조회**

* 데이터 모니터링에서는 조회 기간을 설정하여 그루비에서 진행한 온사이트 및 오프사이트 캠페인 데이터를 확인할 수 있습니다.
* 탭에서 조회하고 싶은 데이터 유형을 선택하여 조회 조건을 설정한 후 데이터를 조회합니다.
* 온사이트 캠페인(쿠키 기준), 온사이트 캠페인 내역, 온/오프사이트 캠페인(ID 기준), 오프사이트 캠페인 내역 총 네 가지 유형을 확인할 수 있습니다.
* 조회한 데이터를 확인하고 다운로드하여 실 데이터를 확인할 수 있습니다.
  * 조회한 데이터는 최대 999건까지 표시되며, 다운로드하면 전체 데이터를 확인할 수 있습니다.

### **온사이트 캠페인(쿠키 기준)**

<img src="/files/QPxFiQPCh1r56jtHR9vS" alt="" width="563">

* 온사이트 캠페인(쿠키 기준) 유형에서는 설정한 날짜의 온사이트 캠페인 데이터를 쿠키 기준으로 조회할 수 있습니다.
* &#x20;조회하고 싶은 일자를 선택 후 조회 버튼을 클릭하면 해당 일자에 발생한 온사이트 캠페인 데이터를 쿠키 기준으로 확인할 수 있습니다.
* 데이터 테이블 오른쪽의 다운로드 버튼을 클릭하면 전체 데이터를 다운로드 받을 수 있습니다.

### **온사이트 캠페인 내역**

<img src="/files/PhtRT4HSSELpW9FenD0a" alt="" width="563">

* 온사이트 캠페인 내역 유형에서는 설정한 기간의 온사이트 캠페인 데이터를 조회할 수 있습니다.
* 조회하고 싶은 기간를 선택 후 조회 버튼을 클릭하면 해당 기간 안에 발생한 온사이트 캠페인 데이터를 확인할 수 있습니다.
* 조회 가능한 최대 기간은 7일입니다.
* 데이터 테이블 오른쪽의 다운로드 버튼을 클릭하면 전체 데이터를 다운로드 받을 수 있습니다.

### **온/오프사이트 캠페인(ID 기준)**

<img src="/files/BGMsJuBDtVdIkOQLC0ar" alt="" width="563">

* 온/오프사이트 캠페인(ID 기준) 유형에서는 설정한 기간의 온사이트 및 오프사이트 캠페인 데이터를 회원 ID 기준으로 조회할 수 있습니다.
* 조회하고 싶은 기간를 선택 후 조회 버튼을 클릭하면 해당 기간 안에 입력한 회원 ID의 회원 대상으로 노출되거나 발송된 온사이트 및 오프사이트 캠페인 데이터를 확인할 수 있습니다.
* 조회 가능한 최대 기간은 31일입니다.
* 데이터 테이블 오른쪽의 다운로드 버튼을 클릭하면 전체 데이터를 다운로드 받을 수 있습니다.

### **오프사이트 캠페인 내역**

<img src="/files/8nFyFK5VC3fOBjX5rp2t" alt="" width="563">

* 오프사이트 캠페인 내역 유형에서는 선택한 오프사이트 캠페인의 데이터를 조회할 수 있습니다.
* 오프사이트 채널을 선택하면 해당 채널에서 완료된 캠페인을 확인할 수 있습니다. 이 중 조회를 원하는 캠페인을 선택하여 데이터를 확인할 수 있습니다.
* 완료된 캠페인 기준 최근 31일 동안의 캠페인을 선택하여 데이터를 확인할 수 있습니다.
* 데이터 테이블 오른쪽의 다운로드 버튼을 클릭하면 전체 데이터를 다운로드 받을 수 있습니다.

{% hint style="warning" %}
현재 단일 발송의 발송 유형으로 진행된 캠페인의 데이터만 확인할 수 있습니다.
{% endhint %}

***

## FAQ

<details>

<summary>데이터 모니터링에서 확인한 성공 수와 발송 완료 탭의 발송 성공 수가 다르게 보입니다.</summary>

두 수치는 성공을 집계하는 단계가 다릅니다.

* 데이터 모니터링의 **성공**은 메시지가 실제 사용자 기기에 도달해 기기로부터 수신 확인 신호가 돌아온 경우에만 집계되는 수치입니다.
* 발송 완료 탭의 **발송 성공 수**는 그루비 서버가 구글 등의 발송 서버에 메시지를 전달하고 "정상 접수" 응답을 받은 수치입니다.

서버 입장에서는 발송 요청이 정상 처리됐더라도, 아래와 같은 사유로 실제 기기에는 도달하지 못하는 경우가 있어 두 수치 간 차이가 발생합니다.

* 사용자가 앱을 삭제한 경우
* 기기 알림 설정에서 수신을 꺼둔 경우
* 네트워크/기기 상태에 따라 일시적으로 수신이 지연되거나 안 되는 경우 (iOS에서 간헐적으로 발생)

</details>


# AI 세그먼트 타겟팅

## **AI 세그먼트 타겟팅이란?**

* 그루비 AI가 고객의 모든 행동을 분석하여 고객을 정밀하게 세그먼테이션 합니다. 빅데이터 분석, 머신러닝 기술로 AI가 자동으로 분류한 세그먼트로 고객을 타겟팅 합니다.
* 그루비의 AI 세그먼트 타겟팅은 RFM 세그먼트, 구매 확률 세그먼트, 취향 분석 세그먼트의 세 가지 종류의 세그먼트로 타겟팅할 수 있습니다.

{% hint style="warning" %}
취향 분석 세그먼트는 그루비에 별도 문의 후 사용할 수 있습니다.
{% endhint %}

### **RFM 세그먼트**

* RFM은 Recency (최근에 방문했는지), Frequency (몇 번 방문했는지), Monetary (구매 금액은 어떻게 되는지)를 기반으로 고객의 가치를 판단하는 CRM 분야의 전통적인 고객 분석 방법입니다.
* 그루비 AI는 전체 방문 고객을 10개의 RFM 세그먼트로 자동 분류하고, 각 세그먼트에 대한 인사이트를 제공합니다.

자세한 내용은 RFM 세그먼트 만들기 문서를 확인해 주세요.

### **구매 확률 세그먼트**

* 그루비 AI가 사이트 방문 고객의 구매 성향과 구매 의지 등을 계산해 구매 가능성을 확률 구간별로 예측합니다.
* 그루비 AI가 고객 행동 빅데이터를 기반으로 고객의 구매 의욕인 구매 확률을 예측합니다. 개별 고객의 다음 번 방문 시 구매할 확률을 계산하여 확률 구간별로 세그먼테이션 합니다.

자세한 내용은 [구매 확률 세그먼트 만들기](#undefined) 문서를 확인해 주세요.

### **취향 분석 세그먼트**

* 취향 분석 세그먼트는 방문자가 가진 특징을 AI LLM 모델로 분석하여 각 세그먼트에 대한 취향 인사이트를 제공합니다.
* 고객이 한 달간 둘러본 상품들을 기반으로 고객을 그룹화하고, AI가 고객 그룹의 특징을 담은 10개의 키워드를 추출합니다. AI LLM 모델을 활용하여 해당 그룹의 고객들이 선호하는 취향을 판단하고 이에 맞게 세그먼트명과 세그먼트 설명을 확인하며 원하는 세그먼트를 타겟팅할 수 있습니다.

자세한 내용은 [취향 분석 세그먼트 만들기](#undefined-1) 문서를 확인해 주세요.


# AI 세그먼트 관리하기

## **AI 세그먼트 관리**

생성한 AI 세그먼트를 관리할 수 있습니다.

<img src="/files/4ak4ezsANRQSpLiuDbI4" alt="" width="563">

### **AI 세그먼트 만들기**

<img src="/files/TOkhWYRxv5QPO8QxkJax" alt="" width="563">

* 새로운 AI 세그먼트를 만들기 위해 만들기 버튼을 클릭하여 원하는 세그먼트를 선택하여 해당 세그먼트 만들기 페이지로 이동할 수 있습니다.
* 그루비 AI 세그먼트 타겟팅에서는 RFM 세그먼트, 구매 확률 세그먼트, 취향 분석 세그먼트를 만들 수 있습니다.

{% hint style="warning" %}
취향 분석 세그먼트는 그루비팀에 별도 문의 후 사용할 수 있습니다.
{% endhint %}

### **AI 세그먼트 리스트**

* 테이블 리스트에서는 생성된 AI 세그먼트 타겟팅 리스트를 확인할 수 있습니다.
* 테이블의 각 컬럼명을 클릭하여 정렬 또는 필터 기능을 사용할 수 있습니다.

**리스트**

* AI 세그먼트 타겟팅에서 생성한 모든 세그먼트를 확인할 수 있습니다.

<img src="/files/tJhAFThEefOyoh8um6CN" alt="" width="563">

AI 세그먼트 리스트에서 확인 가능한 내용은 다음과 같습니다.

* 즐겨찾기 : 별 아이콘을 클릭하여 즐겨찾는 AI 세그먼트를 등록할 수 있습니다. 아이콘을 한 번 더 클릭하면 즐겨찾기가 해제됩니다.
* 세그먼트명 : AI 세그먼트 생성 시 설정한 세그먼트의 이름입니다. 각 세그먼트명 클릭 시 수정 화면으로 전환됩니다.
* 캠페인 활용 : AI 세그먼트가 캠페인에 활용되고 있는지 상태를 표시합니다.
  * 활용 : 그루비 캠페인에서 활용되고 있는 세그먼트를 표시합니다.
  * 미활용 : 생성 후 그루비 캠페인에서 아직 활용되고 있지 않은 세그먼트를 표시합니다.
  * 만료 : 세그먼트 사용 기한이 만료된 상태입니다.
* 세그먼테이션 : AI 세그먼트 생성 시 선택한 세그먼트 유형을 표시합니다. 각 유형에 대한 상세한 설명은 RFM 세그먼트 만들기, 구매 확률 세그먼트 만들기, 취향 분석 세그먼트 만들기 도움말에서 확인할 수 있습니다.
  * RFM
  * 구매 확률
  * 취향 분석
* 타겟팅 유형 :AI 세그먼트 생성 시 설정한 타겟팅 유형을 표시합니다.
  * 현재 세그먼트
  * 세그먼트 이동
* 작성일 : AI 세그먼트를 생성한 날짜를 표시합니다.
* 최종 수정일 : AI 세그먼트를 마지막으로 수정한 날짜를 표시합니다.

**즐겨찾기**

<img src="/files/9joRmSrV8SlPaBoLt3aH" alt="" width="563">

* 리스트에서 즐겨찾기 등록한 AI 세그먼트만 리스팅됩니다.
* 세그먼트명 옆의 별표 모양 아이콘으로 즐겨찾기 등록 및 해제할 수 있습니다.

### **태그 및 검색**

<img src="/files/9Ae6GviMfFRO8q12qwlo" alt="" width="188">

* 태그 필터 버튼 클릭 시 태그 필터창에서 세그먼트 생성 시 추가한 태그로 태그 필터를 사용할 수 있습니다.
* 추가된 태그 중 조건에 맞는 태그를 체크하여 선택 버튼을 누르면 해당 태그가 추가되어 있는 세그먼트만 필터링됩니다.
* 하나의 태그를 여러 세그먼트에 사용할 수 있으며, 한 세그먼트에서 동일한 태그를 여러 번 중복하여 추가할 수 없습니다.
* 검색을 이용하여 원하는 세그먼트를 검색할 수 있습니다.

### **관리 도구 (・・・)**

<table data-header-hidden><thead><tr><th width="85.1015625"></th><th width="107.5"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/5MZXyIqUki7km9UXRh7C" alt="" width="24"></p></td><td>수정</td><td>클릭 시 세그먼트 수정 페이지로 이동하여 세그먼트를 수정할 수 있습니다.</td></tr><tr><td><p><img src="/files/4gFacjNE49SYnn3mNnDX" alt="" width="24"></p></td><td>복사</td><td>클릭 시 세그먼트가 복사되어 새로운 세그먼트 만들기 페이지로 이동합니다.</td></tr><tr><td><p><img src="/files/jGiFrpo2XxAfHtsx7RQj" alt="" width="24"></p></td><td>삭제</td><td>클릭 시 세그먼트가 삭제됩니다.</td></tr></tbody></table>


# RFM 세그먼트 만들기

## **RFM 세그먼트란?**

* RFM은 Recency (최근에 방문했는지), Frequency (몇 번 방문했는지), Monetary (구매 금액은 어떻게 되는지)를 기반으로 고객의 가치를 판단하는 CRM 분야의 전통적인 고객 분석 방법입니다.
* 그루비 AI는 전체 방문 고객을 10개의 RFM 세그먼트로 자동 분류하고, 각 세그먼트에 대한 인사이트를 제공합니다.
* 그루비 RFM 세그먼트는 최근 방문(R) 점수, 방문 빈도(F), 구매 금액(M) 합산 점수를 기준으로 고객의 잠재 가치와 현재 상태를 직관적으로 분류합니다.
* X축은 최근 방문 점수 축, Y축은 방문 빈도와 구매 금액의 합산 점수 축을 나타냅니다.
* 구매 이력 유무와 상관없이 모든 고객의 분석이 가능합니다.
* 타겟팅 유형은 2가지입니다.
  * 현재 세그먼트 : 1개 이상의 RFM 세그먼트를 타겟팅 할 수 있습니다.
  * 세그먼트 이동 : 특정 RFM 세그먼트에서 다른 RFM 세그먼트로 이동한 고객을 타겟팅 할 수 있습니다.

{% hint style="warning" %}
그루비 스크립트 설치 이후 방문한 고객의 행동 데이터를 분석합니다. 스크립트 설치 이전 데이터는 포함되지 않습니다.
{% endhint %}

### **그루비 RFM 세그먼트**

* 그루비 AI가 분류하는 RFM 세그먼트는 총 10개입니다.

<table><thead><tr><th width="150.00390625">RFM 세그먼트</th><th>설명</th></tr></thead><tbody><tr><td>VIP</td><td>구매도 많이 하고, 자주 오고, 최근까지 꾸준히 방문해주는 VIP</td></tr><tr><td>뜸한 VIP</td><td>VIP 만큼 구매도 많이 하고 자주 오지만, 최근 방문이 조금 뜸해지고 있는 고객</td></tr><tr><td>잠재 VIP</td><td>최근까지 꾸준히 방문하고 구매와 방문 빈도도 높은 잠재 VIP</td></tr><tr><td>신규 고객</td><td>기간 내 사이트에 처음 방문한 고객</td></tr><tr><td>지금 잡아야 할 고객</td><td>최근 사이트에 왔었지만 흥미를 느끼지 못한 고객</td></tr><tr><td>신경써야 할 고객</td><td>구매도 어느 정도 하고, 방문도 가끔 해주는, 조금만 더 신경쓰면 VIP로 이동할 가능성이 있는 고객</td></tr><tr><td>이탈 우려</td><td>사이트에 흥미를 잃고 이탈하는 과정에 있는 고객</td></tr><tr><td>이탈한 VIP</td><td>한 때 VIP였으나 최근에 사이트를 방문해주지 않는 고객</td></tr><tr><td>이탈한 잠재 VIP</td><td>평균 이상으로 구매도 하고, 방문도 해주는 고객이었으나, 최근에는 사이트를 방문하지 않은 고객</td></tr><tr><td>이탈한 고객</td><td>사이트에 관심이 적고 더 이상 방문해주지 않는 고객</td></tr></tbody></table>

***

## **RFM세그먼트 만들기**

<img src="/files/AarI5iRDCyAnEowglf6X" alt="" width="563">

### **세그먼트 기본 설정**

<img src="/files/gB6gsEIUoVkm666ZrLHg" alt="" width="563">

* 세그먼트명 : 해당 세그먼트의 이름을 설정합니다. 공백 포함 최대 40자까지 설정 가능합니다.
* 상세 설명 : 해당 세그먼트에 대한 간략한 설명이 필요할 시 설정합니다. 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. AI 세그먼트 타겟팅 리스트에서 태그 필터를 통해 특정 세그먼트를 필터링할 때 활용할 수 있습니다.

| <p><img src="/files/qTxQT8tHD17kq2lPgyTY" alt="" width="188"></p> | <ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul> |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |

### **타겟 설정**

* 타겟팅 유형에 따라 세그먼트 만드는 방식이 다릅니다. 타겟팅 유형을 확인하여 만들어 주세요.

#### **타겟팅 유형 : 현재 세그먼트**

<img src="/files/lGHH9M3O7kPWP4oGrLEb" alt="" width="563">

ⓐ 데이터 분석 기간

* AI가 분석에 사용한 데이터 기간이 표시됩니다. 그루비 설치 시점 이후의 데이터를 사용하며, 현재 시점에서 최대 3개월까지의 데이터를 사용합니다.

ⓑ 타겟팅 유형 : 현재 세그먼트 / 세그먼트 이동

* 현재 세그먼트 : 1개 이상의 RFM 세그먼트를 선택하여 타겟팅 할 수 있습니다. 복수 선택 가능합니다.\
  RFM 세그먼트는 매일 갱신되며, 현재(오늘)를 기준으로 설정한 세그먼트에 해당하는 고객을 타겟팅 합니다.

ⓒ 세그먼트 선택

* RFM 세그먼트 생성을 위한 선택 필수 항목입니다.
* RFM 분석 결과를 확인할 수 있는 차트를 제공합니다.
* 해당 세그먼트의 상세 정보와 전주 대비 데이터 변동치를 확인할 수 있습니다.
* 각 영역에 표시되는 데이터는 다음과 같습니다.

<img src="/files/Cs7BojGtLgL5fmgissWI" alt="" width="375">

ⓓ 예상 타겟 수

* 선택한 RFM 세그먼트 조건에 맞는 예상 타겟 수 합계를 확인할 수 있습니다.

{% hint style="warning" %}
AI 세그먼트 생성 시점을 기준으로 계산한 예상 수치입니다. 실제로 타겟팅 되는 타겟의 수는 캠페인이 노출될 당일 시점을 기준으로 적용되므로 변동될 수 있습니다.
{% endhint %}

#### **타겟팅 유형 : 세그먼트 이동**

<img src="/files/5cMR8Co1wRNCmBFgzgfb" alt="" width="563">

ⓐ 데이터 분석 기간

* AI가 분석에 사용한 데이터 기간이 표시됩니다. 그루비 설치 시점 이후의 데이터를 사용하며, 현재 시점에서 최대 3개월까지의 데이터를 사용합니다.

ⓑ 타겟팅 유형 : 현재 세그먼트 / 세그먼트 이동

* 세그먼트 이동 : 특정 RFM 세그먼트에서 다른 RFM 세그먼트로 이동한 고객을 타겟팅 할 수 있습니다.
  * 과거 특정 시점의 RFM 세그먼트와 현재의 RFM 세그먼트를 비교하여 세그먼트 이동이 발생한 고객을 타겟팅 합니다.
  * 예를 들어 시점은 '7일 전', 세그먼트는 '뜸한 VIP -> VIP'로 설정 후 저장한 경우, 캠페인이 노출될 현재 날짜로부터 7일 전에는 '뜸한 VIP' 세그먼트에 속해 있다가 현재 'VIP' 세그먼트로 이동한 고객을 타겟팅 합니다.

ⓒ 세그먼트 선택

<img src="/files/NbmxD1zexLNlbhmUXecw" alt="" width="563">

* 시점 설정(N일 전) : 이동 전 과거 세그먼트의 시점 일자를 선택합니다. 최대 31일까지 설정 가능합니다.

{% hint style="info" %}
세그먼트 저장 시 선택한 날짜의 절댓값이 아닌 상댓값(N일 전)을 적용합니다.\
예를 들어 '7일 전'으로 설정한 경우 현재 날짜로부터 7일 전 세그먼트 이동이 발생한 고객을 타겟팅 합니다.
{% endhint %}

* 이동 전 세그먼트(왼쪽)
  * 타겟이 이동하기 전 세그먼트를 선택합니다. 복수 선택이 가능합니다.
* 이동 후 세그먼트(오른쪽)
  * 타겟이 이동한 후 현재(오늘) 속한 세그먼트를 선택합니다. 복수 선택이 가능합니다.
  * 이동 전 세그먼트로 이미 선택한 세그먼트는 선택할 수 없습니다.

ⓓ 예상 타겟 수

* 선택한 RFM 세그먼트 조건에 맞는 예상 타겟 수 합계를 확인할 수 있습니다.

{% hint style="warning" %}
AI 세그먼트 생성 시점을 기준으로 계산한 예상 수치입니다. 실제로 타겟팅 되는 타겟의 수는 캠페인이 노출될 당일 시점을 기준으로 적용되므로 변동될 수 있습니다.
{% endhint %}


# 구매 확률 세그먼트 만들기

## **구매 확률 세그먼트란?**

* 그루비 AI가 고객 행동 빅데이터를 기반으로 고객의 구매 의욕, 즉 구매 확률을 예측합니다. 개별 고객의 다음 번 방문 시 구매할 확률을 계산하여 확률 구간별로 세그먼테이션 합니다.
* X축은 구매 확률 축, Y축은 고객 수를 밀도 값으로 변환한 축입니다.
* 구매 이력 유무와 상관없이 모든 고객의 분석이 가능합니다.
* 타겟팅 유형은 2가지입니다.
  * 현재 세그먼트 : 특정 구매 확률 구간에 속한 고객을 타겟팅 할 수 있습니다.
  * 세그먼트 이동 : 구매 확률이 변경된 고객을 타겟팅 할 수 있습니다.

{% hint style="warning" %}
그루비 스크립트 설치 이후 방문한 고객의 행동 데이터를 분석합니다. 스크립트 설치 이전 데이터는 포함되지 않습니다.
{% endhint %}

***

## **구매 확률 세그먼트 만들기**

<img src="/files/WPqk1tArYJvZogJcpKHp" alt="" width="563">

### **세그먼트 기본 설정**

![](/files/j44vTMEFf6DmP80bFOzi)

* 세그먼트명 : 해당 세그먼트의 이름을 설정합니다. 공백 포함 최대 40자까지 설정 가능합니다.
* 상세 설명 : 해당 세그먼트에 대한 간략한 설명이 필요할 시 설정합니다. 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. AI 세그먼트 타겟팅 리스트에서 태그 필터를 통해 특정 세그먼트를 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="347.98828125"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/4CSN1POVIEP2AyRsid2y" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

* 타겟팅 유형에 따라 세그먼트 만드는 방식이 다릅니다. 타겟팅 유형을 확인하여 만들어 주세요.

#### **타겟팅 유형 : 현재 세그먼트**

<img src="/files/QGQDFX3TYqVyOc1XAF1O" alt="" width="563">

ⓐ 데이터 분석 기간

* AI가 분석에 사용한 데이터 기간이 표시됩니다. 그루비 설치 시점 이후의 데이터를 사용하며, 현재 시점에서 최대 1개월까지의 데이터를 사용합니다.

ⓑ 타겟팅 유형 : 현재 세그먼트 / 세그먼트 이동

* 현재 세그먼트 : 특정 구매 확률 구간에 속한 고객을 타겟팅 할 수 있습니다.\
  구매 확률 세그먼트는 매일 갱신되며, 현재(오늘)를 기준으로 설정한 세그먼트에 해당하는 고객을 타겟팅 합니다.

ⓒ 세그먼트 선택

* 구매 확률 세그먼트 생성을 위한 선택 필수 항목입니다.
* 구매 확률 예측 결과를 확인할 수 있는 차트를 제공합니다.
* 타겟팅 하고자 하는 세그먼트 확률 구간을 선택할 수 있습니다.
  * 특정 구간 선택 : 확률 구간에 해당하는 고객을 타겟팅 합니다.
  * 직접 입력 : 원하는 확률 구간을 입력하여 지정합니다.

ⓓ 예상 타겟 수

* 선택한 구매 확률 세그먼트 조건에 맞는 예상 타겟 수 합계를 확인할 수 있습니다.

{% hint style="warning" %}
AI 세그먼트 생성 시점을 기준으로 계산한 예상 수치입니다. 실제로 타겟팅 되는 타겟의 수는 캠페인이 노출될 당일 시점을 기준으로 적용되므로 변동될 수 있습니다.
{% endhint %}

#### **타겟팅 유형 : 세그먼트 이동**

<img src="/files/igRyCHEy6pRxJ2qeB0oO" alt="" width="563">

ⓐ 데이터 분석 기간

* AI가 분석에 사용한 데이터 기간이 표시됩니다. 그루비 설치 시점 이후의 데이터를 사용하며, 현재 시점에서 최대 1개월까지의 데이터를 사용합니다.

ⓑ 타겟팅 유형 : 현재 세그먼트 / 세그먼트 이동

* 세그먼트 이동 : 선택된 시점 동안 구매 확률이 변경된 고객을 타겟팅 할 수 있습니다.
  * 과거 특정 시점의 구매 확률 세그먼트와 현재의 구매 확률 세그먼트를 비교하여 세그먼트 이동이 발생한 고객을 타겟팅 합니다.
  * 예를 들어 시점은 '7일 전', 세그먼트는 '61\~80%' -> '81\~100%' 구간으로 설정한 경우, 캠페인이 노출될 현재 날짜로부터 7일 전에는 61\~80% 구매 확률 세그먼트에 속해 있다가 현재 81\~100% 구매 확률 세그먼트로 이동한 고객을 타겟팅 합니다.

ⓒ 세그먼트 선택

<img src="/files/V33MqJpq2qCnQ28QTMmi" alt="" width="563">

* 시점 설정(N일 전) : 이동 전 과거 세그먼트의 시점 일자를 선택합니다. 최대 31일까지 설정 가능합니다.

{% hint style="info" %}
세그먼트 저장 시 선택한 날짜의 절댓값이 아닌 상댓값(N일 전)을 적용합니다.\
예를 들어 '7일 전'으로 설정한 경우 현재 날짜로부터 7일 전 세그먼트 이동이 발생한 고객을 타겟팅 합니다.
{% endhint %}

* 이동 전 세그먼트(왼쪽)
  * 특정 과거 시점의 구매 확률을 선택하거나 직접 입력합니다.
* 이동 후 세그먼트(오른쪽)
  * 타겟이 이동한 후 현재(오늘)의 구매 확률을 선택하거나 직접 입력합니다.
  * 이동 전 세그먼트로 이미 선택한 세그먼트 구간은 선택할 수 없습니다.

ⓓ 예상 타겟 수

* 선택한 구매 확률 세그먼트 조건에 맞는 예상 타겟 수 합계를 확인할 수 있습니다.

{% hint style="warning" %}
AI 세그먼트 생성 시점을 기준으로 계산한 예상 수치입니다. 실제로 타겟팅 되는 타겟의 수는 캠페인이 노출될 당일 시점을 기준으로 적용되므로 변동될 수 있습니다.
{% endhint %}


# 취향 분석 세그먼트 만들기

## **취향 분석 세그먼트란?**

* 취향 분석 세그먼트는 방문자가 가진 특징을 AI LLM 모델로 분석하여 각 세그먼트에 대한 취향 인사이트를 제공합니다.
* 세그먼트명, 세그먼트의 특징 및 설명, 관련 태그까지 모두 LLM 모델로 취향을 나눠 생성하여 캠페인에 활용할 수 있습니다.

{% hint style="warning" %}
취향 분석 세그먼트는 그루비에 별도 문의 후 사용할 수 있습니다.
{% endhint %}

{% hint style="warning" %}
취향 분석 세그먼트는 오프사이트 캠페인에서만 활용할 수 있습니다.
{% endhint %}

***

## **취향 분석 세그먼트 만들기**

<img src="/files/vpIYUMsUXYrXLkQeaU6L" alt="" width="563">

### **세그먼트 기본 설정**

<img src="/files/5jDbWLSe7jqqG96pJcSL" alt="" width="563">

* 세그먼트명 : 해당 세그먼트의 이름을 설정합니다. 공백 포함 최대 40자까지 설정 가능합니다.
* 상세 설명 : 해당 세그먼트에 대한 간략한 설명이 필요할 시 설정합니다. 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. AI 세그먼트 타겟팅 리스트에서 태그 필터를 통해 특정 세그먼트를 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="335.14453125"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/5fzJdqEc9nUFkYphfVTw" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

<img src="/files/szR70QEHSv71bIrSfPf0" alt="" width="563">

ⓐ 데이터 분석 기간

* AI가 분석에 사용한 데이터 기간이 표시됩니다. 일자 선택에서 선택한 일자 전일부터 과거 총 31일 동안의 분석 기간을 갖습니다.

ⓑ 일자 선택

* 분석의 기준이 되는 일자를 선택합니다. 오늘을 포함한 과거 30일 전 기간 중 선택할 수 있습니다. 매일 선택 가능한 일자가 변경됩니다.

ⓒ 사용 가능 기한

* 취향 분석 세그먼트는 일자 선택에서 선택한 일자 포함 31일간 캠페인에 활용할 수 있으며, 이후 세그먼트가 만료됩니다. 사용 가능 기한은 세그먼트를 오프사이트 캠페인에 활용할 수 있는 기한입니다.

{% hint style="danger" %}
취향 분석 세그먼트는 사용 가능 기한이 지나면 만료됩니다. 만료된 세그먼트는 캠페인에 사용할 수 없습니다.
{% endhint %}

ⓓ 세그먼트 선택

<img src="/files/gvgJtRYatLebEwR9cUjn" alt="" width="563">

* 그루비에서 LLM을 활용하여 생성된 취향 분석의 세그먼테이션과 설명을 확인할 수 있습니다.
* 취향 분석 세그먼트는 최소 5개에서 최대 15개까지 분석 후 적합한 세그먼트 수로 제공됩니다.
* 다수의 세그먼트를 선택할 수 있으며, 선택한 세그먼트의 타겟 수 합계가 총 예상 타겟 수가됩니다.

ⓔ 대표 상품 / 많이 조회한 상품

* 대표 상품 : 분석된 집단(세그먼테이션)에서 가장 많이 조회한 1위 상품 이미지를 표시합니다.
* 많이 조회한 상품 : 분석된 집단(세그먼테이션)에서 가장 많이 조회한 1위 상품을 포함한 9개 상품 이미지를 표시합니다.

<img src="/files/jjz4WLQhUnxDUU0r2XpD" alt="" width="563">

ⓕ 예상 타겟 수

* 세그먼트 선택에서 선택한 모든 세그먼테이션의 타겟 수 합계가 취향 분석 세그먼트의 예상 타겟 수 입니다.

{% hint style="info" %}
**※ 확인사항**

* 취향 분석 세그먼트는 오프사이트 스케줄 캠페인에서만 활용할 수 있습니다.
* 세그먼트 생성 후에는 세그먼트명만 수정이 가능하며, 일자 변경 및 선택한 세그먼트 수정을 원할 경우 \
  새로운 세그먼트를 만들어 주세요.
* 세그먼트 기한이 만료될 경우 모든 캠페인은 자동으로 중지됩니다.
  {% endhint %}


# 세그먼트 타겟팅

## **세그먼트 타겟팅이란?**

세그먼트 타겟팅은 고객을 공통된 특성이나 행동 기준으로 분류(세그먼트)하여, 각 그룹에 맞는 맞춤형 마케팅 전략을 실행하는 방식입니다.

그루비의 세그먼트 타겟팅은 단순히 고객을 나누는 데 그치지 않고,

* 다양한 변수와 시점을 조합해 원하는 고객군을 직접 정의하고,
* AND / OR 조건식과 행동 시퀀스를 반영해 더 정밀한 타겟팅을 가능하게 하며,
* 온·오프사이트를 아우르는 타겟 마케팅까지 지원합니다.

이를 통해 고객의 관심사, 행동 패턴, 구매 여정에 맞춘 최적화된 메시지와 경험을 제공하고, 전환율을 극대화할 수 있습니다.

### **다양한 변수 제공**

그루비는 **69가지 이상의 다양한 변수와 시점**을 제공합니다.

이를 조합해 직접 고객 세그먼트를 만들고, 원하는 타겟팅을 진행할 수 있습니다.

또한 자체 보유 데이터를 그루비와 연동하거나, 고객의 특정 행동을 조건으로 설정하여 우리 브랜드만의 최적화된 포지셔닝 전략을 세워보세요.

{% hint style="info" %}
[세그먼트 변수 설명](/new-admin/segment/variable) 참고해 주세요.
{% endhint %}

### **AND / OR 조건을 활용한 타겟팅**

* OR 조합: 하나라도 조건을 만족하는 고객을 타겟팅할 때 활용합니다.
* AND 조합: 모든 조건을 만족하는 고객만 타겟팅할 때 사용합니다.

상황에 맞는 조건식을 구성해 원하는 고객 그룹을 정확히 공략할 수 있습니다.

### **시퀀스를 활용한 타겟팅**

고객이 사이트에서 경험하는 행동 순서(시퀀스)에 기반해 정교한 타겟팅을 할 수 있습니다.

고객 여정을 따라가는 방식으로, 더 세밀한 행동 기반 마케팅 전략을 실행할 수 있습니다.


# 세그먼트 관리하기

## **세그먼트 관리하기**

* 생성한 세그먼트를 관리할 수 있습니다.

<img src="/files/KtLkcCZN4v3r9ATpnWFX" alt="" width="563">

### **세그먼트 만들기**

다양한 고객 데이터를 기반으로 맞춤형 세그먼트를 생성할 수 있어 효과적인 타겟 설정이 가능합니다.

### **세그먼트 리스트**

* 데이터 테이블에서는 세그먼트 타입별로 생성된 캠페인 리스트를 확인할 수 있습니다.
* 테이블의 각 컬럼명을 클릭하여 정렬 또는 필터 기능을 사용할 수 있습니다.

<img src="/files/6VPMim1Sig0bdPAkdjzx" alt="" width="563">

### **태그 및 검색**

<img src="/files/ED7zLOt5facHOibL2iIN" alt="" width="188">

* 태그 필터 버튼 클릭 시 태그 필터창에서 캠페인 생성 시 추가한 태그로 태그 필터를 사용할 수 있습니다.
* 추가된 태그 중 조건에 맞는 태그를 체크하여 선택 버튼을 누르면 해당 태그가 추가되어 있는 캠페인만 필터링됩니다.
* 하나의 태그를 여러 캠페인에 사용할 수 있으며, 한 캠페인에서 동일한 태그를 여러 번 중복하여 추가할 수 없습니다.
* 검색을 이용하여 원하는 캠페인명을 검색할 수 있습니다.

### **관리 도구 (・・・)**

<table data-header-hidden><thead><tr><th width="74.85546875"></th><th width="185.43359375"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/zuFZMaxeUVs14wurOYmy" alt="" width="24"></p></td><td>수정</td><td>클릭 시 세그먼트 수정 페이지로 이동합니다. 활용 중인 세그먼트는 수정에 유의해주세요.</td></tr><tr><td><p><img src="/files/eWOB3OsOvaVKOvJCLnNI" alt="" width="24"></p></td><td>복사</td><td>클릭 시 캠페인이 복사되어 새로운 캠페인 만들기 페이지로 이동합니다.</td></tr><tr><td><p><img src="/files/BonCbmhYdUjblSkHTEn7" alt="" width="24"></p></td><td>방문자 리스트 다운로드</td><td><ul><li>선택된 세그먼트를 다운로드합니다.</li><li>현재 시점의 방문자 리스트를 다운로드하는 경우 오늘을 포함한 최근 7일로 총 8일의 기간이 계산됩니다.</li></ul></td></tr><tr><td><p><img src="/files/XCx56sGHmGg1MUC8IqUF" alt="" width="24"></p></td><td>삭제</td><td>선택된 세그먼트를 삭제합니다.</td></tr></tbody></table>

***

## **세그먼트 QnA**

**방문자 리스트 다운로드**

세그먼트 생성 시 화면에 표시된 예상 타겟 수와 엑셀로 다운로드한 방문자 리스트의 숫자가 다른 이유는 무엇인가요?

* 방문자 리스트는 세그먼트 조건에 해당하면서, 동시에 회원가입 한 방문자 데이터만 포함합니다.
* 예상 타겟 수는 빠른 계산을 위해 근사치를 표시해 주는 반면, 방문자 리스트는 정확한 데이터를 반영하기 때문에 일부 수치의 차이가 발생할 수 있습니다. (실제 타겟팅에는 정확한 데이터가 사용됩니다.)


# 세그먼트 만들기

## **세그먼트 만들기**

<img src="/files/1rsAnhf98VTbGjDLtvFj" alt="" width="563">

### **세그먼트 기본 정보**

<img src="/files/I2icpGToCfUiA6XXhvQJ" alt="" width="563">

* 세그먼트명 : 세그먼트 생성을 위한 작성 필수 항목입니다. 한글 공백 포함 최대 40자로 작성해주세요.
* 상세 설명 : 세그먼트명으로 표현하기 부족한 부분을 상세하게 작성할 수 있습니다. 한글 공백 포함 최대 400자로 작성해주세요.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. 캠페인 리스트에서 태그 필터를 통해 특정 캠페인을 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="331.4765625"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/bXTJEMrRj0KCZbrKLCwm" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

<img src="/files/3zRBXapFsVdnSQ8Mfhcd" alt="" width="563">

#### ⓐ 활용 범위 <a href="#range" id="range"></a>

* 온사이트 : 온사이트 캠페인, AI 상품 추천, 푸시 알림 캠페인 이벤트 트리거 발송 방식에서 사용할 수 있습니다.
* 오프사이트 : 푸시 알림 캠페인, 카카오톡 캠페인, SMS 캠페인 스케줄 발송 방식 캠페인에서 사용할 수 있습니다.

#### ⓑ 시점 <a href="#time" id="time"></a>

* 고객의 과거 이력, 실시간 행동으로 세그먼트를 타겟팅하거나 두 조건을 조합한 세그먼트를 타겟팅할 수 있습니다.
* 시점을 선택한 후 변수를 1개 이상 추가하면 시점을 변경할 수 없습니다. 시점은 변수를 모두 삭제한 후에 변경할 수 있습니다.
* 세그먼트 활용 범위에 따라 설정 가능한 변수 시점이 다릅니다.
  * 온사이트 : 과거, 현재, 과거X현재
  * 오프사이트 : 과거

**※시점 설명**

* 과거<br>

  <img src="/files/bHCtHw1wg83RaDBtzXwS" alt="" width="563">

  * 고객의 과거 이력과 속성을 기준으로 타겟팅합니다.
  * 설정 가능한 과거 이력 검색 기간은 전일 기준 최대 3개월입니다.
  * 과거 시점으로 가능한 변수 조합은 AND 또는 OR 조합입니다.
  * 과거 이력을 검색할 기간을 설정하고 기간에 대한 기준일을 설정합니다.

* 현재<br>

  <img src="/files/epZKbecyKlfBqcwtMnjC" alt="" width="563">

  * 사이트에 접속 중인 고객의 행동 및 속성을 기준으로 타겟팅합니다. 현재 시점에서는 조합 조건을 AND/OR, 시퀀스 조합을 사용할 수 있습니다.
  * 조합 조&#xAC74;**:** 조합 조건은 현재 시점에서만 제공됩니다.
    * AND/OR
      * AND : 좁은 범위의 세밀한 세그먼트 타겟팅을 위한 조합 유형입니다. AND 조합으로 묶인 변수는 동시에 만족해야 합니다.
      * OR : 넓은 범위의 세그먼트 타겟팅을 위한 조합 유형입니다. OR 조합으로 묶인 변수 중 하나만 만족해도 타겟팅됩니다.
    * 시퀀스
      * 시퀀스(강) : 사이트에 접속 중인 방문자의 행동 순서 또는 이동 경로가 정확하게 일치한 방문자를 타겟팅 합니다.
      * 시퀀스(약) : 사이트에 접속 중인 방문자의 행동 순서 또는 이동 경로 사이에 다른 행동 또는 이동 경로가 포함되어도 순서만 일치한 방문자를 타겟팅 합니다..

* 과거 x 현재<br>

  <img src="/files/D6L0tPZiGI5OF9QCf0bc" alt="" width="563">

  * 과거 변수와 현재 변수를 따로 설정하여 과거의 특정 이력을 가진 고객이 사이트에 접속했을 때의 행동 및 속성을 기준으로 타겟팅합니다.
  * 과거와 현재는 각각 하나의 그룹으로 구성되며, 두 시점은 AND 조건으로 연결됩니다. \
    각 시점 내부에서는 변수들을 AND 또는 OR 조건으로 설정할 수 있습니다.
  * 과거 이력을 검색할 기간을 설정하고 기간에 대한 기준일을 설정합니다.

#### ⓒ 기간 설정 <a href="#period" id="period"></a>

* 고정 : 입력한 기간을 고정으로 하여 이력을 검색합니다.
* 노출일 기준 : 캠페의 진행 기간에 따라 입력한 기간이 Shift 됩니다.
* 예를 들어 2025.12.01\~2026.02.05 로 기간을 입력하고 2026.03.01\~2026.03.02 동안 진행되는 캠페인에 해당 세그먼트를 설정했을 경우, \
  03.01 에는 2025.12.01\~2026.02.05 이력을 검색하고, 03.02에는 2025.12.02\~2026.02.06으로 기간이 변경되어 이력을 검색합니다.

### **변수 영역**

<img src="/files/j6wFgD3fCn8BT99ERZQa" alt="" width="563">

**변수 추가/수정/삭제**

ⓐ 변수 추가 : 변수 추가를 위해 변수 리스트를 확인할 수 있습니다.

ⓑ 변수 설정 : 변수 설정 영역으로 각 변수의 조건을 설정할 수 있습니다.

ⓒ 변수 초기화 : 추가된 변수를 초기화하여 처음부터 다시 설정할 수 있습니다.

ⓓ 변수 그룹 삭제 : OR 조건의 변수 그룹을 삭제할 수 있습니다.

ⓔ 변수 삭제 : 각각의 변수를 하나씩 삭제할 수 있습니다.<br>

### **변수 리스트**

<img src="/files/bkOde6SrGHgJu9IBwOS6" alt="" width="563">

\
ⓐ 약 70여개의 롤 세그먼트 변수를 제공하고 있습니다.

ⓑ 각각의 변수 설명을 도움말 페이지를 통해 확인할 수 있습니다.

[**변수 설명 보러 가기**](/new-admin/segment/variable)

### **예상 타겟 수**

**예상 타겟 수 확인**<br>

![](/files/4HGIeFJJOTONISHlxoQt)

* 시점에 따라 변수를 추가하면서 실시간으로 예상 타겟 수를 확인할 수 있습니다.
* 현재 시점 : 최근 7일 동여안 설정한 세그먼트 조건을 만족한 방문자 수를 표시합니다. 이를 참고하여 세그먼트 타겟 수 볼륨을 예상할 수 있습니다. (현재 시점은 오늘을 포함한 최근7일로 총 8일의 기간이 계산됩니다.)
* 과거 시점 : 입력한 기간 내 설정한 세그먼트 조건을 만족한 방문자 수를 표시합니다. 이를 참고하여 세그먼트 타겟 수 볼륨을 예상할 수 있습니다.

**예상 타겟 수 제한**<br>

![](/files/Azw2usmJgzdp4mFHNgdt)

예상 타겟 수 측정이 제공되지 않는 변수들입니다.

* 시스템 : 접속 IP, 접속 IP 대역대
* 방문자 유형 : 회원 번호(ID)-대량

예상 타겟 수 측정 불가 조합 조건

* 시퀀스(강), 시퀀스(약)

## **세그먼트 제한 사항**

* 대용량 파일을 사용한 변수는 세그먼트 만들기에 한 개씩 사용할 수 있습니다.
* 대용량 파일을 사용한 세그먼트는 복사하여 사용할 수 없습니다. '새로운 세그먼트 만들기'를 사용해 주세요.

***

## **세그먼트 수정하기**

* 현재 사용 중인 세그먼트를 수정하면 실행 중인 캠페인에 바로 반영되므로, 수정 시 주의해 주세요.
* 캠페인에서 활용하고 있는 세그먼트는 삭제할 수 없습니다. 활용 중인 캠페인을 삭제하거나, 다른 세그먼트로 변경 후 삭제해 주세요.<br>


# 세그먼트 변수 설명

세그먼트 변수 그룹별로 연결 링크를 제공하는 페이지 입니다.

### **시스템**

{% content-ref url="/pages/eOO9EGpjnnxJmNwUoMHF" %}
[세그먼트 변수: 시스템](/new-admin/segment/variable/system)
{% endcontent-ref %}

### **방문 이력**

{% content-ref url="/pages/py1rHG1VYQUgdhABaanI" %}
[세그먼트 변수: 방문 이력](/new-admin/segment/variable/visit-record)
{% endcontent-ref %}

### **주문 이력**

{% content-ref url="/pages/uNeNOlRexQQK1MPlWTmd" %}
[세그먼트 변수: 주문 이력](/new-admin/segment/variable/order-record)
{% endcontent-ref %}

### **캠페인 이력**

{% content-ref url="/pages/01kGA5ZmYqHqlcLNxkL6" %}
[세그먼트 변수: 캠페인 이력](/new-admin/segment/variable/campaign-record)
{% endcontent-ref %}

### **방문자 유형**

{% content-ref url="/pages/T7mQF1437Qs44o3a5Hin" %}
[세그먼트 변수: 방문자 유형](/new-admin/segment/variable/visitor-type)
{% endcontent-ref %}

### **방문 행동**

{% content-ref url="/pages/yb79BJZJ22JGlzgS4ziM" %}
[세그먼트 변수: 방문 행동](/new-admin/segment/variable/visit-action)
{% endcontent-ref %}

### **장바구니 행동**

{% content-ref url="/pages/QSOcGjbT9ONtuFLHHnRO" %}
[세그먼트 변수: 장바구니 행동](/new-admin/segment/variable/cart-action)
{% endcontent-ref %}

### **주문 행동**

{% content-ref url="/pages/sFHxraGnF0QrKNJexmpS" %}
[세그먼트 변수: 주문 행동](/new-admin/segment/variable/order-action)
{% endcontent-ref %}

### **커스텀**

{% content-ref url="/pages/D2sdkNhEnb40WoEslJag" %}
[세그먼트 변수: 커스텀](/new-admin/segment/variable/custom)
{% endcontent-ref %}


# 세그먼트 변수: 시스템

### **접속 디바이스**

방문자가 사용한 디바이스(PC, 모바일웹, 모바일앱)별로 타겟팅 합니다.

**시점**

* 과거 : 기간 내 타겟팅한 디바이스로 접속한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 디바이스로 접속 중인 방문자

**변수 사용 예시**

접속 디바이스 \[PC]

* *일 때* : \[PC]로 접속한 방문자 타겟팅
* *아닐 때* : \[PC] 이외의 디바이스로 접속한 방문자 타겟팅

**Tip & Guide**

접속 디바이스 변수를 과거 변수로 사용할 때에는 두 개 이상의 디바이스 유형을 AND 조건으로 조합하는 것이 가능합니다.

그러나 접속 디바이스 변수를 현재 변수로 사용할 때에는 두 개 이상의 디바이스 유형을 AND 조건으로 조합하는 것이 불가능합니다. (방문자가 현재 세션에서 두 개 이상의 디바이스로 동시 접속 불가)

***

### **브라우저 유형**

방문자가 사용한 브라우저 유형(IE, Chrome, Edge, Safari, Firefox, Opera, 기타)별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브라우저로 접속한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브라우저로 접속 중인 방문자

**변수 사용 예시**

브라우저 유형 \[Chrome]

* *일 때* : \[Chrome]으로 접속한 방문자 타겟팅
* *아닐 때* : \[Chrome] 이외의 브라우저로 접속한 방문자 타겟팅

**Tip & Guide**

현재 변수로 브라우저 유형 변수와 접속 디바이스 변수를 AND 조건으로 조합할 때에는 접속 디바이스의 값 중 \[모바일 앱]은 제외해주세요.

***

### **브라우저 언어**

방문자가 사용한 브라우저 언어별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브라우저 언어를 사용하여 접속한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브라우저 언어로 접속 중인 방문자

**변수 사용 예시**

브라우저 언어 \[English]

* *일 때* : \[English]로 접속한 방문자 타겟팅
* *아닐 때* : \[English] 이외의 브라우저 언어로 접속한 방문자 타겟팅
*

***

### **접속 IP**

방문자가 사용한 IP 주소 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 IP로 접속한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 IP로 접속 중인 방문자

**변수 사용 예시**

접속 IP \[123.123.123.123]

* *일 때* : 접속 IP가 \[123.123.123.123]인 방문자 타겟팅
* *아닐 때* : 접속 IP가 \[123.123.123.123]인 방문자를 제외한 타겟팅
* *포함할 때* : 접속 IP에 123이 포함된 방문자 타겟팅
* *포함하지 않을 때* : 접속 IP에 123이 포함된 방문자를 제외한 타겟팅
* *시작할 때* : 접속 IP가 123으로 시작하는 방문자 타겟팅
* *시작하지 않을 때* : 접속 IP가 123으로 시작하는 방문자를 제외한 타겟팅
* *끝날 때* : 접속 IP가 123으로 끝나는 방문자 타겟팅
* *끝나지 않을 때* : 접속 IP가 123으로 끝나는 방문자를 제외한 타겟팅

***

### **접속 IP 대역대**

방문자가 사용한 IP 대역대 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 IP 대역대에 포함된 IP로 접속한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 IP 대역대에 포함된 IP로 접속 중인 방문자

**변수 사용 예시**

접속 IP 대역대 \[123.02.11.12] \~ \[123.02.11.20]

* 범위 일 때 : \[123.02.11.12] \~ \[123.02.11.20] 범위의 방문자 타겟팅
* 범위가 아닐 때 : \[123.02.11.12] \~ \[123.02.11.20] 범위의 방문자를 제외한 타겟팅

**Tip & Guide**

대역대의 시작 입력값 보다 종료 값이 클 수 없습니다.

***

### **접속 OS**

방문자가 사용한 접속 OS별로 타겟팅 합니다. / 온사이트(Native)에서만 사용

**시점**

* 과거 : 기간 내 타겟팅 한 접속 OS 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 접속 OS로 접속중인 방문자

**변수 사용 예시**

접속 OS \[안드로이드]

* *일 때* : \[안드로이드]로 접속한 방문자 타겟팅
* *아닐 때* : \[안드로이드] 이외의 OS로 접속한 방문자 타겟팅


# 세그먼트 변수: 방문 이력

### **방문 횟수**

방문자의 서비스 방문 횟수별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 과거 방문 이력을 조회하여 방문 횟수가 조건을 만족하는 방문자
* 현재 : 현재 시점에서 사용 불가능한 변수입니다.

**변수 사용 예시**

방문 횟수 \[3]

* 이상 : 과거에 서비스를 3번 이상 방문했던 방문자 타겟팅
* 이하 : 과거에 서비스를 3번 이하로 방문했던 방문자 타겟팅
* 일 때 : 과거에 서비스를 3번 방문한 방문자 타겟팅
* 아닐 때 : 과거에 서비스를 3번 방문한 방문자를 제외한 타겟팅

***

### **첫 방문**

방문자의 첫 방문 여부에 따라 타겟팅합니다.

**시점**

* 과거 : 기간 내 첫 방문 이력이 있는 방문자
* 현재 : 현재 세션이 첫 방문인 방문자

**변수 사용 예시**

첫 방문

* *첫 방문* : 처음으로 접속한 방문자 타겟팅
* *첫 방문 아닐 때* : 재 방문자(방문 횟수가 1회 이상인 방문자) 타겟팅

**Tip & Guide**

첫 방문의 기준은 처음으로 그루비 쿠키가 발행된 경우를 의미합니다.

***

### **마지막 방문**

방문자의 마지막 방문 여부에 따라 타겟팅합니다.

**시점**

* 과거 : 기간 내에 마지막으로 방문한 이력이 있는 방문자
* 현재 : 현재 시점에서 사용 불가능한 변수입니다.

**변수 사용 예시**

마지막 방문

* *마지막 방문* : 기간 내 마지막 방문 이력이 있는 방문자 타겟팅
* *마지막 방문 아닐 때* : 기간 내 마지막 방문 이력이 있는 방문자를 제외한 타겟팅

***

### **방문 요일**

방문자가 방문한 요일 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 요일에 방문한 이력이 있는 방문자
* 현재 : 타겟팅한 요일에 방문 중인 방문자

**변수 사용 예시**

방문 요일 \[월]

* 일 때 : 월요일에 방문한 방문자 타겟팅
* 아닐 때 : 월요일에 방문한 방문자를 제외한 타겟팅

***

### **방문 시간대**

방문자가 방문한 시간대별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 시간대에 방문한 이력이 있는 방문자
* 현재 : 타겟팅한 시간대에 방문 중인 방문자

**변수 사용 예시**

방문 시간대 \[13:00 \~ 13:59]

* *일 때* : 13:00 \~ 13:59 시간대에 방문한 방문자 타겟팅
* *아닐 때* : 13:00 \~ 13:59 시간대에 방문한 방문자를 제외한 타겟팅


# 세그먼트 변수: 주문 이력

### **주문 횟수**

방문자가 주문한 횟수별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 과거 주문 이력을 조회하여 주문 횟수가 조건 값을 만족하는 방문자
* 현재 : 현재 세션에서 조건 값을 만족하는 만큼 상품을 주문한 방문자

**변수 사용 예시**

주문 횟수 \[3]

* *이상* : 과거에 3번 이상 주문했던 방문자 타겟팅
* *이하* : 과거에 3번 이하로 주문했던 방문자 타겟팅
* *일 때* : 과거에 3번 주문한 방문자 타겟팅
* *아닐 때* : 과거에 3번 주문한 방문자를 제외한 타겟팅

주문 횟수 \[3 이상 5 이하]

* *범위 일 때* : 과거에 3번 이상 5번 이하로 주문했던 방문자 타겟팅
* *범위가 아닐 때* : 과거에 3번 이상 5번 이하로 주문했던 방문자를 제외한 타겟팅

***

### **첫 주문**

방문자의 첫 주문 여부에 따라 타겟팅합니다.

**시점**

* 과거 : 기간 내 첫 주문 이력이 있는 방문자
* 현재 : 현재 세션에서 처음으로 주문한 방문자

**변수 사용 예시**

첫 주문

* *첫 주문* : 처음으로 주문한 방문자 타겟팅
* *첫 주문 아닐 때* : 현재 주문이 재주문(주문 횟수가 1회 이상인 방문자)인 방문자 타겟팅

**Tip & Guide**

첫 주문의 기준은 구매이력이 없는 방문자가 주문을 했을 때를 의미합니다. 과거 변수로 사용 시 기간 내 첫 주문이 이력이 있으면 주문 횟수가 1번 이상이어도 타겟팅이 되므로 사용에 유의해주세요.

***

### **마지막 주문**

방문자의 마지막 주문 여부에 따라 타겟팅합니다.

**시점**

* 과거 : 기간 내 마지막 주문 이력이 있는 방문자
* 현재 : 현재 시점에서 사용 불가능한 변수

**변수 사용 예시**

마지막 주문

* *마지막 주문* : 기간 내 마지막 주문 이력이 있는 방문자 타겟팅
* *마지막 주문 아닐 때* : 기간 내 마지막 주문 이력이 있는 방문자를 제외한 타겟팅

***

### **주문 요일**

방문자가 주문한 요일 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 요일에 주문한 이력이 있는 방문자
* 현재 : 타겟팅한 요일에 상품을 주문한 방문자

**변수 사용 예시**

방문 요일 \[월]

* *일 때* : 월요일에 주문한 방문자 타겟팅
* *아닐 때* : 월요일에 주문한 방문자를 제외한 타겟팅

***

### **주문 시간대**

방문자가 주문한 시간대 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 시간대에 주문한 이력이 있는 방문자
* 현재 : 타겟팅한 시간대에 상품을 주문한 방문자

**변수 사용 예시**

방문 시간대 \[13시 \~ 14시]

* *일 때* : 13시 \~ 14시에 주문한 방문자 타겟팅
* *아닐 때* : 13시 \~ 14시 주문한 방문자를 제외한 타겟팅


# 세그먼트 변수: 캠페인 이력

### **온사이트 캠페인**

온사이트 캠페인 이력에 따라 타겟팅합니다.

**시점**

* 과거 : 기간 내 온사이트 캠페인에 노출되었거나 반응한 이력이 있는 방문자
* 현재 : 현재 세션에서 온사이트 캠페인에 노출되었거나 반응한 방문자

**변수 사용 예시**

온사이트 캠페인 \[시즌 기획전 홍보 팝업]

* *노출 된* : 시즌 기획전 홍보 팝업 캠페인에 노출된 방문자 타겟팅
* *노출되지 않은* : 시즌 기획전 홍보 팝업 캠페인에 노출되지 않은 방문자 타겟팅
* *노출 후 클릭한* : 시즌 기획전 홍보 팝업 캠페인을 클릭한 방문자 타겟팅
* *노출 후 클릭하지 않은* : 시즌 기획전 홍보 팝업 캠페인에 노출 되었는데 클릭하지 않은 방문자 타겟팅

***

### **AI 상품 추천 캠페인**

AI 상품 추천 이력에 따라 타겟팅 합니다.

**시점**

* 과거 : 기간 내 AI 상품 추천에 노출 되었거나 반응한 이력이 있는 방문자
* 현재 : 현재 세션에서 AI 상품 추천에 노출 되었거나 반응한 방문자

**변수 사용 예시**

AI 상품추천 \[검색결과 추천]

* *노출 된* : 검색결과 추천에 노출된 방문자 타겟팅
* *노출되지 않은* : 검색결과 추천에 노출되지 않은 방문자 타겟팅
* *노출 후 클릭한* : 검색결과 추천을 클릭한 방문자 타겟팅
* *노출 후 클릭하지 않은* : 검색결과 추천을 클릭하지 않은 방문자 타겟팅


# 세그먼트 변수: 방문자 유형

### **회원 방문자**

방문자의 회원 여부에 따라 타겟팅합니다.

**시점**

* 과거 : 설정 기간 중 종료일 이전에 로그인 이력이 있는 방문자
* 현재 : 현재까지 로그인 이력이 있는 방문자

**변수 사용 예시**

회원 방문자

* *회원* : 로그인 이력이 있는 방문자 타겟팅
* *비회원* : 로그인 이력이 없는 방문자 타겟팅

***

### **로그인 방문자**

방문자의 로그인 여부에 따라 타겟팅합니다.

**시점**

* 과거 : 기간 내 사이트에 방문했던 방문자 중 로그인 이력이 있는 방문자
* 현재 : 현재 세션에서 로그인 중인 방문자

**변수 사용 예시**

로그인 방문자

* 로그인 : 방문자 중 로그인 상태인 경우 타겟팅
* 비로그인 : 방문자 중 비로그인 상태인 경우 타겟팅

***

### **회원 성별**

회원 방문자의 성별별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 회원 성별로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 회원 성별로 접속 중인 방문자

**변수 사용 예시**

회원 성별 설정 - \[남성 : 남] / \[여성 : 여 ]로 설정했을 때

* 남 : 회원 방문자 중 성별이 남성인 방문자 타겟팅
* 여 : 회원 방문자 중 성별이 여성이 방문자 타겟팅

**Tip & Guide**

고객사에서 데이터를 제공한 후 설정 페이지에서 회원 성별 설정을 완료한 후 사용 가능한 변수입니다.

***

### **회원 연령대**

회원 방문자의 연령대 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 연령대로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 연령대로 접속 중인 방문자

**변수 사용 예시**

회원 연령대 설정 - \[10세\~19세 : 10대] / \[20세\~29세 : 20대] 로 설정했을 때

회원 연령대 \[10대]

* *일 때* : 회원 방문자 중 연령대가 10세\~19세인 방문자 타겟팅
* *아닐 때* : 회원 방문자 중 연령대가 10세\~19세인 방문자를 제외한 타겟팅

**Tip & Guide**

고객사에서 데이터를 제공한 후 설정 페이지에서 회원 연령대 설정을 완료한 후 사용 가능한 변수입니다.

***

### **회원 등급**

회원 방문자의 등급별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 회원 등급으로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 회원 등급으로 접속 중인 방문자

**변수 사용 예시**

회원 등급 설정 - \[VIP] / \[Gold] / \[Silver] 로 설정했을 때

* 회원 등급 \[VIP]
  * *일 때* : 회원 방문자 중 회원 등급이 VIP인 방문자 타겟팅
  * *아닐 때* : 회원 방문자 중 회원 등급이 VIP인 방문자를 제외한 타겟팅

**Tip & Guide**

고객사에서 데이터를 제공한 후 설정 페이지에서 회원 등급 설정을 완료한 후 사용 가능한 변수입니다.

***

### **회원 유형**

회원 방문자의 유형별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 회원 유형으로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 회원 유형으로 접속 중인 방문자

**변수 사용 예시**

회원 유형 설정 - \[유료 회원] / \[무료 회원] 로 설정했을 때

회원 유형 \[유료 회원]

* *일 때* : 회원 방문자 중 회원 유형이 유료 회원인 방문자 타겟팅
* *아닐 때* : 회원 방문자 중 회원 유형이 유료 회원인 방문자를 제외한 타겟팅

**Tip & Guide**

고객사에서 데이터를 제공한 후 설정 페이지에서 회원 유형 설정을 완료한 후 사용 가능한 변수입니다.

***

### **회원 번호(ID)**

회원 방문자의 회원번호별로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

타겟팅 할 회원 번호(ID)가 1,000개를 초과하는 경우 회원 번호(ID) 변수가 아닌 회원 번호(ID)-대량 변수를 선택하세요.

**시점**

* 과거 : 기간 내 타겟팅한 회원번호(ID)로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 회원번호(ID)로 접속 중인 방문자

**변수 사용 예시**

* 회원번호(ID) \[123]
  * *일 때* : 회원 방문자 중 회원번호(ID)가 123인 방문자 타겟팅
  * *아닐 때* : 회원 방문자 중 회원번호(ID)가 123인 방문자 제외한 타겟팅
  * *포함할 때* : 회원 방문자 중 회원번호(ID)에 123을 포함하는 방문자 타겟팅
  * *포함하지 않을 때* : 회원 방문자 중 회원번호(ID)에 123이 포함된 방문자를 제외한 타겟팅
* 회원번호(ID) \[123, 345]
  * *중 포함하는게 있을 때* : 회원 방문자 중 회원번호(ID)가 123, 345 중 하나라도 포함하는 방문자 타겟팅
  * *중 하나일 때* : 회원 방문자 중 회원번호(ID)가 123, 345 중 하나인 방문자 타겟팅
  * *중 포함하는게 없을 때* : 회원 방문자 중 회원번호(ID)가 123, 345 중 하나라도 포함한 방문자를 제외한 타겟팅
  * *중 하나도 없을 때* : 회원 방문자 중 회원번호(ID)가 123, 345 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 한 번이라도 로그인 한 이력이 있는 방문자의 ID를 식별할 수 있습니다.(쿠키 기반)
* 회원 번호(ID), 회원 번호(ID)-대량, 고객 코드는 하나를 택하여 세그먼트당 최대 1개만 사용할 수 있습니다.

***

### **회원 번호(ID)-대량**

타겟팅 할 회원 번호(ID)가 1,000개를 초과하는 경우 회원 번호(ID) 변수가 아닌 회원 번호(ID)-대량 변수를 선택하세요. csv 파일 형식으로 100만건 까지 업로드 할 수 있습니다.​

**시점**

* 과거 : 기간 내 타겟팅한 회원번호(ID)로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 회원번호(ID)로 접속 중인 방문자

**변수 사용 예시**

* 회원번호(ID) \[123, 345]​
  * *중 하나일 때* : 회원 방문자 중 회원번호(ID)가 123, 345 중 하나인 방문자 타겟팅
  * *중 하나도 없을 때* : 회원 방문자 중 회원번호(ID)가 123, 345 중 하나인 방문자를 제외한 타겟팅​​

**Tip & Guide**

* 한 번이라도 로그인 한 이력이 있는 방문자의 ID를 식별할 수 있습니다.(쿠키 기반)
* 회원 번호(ID), 회원 번호(ID)-대량, 고객 코드는 하나를 택하여 세그먼트당 최대 1개만 사용할 수 있습니다.


# 세그먼트 변수: 방문 행동

### **방문 페이지 URL**

방문자가 방문한 페이지 URL별로 타겟팅합니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 URL로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 URL 방문자

**변수 사용 예시**

방문 페이지 URL \[[https://groobee.net/\]](https://groobee.net/%5D)

* *일 때* : 방문 페이지 URL이 [https://groobee.net/인](https://groobee.net/%EC%9D%B8) 방문자 타겟팅
* *아닐 때* : 방문 페이지 URL이 [https://groobee.net/인](https://groobee.net/%EC%9D%B8) 방문자를 제외한 타겟팅
* *포함할 때* : 방문 페이지 URL이 [https://groobee.net/을](https://groobee.net/%EC%9D%84) 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 방문 페이지 URL이 [https://groobee.net/이](https://groobee.net/%EC%9D%B4) 포함된 방문자를 제외한 타겟팅

방문 페이지 URL \[<https://groobee.net/,> <https://groobee>]

* *중 포함 하는게 있을 때* : 방문 페이지 URL이 <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 방문 페이지 URL이 <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나인 방문자 타겟팅
* *중 포함 하는게 없을 때* : 방문 페이지 URL이 <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 방문 페이지 URL <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 URL이 포함된 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 페이지에 머문 시간

***

### **리퍼러 URL**

리퍼러란 방문자가 링크를 통해 서비스를 방문한 경우, 외부 URL을 말합니다.

방문자의 리퍼러 URL별로 타겟팅합니다. 파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 리퍼러 URL로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 리퍼러 URL를 통한 방문자

**변수 사용 예시**

리퍼러 URL \[[https://google.com/\]](https://google.com/%5D)

* *일 때* : 리퍼러 URL이 [https://google.com/인](https://google.com/%EC%9D%B8) 방문자 타겟팅
* *아닐 때* : 리퍼러 URL이 [https://google.com/인](https://google.com/%EC%9D%B8) 방문자를 제외한 타겟팅
* *포함할 때* : 리퍼러 URL이 [https://google.com/을](https://google.com/%EC%9D%84) 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 리퍼러 URL이 [https://google.com/이](https://google.com/%EC%9D%B4) 포함된 방문자를 제외한 타겟팅

리퍼러 URL \[<https://google.com/,> <https://google>]

* *중 포함하는게 있을 때* : 리퍼러 URL <https://google.com/,> [https://google](https://google/) 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 리퍼러 URL이 <https://google.com/,> [https://google](https://google/) 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 리퍼러 URL이 <https://google.com/,> [https://google](https://google/) 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 리퍼러 URL이 <https://google.com/,> [https://google](https://google/) 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

특정 링크를 통해 유입된 방문자를 타겟팅 하기 위해서는 유입 링크에 식별자를 넣는 것이 좋습니다.

***

### **랜딩 페이지 URL**

랜딩 페이지란 방문자가 첫 번째로 접속하는 내부 페이지를 말합니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

방문자의 랜딩 페이지 URL별로 타겟팅합니다. 파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 랜딩 페이지 URL로 사이트에 처음 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 랜딩 페이지 URL로 사이트에 처음 방문한 방문자

**변수 사용 예시**

랜딩 페이지 URL \[[https://groobee.net/\]](https://groobee.net/%5D)

* *일 때* : 랜딩 페이지 URL이 [https://groobee.net/인](https://groobee.net/%EC%9D%B8) 방문자 타겟팅
* *아닐 때* : 랜딩 페이지 URL이 [https://groobee.net/인](https://groobee.net/%EC%9D%B8) 방문자를 제외한 타겟팅
* *포함할 때* : 랜딩 페이지 URL이 [https://groobee.net/을](https://groobee.net/%EC%9D%84) 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 랜딩 페이지 URL이 [https://groobee.net/이](https://groobee.net/%EC%9D%B4) 포함된 방문자를 제외한 타겟팅

랜딩 페이지 URL \[<https://groobee.net/,> <https://groobee>]

* *중 포함하는게 있을 때* : 랜딩 페이지 URL이 <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 랜딩 페이지 URL이 <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 랜딩 페이지 URL이 <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 랜딩 페이지 URL <https://groobee.net/,> [https://groobee](https://groobee/) 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 URL이 포함된 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 페이지에 머문 시간

***

### **리퍼러 검색어**

리퍼러 검색어란 방문자의 유입 검색어를 말합니다.

방문자의 리퍼러 검색어별로 타겟팅합니다. 파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 리퍼러 검색어로 검색하여 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 리퍼러 검색어로 검색하여 접속 중인 방문자

**변수 사용 예시**

리퍼러 검색어 \[원피스]

* *일 때* : 검색엔진에서 원피스로 검색하고 들어온 방문자 타겟팅
* *아닐 때* : 검색엔진에서 원피스로 검색하고 들어온 방문자를 제외한 타겟팅
* *포함할 때* : 검색엔진에서 원피스를 포함하는 단어를 검색하고 들어온 방문자 타겟팅
* *포함하지 않을 때* : 검색엔진에서 원피스를 포함하는 단어를 검색하고 들어온 방문자를 제외한 타겟팅

리퍼러 검색어 \[원피스, 청바지]

* *중 포함하는게 있을 때* : 검색엔진에서 원피스, 청바지 중 하나라도 포함하여 검색하고 들어온 방문자 타겟팅
* *중 하나일 때* : 검색엔진에서 원피스, 청바지 중 하나를 검색하고 들어온 방문자 타겟팅
* *중 포함하는게 없을 때* : 검색엔진에서 원피스, 청바지 중 하나라도 포함해 검색하고 들어온 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 검색엔진에서 원피스, 청바지 중 하나를 검색하고 들어온 방문자를 제외한 타겟팅

**Tip & Guide**

검색 엔진은 google을 제외한 모든 검색 엔진(네이버, 다음, 네이트)이 해당 됩니다.

***

### **사이트 검색어**

사이트 검색어란 사이트 내부에서 검색한 키워드를 말합니다.

방문자의 사이트 검색어별로 타겟팅합니다. 파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 사이트 검색어로 검색한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 사이트 검색어로 검색한 방문자

**변수 사용 예시**

사이트 검색어 \[원피스]

* *일 때* : 사이트 내부에서 원피스를 검색한 방문자 타겟팅
* *아닐 때* : 사이트 내부에서 원피스를 검색한 방문자를 제외한 타겟팅
* *포함할 때* : 사이트 내부에서 원피스를 포함하는 단어를 검색한 방문자 타겟팅
* *포함하지 않을 때* : 사이트 내부에서 원피스를 포함하는 단어를 검색한 방문자를 제외한 타겟팅

사이트 검색어 \[원피스, 청바지]

* *중 포함 하는게 있을 때* : 사이트 내부에서 원피스, 청바지 중 하나라도 포함하여 검색한 방문자 타겟팅
* *중 하나일 때* : 사이트 내부에서 원피스, 청바지 중 하나를 검색한 방문자 타겟팅
* *중 포함 하는게 없을 때* : 사이트 내부에서 원피스, 청바지 중 하나라도 포함하여 검색한 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 사이트 내부에서 원피스, 청바지 중 하나를 검색한 방문자를 제외한 타겟팅

***

### **PDP-상품명**

방문자가 보고 있는 상품 상세 페이지(PDP)의 상품명별로 타겟팅합니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품명의 상품 상세 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품명의 상품 상세 페이지 방문자

**변수 사용 예시**

PDP-상품명 \[원피스]

* *일 때* : 방문한 상품 페이지의 상품명이 원피스인 방문자 타겟팅
* *아닐 때* : 방문한 상품 페이지의 상품명이 원피스인 방문자를 제외한 타겟팅
* *포함할 때* : 방문한 상품 페이지의 상품명이 원피스를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 방문한 상품 페이지의 상품명이 원피스를 포함하는 방문자를 제외한 타겟팅

PDP-상품명 \[원피스, 청바지]

* *중 포함하는게 있을 때* : 방문한 상품 페이지의 상품명이 원피스, 청바지 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 방문한 상품 페이지의 상품명이 원피스, 청바지 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 방문한 상품 페이지의 상품명이 원피스, 청바지 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 방문한 상품 페이지의 상품명이 원피스, 청바지 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 URL이 포함된 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 페이지에 머문 시간

***

### **PDP-상품 코드**

방문자가 보고 있는 상품 상세 페이지(PDP)의 상품 코드별로 타겟팅합니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

**시점**

* 과거 : 기간 내 타겟팅한 상품 코드의 상품 상세 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품 코드의 상품 상세 페이지 방문자

**변수 사용 예시**

PDP-상품 코드 \[P127644BP]

* 일 때 : 방문한 상품 페이지의 상품 코드가 P127644BP인 방문자 타겟팅
* 아닐 때 : 방문한 상품 페이지의 상품 코드가 P127644BP인 방문자를 제외한 타겟팅
* 포함할 때 : 방문한 상품 페이지의 상품 코드가 P127644BP를 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 방문한 상품 페이지의 상품 코드가 P127644BP를 포함하는 방문자를 제외한 타겟팅

PDP-상품 코드 \[P127644BP, P00000BU]

* 중 포함하는게 있을 때 : 방문한 상품 페이지의 상품 코드가P127644BP, P00000BU 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 방문한 상품 페이지의 상품 코드가 P127644BP, P00000BU 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 방문한 상품 페이지의 상품 코드가 P127644BP, P00000BU 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 방문한 상품 페이지의 상품 코드가P127644BP, P00000BU 중 하나인 방문자를 제외한 타겟\
  팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 URL이 포함된 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 페이지에 머문 시간

***

### **PDP-상품가격**

방문자가 보고 있는 상품 상세 페이지(PDP)의 상품 가격별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품 가격에 타겟팅한하는 상품 상세 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품 가격에 타겟팅한하는 상품 상세 페이지 방문자

**변수 사용 예시**

PDP-상품 가격 \[20,000]원

* *이상* : 과거 상품 가격이 20,000원 이상인 상품을 본 방문자 타겟팅
* *이하* : 과거 상품 가격이 20,000원 이하인 상품을 본 방문자 타겟팅
* *일 때* : 과거 상품 가격이 20,000원인 상품을 본 방문자 타겟팅
* *아닐 때* : 과거 상품 가격이 20,000원이 아닌 상품을 본 방문자 타겟팅

PDP-상품 가격 \[10,000\~20,000]원

* *범위 일 때* : 기간 내 10,000원 이상 20,000원 이하 상품을 본 방문자 타겟팅
* *범위가 아닐 때* : 기간 내 10,000원 이상 20,000원 이하 상품을 본 방문자를 제외한 타겟팅

***

### **PDP-카테고리명**

방문자가 보고 있는 상품 상세 페이지(PDP)의 상품명별로 타겟팅합니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 카테고리명의 상품 상세 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 카테고리명의 상품 상세 페이지 방문자

**변수 사용 예시**

PDP-카테고리명 \[상의]

* *일 때* : 방문한 상품 페이지의 카테고리명이 상의인 방문자 타겟팅
* *아닐 때* : 방문한 상품 페이지의 카테고리명이 상의인 방문자를 제외한 타겟팅
* *포함할 때* : 방문한 상품 페이지의 카테고리명이 상의를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 방문한 상품 페이지의 카테고리명이 상의를 포함하는 방문자를 제외한 타겟팅

PDP-카테고리명 \[상의, 하의]

* *중 포함하는게 있을 때* : 방문한 상품 페이지의 카테고리명이 상의, 하의 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 방문한 상품 페이지의 카테고리명이 상의, 하의 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 방문한 상품 페이지의 카테고리명이 상의, 하의 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 방문한 상품 페이지의 카테고리명이 상의, 하의 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 URL이 포함된 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 페이지에 머문 시간

***

### **PDP-카테고리 코드**

방문자가 보고 있는 상품 상세 페이지(PDP)의 상품 카테고리 코드별로 타겟팅합니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

**시점**

* 과거 : 기간 내 타겟팅한 카테고리 코드의 상품 상세 페이지에 방문한 이력이 있는 방문자\
  현재 : 현재 세션에서 타겟팅한 카테고리 코드의 상품 상세 페이지 방문자

**변수 사용 예시**

PDP-카테고리 코드 \[catecode25]

* 일 때 : 방문한 상품 페이지의 카테고리 코드가 catecode25인 방문자 타겟팅
* 아닐 때 : 방문한 상품 페이지의 카테고리 코드가 catecode25인 방문자를 제외한 타겟팅
* 포함할 때 : 방문한 상품 페이지의 카테고리 코드가 catecode25를 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 방문한 상품 페이지의 카테고리 코드가 catecode25를 포함하는 방문자를 제외한 타겟팅

PDP-카테고리 코드 \[catecode25, catecode121]

* 중 포함하는게 있을 때 : 방문한 상품 페이지의 카테고리 코드가 catecode25, catecode121 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 방문한 상품 페이지의 카테고리 코드가catecode25, catecode121 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 방문한 상품 페이지의 카테고리 코드가 catecode25, catecode121 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 방문한 상품 페이지의 카테고리 코드가 catecode25, catecode121 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 URL이 포함된 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 페이지에 머문 시간

***

### **PDP-브랜드명**

방문자가 보고 있는 상품 상세 페이지(PDP)의 브랜드명 별로 타겟팅합니다. 페이지 뷰, 체류시간 옵션을 설정할 수 있습니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

**시점**

* 과거 : 기간 내 타겟팅한 브랜드 명의 상품 상세 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드명의 상품 상세 페이지 방문자

**변수 사용 예시**

PDP-브랜드명 \[A브랜드]

* 일 때 : 방문한 상품 페이지의 브랜드명이 A브랜드인 방문자 타겟팅
* 아닐 때 : 방문한 상품 페이지의 브랜드명이 A브랜드인 방문자를 제외한 타겟팅
* 포함할 때 : 방문한 상품 페이지의 브랜드명이 A브랜드인 방문자를 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 방문한 상품 페이지의 브랜드명이 A브랜드를 포함하는 방문자를 제외한 타겟팅

PDP-브랜드명 \[A브랜드, B브랜드]

* 중 포함하는게 있을 때 : 방문한 상품 페이지의 브랜드명이 A브랜드, B브랜드 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 방문한 상품 페이지의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 방문한 상품 페이지의 브랜드명이 A브랜드, B브랜드 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 방문한 상품 페이지의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 브랜드명의 상품 상세 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 브랜드명의 상품 상세 페이지에 머문 시간

***

### **PDP-브랜드 코드**

방문자가 보고 있는 상품 페이지(PDP)의 브랜드 코드별로 타겟팅 합니다. 페이지 뷰, 체류시간 옵션을 설정할 수 있습니다.

변수 옵션(선택 값) 페이지 뷰, 체류시간

**시점**

* 과거 : 기간 내 타겟팅한 브랜드 코드의 상품 상세 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드 코드의 상품 상세 페이지 방문자

**변수 사용 예시**

PDP-브랜드 코드 \[1034]

* 일 때 : 방문한 상품 페이지의 브랜드 코드가 1034인 방문자 타겟팅
* 아닐 때 : 방문한 상품 페이지의 브랜드 코드가 1034인 방문자를 제외한 타겟팅
* 포함할 때 : 방문한 상품 페이지의 브랜드 코드가 1034인 방문자를 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 방문한 상품 페이지의 브랜드 코드가 1034를 포함하는 방문자를 제외한 타겟팅

PDP-브랜드 코드 \[1034, 1180]

* 중 포함하는게 있을 때 : 방문한 상품 페이지의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 방문한 상품 페이지의 브랜드 코드가 1034, 1180 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 방문한 상품 페이지의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 방문한 상품 페이지의 브랜드 코드가 1034, 1180 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 페이지 뷰 : 한 방문자가 세션 내 타겟팅한 브랜드 코드의 상품 상세 페이지를 본 횟수
* 체류시간 : 한 방문자가 세션 내 타겟팅한 브랜드 코드의 상품 상세 페이지에 머문 시간

***

### **방문 페이지 ID**

방문자가 방문한 페이지 ID별로 타겟팅 합니다. / 온사이트(Native) 에서만 활용 가능

변수 옵션(선택 값) 페이지 뷰

**시점**

* 과거 : 기간 내 타겟팅한 페이지 ID로 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 페이지 ID 방문자

**변수 사용 예시**

방문 페이지 ID \[P01]

* *일 때* : 방문 페이지 ID가 P01인 방문자 타겟팅
* *아닐 때* : 방문 페이지 ID가 P01인 방문자를 제외한 타겟팅
* *포함할 때* : 방문 페이지 ID가 P01을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 방문 페이지 ID가 P01이 포함된 방문자를 제외한 타겟팅

방문 페이지 ID \[P01, P02]

* *중 포함하는게 있을 때* : 방문 페이지 ID가 P01, P02 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 방문 페이지 ID가 P01, P02 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 방문 페이지 ID가 P01, P02 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 방문 페이지 ID가 P01, P02 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문 페이지 ID는 앱 개발 시 개발자가 설정한 페이지 ID입니다. ID는 담당 개발자에게 문의해 주세요.


# 세그먼트 변수: 장바구니 행동

{% hint style="info" %}

* 방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 동작하지 않음
* 상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 동작
  {% endhint %}

***

### **담은 상품명**

장바구니 페이지에 도달하여 장바구니에 담은 상품의 상품명별로 타겟팅합니다.

변수 옵션(선택 값) 담은 상품 금액, 담은 상품 수량

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품명의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품명의 상품을 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 상품명 \[반팔자켓]

* *일 때* : 장바구니에 담은 상품의 상품명이 반팔자켓인 방문자 타겟팅
* *아닐 때* : 장바구니에 담은 상품의 상품명이 반팔자켓인 방문자를 제외한 타겟팅
* *포함할 때* : 장바구니에 담은 상품의 상품명이 반팔자켓을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 장바구니에 담은 상품의 상품명이 반팔자켓을 포함하는 방문자를 제외한 타겟팅

담은 상품명 \[반팔자켓, 롱원피스]

* *중 포함하는게 있을 때* : 장바구니에 담은 상품의 상품명이 반팔자켓, 롱원피스 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 장바구니에 담은 상품의 상품명이 반팔자켓, 롱원피스 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 장바구니에 담은 상품의 상품명이 반팔자켓, 롱원피스 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 장바구니에 담은 상품의 상품명이 반팔자켓, 롱원피스 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

* 담은 상품 금액 : 장바구니에 담은 상품 금액
* 담은 상품 수량 : 장바구니에 담은 상품 수량

***

### **담은 상품 코드**

장바구니 페이지에 도달하여 장바구니 에 담은 상품의 상품 코드별로 타겟팅합니다.

변수 옵션(선택 값) 담은 상품 금액, 담은 상품 수량

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품코드의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품코드의 상품을 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 상품코드 \[P127644BP]

* *일 때* : 장바구니에 담은 상품의 상품코드가 P127644BP인 방문자 타겟팅
* *아닐 때* : 장바구니에 담은 상품의 상품코드가 P127644BP인 방문자를 제외한 타겟팅
* *포함할 때* : 장바구니에 담은 상품의 상품코드가 P127644BP을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 장바구니에 담은 상품의 상품코드가 P127644BP을 포함하는 방문자를 제외한 타겟팅

담은 상품코드 \[P127644BP, P00000BU]

* *중 포함하는게 있을 때* : 장바구니에 담은 상품의 상품코드가 P127644BP, P00000BU 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 장바구니에 담은 상품의 상풐모드가 P127644BP, P00000BU 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 장바구니에 담은 상품의 상품코드가 P127644BP, P00000BU 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 장바구니에 담은 상품의 상품코드가 P127644BP, P00000BU 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

* 담은 상품 금액 : 장바구니에 담은 상품 금액
* 담은 상품 수량 : 장바구니에 담은 상품 수량

***

### **담은 총액**

장바구니 페이지에 도달하여 장바구니 페이지의 상품 총 금액 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 금액만큼의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 금액만큼의 상품을 장바구니에 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 총액 \[25,000]원

* *이상* : 장바구니에 담은 총 금액이 25,000원 이상인 방문자 타겟팅
* *이하* : 장바구니에 담은 총 금액이 25,000원 이하인 방문자 타겟팅
* *일 때* : 장바구니에 담은 총 금액이 25,000원인 방문자 타겟팅
* *아닐 때* : 장바구니에 담은 총 금액이 25,000원인 방문자를 제외한 타겟팅

담은 총액 \[30,000 \~ 50,000]원

* 범위 일 때 : 장바구니에 담은 총 금액이 30,000원 이상 50,000원 이하인 방문자 타겟팅
* 범위가 아닐 때 : 장바구니에 담은 총 금액이 30,000원 이상 50,000원 이하인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

***

### **담은 카테고리명**

장바구니 페이지에 도달하여 장바구니 페이지의 상품 카테고리명 별로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 카테고리의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 카테고리의 상품을 장바구니에 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 카테고리명 \[아우터]

* *일 때* : 장바구니에 담은 상품의 카테고리명이 아우터인 방문자 타겟팅
* *아닐 때* : 장바구니에 담은 상품의 카테고리명이 아우터인 방문자를 제외한 타겟팅
* *포함할 때* : 장바구니에 담은 상품의 카테고리명이 아우터를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 장바구니에 담은 상품의 카테고리명이 아우터를 포함하는 방문자를 제외한 타겟팅

담은 카테고리명 \[아우터, 드레스]

* *중 포함하는게 있을 때* : 장바구니에 담은 상품의 카테고리명이 아우터, 드레스 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 장바구니에 담은 상품의 카테고리명이 아우터, 드레스 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 장바구니에 담은 상품의 카테고리명이 아우터, 드레스 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 장바구니에 담은 상품의 카테고리명이 아우터, 드레스 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

***

### **담은 카테고리 코드**

장바구니 페이지에 도달하여 장바구니 페이지의 상품 카테고리 코드별로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 카테고리에 속한 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 카테고리에 상품을 장바구니에 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 카테고리 코드 \[catecode25]

* *일 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25인 방문자 타겟팅
* *아닐 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25인 방문자를 제외한 타겟팅
* *포함할 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25를 포함하는 방문자를 제외한 타겟팅

담은 카테고리 코드 \[catecode25, catecode121]

* *중 포함하는게 있을 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25, catecode121 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25, catecode121 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25, catecode121 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 장바구니에 담은 상품의 카테고리 코드가 catecode25, catecode121 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

***

### **담은 SKU 수**

장바구니 페이지에 도달하여 장바구니 페이지의 상품 SKU 수 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 SKU 수만큼의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 SKU 수만큼의 상품을 장바구니에 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 SKU 수 \[3]개

* *이상* : 장바구니에 담은 SKU 수가 3개 이상인 방문자 타겟팅
* *이하* : 장바구니에 담은 SKU 수가 3개 이하인 방문자 타겟팅
* *일 때* : 장바구니에 담은 SKU 수가 3개인 방문자 타겟팅
* *아닐 때* : 장바구니에 담은 SKU 수가 3개인 방문자를 제외한 타겟팅

담은 SKU 수 \[3\~5]개

* *범위 일 때* : 장바구니에 담은 SKU 수가 3개 이상 5개 이하인 방문자 타겟팅
* *범위가 아닐 때* : 장바구니에 담은 SKU 수가 3개 이상 5개 이하인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

***

### **담은 총 수량**

장바구니 페이지에 도달하여 장바구니 페이지의 상품 총 수량별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 총 수량만큼의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 총 수량만큼의 상품을 장바구니에 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 총 수량 \[3]개

* *이상* : 장바구니에 담은 상품의 총 수량이 3개 이상인 방문자 타겟팅
* *이하* : 장바구니에 담은 상품의 총 수량이 3개 이하인 방문자 타겟팅
* *일 때* : 장바구니에 담은 상품의 총 수량이 3개인 방문자 타겟팅
* *아닐 때* : 장바구니에 담은 상품의 총 수량이 3개인 방문자를 제외한 타겟팅

담은 총 수량 \[3\~5]개

* *범위 일 때* : 장바구니에 담은 상품의 총 수량이 3개 이상 5개 이하인 방문자 타겟팅
* *범위가 아닐 때* : 장바구니에 담은 상품의 총 수량이 3개 이상 5개 이하인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

***

### **담은 브랜드명**

장바구니 페이지에 도달하여 장바구니에 담은 상품의 브랜드명 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브랜드 명의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드 명의 상품을 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 상품 브랜드명 \[A브랜드]

* 일 때 : 장바구니에 담은 상품의 브랜드명이 A브랜드인 방문자 타겟팅
* 아닐 때: 장바구니에 담은 상품의 브랜드명이 A브랜드인 방문자를 제외한 타겟팅
* 포함할 때: 장바구니에 담은 상품의 브랜드명이 A브랜드를 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 장바구니에 담은 상품의 브랜드명이 A브랜드를 포함하는 방문자를 제외한 타겟팅

담은 상품 브랜드명 \[A브랜드, B브랜드]

* 중 포함하는게 있을 때 : 장바구니에 담은 상품의 브랜드명이 A브랜드, B브랜드중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 장바구니에 담은 상품의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 장바구니에 담은 상품의 브랜드명\
  이 A브랜드, B브랜드 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 장바구니에 담은 상품의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 브랜드명의 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

***

### **담은 브랜드 코드**

장바구니 페이지에 도달하여 장바구니에 담은 상품의 브랜드 코드별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브랜드코드의 상품을 장바구니에 담고 장바구니 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드코드의 상품을 담은 장바구니 페이지 방문자

**변수 사용 예시**

담은 상품 브랜드 코드 \[1034]

* 일 때 : 장바구니에 담은 상품의 브랜드 코드가 1034인 방문자 타겟팅
* 아닐 때 : 장바구니에 담은 상품의 브랜드 코드가 1034인 방문자를 제외한 타겟팅
* 포함할 때 : 장바구니에 담은 상품의 브랜드 코드가 1034을 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 장바구니에 담은 상품의 브랜드 코드가 1034을 포함하는 방문자를 제외한 타겟팅

담은 상품 브랜드 코드 \[1034, 1180]

* 중 포함하는게 있을 때 : 장바구니에 담은 상품의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 장바구니에 담은 상품의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 포함하는게 없을 때 : 장바구니에 담은 상품의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자를 제외한타겟팅
* 중 하나도 없을 때 : 장바구니에 담은 상품의 브랜드 코드가 1034, 1180 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 브랜드코드의 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.


# 세그먼트 변수: 주문 행동

{% hint style="info" %}
주문 페이지, 주문서 페이지를 방문하는 시점에 동작
{% endhint %}

## 주문 행동

### **주문 상품명**

주문 완료(결제 완료) 페이지에 도달하여 주문 완료한 상품명 별로 타겟팅합니다.

변수 옵션(선택 값) 주문 상품 금액, 주문 상품 수량

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품명의 상품 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품명의 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 상품명 \[반팔자켓]

* *일 때* : 주문 완료 상품의 상품명이 반팔자켓인 방문자 타겟팅
* *아닐 때* : 주문 상품의 상품명이 반팔자켓인 방문자를 제외한 타겟팅
* *포함할 때* : 주문 상품의 상품명이 반팔자켓을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 상품의 상품명이 반팔자켓을 포함하는 방문자를 제외한 타겟팅

주문 상품명 \[반팔자켓, 롱원피스]

* *중 포함하는게 있을 때* : 주문 상품의 상품명이 반팔자켓, 롱원피스 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 상품의 상품명이 반팔자켓, 롱원피스 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 상품의 상품명이 반팔자켓, 롱원피스 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 상품의 상품명이 반팔자켓, 롱원피스 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

방문자가 타겟팅한 상품을 장바구니에 담기 버튼만 누르고 장바구니 페이지에 방문하지 않으면 작동하지 않습니다.

상품이 담겨있는 상태의 장바구니 페이지를 방문하는 시점에 작동합니다.

* 주문 상품 금액 : 주문 완료한 상품의 금액
* 주문 상품 수량 : 주문 완료한 상품의 수량

***

### **주문 상품 코드**

주문 완료(결제 완료) 페이지에 도달하여 주문 완료한 상품 코드를 별로 타겟팅합니다.

변수 옵션(선택 값) 주문 상품 금액, 주문 상품 수량

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품 코드의 상품 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품 코드의 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 상품 코드 \[P127644BP]

* *일 때* : 주문 완료 상품의 상품코드가 P127644BP인 방문자 타겟팅
* *아닐 때* : 주문 완료 상품의 상품코드가 P127644BP인 방문자를 제외한 타겟팅
* *포함할 때* : 주문 완료 상품의 상품코드가 P127644BP을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 완료 상품의 상품코드가 P127644BP을 포함하는 방문자를 제외한 타겟팅

주문 상품 코드 \[P127644BP, P00000BU]

* *중 포함하는게 있을 때* : 주문 완료 상품의 상품코드가 P127644BP, P00000BU 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 완료 상품의 상품코드가 P127644BP, P00000BU 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 완료 상품의 상품코드가 P127644BP, P00000BU 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 완료 상품의 상품코드가 P127644BP, P00000BU 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 주문 상품 금액 : 주문 완료한 상품의 금액
* 주문 상품 수량 : 주문 완료한 상품의 수량

***

### **주문 총액**

주문 완료(결제 완료) 페이지에 도달하여 주문 완료한 상품의 총 금액을 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 금액만큼의 상품을 주문 완료하여 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 금액만큼의 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 총액 \[25,000]원

* *이상* : 주문 완료 상품의 총 금액이 25,000원 이상인 방문자 타겟팅
* *이하* : 주문 완료 상품의 총 금액이 25,000원 이하인 방문자 타겟팅
* *일 때* : 주문 완료 상품의 총 금액이 25,000원인 방문자 타겟팅
* *아닐 때* : 주문 완료 상품의 총 금액이 25,000원인 방문자를 제외한 타겟팅

주문 총액 \[30,000 \~ 50,000]원

* *범위 일 때* : 주문 완료 상품의 총 금액이 30,000원 이상 50,000원 이하인 방문자 타겟팅
* *범위가 아닐 때* : 주문 완료 상품의 총 금액이 30,000원 이상 50,000원 이하인 방문자를 제외한 타겟팅

***

### **주문 번호**

주문 완료(결제 완료) 페이지의 주문번호로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 주문번호의 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 주문번호의 주문 완료 페이지 방문자

**변수 사용 예시**

주문번호 \[Y02051201]

* *일 때* : 주문 완료 페이지의 주문번호가 Y02051201인 방문자 타겟팅
* *아닐 때* : 주문 완료 페이지의 주문번호가 Y02051201인 방문자 제외한 타겟팅
* *포함할 때* : 주문 완료 페이지의 주문번호가 Y02051201을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 완료 페이지의 주문번호가 Y02051201을 포함하는 방문자를 제외한 타겟팅

주문번호 \[Y02051201, Y02051230]

* *중 포함하는게 있을 때* : 주문 완료 페이지의 주문번호가 Y02051201, Y02051230 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 완료 페이지의 주문번호가 Y02051201, Y02051230 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 완료 페이지의 주문번호가 Y02051201, Y02051230 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 완료 페이지의 주문번호가 Y02051201, Y02051230 중 하나인 방문자를 제외한 타겟팅

***

### **주문 카테고리명**

주문 완료(결제 완료) 페이지에 도달하여 주문 완료한 상품의 카테고리명별로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 카테고리에 속하는 상품 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 카테고리에 속하는 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 카테고리명 \[상의]

* *일 때* : 주문 완료 페이지의 상품 카테고리명이 상의인 방문자 타겟팅
* *아닐 때* : 주문 완료 페이지의 상품 카테고리명이 상의인 방문자 제외한 타겟팅
* *포함할 때* : 주문 완료 페이지의 상품 카테고리명이 상의를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 완료 페이지의 상품 카테고리명이 상의를 포함하는 방문자를 제외한 타겟팅

주문 카테고리명 \[상의, 하의]

* *중 포함하는게 있을 때* : 주문 완료 페이지의 상품 카테고리명이 상의, 하의 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 완료 페이지의 상품 카테고리명이 상의, 하의 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 완료 페이지의 상품 카테고리명이 상의, 하의 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 완료 페이지의 상품 카테고리명이 상의, 하의 중 하나인 방문자를 제외한 타겟팅

***

### **주문 카테고리 코드**

주문 완료(결제 완료) 페이지에 도달하여 주문 완료한 상품 카테고리 코드별로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 카테고리에 속하는 상품 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 카테고리에 속하는 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 카테고리 코드 \[Y02051201]

* *일 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201인 방문자 타겟팅
* *아닐 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201인 방문자 제외한 타겟팅
* *포함할 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201를 포함하는 방문자를 제외한 타겟팅

주문 카테고리 코드 \[Y02051201, Y02051230]

* *중 포함하는게 있을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나인 방문자를 제외한 타겟팅

***

### **주문 SKU 수**

주문 완료(결제 완료) 페이지에 도달하여 주문 완료한 상품 SKU수로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 SKU 수만큼의 상품을 주문 완료하여 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 SKU 수만큼의 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 SKU 수 \[3]개

* *이상* : 주문 완료 페이지의 SKU 수가 3개 이상인 방문자 타겟팅
* *이하* : 주문 완료 페이지의 SKU 수가 3개 이하인 방문자 타겟팅
* *일 때* : 주문 완료 페이지의 SKU 수가 3개인 방문자 타겟팅
* *아닐 때* : 주문 완료 페이지의 SKU 수가 3개인 방문자를 제외한 타겟팅

주문 SKU 수 \[3\~5]개

* *범위 일 때* : 주문 완료 페이지의 SKU 수가 3개 이상 5개 이하인 방문자 타겟팅
* *범위가 아닐 때* : 주문 완료 페이지의 SKU 수가 3개 이상 5개 이하인 방문자를 제외한 타겟팅

***

### **주문 총 수량**

주문 완료(결제 완료) 페이지에 도달하여 주문 완료한 상품의 총 수량별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 총 수량 만큼의 상품을 주문 완료하여 주문 완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 총 수량 만큼의 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 총 수량 \[3]개

* *이상* : 주문 완료 상품의 총 수량이 3개 이상인 방문자 타겟팅
* *이하* : 주문 완료 상품의 총 수량이 3개 이하인 방문자 타겟팅
* *일 때* : 주문 완료 상품의 총 수량이 3개인 방문자 타겟팅
* *아닐 때* : 주문 완료 상품의 총 수량이 3개인 방문자를 제외한 타겟팅

주문 총 수량 \[3\~5]개

* *범위 일 때* : 주문 완료 상품의 총 수량이 3개 이상 5개 이하인 방문자 타겟팅
* *범위가 아닐 때* : 주문 완료 상품의 총 수량이 3개 이상 5개 이하인 방문자를 제외한 타겟팅

## **주문서 행동**

### **주문서 상품명**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 상품명별로 타겟팅합니다.

변수 옵션(선택 값) 주문서 상품 금액, 주문서 상품 수량

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품명의 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품명의 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 상품명 \[반팔자켓]

* *일 때* : 주문 중인 상품의 상품명이 반팔자켓인 방문자 타겟팅
* *아닐 때* : 주문 중인 상품의 상품명이 반팔자켓인 방문자를 제외한 타겟팅
* *포함할 때* : 주문 중인 상품의 상품명이 반팔자켓을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 중인 상품의 상품명이 반팔자켓을 포함하는 방문자를 제외한 타겟팅

주문서 상품명 \[반팔자켓, 롱원피스]

* *중 포함하는게 있을 때* : 주문 중인 상품의 상품명이 반팔자켓, 롱원피스 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 중인 상품의 상품명이 반팔자켓, 롱원피스 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 중인 상품의 상품명이 반팔자켓, 롱원피스 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 중인 상품의 상품명이 반팔자켓, 롱원피스 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 주문서 상품 금액 : 주문 중인 상품 금액
* 주문서 상품 수량 : 주문 중인 상품 수량

***

### **주문서 상품 코드**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 상품 코드별로 타겟팅합니다.

변수 옵션(선택 값) 주문서 상품 금액, 주문서 상품 수량

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 상품 코드의 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 상품 코드의 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 상품코드 \[P127644BP]

* *일 때* : 주문 중인 상품의 상품코드가 P127644BP인 방문자 타겟팅
* *아닐 때* : 주문 중인 상품의 상품코드가 P127644BP인 방문자를 제외한 타겟팅
* *포함할 때* : 주문 중인 상품의 상품코드가 P127644BP을 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 중인 상품의 상품코드가 P127644BP을 포함하는 방문자를 제외한 타겟팅

주문서 상품코드 \[P127644BP, P00000BU]

* *중 포함하는게 있을 때* : 주문 중인 상품의 상품코드가 P127644BP, P00000BU 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 중인 상품의 상품코드가 P127644BP, P00000BU 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 중인 상품의 상품코드가 P127644BP, P00000BU 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 중인 상품의 상품코드가 P127644BP, P00000BU 중 하나인 방문자를 제외한 타겟팅

**Tip & Guide**

* 주문서 상품 금액 : 주문 중인 상품 금액
* 주문서 상품 수량 : 주문 중인 상품 수량

***

### **주문서 총액**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 총 금액으로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 금액 만큼의 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 금액 만큼의 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 총액 \[25,000]원

* *이상* : 주문 중인 상품 총 금액이 25,000원 이상인 방문자 타겟팅
* *이하* : 주문 중인 상품 총 금액이 25,000원 이하인 방문자 타겟팅
* *일 때* : 주문 중인 상품 총 금액이 25,000원인 방문자 타겟팅
* *아닐 때* : 주문 중인 상품 총 금액이 25,000원인 방문자를 제외한 타겟팅

주문서 총액 \[30,000 \~ 50,000]원

* *범위 일 때* : 주문 중인 상품 총 금액이 30,000원 이상 50,000원 이하인 방문자 타겟팅
* *범위가 아닐 때* : 주문 중인 상품 총 금액이 30,000원 이상 50,000원 이하인 방문자를 제외한 타겟팅

***

### **주문서 카테고리명**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 카테고리명별로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 카테고리에 속하는 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 카테고리에 속하는 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 카테고리명 \[상의]

* *일 때* : 주문 중인 상품의 상품 카테고리명이 상의인 방문자 타겟팅
* *아닐 때* : 주문 중인 상품의 상품 카테고리명이 상의인 방문자 제외한 타겟팅
* *포함할 때* : 주문 중인 상품의 상품 카테고리명이 상의를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 중인 상품의 상품 카테고리명이 상의를 포함하는 방문자를 제외한 타겟팅

주문서 카테고리명 \[상의, 하의]

* *중 포함하는게 있을 때* : 주문 중인 상품의 상품 카테고리명이 상의, 하의 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 중인 상품의 상품 카테고리명이 상의, 하의 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 중인 상품의 상품 카테고리명이 상의, 하의 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 중인 상품의 상품 카테고리명이 상의, 하의 중 하나인 방문자를 제외한 타겟팅

***

### **주문서 카테고리 코드**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 카테고리 코드별로 타겟팅합니다.

파일 형태인 경우 한 번에 최대 1,000개까지 업로드할 수 있습니다.

**시점**

* 과거 : 기간 내 타겟팅한 카테고리에 속하는 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 카테고리에 속하는 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 카테고리 코드 \[Y02051201]

* *일 때* : 주문 중인 상품의 카테고리 코드가 Y02051201인 방문자 타겟팅
* *아닐 때* : 주문 중인 상품의 카테고리 코드가 Y02051201인 방문자 제외한 타겟팅
* *포함할 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201를 포함하는 방문자 타겟팅
* *포함하지 않을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201를 포함하는 방문자를 제외한 타겟팅

주문서 카테고리 코드 \[Y02051201, Y02051230]

* *중 포함하는게 있을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나라도 포함하는 방문자 타겟팅
* *중 하나일 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나인 방문자 타겟팅
* *중 포함하는게 없을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나라도 포함하는 방문자를 제외한 타겟팅
* *중 하나도 없을 때* : 주문 완료 페이지의 상품 카테고리 코드가 Y02051201, Y02051230 중 하나인 방문자를 제외한 타겟팅

***

### **주문서 SKU 수**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 SKU수로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 SKU 수만큼의 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 SKU 수만큼의 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 SKU 수 \[3]개

* *이상* : 주문서 페이지의 상품 SKU 수가 3개 이상인 방문자 타겟팅
* *이하* : 주문서 페이지의 상품 SKU 수가 3개 이하인 방문자 타겟팅
* *일 때* : 주문서 페이지의 상품 SKU 수가 3개인 방문자 타겟팅
* *아닐 때* : 주문서 페이지의 상품 SKU 수가 3개인 방문자를 제외한 타겟팅

주문서 SKU 수 \[3\~5]개

* *범위 일 때* : 주문서 페이지의 상품 SKU 수가 3개 이상 5개 이하인 방문자 타겟팅
* *범위가 아닐 때* : 주문서 페이지의 상품 SKU 수가 3개 이상 5개 이하인 방문자를 제외한 타겟팅

***

### **주문서 총 수량**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 총 수량으로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 총 수량만큼의 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 총 수량만큼의 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 총 수량 \[3]개

* *이상* : 주문서 페이지의 상품 총 수량이 3개 이상인 방문자 타겟팅
* *이하* : 주문서 페이지의 상품 총 수량이 3개 이하인 방문자 타겟팅
* *일 때* : 주문서 페이지의 상품 총 수량이 3개인 방문자 타겟팅
* *아닐 때* : 주문서 페이지의 상품 총 수량이 3개인 방문자를 제외한 타겟팅

주문서 총 수량 \[3\~5]개

* *범위 일 때* : 주문서 페이지의 상품 총 수량이 3개 이상 5개 이하인 방문자 타겟팅
* *범위가 아닐 때* : 주문서 페이지의 상품 총 수량이 3개 이상 5개 이하인 방문자를 제외한 타겟팅

***

### **주문서 브랜드명**

주문 완료(결제 완료) 페이지에도 도달하여 주문 완료한 상품의 브랜드명 별로 타겟팅 합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브랜드명의 상품 주문완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드명의 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 브랜드명 \[A브랜드]

* 일 때 : 주문 완료 상품의 브랜드명이 A브랜드인 방문자 타겟팅
* 아닐 때 : 주문 상품의 상품 브랜드명이 A브랜드인 방문자를 제외한 타겟팅
* 포함할 때 : 주문 상품의 브랜드명이 A브랜드를 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 주문 상품의 브랜드명이 A브랜드를 포함하는 방문자를 제외한 타겟팅

주문 브랜드명 \[A브랜드, B브랜드]

* 중 포함하는게 있을 때 : 주문 상품의 브랜드명이 A브랜드, B브랜드 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때: 주문 상품의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 주문 상품의 브랜드명이 A브랜드, B브랜드 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 주문 상품의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자를 제외한 타겟팅

***

### **주문서 브랜드 코드**

주문 완료(결제 완료)페이지에 도달하여 주문 완료한 상품의 브랜드 코드별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브랜드 코드의 상품 주문완료 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드 코드의 상품을 주문한 주문 완료 페이지 방문자

**변수 사용 예시**

주문 브랜드 코드 \[1034]

* 일 때 : 주문 완료 상품의 브랜드 코드가 1034인 방문자 타겟팅
* 아닐 때 : 주문 완료 상품의 브랜드 코드가 1034인 방문자를 제외한 타겟팅
* 포함할 때 : 주문 완료 상품의 브랜드 코드가 1034을 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 주문 완료 상품의 브랜드 코드가 1034을 포함하는 방문자 타겟팅

주문 브랜드 코드 \[1034, 1180]

* 중 포함하는게 있을 때 : 주문 완료 상품의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 주문 완료 상품의 브랜드 코드가 1034, 1180 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 주문 완료 상품의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 주문 완료 상품의 브랜드 코드가 1034, 1180 중 하나인 방문자를 제외한 타겟팅

***

### **주문서 브랜드명**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 브랜드명 별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브랜드명의 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드명의 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 브랜드명 \[A브랜드]

* 일 때 : 주문 중인 상품의 브랜드명이 A브랜드인 방문자 타겟팅
* 아닐 때 : 주문 중인 상품의 브랜드명이 A브랜드인 방문자를 제외한 타겟팅
* 포함할 때 : 주문 중인 상품의 브랜드명이 A브랜드를 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 주문 중인 상품의 브랜드명이 A브랜드를 포함하는 방문자를 제외한 타겟팅

주문서 브랜드 \[A브랜드, B브랜드]

* 중 포함하는게 있을 때 : 주문 중인 상품의 브랜드명이 A브랜드, B브랜드 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 주문 중인 상품의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 주문 중인 상품의 브랜드명이 A브랜드, B브랜드 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 주문 중인 상품의 브랜드명이 A브랜드, B브랜드 중 하나인 방문자를 제외한 타겟팅

***

### **주문서 브랜드 코드**

결제 단계 이전의 주문서 페이지에서 주문 중인 상품의 브랜드 코드별로 타겟팅합니다.

**시점**

* 과거 : 기간 내 타겟팅한 브랜드 코드의 상품이 포함된 주문서 페이지에 방문한 이력이 있는 방문자
* 현재 : 현재 세션에서 타겟팅한 브랜드 코드의 상품이 포함된 주문서 페이지 방문자

**변수 사용 예시**

주문서 브랜드 코드 \[1034]

* 일 때 : 주문 중인 상품의 브랜드 코드가 1034인 방문자 타겟팅
* 아닐 때 : 주문 중인 상품의 브랜드 코드가 1034인 방문자를 제외한 타겟팅
* 포함할 때 : 주문 중인 상품의 브랜드 코드가 1034을 포함하는 방문자 타겟팅
* 포함하지 않을 때 : 주문 중인 상품의 브랜드 코드가 1034을 포함하는 방문자를 제외한 타겟팅

주문서 브랜드 코드 \[1034, 1180]

* 중 포함하는게 있을 때 : 주문 중인 상품의 브랜드 코드가 1034, 1180 중 하나라도 포함하는 방문자 타겟팅
* 중 하나일 때 : 주문 중인 상품의 브랜드 코드가 1034, 1180 중 하나인 방문자 타겟팅
* 중 포함하는게 없을 때 : 주문 중인 상품의 브랜드 코드가1034, 1180 중 하나라도 포함하는 방문자를 제외한 타겟팅
* 중 하나도 없을 때 : 주문 중인 상품의 브랜드 코드가 1034, 1180 중 하나인 방문자를 제외한 타겟팅


# 세그먼트 변수: 커스텀

### **커스텀 이벤트**

설정 화면에서 생성한 커스텀 이벤트를 사용하여 방문자를 타겟팅합니다.

**시점**

* 과거 : 기간 내 커스텀 이벤트를 발생시킨 방문자
* 현재 : 현재 세션에서 커스텀 이벤트를 발생시킨 방문자

**변수 사용 예시**

리뷰 작성 시 호출, 데이터 타입 'Int' 선택, 선택값 '3'입력 시

* *이상* : 리뷰 작성 횟수가 3개 이상인 방문자 타겟팅
* *이하* : 리뷰 작성 횟수가 3개 이하인 방문자 타겟팅
* *일 때* : 리뷰 작성 횟수가 3개인 방문자 타겟팅
* *아닐 때* : 리뷰 작성 횟수가 3개인 방문자를 제외한 타겟팅

리뷰 작성 횟수 \[3\~5]개

* *범위 일 때* : 리뷰 작성 횟수가 3개 이상 5개 이하인 방문자 타겟
* *범위가 아닐 때* : 리뷰 작성 횟수가 3개 이상 5개 이하인 방문자를제외한 타겟팅

***

### **커스텀 데이터**

설정 화면에서 생성한 커스텀 데이터를 사용하여 방문자를 타겟팅합니다.

**시점**

* 과거, 현재 시점과 관계 없이 캠페인 노출 시점 기준으로 커스텀 데이터 행동 이력이 있는 방문자

**변수 사용 예시**

쿠폰 개수, 데이터 타입 ‘int’ 선택, 선택값 ‘1’ 입력 시

* *이상* : 쿠폰을 1개 이상 보유 중인 방문자 타겟팅
* *이하*: 쿠폰을 1개 이하 보유 중인 방문자 타겟팅
* *일 때*: 쿠폰을 1개 보유 중인 방문자 타겟팅
* *아닐 때*: 쿠폰을 1개 보유 중인 방문자를 제외한 타겟팅

쿠폰 개수 ‘1\~5’ 입력 시

* *범위 일 때*: 쿠폰을 1개 이상 5개 이하 보유중인 방문자 타겟팅
* *범위 아닐 때*: 쿠폰을 1개 이상 5개 이하 보유중인 방문자를 제외한 타겟팅

**Tip & Guide**

* 설정 화면에서 커스텀 데이터를 추가할 수 있습니다.
* 커스텀 데이터는 최대 30개까지 생성 가능합니다.
* 추가한 커스텀 데이터에 대한 값을 그루비 API를 호출하여 넘겨주지 않으면 동작하지 않습니다.


# AI 상품 추천 캠페인

## **AI 상품 추천 캠페인이란?**

AI 상품 추천 캠페인은 고객의 행동 데이터를 기반으로 머신러닝·딥러닝 알고리즘과 통계형 분석 모델을 활용하여, 고객 개개인에게 가장 적합한 상품을 제안하는 마케팅 방식입니다.

그루비의 상품 추천 캠페인은 단순한 추천을 넘어,

* 28종 이상의 고품질 추천 알고리즘을 지속적으로 고도화된 AI 모델을 통해 제공하고,
* 고객 행동 데이터와 결합해 더욱 세밀하고 전략적인 타겟팅을 지원하며,
* 마케팅 목표(클릭 주문)에 가장 적합한 추천 방식을 AI가 자동으로 계산·적용합니다.

또한 PC·모바일 웹사이트 어디서나 사용할 수 있는 추천 영역 템플릿과 에디터 기능을 제공해, 타이틀·상품명·가격 등 핵심 요소를 직접 수정할 수 있어 개발 리소스를 최소화하고 손쉽게 개인화된 추천 페이지를 제작할 수 있습니다.

***

### **AI 알고리즘 기반의 상품 추천**

그루비는 고객 행동 데이터를 머신러닝·딥러닝 AI와 통계형 알고리즘으로 분석하여 정확한 맞춤형 상품 추천을 제공합니다.

* 최신 AI 모델을 활용한 지속적인 학습과 성능 고도화
* 업계 최적화된 추천 알고리즘 제공

추천 알고리즘은 고객 데이터가 쌓일수록 더 정교해지고, 장기적으로 높은 효율을 발휘합니다.

***

### **고객 타겟팅과 함께 사용**

타겟팅한 고객 행동 데이터와 AI 알고리즘을 결합하여, 단순 추천을 넘어선 정밀 타겟팅이 가능합니다.

* 예: 특정 브랜드/카테고리에 반복적으로 관심을 보인 고객에게 관련 상품 노출

이처럼 고객의 실제 행동 패턴을 기반으로, 맞춤형 캠페인 전략을 세울 수 있습니다.

***

### **AI가 자동으로 추천하는 알고리즘**

그루비 AI는 설정된 마케팅 목표(예: 클릭, 주문)를 달성하기 위해 가장 효과적인 추천 알고리즘을 자동으로 선택해 적용할 수 있습니다.

* 목표 중심의 운영으로 캠페인 성과 극대화

***

### **쉽게 만드는 개인화 상품 추천 페이지**

사이트 모두에서 사용할 수 있는 추천 영역 템플릿을 제공합니다.

* 타이틀, 상품명, 상품 가격 등 핵심 요소 직접 수정 가능
* 디자인 변경, 레이아웃 조정 등 개발 리소스 부담 최소화

***

### **추천 결과가 없을 때는 어떻게 되나요?**

그루비는 추천 결과가 없는 경우 자동으로 폴백(Fallback) 알고리즘을 적용합니다.

추천 대상 상품을 찾지 못한 경우에는 최근 본 상품, **많이 본 상품 TOP N, 많이 구매한 상품 TOP N** 등 사전에 정의된 대체 추천 로직을 **조건에 따라 자동으로** 적용하여 추천 결과를 제공합니다.


# AI 상품 추천 캠페인 관리하기

## **캠페인 관리하기**

추천 캠페인 관리 페이지에서는 새로운 추천 캠페인을 만들고 생성한 추천 캠페인을 관리할 수 있습니다.

### **캠페인 리스트**

<img src="/files/dqoQkloucah1XVkJzBv4" alt="" width="563">

각 항목명을 누르면 필터 또는 정렬 기능을 켜고 끌 수 있습니다.

1. 어드민: 추천 캠페인을 생성한 어드민을 구분합니다. 신규 어드민에서 생성한 캠페인은 '신규'로 표시되고, 기존 어드민에서 생성한 캠페인은 '기존'으로 표시됩니다. 향후 신규 어드민의 개발이 완료되면 구분은 사라질 예정입니다.
2. 캠페인: 추천 캠페인 생성 시 설정한 캠페인의 이름입니다. 각 캠페인명 클릭 시 수정 화면으로 전환됩니다.
3. 상태: 추천 캠페인의 진행 상태를 표시합니다.
   1. 진행중: ▶️
   2. 중지중: ⏸️
4. 접속 유형: 추천 캠페인 생성 시 설정한 접속 유형을 표시합니다. 항목명 클릭 시 필터 기능을 사용할 수 있습니다.
   1. PC/웹
   2. 모바일 전체
   3. 모바일 웹
   4. 모바일 앱
5. 노출 페이지: 추천 캠페인 생성 시 설정한 노출 페이지를 표시합니다. 노출 페이지에 대한 상세한 설명은 추천 1단계 기본 설정 도움말에서 확인할 수 있습니다.
   1. 항목 : 메인, 상품상세, 검색 결과, 장바구니, 직접 입력
6. 알고리즘: 추천 캠페인 생성 시 설정한 알고리즘을 표시합니다. 전체 알고리즘은 추천명을 클릭하면 수정 화면 상에서 확인할 수 있습니다. 알고리즘에 대한 상세한 설명은 추천 1단계 도움말에서 확인할 수 있습니다.
7. 진행기간: 추천 캠페인 생성 시 설정한 진행기간을 표시합니다.
8. 작성일: 추천 캠페인을 생성한 날짜를 표시합니다.
9. 최종 수정일: 추천 캠페인을 마지막으로 수정한 날짜를 표시합니다.
10. 전환 금액: 추천 캠페인이 클릭된 후 같은 세션 내에 추천된 상품이 주문되었을 때 금액 합계를 표시합니다. 자세한 캠페인 성과는 관리 메뉴의 분석 리포트에서 확인할 수 있습니다.

### **관리 메뉴(・・・)**

리스트의 오른쪽 아이콘 마우스 오버 시 관리 메뉴가 표시됩니다.

<img src="/files/Z5u2vEW6hzGohQvfLeOY" alt="" width="563">

**추천 진행중 탭 관리 메뉴**

<table data-header-hidden><thead><tr><th width="105.6484375"></th><th></th></tr></thead><tbody><tr><td>수정</td><td>선택된 추천을 수정합니다.</td></tr><tr><td>복사</td><td>선택된 추천을 복사합니다.</td></tr><tr><td>통계</td><td>추천 분석 리포트에서 선택된 추천의 기본 분석, 주문 상품 분석, 알고리즘 분석 결과를 확인할 수 있습니다.</td></tr><tr><td>미리보기</td><td>선택한 추천의 세팅 내용과 적용될 레이아웃을 확인할 수 있습니다.</td></tr><tr><td>코드 복사</td><td>추천 서비스 적용을 위해 HTML 코드를 복사하여 설정한 노출 페이지 내 원하는 위치에 추가해주세요.</td></tr></tbody></table>

**추천 중지중 탭 관리 메뉴**

<table data-header-hidden><thead><tr><th width="128.18359375"></th><th></th></tr></thead><tbody><tr><td>수정</td><td>선택된 추천을 수정합니다.</td></tr><tr><td>복사</td><td>선택된 추천을 복사합니다.</td></tr><tr><td>통계</td><td>추천 분석 리포트에서 추천의 기본 분석, 주문 상품 분석, 알고리즘 분석 결과를 확인할 수 있습니다.</td></tr><tr><td>미리보기</td><td>선택한 추천의 세팅 내용과 적용될 레이아웃을 확인할 수 있습니다.</td></tr><tr><td>코드 복사</td><td>추천 서비스 적용을 위해 코드를 복사하여 설정한 노출 페이지 내 원하는 위치에 추가해주세요.</td></tr><tr><td>보관함으로 이동</td><td>선택된 추천을 보관합니다.</td></tr></tbody></table>

&#x20;

**추천 보관중 탭 관리 메뉴**

<table data-header-hidden><thead><tr><th width="130.99609375"></th><th></th></tr></thead><tbody><tr><td>통계</td><td>추천 분석 리포트에서 추천의 기본 분석, 주문 상품 분석, 알고리즘 분석 결과를 확인할 수 있습니다.</td></tr><tr><td>중지중으로 이동</td><td>선택된 추천을 중지중 추천으로 이동시킵니다.</td></tr><tr><td>코드 복사</td><td>추천 서비스 적용을 위해 코드를 복사하여 설정한 노출 페이지 내 원하는 위치에 추가해주세요.</td></tr><tr><td>삭제</td><td>선택된 추천을 삭제합니다.</td></tr></tbody></table>

{% hint style="warning" %}
미리보기에는 추천 알고리즘과 무관하게 사이트에서 수집된 상품 정보가 보여집니다. 수집된 상품 데이터 부족한 경우 샘플 이미지로 표현될 수 있습니다.
{% endhint %}


# AI 상품 추천 캠페인 만들기

## **1단계 : 기본 설정**

새로운 추천 캠페인 만들기 기본 설정에서는 캠페인명, 캠페인의 상세설명, 태그 등의 캠페인 기본 정보와 노출할 페이지와 알고리즘을 설정할 수 있습니다.

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

### **캠페인 기본 설정**

1. 단계 이동: 만들기 단계를 확인하실 수 있습니다.
2. 추천명: 추천 생성을 위한 작성 필수 항목입니다.
3. 상세 설명: 추천명으로 표시하기 부족한 부분을 상세하게 작성할 수 있습니다.
4. 태그: 태그를 지정하면 AI 상품 추천 캠페인 관리 메뉴에서 태그 필터 기능으로 생성한 추천을 분류하여 관리할 수 있습니다.
5. 접속 유형: 추천 생성을 위한 작성 필수 항목입니다. 설정 가능한 접속 유형은 다음과 같습니다.
   1. PC/웹 : 방문자가 PC/웹으로 접속한 경우 추천을 노출합니다.
   2. 모바일 전체 : 방문자가 모바일 웹 또는 모바일 앱으로 접속한 경우 추천을 노출합니다.
   3. 모바일 웹 : 방문자가 모바일 웹으로 접속한 경우 추천을 노출합니다.
   4. 모바일 앱 : 방문자가 모바일 앱으로 접속한 경우 추천을 노출합니다.

{% hint style="info" %}
추천 접속 유형을 모바일 앱(하이브리드 앱)으로 설정하기 위해서는 설정 메뉴에서 '모바일 앱 설정'이 먼저 완료되어야 합니다.
{% endhint %}

### **노출 페이지**

* 추천 생성을 위한 작성 필수 항목입니다.
* 페이지 URL 등록은 설정 메뉴에서 가능합니다.
* 설정 가능한 페이지는 다음과 같습니다.
  * 메인
  * 카테고리
  * 상품 상세
  * 장바구니
  * 검색 결과
  * 직접 입력
  * 모든 페이지 (데이터 호출형)

### **알고리즘 설정**

* 추천에 사용될 알고리즘을 선택합니다.
* 설정 가능한 알고리즘 유형은 다음과 같습니다.
  * 상품 추천: 접속한 방문자에게 상품을 추천합니다.
  * 기획전 추천: 접속한 방문자에게 기획전을 추천합니다.
  * 커스텀 추천: 접속한 방문자에게 고객사 맞춤형으로 제작된 추천 알고리즘을 사용한 상품/기획전을 추천합니다.

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

* 설정한 노출 페이지에 따라 사용 가능한 알고리즘이 달라집니다.
* 추천은 한 번 노출될 때마다 1개의 알고리즘을 사용하여 추천할 상품 목록을 생성합니다.
* 2개 이상의 추천 알고리즘을 선택한 경우 동작 방식은 아래와 같습니다.
  * 초기 진행 시 동일한 비율로 선택한 알고리즘 중 1개를 선정하여 추천 상품/기획전을 노출합니다.
  * 이후 그루비만의 AI 기반 노출 비율 최적화 기능을 통해 실시간으로 성과가 좋은 알고리즘의 더 많이 노출되도록 자동으로 조정됩니다.

{% hint style="danger" %}
선택할 수 있는 알고리즘 개수 제한은 없습니다. 다만 사이트 규모와 테스트 기간에 따라 적절한 개수의 알고리즘을 선택해 주세요. \
트래픽이 부족할 경우 많은 알고리즘을 선택할 수록 테스트 시간이 늘어납니다.
{% endhint %}

* 최적화 목표는 선택한 알고리즘이 2개 이상일 때 노출 비율 최적화를 위한 알고리즘의 성과 판단의 기준이 됩니다. (선택한 알고리즘이 1개인 경우 최적화 목표를 설정할 수 없습니다.)
  * '클릭 수'를 선택하면 더 많이 클릭된 추천에 적용된 알고리즘이 더 많이 노출됩니다. '주문 수'를 선택하면 추천을 통한 구매가 더 많이 이루어진 추천에 적용된 알고리즘이 더 많이 노출됩니다.

{% hint style="info" %}
그루비 개인화 추천 기능은 일반적으로 스크립트 설치 후 2\~3일 이후부터 사용하실 수 있습니다. 이 기간 동안 그루비 AI는 최적화된 추천을 제공하기 위해 사이트 방문자의 행동을 분석하여 학습합니다. 고객사의 트래픽 규모에 따라 AI의 학습 기간이 더 짧아지거나 길어질 수 있기 때문에, 그루비팀에서 학습 상황을 모니터링하여 정교한 추천 기능을 사용할 수 있는 시점을 별도로 안내드립니다.
{% endhint %}

* 상품 추천 알고리즘과 기획전 추천 알고리즘은 함께 사용할 수 없습니다. 하나의 노출 영역에 상품과 기획전을 함께 추천하고 싶으시다면 상품 추천, 기획전 추천을 각각 스크립트형 또는 데이터 호출형으로 생성한 뒤 그루비에서 제공하는 2개의 추천 결과 리스트를 받아 고객사 측에서 홈페이지 상에 직접 노출 처리하셔야 합니다.

### **세그먼트 설정**

* 추천을 노출할 타겟 고객을 지정할 수 있습니다. 세그먼트를 설정하지 않으면 노출 페이지를 방문한 모든 고객에게 추천을 노출합니다.
* 세그먼트를 사용하면 설정한 세그먼트에 해당되지 않는 방문자에게는 추천 영역이 노출되지 않습니다.
* 추천 생성 전 타겟팅을 위한 세그먼트를 먼저 생성해주세요.

***

## **2단계 : 메시지 설정**

고객사에서 추천되는 상품을 제어하거나 또는 추천 상품과 관련된 전시 영역의 디자인에 수정이 필요한 경우 스크립트 방식 또는 데이터 호출 방식을 사용할 수 있습니다.

<img src="/files/KPj8rkh9qTTMta0FrsJG" alt="" width="563">

1. 단계 이동: 만들기 단계를 확인하실 수 있습니다.
2. 접속 유형: 기본 설정에서 설정한 접속 유형을 확인하실 수 있습니다.
3. 디자인 유형: 그루비에서 제공하는 AI 상품 추천을 선택하실 수 있습니다. 3가지 유형으로 나눌 수 있으며 유형별 특징은 아래와 같습니다.

![](/files/64wz3dDwOiBmfC1O3ZPb)

![](/files/k7MFKhcWXjp64Hm5bleX)

{% hint style="warning" %}
DIV 유형은 기존 어드민에서 제공하고 있습니다. 신규 어드민에도 추가될 예정입니다.
{% endhint %}

***

## **3단계 : 옵션 설정**

<img src="/files/ela03A4py0ojHxzgbh3g" alt="" width="563">

### **필터링 설정**

* 클릭한 상품 제외 : 현재 세션을 기준으로 한 번 이상 클릭된 상품을 추천에서 제외하는 기능입니다.
* 구매한 상품 제외 : 현재 세션을 기준으로 이미 구매한 상품을 추천에서 제외하는 기능입니다.

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}

{% hint style="warning" %}
필터링 설정 기능은 추천 만들기 1단계 화면에서 '상품 추천' 알고리즘을 선택하신 경우에만 사용할 수 있습니다.
{% endhint %}

### **스케줄**

* '수동 종료 전까지'를 선택하면 추천 생성 시점부터 수동으로 추천을 종료할 때까지 테스트가 진행됩니다.
* 추천을 특정 기간동안에만 노출하려고 한다면 '기간 지정'을 선택해 시작일과 종료일을 입력해 주세요.


# 그루비 알고리즘

그루비에서 설정할 수 있는 알고리즘의 종류와 특징에 대해 알아보세요.

## **알고리즘 유형**

설정 가능한 알고리즘 유형은 다음과 같습니다.

* 상품 추천 : 접속한 방문자에게 상품을 추천합니다.
* 기획전 추천 : 접속한 방문자에게 기획전을 추천합니다.
* 커스텀 추천 : 접속한 방문자에게 고객사 맞춤형으로 제작된 추천 알고리즘을 사용한 상품/기획전을 추천합니다.

{% hint style="warning" %}
커스텀 추천을 사용하면 고객사별 고객의 특정 선호도와 행동에 맞는 추천 알고리즘을 활용해 고객들에게 개인화된 경험을 제공할 수 있습니다. 기본으로 제공되는 상품 추천 및 기획전 추천 알고리즘 외에 그루비 매니저와 협업하여 각 사이트에 특화된 고유한 추천 알고리즘을 구현합니다.&#x20;

\*커스텀 추천 사용을 원하실 경우 그루비로 문의해 주세요. (<groobee_sales@plateer.com>)
{% endhint %}

***

## **알고리즘 종류**

그루비가 제공하는 알고리즘은 총 28개입니다.

그루비 알고리즘은 상품 기반, 방문자 이력 기반, 통계에 기반하여 제작됩니다.

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

### **상품 기반 AI 알고리즘** <a href="#goods" id="goods"></a>

현재 보고 있거나 장바구니에 담은 상품 또는 기획전과 관련도가 높은 상품 또는 기획전을 추천합니다.  특정 상품의 조회, 구매 등 데이터가 부족하여 선택한 알고리즘으로 추천이 불가한 경우 상품명을 분석하여 연관성 높은 상품을 추천하는 '상품명 기반 유사 상품'이 적용됩니다. (통계에도 반영)

{% hint style="warning" %}
특정 상품의 조회나 구매 등 데이터가 부족하여 선택한 알고리즘으로 추천이 불가한 경우 최근 본 상품이 있다면 \[상품명 기반 유사 상품 알고리즘]이 대체 적용되며, 최근 본 상품이 없는 경우에는 \[많이 본 상품 TOP N, 많이 담은 상품 TOP N, 주문 전환율 TOP N , 추천 유입률 TOP N, 추천 클릭률 TOP N] 중 임의의 알고리즘 한 개가 적용되며 통계에도 반영됩니다.

\*임의의 알고리즘이 아닌 특정 알고리즘을 선택하려면 그루비로 문의해 주세요. (<groobee_sales@plateer.com>)
{% endhint %}

#### **함께 본 상품**

가장 기본적인 추천 알고리즘으로서 해당 상품과 연관된 다른 상품을 추천함으로써 구매를 유도합니다. 상품 상세 페이지나 장바구니 페이지가 아닌 경우 최근 본 상품을 기준으로 함께 본 상품을 추천합니다.

노출 제안 페이지

메인, 상품 상세, 장바구니, 직접 입력

#### **함께 담은 상품**

가장 기본적인 추천 알고리즘으로서 해당 상품과 연관된 다른 상품을 추천함으로써 구매를 유도합니다. 상품 상세 페이지나 장바구니 페이지가 아닌 경우 최근 본 상품을 기준으로 함께 담은 상품을 추천합니다.

노출 제안 페이지

메인, 상품 상세, 장바구니, 직접 입력

#### **함께 구매한 상품**

가장 기본적인 추천 알고리즘으로서 해당 상품과 연관된 다른 상품을 추천함으로써 구매를 유도합니다. 상품 상세 페이지나 장바구니 페이지가 아닌 경우 최근 본 상품을 기준으로 함께 구매한 상품을 추천합니다.

노출 제안 페이지

메인, 상품 상세, 장바구니, 직접 입력

#### **연관 카테고리 상품**

보고 있는 카테고리 페이지나 상품의 카테고리 정보를 이용하여 연관된 다른 카테고리 상품을 추천합니다. 추천 실패 또는 추천 상품이 5개 미만인 경우 연관 카테고리 상품 대신 상품명 기반 유사 상품이 추천됩니다.

노출 제안 페이지

카테고리, 상품 상세, 장바구니

다음의 경우에만 카테고리 알고리즘을 적용할 수 있습니다.

* 자체 개발 사이트인 경우
* 카테고리 정보를 대,중,소,세 총 4가지로 분류하여 수집하는 버전의 그루비 스크립트가 설치된 경우

#### **구매 패턴 유사 상품**

기존의 협업 필터링을 개선한 그루비만의 협업 필터링 알고리즘입니다. 고객의 쇼핑 경험을 기반으로 유사 상품을 추천합니다. 기존의 협업 필터링이 단순히 해당 상품을 구매한 고객들이 구매한 상품을 추천했다면, 그루비 협업 필터링은 정밀한 추천 유사도 계산으로 더 정확하게 추천합니다.

노출 제안 페이지

메인, 상품 상세, 장바구니, 직접 입력

#### **딥러닝 기반 유사 상품**

그루비만의 유사 상품 추천 알고리즘입니다. 고객의 브라우징 패턴 중 비슷한 위치에서 등장하는 상품은 비슷한 특성을 가진다는 점에 착안하였습니다. 카테고리 내 상품을 서칭하는 고객에게 효과적이며 상품 상세 페이지를 보고 있는 고객에게 다음으로 볼 상품을 추천합니다.

노출 제안 페이지

메인, 상품 상세, 장바구니, 직접 입력

#### **이미지 기반 유사 상품**

고객이 선호하는 상품과 이미지 유사도가 높은 순으로 상품을 추천합니다. 등록된 상품 이미지의 분류,색상,모양 등 여러 속성을 분석하여, 고객이 선호하는 스타일의 유사 상품을 추천합니다. 고객의 구매 데이터나 선호 데이터가 없는 상황에서도 이미지만으로 유사도를 분석하여 이미지가 비슷한 상품을 추천할 수 있습니다.

노출 제안 페이지

메인, 상품 상세, 장바구니, 직접 입력

다음의 경우에만 이미지 기반 유사 상품 알고리즘을 적용할 수 있습니다.

* 자체 개발 사이트인 경우
* 수집된 카테고리 정보가 유효한 경우
* 수집된 상품 이미지 정보가 유효한 경우

#### **상품명 기반 유사 상품**

방대한 양의 자연어 및 400만개 이상의 상품 데이터를 가지고 딥러닝 기법을 활용한 상품명 확장 분석을 진행합니다.이를 통해 구매, 조회와 같은 이력 데이터 없이도 고도화된 유사 상품 추천이 가능하여 콜드스타트인 경우에도 정확한 상품 추천을 제공할 수 있습니다.

노출 제안 페이지

메인, 상품 상세, 장바구니, 직접 입력

#### **검색어 추천**

방대한 양의 자연어 및 400만개 이상의 상품 데이터를 가지고 딥러닝 기법을 활용한 검색어 확장 분석을 진행합니다. 이를 통해 고객의 검색 의도를 파악하는 고도의 상품 추천이 이루어집니다.

노출 제안 페이지

검색 결과

### **방문자 이력 기반 AI 알고리즘** <a href="#visitor" id="visitor"></a>

이전 방문에서 상품 조회, 구매 등의 이력을 남긴 방문자에게 과거 이력을 기반으로 관심이 있을 가능성이 높은 상품을 추천합니다. 아래 조건으로 생성한 세그먼트와 함께 사용하세요.&#x20;

\[시점: 현재, 변수: 첫 방문, 조건: 첫 방문 아닐 때] \
방문자의 과거 이력 데이터가 부족하여 선택한 알고리즘으로 추천이 불가한 경우 통계형 알고리즘 '많이 본 상품 TOP N, 많이 담은 상품 TOP N, 주문 전환율 TOP N, 추천 유입률 TOP N, 추천 클릭률 TOP N' 중 하나가 선택되어 적용됩니다. (통계에도 반영)

{% hint style="warning" %}
방문자의 과거 이력 데이터가 부족하여 선택한 알고리즘으로 추천이 불가한 경우 최소한의 이력 데이터를 필요로 하는 \[많이 본 상품 TOP N, 많이 담은 상품 TOP N, 주문 전환율 TOP N , 추천 유입률 TOP N, 추천 클릭률 TOP N] 중 임의의 알고리즘 한 개가 적용되며 통계에도 반영됩니다.

\* 임의의 알고리즘이 아닌 특정 알고리즘을 선택하려면 그루비로 문의해 주세요. (<groobee_sales@plateer.com>)
{% endhint %}

#### **딥러닝 기반 다음에 볼 상품**

실시간 또는 과거의 브라우징 패턴으로 고객 개개인의 최근 관심 상품을 분석하여 고객이 다음에 볼 상품을 예측하여 추천합니다.

노출 제안 페이지

모든 페이지

#### **딥러닝 기반 유사 고객 선호 상품**

기존의 협업 필터링의 단점을 개선한 딥러닝 버전의 협업 필터링 알고리즘입니다. 고객의 쇼핑 패턴을 더 잘 찾아내어 유사 고객이 선호하는 상품을 추천합니다.

노출 제안 페이지

모든 페이지

#### **딥러닝 기반 연관 기획전**

그루비만의 기획전 추천 알고리즘입니다. 고객이 보고 있는 상품과 연관된 상품들의 카테고리 및 기획전 정보를 활용하여 가장 연관성이 높은 기획전을 추천합니다. 상품 상세 페이지나 장바구니 페이지가 아닌 경우 최근 본 상품을 기준으로 관련 기획전을 추천합니다.

노출 제안 페이지

모든 페이지

#### **RFM 세그먼트 별 선호 상품**

고객의 Recency(최근 방문), Frequency(방문 빈도), Monetary(구매 금액)를 기준으로 클러스터링하여 상품을 보는 고객이 어떤 클러스터에 해당하는지 파악한 뒤 해당 클러스터에서 선호하는 상품을 추천합니다.

노출 제안 페이지

모든 페이지

#### **유사 취향 고객 선호 상품**

고객의 브라우징 패턴, 본 페이지 순서에 따라 취향을 클러스터링합니다. 고객이 어떤 취향에 들어갈 확률이 높은지 먼저 구하고 그 취향의 클러스터에서 구매 확률이 높은(선호하는) 상품을 구합니다. 기존에는 이 상품군 안에서 랜덤으로 추천을 하였다면 그루비는 유사도를 적용하여 더 정확하게 추천합니다. 비슷한 스타일 또는 같은 카테고리의 상품이 추천되므로 패션, 액세서리 등 특정 분야를 전문으로 하는 버티컬 사이트에서 적용하면 좋은 알고리즘입니다.

노출 제안 페이지

모든 페이지

#### **구매 패턴 유사 고객 선호 상품**

기존의 협업 필터링을 개선한 그루비만의 협업 필터링 알고리즘입니다. 고객의 쇼핑 경험을 기반으로 구매 패턴이 유사한 고객이 선호하는 상품을 추천합니다. 기존의 협업 필터링이 단순히 해당 상품 구매 고객들이 구매한 상품을 추천했다면, 그루비 협업 필터링은 정밀한 추천 유사도 계산으로 더 정확하게 추천합니다.

노출 제안 페이지

모든 페이지

**(종료) 고객 프로파일링 기반 선호 상품**

상품 특성 뿐만 아니라 구매 경험, 방문 경험과 같은 고객의 특성을 반영하여 특정 고객이 구매할 확률이 가장 높은 상품을 추천하는 알고리즘입니다. 고객에 따라 추천 상품 리스트가 달라집니다. 고객이 관심이 없을 만한 것은 아예 추천 대상에서 제외시키기 때문에 세렌디피티(의외의 추천) 효과는 기대할 수 없지만 의외성은 배제한 정직한 추천을 합니다.

노출 제안 페이지

모든 페이지

{% hint style="danger" %}
고객 프로파일링 기반 선호 상품 알고리즘은 2025년 10월 이후 공식 지원이 종료되었습니다.
{% endhint %}

### **통계형 알고리즘** <a href="#statstics" id="statstics"></a>

사이트 전체 데이터 통계를 기반으로 상품을 추천합니다. 메인 페이지 추천이나 첫 방문자 대상 추천으로 활용하기 좋습니다.

#### **많이 본 상품 TOP N**

많이 본 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 상세 페이지 뷰를 기준으로 24시간 간격으로 상품 리스트를 업데이트 합니다.

노출 제안 페이지

모든 페이지

#### **많이 본 기획전 TOP N**

고객이 본 상품과 연계된 기획전을 집계하여 가장 많이 집계된 기획전 순으로 추천하는 통계형 알고리즘입니다. 24시간 간격으로 기획전 리스트를 업데이트 합니다.

노출 제안 페이지

모든 페이지

#### **많이 담은 상품 TOP N**

장바구니에 많이 담은 상품 순으로 추천하는 통계형 알고리즘입니다. 24시간 간격으로 상품 리스트를 업데이트 합니다.

노출 제안 페이지

모든 페이지

#### **많이 구매한 상품 TOP N**

많이 구매한 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 주문 수를 기준으로 24시간 간격으로 상품 리스트를 업데이트 합니다.

노출 제안 페이지

모든 페이지

#### **주문 전환율 TOP N**

주문 전환율이 높은 상품 순으로 추천하는 통계형 알고리즘입니다. 주문 전환율이란 노출 수 대비 주문한 비율입니다. 24시간 간격으로 상품 리스트를 업데이트 합니다.

노출 제안 페이지

모든 페이지

#### **추천 유입률 TOP N**

추천 유입률이 높은 상품 순으로 추천하는 통계형 알고리즘입니다. 추천 유입률이란 상품 전체 노출 수 대비 추천을 통한 노출 수 비율입니다. 상품 상세 페이지 유입 경로 중 추천을 통한 유입 비율이 높은 상품이 추천됩니다. 24시간 간격으로 상품 리스트를 업데이트 합니다.

노출 제안 페이지

모든 페이지

#### **추천 클릭률 TOP N**

추천 클릭률 순으로 추천하는 통계형 알고리즘입니다. 추천 클릭률이란 노출 수 대비 클릭한 비율입니다. 24시간 간격으로 상품 리스트를 업데이트 합니다.

노출 제안 페이지

모든 페이지

#### **할인율 높은 상품 TOP N**

할인율이 좋은 상품 순으로 추천하는 통계형 알고리즘입니다. 24시간 간격으로 상품 리스트를 업데이트 합니다. 해당 알고리즘을 사용하기 위해서는 먼저 상품 정보를 그루비와 연동해야 합니다.

노출 제안 페이지

모든 페이지

#### **카테고리 TOP N**

카테고리 내 인기 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 상세 페이지 뷰 기준으로 24시간 간격으로 상품 리스트를 업데이트 합니다. 사용자별로 선호하는 가격대의 상품을 우선적으로 노출합니다.&#x20;

이 알고리즘을 카테고리 페이지에 적용하는 경우 보고 있는 카테고리 내의 상품이 5개 이하면 추천 영역이 노출되지 않습니다. 이 알고리즘을 장바구니/상품 상세 페이지에 적용하면 보고 있는 상품 또는 장바구니에 담긴 상품과 대/중/소/세 분류가 일치하는 상품이 추천되게 되고, 일치하는 상품 개수가 5개 이하일 때에는 5개 이상인 상위 카테고리를 탐색하여 상품이 추천됩니다.&#x20;

카테고리 제한 기준을 사이트 구조 상의 최하위 카테고리로 설정하면, 카테고리 일치 상 이 5개 이하일 때 상위 카테고리를 탐색하지 않고, 추천 영역을 노출하지 않습니다.

노출 제안 페이지

카테고리, 상품 상세, 장바구니

{% hint style="warning" %}
다음의 경우에만 카테고리 알고리즘을 적용할 수 있습니다.

* 자체 개발 사이트인 경우
* 카테고리 정보를 대,중,소,세 총 4가지로 분류하여 수집하는 버전의 그루비 스크립트가 설치된 경우
  {% endhint %}

#### **실시간 많이 본 TOP N**

실시간 많이 본 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 상세 페이지 뷰 기준으로 3시간 간격으로 상품 리스트를 업데이트합니다.

노출 제안 페이지

모든 페이지

#### **실시간 많이 구매한 TOP N**

실시간 많이 구매한 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 구매 수를 기준으로 3시간마다 추천 상품 리스트를 업데이트합니다.

노출 제안 페이지

모든 페이지

#### **실시간 카테고리 TOP N**

카테고리 내 실시간 인기 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 상세 페이지 뷰 기준으로 3시간 간격으로 상품 리스트를 업데이트 합니다. 사용자별로 선호하는 가격대의 상품을 우선적으로 노출합니다. 이 알고리즘을 카테고리 페이지에 적용하는 경우 보고 있는 카테고리 내의 상품이 5개 이하면 추천 영역이 노출되지 않습니다. 이 알고리즘을 장바구니/상품 상세 페이지에 적용하면 보고 있는 상품 또는 장바구니에 담긴 상품과 대/중/소/세 분류가 일치하는 상품이 추천되게 되고, 일치하는 상품 개수가 5개 이하일 때에는 5개 이상인 상위 카테고리를 탐색하여 상품이 추천됩니다. 카테고리 제한 기준을 사이트 구조 상의 최하위 카테고리로 설정하면, 카테고리 일치 상품이 5개 이하일 때 상위 카테고리를 탐색하지 않고, 추천 영역을 노출하지 않습니다.

노출 제안 페이지

카테고리, 상품 상세, 장바구니

{% hint style="warning" %}
다음의 경우에만 카테고리 알고리즘을 적용할 수 있습니다.

* 자체 개발 사이트인 경우
* 카테고리 정보를 대,중,소,세 총 4가지로 분류하여 수집하는 버전의 그루비 스크립트가 설치된 경우
  {% endhint %}


# 알고리즘 미리보기

## **알고리즘 미리보기**

<img src="/files/8PikYNPeZWulcoc3nyjI" alt="" width="563">

### **자동 추천**

임의의 데이터를 사용하여 추천 결과를 다시 불러옵니다.

### **데이터 입력**

알고리즘에 사용되는 데이터를 직접입력 하여 추천 결과를 확인할 수 있습니다.

* 상품 기반 알고리즘: 상품코드
* 방문자 기반 알고리즘: 회원 ID
* 검색어 알고리즘: 검색 키워드
* 딥러닝 기반 다음에 볼 상품: 5개(권장)의 상품코드 (ex 상품코드1, 상품코드2, ... ,상품코드5)

### **추천 결과 미리보기**

알고리즘에 의한 추천 결과를 확인할 수 있습니다. 노출 우선순위가 높은 상품 순으로 최대 10개의 상품이 노출됩니다.

{% hint style="warning" %}
추천 결과는 노출 필터링 설정, 추천 노출 시점 등의 환경 차이로 인해 달라질 수있습니다.
{% endhint %}

{% hint style="warning" %}
통계형 알고리즘의 경우 사이트 전체의 데이터를 반영하기 때문에 데이터 입력 기능을 제공하지 않습니다.
{% endhint %}

{% hint style="warning" %}
검색 시 추천을 위한 AI 학습이 부족하거나, 입력한 조건에 대한 추천 결과를 찾을 수 없는 경우 추천 결과 확인이 불가능 합니다.
{% endhint %}


# AI 상품 추천 캠페인 분석 리포트

## **기본 분석**

추천 분석 리포트의 기본 분석을 통해 선택한 추천의 기본적인 성과를 확인할 수 있습니다.

<img src="/files/G9lDTxWnEZaA4ut7tBdk" alt="" width="563">

#### **조회 기간**

추천의 진행 기간을 참고하여 데이터 조회 기간을 입력해주세요. 요약 지표, 데이터 추이, 데이터 테이블에 공통적으로 적용되는 조회 기간입니다.

#### **추천 정보**

* 선택한 추천의 기본적인 정보입니다.
* 캠페인명 옆의 새 창으로 열기 아이콘 클릭 시 추천의 상세 정보가 새 창으로 열립니다.

#### **요약 지표**

* 설정한 기간 내 데이터 요약 지표입니다.

#### **데이터 추이**

* 설정한 기간 내 데이터 테이블에 해당하는 데이터의 일별 추이 그래프입니다.
* 노출/클릭/주문 수 데이터 추이와 클릭/주문 전환율 데이터 추이를 막대, 꺾은선 그래프 형태로 확인할 수 있습니다.

#### **데이터 테이블**

* 설정한 기간 내 데이터를 일별로 확인할 수 있습니다.
* 엑셀 파일 다운로드가 가능합니다.
* 데이터 항목은 다음과 같습니다.
  * 노출 수: 설정한 기간 내 추천 SET이 노출된 횟수입니다. 세션과 상관없이 추천 SET이 노출될 때마다 카운팅됩니다.
  * 클릭 수: 설정한 기간 내 추천 SET에서 상품이 클릭된 횟수입니다. 세션과 상관없이 상품이 클릭될 때마다 카운팅됩니다.
  * 주문 수: 설정한 기간 내 추천 SET에서 상품을 클릭하고, 같은 세션에서 해당 상품이 주문된 횟수입니다.
  * 클릭 전환율: 클릭 수 / 노출 수 \* 100
  * 주문 전환율: 주문 수 / 노출 수 \* 100
  * 전환 금액: 설정한 기간 내 추천 SET에서 상품을 클릭하고, 같은 세션에서 해당 상품이 주문된 금액의 합계입니다.

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}

{% hint style="info" %}
주문 완료 페이지에서 전환 데이터가 중복 집계되지 않도록 최초 1회에 한해 그루비와 데이터를 연동합니다. 동일한 주문 완료 페이지를 새로고침하는 경우 추가 연동을 하지 않기 때문에 온사이트 캠페인 또는 상품 추천이 노출되지 않습니다.
{% endhint %}

***

## **주문 상품 분석**

추천 분석 리포트의 주문 상품 분석을 통해 선택한 추천을 통한 주문 이력과 추천 상품 랭킹을 확인할 수 있습니다.

<img src="/files/2Z8EzSsNpBfLdpc8foYR" alt="" width="563">

#### **조회 기간**

* 추천의 진행 기간을 참고하여 데이터 조회 기간을 입력해주세요. 상세 주문 리스트, 추천 상품 랭킹에 공통적으로 적용되는 조회 기간입니다.

#### **추천 정보**

* 선택한 추천의 기본적인 정보입니다.
* 추천명 옆의 새 창으로 열기 아이콘 클릭 시 추천의 상세 정보가 새 창으로 열립니다.

#### **상세 주문 리스트**

* 설정한 기간 내 해당 추천에 의해 노출된 상품이 클릭된 후, 같은 세션 내에서 해당 상품이 주문되었을 때의 주문 이력입니다.
* 주문 일시, 주문 번호, 회원 ID, 주문 금액, 주문 수량, 주문 상품을 확인할 수 있습니다.
* 회원 ID 항목에는 로그인 회원의 주문인 경우 회원ID가 노출되고, 로그인하지 않은 회원의 주문인 경우 '비로그인 회원', 비회원의 주문인 경우 '비회원'이 노출됩니다.
* 주문 상품 마우스 오버 시 전체 주문 상품을 확인 할 수 있습니다.
* 엑셀 파일 다운로드가 가능합니다.(제공 항목)
  * 주문일시 / 주문번호 / 주문 금액 / 주문 수량 / 상품코드 / 주문 상품

#### **추천 상품 랭킹**

* 설정한 기간 내 해당 추천에 의해 노출된 상품의 랭킹입니다.
* 클릭 전환율, 주문 전환율, 전환 금액, 노출 수, 클릭 수, 주문 수 순으로 상품 랭킹 확인이 가능합니다.
* 예를 들어 클릭 수 Top 100은 설정한 기간 내 추천된 상품 중 클릭 수가 높은 상품 순으로 기타 데이터 항목들을 표시합니다.
* 엑셀 파일 다운로드가 가능합니다. (제공 항목)
  * 상품코드 / 상품명 / 카테고리 코드 / 가격 / 노출 수 / 클릭 수 / 주문 수 / 클릭 전환율 / 주문 전환율 / 전환 금액
  * 상품코드 : 서비스에 등록된 상품의 코드가 표시됩니다.ㅤㅤ
  * 상품명 : 서비스에 등록된 상품의 이름이 표시됩니다.
  * 카테고리 코드 : 상품이 속한 카테고리 코드입니다. 여러 카테고리에 속한 상품인 경우 모두 표시됩니다.
  * 가격 : 상품의 판매가입니다.
  * 노출 수 : 설정한 기간 내 해당 추천에 의해 상품이 노출된 횟수입니다. 동일 사용자가 같은 상품에 여러 번 노출된 경우 중복으로 데이터를 집계합니다.
  * 클릭 수 : 설정한 기간 내 해당 추천에 의해 노출된 상품이 클릭된 횟수입니다. 동일 사용자가 같은 상품을 여러 번 클릭한 경우 중복으로 데이터를 집계합니다.
  * 주문 수 : 설정한 기간 내 해당 추천에 의해 노출된 상품이 클릭된 후 같은 세션 내에서 주문까지 완료된 횟수입니다.
  * 클릭 전환율 : 클릭 수 Top 100 중 클릭 전환율이 높은 순으로 랭킹을 표시합니다. 클릭 전환율은 (클릭 수 / 노출 수 \* 100)로 계산됩니다.
  * 주문 전환율 : 주문 수 Top 100 중 주문 전환율이 높은 순으로 랭킹을 표시합니다. 주문 전환율은 (주문 수 / 노출 수 \* 100)로 계산됩니다.
  * 전환 금액 : 설정한 기간 내 해당 추천에 의해 노출된 상품이 클릭된 후 같은 세션 내에서 주문까지 완료된 금액의 합계입니다.

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}

***

## **알고리즘 분석**

* 추천 분석 리포트의 알고리즘 분석을 통해 선택한 추천에 적용된 알고리즘의 분석 데이터를 확인할 수 있습니다.

<img src="/files/fiVnV7mDsnMr5JG21aaC" alt="" width="563">

#### **조회 기간**

* 추천의 진행 기간을 참고하여 데이터 조회 기간을 입력해주세요. 요약 지표, 데이터 추이, 데이터 테이블에 공통적으로 적용되는 조회 기간입니다.

#### **추천 정보**

* 선택한 추천의 기본적인 정보입니다.
* 추천명 옆의 새 창으로 열기 아이콘 클릭 시 추천의 상세 정보가 새 창으로 열립니다.

#### **알고리즘별 데이터**

* 설정한 기간 내 추천 SET에 적용된 알고리즘의 성과에 따른 순위 그래프를 확인할 수 있습니다.
* 순위 그래프 항목은 다음과 같습니다.
  * 노출 수: 설정한 기간 내 알고리즘이 적용된 추천 SET 내 상품이 노출된 횟수입니다. 알고리즘 노출 수는 세션과 상관없이 해당 알고리즘이 적용된 추천 SET이 노출될 때마다 카운팅됩니다.
  * 클릭 수: 설정한 기간 내 알고리즘이 적용된 추천 SET에서 상품이 클릭된 횟수입니다. 알고리즘 클릭 수는 세션과 상관없이 해당 알고리즘이 적용된 추천 SET에서 상품이 클릭될 때마다 카운팅됩니다.
  * 주문 수: 설정한 기간 내 알고리즘이 적용된 추천 SET에서 상품을 클릭하고, 같은 세션 내에서 해당 상품이 주문된 횟수입니다.
  * 클릭 전환율: 클릭 수 / 노출 수 \* 100
  * 주문 전환율: 주문 수 / 노출 수 \* 100
  * 전환 금액: 설정한 기간 내 추천 SET에서 상품을 클릭하고, 같은 세션 내에서 해당 상품이 주문된 금액의 합계입니다.
* 설정한 기간 내의 성과에서 추천 SET에 적용된 알고리즘 각각의 비중 그래프를 확인할 수 있습니다.
* 비중 그래프 항목은 다음과 같습니다.
  * 노출 수: 설정한 기간 내 추천 SET 노출 횟수 중 해당 알고리즘이 적용된 추천 SET 노출 횟수 비율입니다.
  * 클릭 수: 설정한 기간 내 추천 SET을 통한 상품 클릭 수 중 해당 알고리즘이 적용된 추천 SET 클릭 수 비율입니다.
  * 주문 수: 설정한 기간 내 추천 SET을 통한 상품 주문 횟수 중 해당 알고리즘이 적용된 추천 SET 주문 횟수 비율입니다.

#### **데이터 테이블**

* 설정한 기간 내 데이터를 알고리즘별로 확인할 수 있습니다.
* 선택한 추천 생성 시 설정한 알고리즘의 성과 데이터를 확인할 수 있습니다.
* 엑셀 파일 다운로드가 가능합니다.
* 데이터 항목은 다음과 같습니다.
  * 노출 수: 설정한 기간 내 알고리즘이 적용된 추천 SET 내 상품이 노출된 횟수입니다. 알고리즘 노출 수는 세션과 상관없이 해당 알고리즘이 적용된 추천 SET이 노출될 때마다 카운팅됩니다.
  * 클릭 수: 설정한 기간 내 알고리즘이 적용된 추천 SET에서 상품이 클릭된 횟수입니다. 알고리즘 클릭 수는 세션과 상관없이 해당 알고리즘이 적용된 추천 SET에서 상품이 클릭될 때마다 카운팅됩니다.
  * 주문 수: 설정한 기간 내 알고리즘이 적용된 추천 SET에서 상품을 클릭하고, 같은 세션 내에서 해당 상품이 주문된 횟수입니다.
  * 클릭 전환율: 클릭 수 / 노출 수 \* 100
  * 주문 전환율: 주문 수 / 노출 수 \* 100
  * 전환 금액: 설정한 기간 내 추천 SET에서 상품을 클릭하고, 같은 세션 내에서 해당 상품이 주문된 금액의 합계입니다.

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}

***

## **추천 폴백(Fallback) 알고리즘**

그루비 추천 엔진은 설정된 추천 알고리즘으로 추천 가능한 상품이 없는 경우, 추천 영역이 비어 보이지 않도록 자동으로 폴백(Fallback) 알고리즘을 적용합니다.&#x20;

폴백 알고리즘은 개인화 데이터가 부족하거나 추천 가능한 후보 상품이 없는 상황에서도 방문자에게 적절한 상품을 제공하기 위한 자동 보완 기능입니다.

### **추천 결과 생성 방식**

<table><thead><tr><th width="300.203125">유형</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>통계형 추천(많이 본 상품 TOP N / 많이 구매한 상품 TOP N) 중 하나 자동 적용</td></tr></tbody></table>

### **추천 다양성 보장**

폴백 알고리즘이 적용되는 경우 특정 상품만 반복 노출되지 않도록 알고리즘 점수 상위 후보군 내에서 무작위 노출(Randomization)이 적용됩니다.

이를 통해 추천 상품의 다양성을 높이고 반복 노출에 따른 피로도를 줄일 수 있습니다.

### **별도 설정 필요 여부**

폴백 알고리즘은 모든 추천 캠페인에 기본 적용됩니다.&#x20;

관리자가 별도로 설정하거나 활성화할 필요 없이 자동으로 동작하며, 추천 결과가 부족한 상황에서도 안정적으로 추천 영역을 운영할 수 있습니다.


# 커스터마이징


# 다이소 커스텀 알고리즘

{% hint style="info" %}
\*DF : 배송 유형 필터링(delivery filtering)
{% endhint %}

**함께 본 상품(DF)**

해당 상품과 대체 관계에 있는 다른 상품을 추천함으로서 구매를 유도합니다. 배송 유형 택배/매장픽업/오늘배송(퀵)/대량주문/정기배송 필터링이 가능합니다.

**함께 구매한 상품(DF)**

해당 상품과 보완 관계에 있는 다른 상품을 추천함으로서 구매를 유도합니다. 배송 유형 택배/매장픽업/오늘배송(퀵)/대량주문/정기배송 필터링이 가능합니다.

**장바구니 기반 함께 본 상품(DF)**

장바구니에 담긴 상품과 연관 관계에 있는 다른 상품을 추천함으로서 구매를 유도합니다. 배송 유형 택배/매장픽업/오늘배송(퀵)/대량주문/정기배송 필터링이 가능합니다.

**많이 본 TOP N (DF)**

많이 본 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 상세 페이지 뷰를 기준으로 24시간 간격으로 상품 리스트를 업데이트 합니다. 배송 유형 택배/매장픽업/오늘배송(퀵)/대량주문/정기배송 필터링이 가능합니다.

**많이 담은 TOP N (DF)**

장바구니에 많이 담은 상품 순으로 추천하는 통계형 알고리즘입니다. 24시간 간격으로 상품 리스트를 업데이트 합니다. 배송 유형 택배/매장픽업/오늘배송(퀵)/대량주문/정기배송 필터링이 가능합니다.

**주문 전환율 TOP N (DF)**

주문 전환율이 높은 상품 순으로 추천하는 통계형 알고리즘입니다. 주문 전환율이란 노출 수 대비 주문한 비율입니다. 24시간 간격으로 상품 리스트를 업데이트 합니다. 배송 유형 택배/매장픽업/오늘배송(퀵)/대량주문/정기배송 필터링이 가능합니다.

**카테고리 기반 최근 본 연관 상품**

유저의 최근 행동을 반영하여 보고 있는 카테고리 페이지와 연관된 상품을 추천합니다. 추천 실패 또는 추천 상품이 10개 미만인 경우 카테고리형 TOP N 상품이 추천됩니다.

**카테고리 TOP N (대분류)**

대 카테고리 내 인기 상품 순으로 추천하는 통계형 알고리즘입니다. 상품 상세 페이지 뷰를 기준으로 24시간 간격으로 상품 리스트를 업데이트합니다.


# H.Point 커스텀 알고리즘

## **커스텀 추천 알고리즘**

* 구매 data와 이미지 분석을 통해 콘텐츠 유사성을 지수화합니다.
* 가맹점 관심도(60%) + 콘텐츠 유사도(40%) = 추천 점수(100%)
* 적용 대상 : 쿠폰, 플러스 포인트, 이벤트, 기획전

***

## **AI 알고리즘**

**상세 페이지 기반 유사 콘텐츠(이벤트)**

방문자가 보고 있는 해당 이벤트와 유사한 이벤트를 추천합니다.

**행동 기반 유사 콘텐츠(이벤트)**

방문자의 과거 N일 행동과 유사한 이벤트를 추천합니다.

**행동 기반 유사 콘텐츠(쿠폰)**

방문자의 과거 N일 행동과 유사한 쿠폰를 추천합니다.

**행동 기반 유사 콘텐츠(플러스 포인트)**

방문자의 과거 N일 행동과 유사한 플포를 추천합니다.

**행동 기반 유사 콘텐츠(미션)**

방문자의 과거 N일 행동과 유사한 미션을 추천합니다.

***

## **통계형 알고리즘**

**많이 본 콘텐츠 TOP N(이벤트)**

방문자들이 많이 본 이벤트를 추천합니다.

**인기 콘텐츠 TOP N(쿠폰)**

방문자들에게 인기가 가장 많은 쿠폰(많이 보고, 다운 받고, 사용한)을 추천합니다.

**인기 콘텐츠 TOP N(플러스 포인트)**

방문자들에게 인기가 가장 많은 플러스포인트(많이 보고, 다운 받고, 사용한)을 추천합니다.


# 한섬 커스텀 알고리즘

{% hint style="info" %}
최근 1개월(D-30 \~ D-0)동안 조회, 마이하트(찜), 쇼핑백(장바구니), 구매와 같은 사용자 행동에 기반하여 추천하는 커스텀 알고리즘입니다.
{% endhint %}

## **상품 기반 알고리즘** <a href="#goods" id="goods"></a>

**선호 브랜드 기반 많이 구매한 상품**

고객의 상품 클릭, 마이하트(찜), 쇼핑백(장바구니), 주문 내역을 분석하여 선호하는 브랜드를 선정한 후, 각 브랜드에서 최근 14일 동안 등록된 상품 중 가장 많이 구매된 상품들을 추천합니다.

상품 노출 순서

최근 14일 간 등록된 선호 브랜드 별 신상품 중 판매량이 많은 순

**선호 기반 대체 상품**

고객의 상품 클릭, 마이하트(찜), 쇼핑백(장바구니) 조회한 상품을 분석하여 유사하거나 대체 가능한 상품을 추천합니다. 고객의 행동 정보가 확인 되지 않는 경우 최근 6시간 동안 상품 상세 페이지 조회수가 많은 상품을 기준으로 추천합니다.

상품 노출 순서

해당 상품과 연관도가 높은 순

**최근 구매 기반 보완 상품**

고객이 최근에 구매한 상품을 기반으로 분석하여 이를 보완할 수 있는 상품을 추천합니다. 로그인한 고객에 대해서는 해당 고객이 최근 구매한 상품 기반으로 추천하며 고객의 행동 정보가 확인되지 않은 경우에는 최근 6시간 동안 많이 구매한 상품 기준으로 추천합니다.

상품 노출 순서

해당 상품과 연관도가 높은 순

**함께 구매한 상품**

해당 상품과 연관된 다른 상품을 추천함으로써 구매를 유도합니다. 상품 상세 페이지나 장바구니 페이지가 아닌 경우 최근 본 상품을 기준으로 함께 구매한 상품을 추천합니다.

상품 노출 순서

해당 상품과 연관도가 높은 순

**구매 패턴 유사 상품**

고객의 쇼핑 경험을 기반으로 구매 패턴이 유사한 고객이 선호하는 상품을 추천합니다. 기존의 협업 필터링이 단순히 해당 상품 구매 고객들이 구매한 상품을 추천했다면, 그루비 협업 필터링은 정밀한 추천 유사도 계산으로 더 정확하게 추천합니다.

상품 노출 순서

해당 상품과 연관도가 높은 순

**세그먼트 기반 많이 구매한 상품**

고객의 연령, 성별 등 유사한 세그먼트 집단의 특성을 분석하여 해당 세그먼트가 관심을 가질 만한 카테고리 및 상품을 추천합니다.

상품 노출 순서

세그먼트 집단이 관심있는 카테고리 중 주문 많은 순

**브랜드 그룹 내 유사 상품**

고객이 보고 있는 상품의 브랜드와 같은 그룹에 속한 유사 브랜드의 상품을 추천합니다. 의류/잡화 상품의 경우, 사전에 정의된 브랜드 그룹 내에서만 유사 상품을 추천하며, 그룹에 속하지 않거나 뷰티 브랜드의 경우 동일 카테고리 내 모든 브랜드를 자유롭게 추천합니다.

상품 노출 순서

해당 상품과 연관도가 높은 순

**VIP 관심 급상승 상품**

더클럽 VIP 등급(STAR, THE STAR) 고객을 대상으로 최근 30일 동안 많이 조회, 장바구니, 주문, 마이하트(찜)을 종합한 인기 상품 현황을 제공합니다.

상품 노출 순서

사용자 행동 정보를 종합한 인기 많은 상품 순

**스타일 라이브 연동 많은 상품**

최근 14일 동안 등록된 스타일 라이브 게시물 중 선호 브랜드, 카테고리, 성별 등을 고려하여 많이 연동된 상품을 추천합니다. 노출 순위는 게시 건수, 게시물 좋아요 수, 게시물 댓글 수의 우선 순위로 결정됩니다.

상품 노출 순서

스타일라이브 게시글에서 많이 연동된 상품 순

**많이 구매한 브랜드 별 신상품 TOP N**

최근 7일 동안 판매량이 가장 높은 브랜드의 신상품을 고객에게 추천합니다.

**실시간 많이 본 상품 TOP N**

최근 6시간 동안 상품 상세 페이지 조회수가 높은 상품을 기준으로 3시간마다 업데이트하여 실시간으로 인기 상품을 추천합니다.

**실시간 많이 구매한 상품 TOP N**

최근 6시간 동안 구매가 가장 많이 이루어진 상품을 기준으로 3시간마다 업데이트하여 지속적으로 인기 상품을 추천합니다.

**(카테고리) 실시간 많이 본 상품 TOP N**

7일간 가장 많이 판매된 카테고리를 선정하여 최근 6시간 동안 상품 상세 페이지 조회수가 높은 상품을 기준으로 3시간마다 업데이트하여실시간으로 인기 상품을 추천합니다.

***

## **콘텐츠 기반 알고리즘** <a href="#contents" id="contents"></a>

**선호 기반 관련 콘텐츠**

방문자의 클릭, 마이하트(찜), 쇼핑백(장바구니), 주문 상품을 분석하여 선호 브랜드의 상품과 관련된 콘텐츠(최근 1개월 내 등록된 기획전, 이벤트와 같은 콘텐츠)를 고객에게 노출하는 알고리즘입니다.

상품 노출 순서

노출 우선 순위가 높은 순

**개인 맞춤형 메인 배너**

고객의 클릭, 마이하트(찜), 쇼핑백(장바구니), 주문 상품을 분석하여 선호 브랜드, 회원 등급, 성별 등을 반영한 메인 배너를 개인화된 순서로 추천합니다. 고객의 행동 정보가 없는 경우 기존에 설정한 노출 순서대로 전시됩니다.

상품 노출 순서

노출 우선 순위가 높은 순

**실시간 많이 본 콘텐츠 TOP N**

최근 6시간 동안 콘텐츠 상세 페이지 조회수가 높은 콘텐츠를 기준으로 3시간마다 업데이트하여 실시간으로 인기 콘텐츠를 추천합니다.

상품 노출 순서

콘텐츠 페이지 조회가 높은 순

**개인 맞춤형 메인 배너 - 기본 알고리즘**

비회원 대상으로 마케팅 MD가 설정한 배너 순서대로 추천합니다.


# COS 커스텀 알고리즘

## **AI 알고리즘**

**검색어 추천**

방대한 양의 자연어 및 400만개 이상의 상품 데이터를 가지고 딥러닝 기법을 활용한 상품명 확장 분석을 진행합니다.이를 통해 구매, 조회와 같은 이력 데이터 없이도 고도화된 유사 상품 추천이 가능하여 콜드스타트인 경우에도 정확한 상품 추천을 제공할 수 있습니다.

**상품 상세(3차)**

상품별 동일한 카테고리 내에서 방문자들이 함께 많이 조회한 상품을 추천합니다. 이는 AbTasty 접근 방식을 모방한 알고리즘입니다.

**상품 상세(4차)**

상품별 동일한 방문자들이 함께 많이 조회한 상품을 추천합니다.

**장바구니(3차)**

중복 및 품절 상품을 제외한 유저가 최근 본 상품을 추천합니다. 이는 AbTasty 접근 방식을 모방한 알고리즘입니다.

**상품상세(2차)**

상품별 동일한 방문자들이 함께 많이 조회한 상품 중 이미지 유사도가 높은 상품을 추천합니다.

**상품상세(5차)**

상품별 동일한 방문자들이 함께 많이 조회한 상품 중 색상이 유사한 상품을 추천합니다.

***

## **통계형 알고리즘**

**실시간 많이 본 TOP N**

방문자들이 실시간으로 많이 본 상위 N개의 상품을 추천합니다.

**실시간 많이 구매한 TOP N**

방문자들이 실시간으로 많이 구매한 상위 N개의 상품을 추천합니다.


# 추천 이력 조회

특정 회원에게 추천된 알고리즘과 추천 내역을 확인합니다.

![](/files/EoMZxqvPBE44rjy3jliD)

## **조회 조건**

![](/files/pOyESdXDJM74I47dyqZa)

1. 알고리즘 미리보기 클릭 시 우측에서 알고리즘 별 추천 결과를 확인할 수 있습니다.

{% hint style="info" %}
[알고리즘 미리보기 도움말 바로가기](/new-admin/ai-recommendation/ai-recommendation-create/algorithm-preview)
{% endhint %}

2. 조회 조건

* 조회하고 싶은 기간을 입력해 주세요. 조회 가능 기간은 최대 한 달(31일)입니다.
* 조회하고 싶은 회원 ID를 입력해 주세요. 해당 사용자에게 추천된 이력이 조회됩니다.

***

## **데이터 테이블**

테이블 항목을 클릭하면 해당 추천에 대한 상세 정보가 우측에 나타납니다.

![](/files/saoLmWhAI5hqo78NbyM5)

1. 테이블 항목
   * 캠페인명: 알고리즘이 포함된 캠페인입니다. 우측 아이콘을 통해 특정 캠페인을 선택하여 볼 수 있습니다.
   * 노출 페이지: 사용자에게 추천이 노출된 페이지입니다. 우측 아이콘을 통해 특정 페이지를 선택하여 볼 수 있습니다.
   * 알고리즘명: 사용자에게 추천을 노출한 알고리즘입니다. 우측 아이콘을 통해 특정 페이지를 선택하여 볼 수 있습니다.
   * 알고리즘 대체 여부: 추천 만들기 단계에서 설정한 개인화 알고리즘은 특정 시점의 개인화 여부에 따라 대체될 수 있습니다. Y의 경우 통계형 알고리즘으로 대체됩니다.
   * 추천 일시: 사용자에게 추천된 시점입니다.

***

## **추천 이력**

우측 패널에서 사용자의 실제 클릭, 추천 결과, 행동 이력 정보를 확인할 수 있습니다.

**실제 노출**

![](/files/VYrDDXuhTitNO8Npfgvk)

1. 기본 정보
   * 회원 ID, 캠페인명, 캠페인 키, 알고리즘명과 같은 회원과 알고리즘에 대한 기본 정보를 확인할 수 있습니다.
2. 클릭한 아이템
   * 회원에게 실제 노출된 리스트 중에서 회원이 실제로 클릭한 아이템이 리스트 상단에 노출됩니다.
3. 추천 아이템
   * 회원에게 실제 노출된 리스트 중에서 회원이 실제로 클릭한 아이템이 리스트 상단에 노출됩니다.

### **추천 결과**

![](/files/NA55Y8oEams8mrbUdMxa)

1. 추천 정보
   * 선호 브랜드, 선호 카테고리, 성별, 연령 등 하단 추천 결과에 활용되는 정보가 노출됩니다. 알고리즘 별로 항목이 달라집니다.
2. 추천 항목
   * 알고리즘에 따라 사용자에게 추천된 결과 항목이 노출됩니다.

### **행동 이력**

![](/files/CnIbCkIXuP5lOimqmm2S)

1. 행동 이력 정보
   * 알고리즘 별로 수집하는 수집 데이터 항목을 노출합니다.


# 온사이트 캠페인

## **온사이트 캠페인이란?**

온사이트 캠페인은 사이트에 접속 중인 고객과 실시간으로 소통하여, 고객의 행동에 맞춘 개인화된 메시지를 즉시 전달하는 마케팅 방식입니다.

그루비의 온사이트 캠페인은 단순 팝업 노출을 넘어,

* 고객의 실시간 행동 데이터를 기반으로 메시지를 자동 발송하고,
* 다양한 UI 환경(PC, 모바일 웹, 앱 등)에서 일관성 있게 적용되며,
* 간편한 에디터 기능을 통해 개발자·디자이너 도움 없이도 마케터가 직접 제작할 수 있습니다.

또한 A/B/N 테스트와 AI 최적화를 결합해, 메시지 성과를 데이터 기반으로 측정·개선할 수 있어 가장 효과적인 고객 경험을 만들어냅니다.

### **사이트 접속 고객과 실시간 상호작용**

* 고객의 행동 시점(스크롤, 클릭, 페이지 체류 등)에 맞춰 메시지 발송
* 즉각적인 개인화 경험 제공으로 이탈 방지 및 전환율 상승

### **다양한 온사이트 메시지 UI**

PC, 모바일 웹, 하이브리드 앱, 네이티브 앱 등 모든 환경에서 메시지를 노출할 수 있습니다.

* 배너, 팝업, 슬라이드인 등 다양한 UI 지원
* 디바이스별 맞춤 최적화 제공

### **간편한 캠페인 에디터**

마케터는 개발자나 디자이너 협업 없이도, 실시간 고객 행동 데이터를 활용해 맞춤형 메시지 페이지를 제작할 수 있습니다.

* 텍스트/이미지 변경, 버튼 삽입 등 직관적 에디터 기능
* 실시간 데이터 기반 메시지 노출로 캠페인 운영 효율성 향상

### **메시지 최적화**

그루비 AI는 최적화 기능을 통해 마케팅 목표(노출, 클릭, 주문 전환 등)에 가장 잘 부합하는 온사이트 메시지 유형의 노출 비율을 자동으로 조절합니다.


# 온사이트 캠페인 관리하기

생성한 온사이트 캠페인의 현황을 확인하고, 관리(진행, 수정, 삭제, 제외 조건 설정 등)하는 페이지입니다.

<figure><img src="/files/6HLMAvHgaEkvY9wwHGbP" alt=""><figcaption></figcaption></figure>

## **1. 만들기**

<img src="/files/LijoMXKw60pZ6FnEWKjN" alt="" data-size="line"> 버튼 클릭 시 **새로운 온사이트 캠페인 만들기 페이지**로 이동합니다.

***

## **2. 제외 조건 관리**

<img src="/files/0N2U5Jak00HJSjJXUx2h" alt="" data-size="line">버튼 클릭 시 **온사이트 캠페인에 설정한 제외 조건의 현황을 확인하고, 관리(수정, 삭제 등)하는 페이지**로 이동합니다.

{% hint style="info" %}
제외 조건 설정은 기준 캠페인이 노출 또는 클릭된 이후 특정 캠페인의 노출을 제한할 수 있는 기능입니다.\
자세한 내용은 [**\[제외 조건 설정\]**](/new-admin/onsite/manage/exclusion-conditions) 도움말을 참고해 주세요.
{% endhint %}

***

## **3. 캠페인 리스트**

### **3-1. 진행중**

생성한 온사이트 캠페인 중 진행 중인 캠페인의 목록입니다.

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

<table><thead><tr><th width="159.8359375">칼럼명</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><img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">: 설정된 스케줄에 따라 캠페인이 진행 중인 상태입니다.</li></ul></td></tr><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>캠페인이 진행되는 시작 및 종료 일자입니다.</td></tr><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>캠페인이 클릭된 총 횟수입니다.</td></tr><tr><td><strong>클릭 전환율</strong></td><td>캠페인의 노출 횟수 대비 클릭된 비율입니다.</td></tr><tr><td><strong>제외 조건</strong></td><td>캠페인에 설정된 제외 조건 여부입니다.</td></tr></tbody></table>

### **3-2. 중지중**

생성한 온사이트 캠페인 중 중지 중인 캠페인의 목록입니다.

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

<table><thead><tr><th width="159.8359375">칼럼명</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><img src="/files/TRr31QJE6zxLsx5PmtD2" alt="" data-size="line">: 캠페인이 일시적으로 중지된 상태입니다. 설정된 진행 기간이 되어도 자동으로 진행되지 않습니다.</li></ul></td></tr><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>캠페인이 진행되는 시작 및 종료 일자입니다.</td></tr><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>캠페인이 클릭된 총 횟수입니다.</td></tr><tr><td><strong>클릭 전환율</strong></td><td>캠페인의 노출 횟수 대비 클릭된 비율입니다.</td></tr><tr><td><strong>제외 조건</strong></td><td>캠페인에 설정된 제외 조건 여부입니다.</td></tr></tbody></table>

### **3-3. 보관함**

생성한 온사이트 캠페인 중 보관함으로 이동된 캠페인의 목록입니다.

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

<table><thead><tr><th width="159.8359375">칼럼명</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><img src="/files/TRr31QJE6zxLsx5PmtD2" alt="" data-size="line">: 캠페인이 일시적으로 중지된 상태입니다. 설정된 진행 기간이 되어도 자동으로 진행되지 않습니다.</li></ul></td></tr><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>캠페인이 진행되는 시작 및 종료 일자입니다.</td></tr><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>캠페인이 클릭된 총 횟수입니다.</td></tr><tr><td><strong>클릭 전환율</strong></td><td>캠페인의 노출 횟수 대비 클릭된 비율입니다.</td></tr><tr><td><strong>제외 조건</strong></td><td>캠페인에 설정된 제외 조건 여부입니다.</td></tr></tbody></table>

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

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

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

<table><thead><tr><th width="160.1015625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/wIrIsQFbNXIu35OPhaS4" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 캠페인을 수정합니다. 단, '메시지 유형' 및 '접속 유형'은 수정할 수 없습니다.<br>'AI 자동화' 방식의 A/B/N 테스트를 설정한 캠페인의 경우, 노출 이력이 있다면 수정할 수 없으며 내용 확인만 가능합니다.</td></tr><tr><td><img src="/files/xHwQYOmNds52LGsy65QX" alt="" data-size="line"> <strong>복사</strong></td><td>선택한 캠페인을 복사하여 동일한 내용의 새로운 캠페인을 생성합니다. 복사된 캠페인은 캠페인명 뒤에 '-COPY'가 추가됩니다.</td></tr><tr><td><img src="/files/96B2sMaulgkXFwUtFWB7" alt="" data-size="line"> <strong>분석 리포트</strong></td><td>해당 캠페인의 성과를 분석 리포트로 확인합니다.</td></tr><tr><td><img src="/files/sdXrs7KYamhq83aIzqbu" alt="" data-size="line"> <strong>미리보기</strong></td><td>온사이트 캠페인이 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.</td></tr><tr><td><img src="/files/c43caFk94K0tdBmRHWIu" alt="" data-size="line"> <strong>제외 조건 설정</strong></td><td>기준 캠페인이 노출되거나 클릭된 이후, 지정한 다른 캠페인 노출을 제한하도록 설정합니다.</td></tr><tr><td><img src="/files/QJsYdzkw4VbDb58UhYty" alt="" data-size="line"> <strong>보관함으로 이동</strong></td><td>캠페인을 '보관함'으로 이동시켜 보관합니다. <strong>'중지' 상태인 캠페인만 이동</strong>할 수 있습니다.</td></tr><tr><td><img src="/files/Elrk2kHEooS8V9PDTUFE" alt="" data-size="line"> <strong>중지중으로 이동</strong></td><td>보관 중인 캠페인을 다시 '중지중'으로 이동시킵니다.</td></tr><tr><td><img src="/files/WCemdenye04VXDipLJHP" alt="" data-size="line"> <strong>삭제</strong></td><td>캠페인을 영구적으로 삭제합니다. <strong>'보관함'의 캠페인만 삭제</strong>할 수 있으며, 삭제된 캠페인은 복구할 수 없습니다.</td></tr></tbody></table>

***

## **4. 태그 필터**

캠페인 생성 시 추가한 태그를 기준으로, 원하는 캠페인만 목록에서 필터링하여 볼 수 있습니다.

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

(1) 원하는 태그를 모두 선택(체크)한 후 \[선택] 버튼을 클릭해 주세요.

(2) 선택한 태그가 포함된 캠페인만 목록에 표시됩니다.

***

## **6. 검색**

검색창에 캠페인명을 직접 입력하여 원하는 캠페인을 찾을 수 있습니다.


# 제외 조건 설정

제외 조건 설정은 기준 캠페인이 노출 또는 클릭된 이후 특정 캠페인의 노출을 제한할 수 있는 기능입니다.

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

## **1. 제외 조건 설정**

캠페인의 관리 도구 메뉴에서 **\[제외 조건 설정]**&#xC744; 클릭하여 설정할 수 있습니다.

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

* **기준 캠페인:** 조건 설정 시 기준이 되는 캠페인의 이름입니다.
* **제외 기준:** 제외 기준을 선택할 수 있습니다.
  * **노출 시:** 기준 캠페인이 노출된 후 선택한 제외 캠페인을 노출하지 않습니다.
  * **클릭 시:** 기준 캠페인이 클릭된 후 선택한 제외 캠페인을 노출하지 않습니다.

{% hint style="warning" %}
제외 기준 선택에 따라 기준 캠페인(A)의 **캠페인 진행 기간 동안 한 번이라도 노출 또는 클릭한 이력**이 있을 경우, 제외 캠페인(B, C, ...)을 노출하지 않습니다.
{% endhint %}

* **제외 캠페인:** 제외 대상 캠페인을 선택할 수 있습니다. (최대 20개)

{% hint style="info" %}
제외 캠페인은 캠페인 상태(진행중, 중지중, 보관함)와 상관없이 설정 가능하지만 제외 캠페인이 모두 중지중되거나 보관함으로 이동된 경우 해당 제외 조건은 자동으로 비활성화됩니다.
{% endhint %}

***

## **2. 제외 조건 관리**

설정한 제외 조건의 현황을 확인하고, 관리(수정, 삭제 등)하는 페이지입니다.

### **2-1. 제외 조건 리스트**

설정한 제외 조건의 목록입니다.

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

<table><thead><tr><th width="159.8359375">칼럼명</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>제외 조건 설정 시 선택한 제외 캠페인의 목록입니다. (최대 20개)</td></tr><tr><td><strong>조건 상태</strong></td><td><p>해당 제외 조건의 활성화 여부를 나타냅니다.</p><ul><li><strong>활성:</strong> 해당 제외 조건의 제외 캠페인이 <strong>1개 이상 진행중</strong>으로 활성화된 상태입니다.</li><li><strong>비활성:</strong> 해당 제외 조건의 제외 캠페인이 <strong>모두 중지 중이거나 보관함으로 이동</strong>되어 비활성화된 상태입니다.</li></ul></td></tr><tr><td><strong>설정일</strong></td><td>제외 조건이 설정된 날짜입니다.</td></tr><tr><td><strong>최종 수정일</strong></td><td>제외 조건이 가장 최근에 수정된 날짜입니다.</td></tr></tbody></table>

{% hint style="info" %}
제외 캠페인의 상태에 따라 제외 조건의 상태가 자동으로 활성화되거나 비활성화됩니다. 또한 기준 캠페인 또는 제외 캠페인이 모두 삭제된 경우 해당 제외 조건도 자동으로 삭제됩니다.
{% endhint %}

### **2-2. 관리 도구**

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

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

<table><thead><tr><th width="160.1015625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/wIrIsQFbNXIu35OPhaS4" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 제외 조건을 수정합니다.</td></tr><tr><td><img src="/files/WCemdenye04VXDipLJHP" alt="" data-size="line"> <strong>삭제</strong></td><td>제외 조건을 영구적으로 삭제합니다. 삭제된 제외 조건은 복구할 수 없습니다.</td></tr></tbody></table>


# ㅤ온사이트 캠페인 만들기 : 레이어

## **1단계 : 기본 설정**

새로운 온사이트 캠페인 만들기 기본 설정에서는 캠페인명, 캠페인의 상세설명, 태그 등의 캠페인 기본 정보와 캠페인 타겟을 설정할 수 있습니다.

<img src="/files/fLuehBNTdoe6KtXd0gfU" alt="" width="563">

### **단계 이동**

* 캠페인 생성을 위한 작성 필수 항목입니다. 한글 공백 포함 최대 40자로 작성해주세요.

### **캠페인 기본 정보**

![](/files/JowF0UOLGbotDO6AUvvg)

* 캠페인명 : 해당 캠페인의 이름을 설정합니다. 한글 기준 공백 포함 최대 40자까지 설정 가능합니다.
* 상세 설명 : 해당 캠페인에 대한 간략한 설명이 필요할 시 설정합니다. 한글 기준 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. 캠페인 리스트에서 태그 필터를 통해 특정 캠페인을 필터링할 때 활용할 수 있습니다.
* 플랫폼 > 웹/하이브리드 : 사이트 플랫폼이 표기됩니다.
* 메시지 유형 > 레이어 : 사이트를 이용 중인 고객이 타겟팅 된 순간 실시간으로 레이어 형태의 메시지를 노출합니다. 팝업, 풀스크린, 슬라이드 인, 플로팅 바 형태의 메시지를 제작할 수 있습니다.
* 접속 유형
  * PC/웹 : 방문자가 PC/웹으로 접속한 경우 캠페인을 노출합니다.
  * 모바일 전체 : 방문자가 모바일 웹 또는 모바일 앱으로 접속한 경우 캠페인을 노출합니다.
  * 모바일 웹 : 방문자가 모바일 웹으로 접속한 경우 캠페인을 노출합니다.
  * 모바일 앱 : 방문자가 모바일 앱으로 접속한 경우 캠페인을 노출합니다.<br>

<table data-header-hidden><thead><tr><th width="341.5078125"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/CQAe8Th1WbYEFwinTHpX" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

![](/files/PYvk56tRfAcd8GlAtY7I)

* 캠페인을 진행할 대상 타겟을 설정합니다.
* 세그먼트는 캠페인 1개 당 1개씩만 지정할 수 있습니다.
* 설정한 세그먼트에 해당되지 않는 방문자에게는 캠페인이 노출되지 않습니다.

***

## **2단계 : 메시지 설정**

* 에디터를 이용해 사이트에 노출할 메시지 디자인 할 수 있습니다.

<img src="/files/Spo8ZqjaxzcbBly0jeWN" alt="" width="563">

### **기본 설정 정보**

* 1단계에서 설정한 캠페인 기본 설정 정보를 확인할 수 있습니다.

### **A/B/N 디자인 안 설정**

* A/B/N 테스트를 위한 디자인 안을 추가할 수 있습니다.&#x20;
* A안 부터 J안 까지 최대 10개까지 추가 가능합니다. 추가되는 디자인들은 A안의 템플릿 유형과 동일하며 제공되는 템플릿을 사용하거나 이미 만들어진 디자인 안을 복사하여 가져올 수 있습니다.

### **디자인 유형 정보**

* 1단계에서 설정한 메시지 디자인 유형을 확인할 수 있습니다.

### **메시지 디자인 설정**

* 팝업, 풀 스크린, 슬라이드 인과 같은 다양한 유형을 설정 할 수 있습니다.\
  (메시지 디자인 설정에 사용된 이미지는 설명을 위해 재가공되었습니다.)

#### 이미지

<img src="/files/sQpRDvEZhZ0tYXBWEN2B" alt="" width="375">

* 업로드: 캠페인에 사용할 이미지를 업로드합니다.
* 가로 사이즈 : 가로 사이즈의 단위는 px과 %(퍼센트)를 선택할 수 있습니다. \
  px은 200px \~ 500px, %(퍼센트)는 10\~95%

#### **이미지 링크** <a href="#link" id="link"></a>

<img src="/files/MXBC1xPktf72RIrPDZ7H" alt="" width="375">

* URL입력
  * URL 형태는 자유롭게 작성하실 수 있습니다.
    * 입력 예시
      * <https://groobee.shop.test/product/detail.html?product\\_no=31\\&cate\\_no=1\\&display\\_group=2>
      * {유동적인 URL}/product/detail.html?product\_no=31\&cate\_no=1\&display\_group=2
      * <https://groobee.shop.test/{유동적인> URL}
  * 이미지 전체 : 이미지 전체에 연결할 링크를 설정
  * 이미지 맵 설정 : 이미지 안에 여러개의 링크를 설정 (최대 5개)
  * 딥 링크 : 클릭 시 앱 내의 특정 화면으로 연결, Android, iOS 두 OS 유형의 링크 값을 Scheme://Path 형태로 200자 이내로 입력 (딥 링크는 접속 유형 : 모바일에서만 설정할 수 있습니다.)

{% hint style="info" %}
URL 주소에 오타나 잘못된 형식이 없는지 꼭! 확인해 주세요. 정확한 정보 입력이 필요합니다.
{% endhint %}

* 클릭 동작
  * 현재 창으로작 열기 : 방문자가 메시지를 클릭 시 새로운 tab이나, 창 이동 없이 페이지 이동
  * 새 창으로 열기 > 메시지 유지 (체크 해제) : 방문자가 메시지를 클릭 시 메시지를 유지 하지 않고 (닫히고) 새 창으로 페이지 이동
  * 새 창으로 열기 > 메시지 유지 (체크 시) : 방문자가 메시지를 클릭 시 메시지를 유지 하고 새 창으로 페이지 이동

#### ⚠️ 이미지 맵 설정 유의 사항

<img src="/files/SjJWaOublDYejXMo10Gt" alt="" width="375">

* 이미지 맵 설정 후 팝업 사이즈를 조정하시면 클릭 영역 재설정이 필요합니다.
  * 설정 시 클릭 영역 재설정 필요 항목 : 이미지 가로 사이즈, 타이틀, 내용, 버튼, 다시 보지 않기
* 모바일 환경에서는 이미지 맵 설정 사항은 확인 가능하며, 클릭 영역 조정은 PC 환경에서 가능합니다.<br>

#### **타이틀/내용**

{% columns %}
{% column %}
![](/files/tPc3hesFsl39V6flKizf)
{% endcolumn %}

{% column %}
![](/files/SoqR76F9BPm135BnttvX)
{% endcolumn %}
{% endcolumns %}

* 텍스트 : 타이틀은 한글 공백 포함 최대 40자, 내용(본문)은 한글 40자 까지 입력 가능
* 글꼴 : 텍스트의 글꼴을 지정
* 굵은 글씨 : 텍스트의 굵게(Bold)를 지정
* 글자색 : 텍스트의 글자색을 지정
* 정렬 : 텍스트의 정렬을 왼쪽, 가운데, 오른쪽을 지정

#### 버튼

<img src="/files/x6OUm7SIZZQLVZxonZpr" alt="" width="375">

* 텍스트 : 버튼 안에 표기될 텍스트 한글 공백 포함 최대 10자 입력 가능
* 글꼴 : 텍스트의 글꼴을 지정
* 굵은 글씨 : 텍스트의 굵게(Bold)를 지정
* 글자색 : 텍스트의 글자색을 지정
* 배경색 : 버튼 색상을 지정
* 정렬 : 버튼 내에서의 텍스트의 정렬을 왼쪽, 가운데, 오른쪽을 지정
* URL 입력 : 버튼에 연결할 링크를 설정
* 클릭 동작
  * 현재 창으로작 열기 : 방문자가 메시지를 클릭 시 새로운 tab이나, 창 이동 없이 페이지 이동
  * 새 창으로 열기 > 메시지 유지 (체크 해제) : 방문자가 메시지를 클릭 시 메시지를 유지 하지 않고 (닫히고) 새 창으로 페이지 이동
  * 새 창으로 열기 > 메시지 유지 (체크 시) : 방문자가 메시지를 클릭 시 메시지를 유지 하고 새 창으로 페이지 이동

#### **닫기 > 아이콘**

{% columns %}
{% column %}
![](/files/6IqULymURORIjPZSI7RW)
{% endcolumn %}

{% column %}
![](/files/Ps3z8m5o6h5uMWbMIW61)
{% endcolumn %}
{% endcolumns %}

* \[스타일 선택] 버튼 클릭 시 아이콘 스타일 선택 가능
* 아이콘 중에 하나를 선택한 후 \[완료] 버튼을 클릭하면 캠페인에 적용
* 닫기 아이콘 클릭은 캠페인 클릭 전환에 포함되지 않음
* 닫기 아이콘과 다시 보지 않기 둘 중 하나는 반드시 선택해야 합니다.

#### 다시 보지 않기

<img src="/files/NOycgXOIXTrNm3tpyNNl" alt="" width="375">

* 기간 설정 : 1일 \~ 7일까지 지정 가능
  * N일간 보지 않기 : 방문자가 클릭한 시점의 당일부터 N일 자정까지 노출
  * 기간 없이 설정 : 방문자가 클릭한 시점의 당일부터 노출
* 배경 : 다시 보지 않기 영역의 색상 지정
* 위치 : 메시지에서 다시 보지 않기 표기 위치 지정

#### **모양 설정 > 스타일/둥근모서리/애니메이션**

{% columns %}
{% column %}

![](/files/kA552NfCqJE0OvxlwMjS)
{% endcolumn %}

{% column %}

![](/files/Otr1QzrVsXivSoJ6OoR1)
{% endcolumn %}
{% endcolumns %}

* 스타일
  * 딤 : 메시지 뒤의 배경을 어둡게하여 딤 처리
  * 그림자 : 메시지에 그림자 설정 (0 \~ 55 설정 가능)
* 둥근 모서리 : 메시지 모서리를 둥글게 처리
* 애니메이션
* 없음 (default),나타내기, 닦아내기, 축소하기, 위쪽 슬라이드, 아래쪽 슬라이드, 왼쪽 슬라이드, 오른쪽 슬라이드

#### **노출 위치**

<img src="/files/Stiu1CLTd3APRIp7M9EU" alt="" width="375">

{% columns %}
{% column %}

<img src="/files/uqUdkYMBDudHinNCCADv" alt="" width="174">
{% endcolumn %}

{% column %}

![](/files/TL32905qnBWlRDic2wLI)
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
![](/files/uWcq2DpLQW0GevVucWMy)
{% endcolumn %}

{% column %}
![](/files/hOGzkyUkBCThcbV3IFPc)
{% endcolumn %}
{% endcolumns %}

* 상세 노출
  * PC화면 설정의 중점으로 메시지의 노출 위치를 상,중,하별 왼쪽, 가운데, 오른쪽을 설정
* 상하 노출
  * 모바일 화면 설정의 중점으로 메시지의 노출 위치를 상, 하 구분하여 설정
  * 콘텐츠 밀기 : 메시지 노출 시 콘텐츠의 영역 차지 여부를 설정

### **A/B/N 테스트 설정**

* 작성한 디자인 미리보기와 A/B/N 테스트 방식을 선택하고 디자인 노출 비율을 정할 수 있습니다. 테스트 방식은 AI 자동화, 수동 설정 두 가지입니다.

#### **1) AI 자동화**

* AI가 디자인 안들의 성과를 실시간으로 체크하여 타겟 고객에게 성과가 좋은 최적의 디자인 안이 보여지도록 노출 비율을 최적화하는 기능입니다.
* AI 자동화 진행 중에는 각 디자인 안에 대한 노출 비율이 실시간으로 자동 조정됩니다.
* 테스트 진행 시 비노출은 필수로 포함되게 됩니다. (A안만 작성한 경우, A안과 비노출로 자동화가 진행됩니다.)

{% hint style="warning" %}
비노출이란 성과 비교를 위한 테스트 대조군(Control Group)으로서 타겟 고객에게 메시지를 노출하지 않는 경우를 말합니다.
{% endhint %}

* 목표
  * AI가 최적의 안을 판단하는 기준입니다.
  * 설정 가능한 항목은 다음과 같습니다.
    * 회원가입
      * 회원가입을 전환 목표로 놓고 디자인 안들의 성과 비교를 합니다. 설정 화면에서 등록한 회원가입 페이지 URL 방문 시 전환으로 카운트합니다.
      * 회원가입 URL 이 등록되지 않았을 때는 선택 불가능합니다.
    * 주문
      * 주문을 전환 목표로 놓고 디자인 안들의 성과 비교를 합니다. 모든 상품 기준으로 상품 수량, 종류와 관계없이 주문 한 건 당 주문 수 1로 카운트합니다.

#### **2) 수동 설정**

* 디자인 안들의 노출 비율을 직접 설정합니다.
* 노출 비율을 설정할 때, 비노출 비율을 포함한 전체 노출 비율의 합은 총 100%가 되어야 합니다.

***

## **3단계 : 옵션 설정**

캠페인 노출 방식에 대한 설정을 할 수 있습니다.

### **트리거 조건** <a href="#trigger" id="trigger"></a>

타겟팅 된 고객을 대상으로 캠페인을 노출하거나 비노출하는 조건을 설정합니다. 고객이 사이트 내에서 특정 페이지를 방문/이탈하거나 특정 버튼을 클릭했을 때, 혹은 웹 페이지에서 일정을 스크롤 한 이후에 캠페인을 노출하거나 비노출 할 수 있습니다.

트리거 조건 사용 여부에 따른 온사이트 캠페인 노출 방식은 다음과 같습니다.

* 트리거 조건 미사용 시, 세그먼트 조건만 충족되면 캠페인 노출- 이 때 우선순위가 가장 높은 캠페인이 먼저 노출됩니다.&#x20;
  * 우선순위 노출 기준: 1. 우선 노출 설정한 캠페인 2. 가장 최근 수정한 캠페인
* 트리거 조건 사용 시, 세그먼트 조건과 트리거 조건 모두 충족 시 노출- 노출 페이지 URL을 제외한 트리거 조건의 경우 우선순위와 관계 없이, 조건에 해당하면 노출되기 때문에 중복 노출을 원하지 않는다면 캠페인 간 노출 조건이 겹치지 않도록 유의해 주세요.
* 트리거 조건을 2개 이상 사용 시, 모든 트리거 조건 충족해야 노출- 트리거 조건을 여러 개 사용하는 경우 방문자가 모든 조건을 충족해야 캠페인을 노출합니다 (조건 간 and로 동작)- 예를 들어 체류시간과 페이지 이탈 시를 함께 트리거 조건으로 설정하면 방문자가 특정 페이지에서 일정시간 체류 한 뒤 이탈하려고 할 때 캠페인을 노출합니다.

#### **ⓐ 노출 페이지**

* 타겟팅 된 고객이 특정 페이지에 방문했을 때 캠페인을 노출합니다.
* 입력한 URL 조건에 해당하는 페이지에 설정한 세그먼트 조건에 해당하는 방문자가 진입했을 때 캠페인을 노출합니다.
* 체류시간과 스크롤 설정으로 페이지 진입 이후의 캠페인 노출 타이밍을 상세하게 조정할 수 있습니다. 입력한 시간만큼 머물렀을 때, 또는 입력한 수치만큼 전체 페이지 스크롤을 내렸을 때 캠페인을 노출합니다.
  * 스크롤의 %는 스크롤의 위치로 계산합니다.

{% hint style="info" %}
새로운 캠페인 만들기 1단계 세그먼트 설정에서 현재 시점 변수로 '방문 페이지 URL' 변수를 단독으로 사용하고 옵션값(페이지 뷰, 체류시간)을 설정하지 않았다면, 트리거 조건의 '노출 페이지'는 동일한 기능이므로 설정하지 않아도 됩니다.

그러나 '방문 페이지 URL' 변수와 다른 변수를 AND 조건으로 함께 설정한 경우에 트리거 조건의 '노출 페이지'를 설정하면,고객이 해당 '방문 페이지'를 방문하고 기타 다른 세그먼트 타겟팅 조건을 만족했어도 캠페인이 노출되지 않고, 해당 '노출 페이지'에 도달해야 캠페인이 노출됩니다.
{% endhint %}

#### **ⓑ 노출 제외 페이지**

* 타겟팅 된 고객이 특정 페이지에 머무를 때 캠페인을 노출하지 않습니다.

**ⓒ 페이지 이탈 시**

* 타겟팅 된 고객이 사이트를 떠날 때를 감지하여 캠페인을 노출합니다.
* 페이지 이탈을 감지하는 기준은 다음과 같습니다.
  * PC/웹
    * 방문자가 브라우저 우측 상단의 \[X]버튼 쪽으로 커서를 이동하는 경우\
      (커서가 브라우저 내 콘텐츠 영역의 우측 상단 부분을 벗어나는 것을 감지)
    * 방문자가 브라우저 우측 상단의 \[X]버튼을 클릭한 후\
      → '사이트에서 나가시겠습니까?' 경고 알림창에서 취소 버튼을 클릭한 경우
    * 방문자가 브라우저 탭의 \[X]버튼을 클릭한 후\
      → '사이트에서 나가시겠습니까?' 경고 알림창에서 취소 버튼을 클릭한 경우
  * 모바일 : 방문자가 사이트 탐색 중 뒤로가기 버튼을 누른 경우
  * 안드로이드 기기에서 크롬 브라우저를 사용하는 경우 페이지 이탈 옵션이 동작하지 않습니다.

#### **ⓓ 클릭 시**

* 타겟팅 된 고객이 웹사이트 내 특정 요소를 클릭했을 때 캠페인을 노출합니다.
* 해당 트리거 조건을 사용하기 위해서는 웹페이지 내 요소의 ID 값이 필요합니다.
* 버튼 ID 확인하는 법

1. 브라우저에서 키보드의 \[F12] 키를 눌러 개발자 도구 오픈 (예시 화면은 크롬 기준입니다.)
2. 개발자 도구에서 \[요소 선택] 버튼 클릭
3. 트리거를 적용하기 원하는 요소 클릭 (요소를 클릭하면 캠페인 메시지가 노출 됩니다.)
4. 개발자 도구에서 하이라이트 된 HTML 코드 확인
   1. 이 경우 버튼ID = keyword 입니다.
   2. 하이라이트 된 요소의 상위 코드에 id가 있는 경우도 있습니다.
   3. id가 없는 요소도 있을 수 있습니다. (이 경우 id지정 전까지는 button id 기능을 사용할 수 없습니다.)
5. 트리거 조건 > 클릭 시 버 id 입력란에 확인한 id값 입력합니다.

{% hint style="warning" %}
주의 사항 : 웹 페이지 개발 시 동일한 id를 여러 요소에 사용한 경우, 해당 id를 가진 모든 버튼에 트리거가 지정 되어 클릭 시 메시지가 노출 됩니다.
{% endhint %}

#### **ⓔ 커스텀 이벤트**

커스텀 이벤트가 발생하여 지정한 조건을 만족했을 때 캠페인을 노출합니다.

* 설정 화면에서 이벤트를 생성한 후 그루비로 관련 데이터를 보내면 커스텀 이벤트를 사용할 수 있습니다. 커스텀 이벤트 생성과 데이터 연동에 대한 자세한 내용은 아래 가이드를 참고하세요.\
  커스텀 이벤트 생성 방법: [설정 > 커스텀 이벤트](http://doc.groobee.io/article/6o2dya5jxv-)
* 이벤트를 선택한 후 상세 조건을 입력하면, 이벤트 발생 후 지정한 조건을 만족했을 때 캠페인이 노출됩니다.

### **스케줄**

**노출 기간**

* '수동 종료 전까지'를 선택하면 추천 생성 시점부터 수동으로 추천을 종료할 때까지 테스트가 진행됩니다.
* 캠페인을 특정 기간동안에만 노출하려고 한다면 '기간 지정'을 선택해 시작일과 종료일을 입력해주세요.

{% hint style="warning" %}
노출 시간 설정 시 종료시간이 시작시간보다 작거나 같은 경우, 다음날까지의 시간으로 적용됩니다.예를 들어 노출 시간을 20시\~02시로 설정한 경우, 저녁 8시부터 다음날 새벽 2시까지 캠페인이 노출됩니다. 10시\~10시로 설정했다면 오전 10시부터 다음날 오전 10시까지 24시간 동안 캠페인이 노출되니 참고해 주세요.
{% endhint %}

* 캠페인을 반복해서 노출하고 싶을 경우 '반복'을 선택해주세요. 일별, 주별, 월별 반복 설정이 가능합니다.
  * 일별 반복 : 노출 기간동안 캠페인을 반복할 일 간격을 설정할 수 있습니다.
  * 주별 반복 : 노출 기간동안 캠페인을 반복할 주 간격과 해당 주에 반복할 특정 요일을 설정할 수 있습니다.
  * 월별 반복 : 노출 기간동안 캠페인을 반복할 월 간격과 해당 월에 반복할 특정 날짜(일) 또는 요일을 설정할 수 있습니다.
    * 특정 날짜(일)을 설정\
      예) 노출 기간 "**2025.02.05 \~ 2026.02.05**", 반복 "**월별, 매 1개월 마다 1일**"로 설정한 경우\
      ▶ 2025.03.01 / 2025.04.01 / . . . / 2026.01.01 / 2026.02.01 에 캠페인 노출
    * 특정 요일 설정\
      예) 노출 기간 "**2025.02.05 \~ 2026.02.05**", 반복 "**월별, 매 1개월마다 첫번째 월요일**"로 설정한 경우\
      ▶ 2024.03. 첫번째 월요일 / 2024.04. 첫번째 월요일 / . . . / 2025.01.첫번째 월요일에 캠페인 노출

### **노출 옵션**

#### **ⓐ 노출 빈도**

타겟팅 된 방문자에게 얼마나 자주 캠페인을 노출할지 설정할 수 있습니다.

* 설정 가능한 항목은 다음과 같습니다.
  * 1 번 : 설정한 기간내에서 한 번 노출합니다.
  * 매월 1 번 : 설정한 기간내에서 매월 한 번 노출합니다. 월의 기준은 1일부터 말일까지입니다.
  * 매주 1 번 : 설정한 기간내에서 매주 한 번 노출합니다. 주의 기준은 일요일부터 토요일까지입니다.
  * 매일 1 번 : 설정한 기간 내에서 매일 한 번 노출합니다. 하루의 기준은 00시부터 24시까지입니다.
  * 방문 세션마다 : 설정한 기간 내에서 세션 당 한 번 씩 노출합니다.
  * 그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다.
  * 방문 페이지마다: 타겟팅 조건을 만족한 방문자의 방문 페이지마다 캠페인이 반복 노출되며, 캠페인 클릭 발생 시 노출을 멈춥니다.
  * 새로운 세션(재방문)에서도 클릭 발생 전까지 매 페이지마다 반복 노출됩니다. 캠페인 피로도를 높일 수 있으므로 사용 시 유의해 주세요
  * 기타 : 기간과 횟수를 직접 지정합니다.

#### **ⓑ 노출 수**

* 캠페인 노출 횟수를 제한하는 옵션입니다.
* 입력한 값만큼 캠페인이 노출되면 타겟팅 조건을 만족해도 캠페인을 더 이상 노출하지 않습니다.
* 제한된 수량의 쿠폰을 발행하려는 경우 노출 수 옵션을 활용할 수 있습니다.
* 최대 노출 설정 시 횟수 제한없이 캠페인을 노출할 수 있습니다.

#### **ⓒ 우선 노출**

* 중요도가 높은 특정 캠페인이 우선 노출되도록 설정할 수 있습니다.
* 사용자가 복수의 캠페인 세그먼트 조건을 충족하면 우선순위가 가장 높은 캠페인이 먼저 노출됩니다.
* 우선순위 노출 기준
  * 온사이트 캠페인은 기본적으로 페이지 당 우선순위가 높은 1개의 캠페인만 노출되며, 그 다음의 우선순위 캠페인의 경우 사용자가 다른 페이지로 이동하거나 페이지를 새로고침(F5) 했을 때 노출됩니다.
  * 우선 노출이 여러개의 캠페인에 적용 됐을 경우 적용된 캠페인 중에서 최근 수정한 캠페인이 우선 노출됩니다.
  * 노출 순서 : 우선 노출 적용한 캠페인 → 가장 최근 수정한 캠페인
* 예를 들어 사용자가 장바구니 페이지에 도달했을 때 캠페인 A, 캠페인 B의 세그먼트 조건을 모두 충족한 경우 캠페인 A가 우선순위가 높다면, 장바구니 페이지에서는 캠페인 A만 노출되며 캠페인 B는 사용자가 다른 페이지로 이동하거나 페이지를 새로고침(F5) 했을 때 노출됩니다.

{% hint style="warning" %}
온사이트 캠페인은 기본적으로 페이지 당 우선순위가 높은 1개의 캠페인만 노출되며, 그 다음의 우선순위 캠페인의 경우 사용자가 다른 페이지로 이동하거나 페이지를 새로고침(F5) 했을 때 노출됩니다.\
단, 트리거 조건을 사용하면 우선순위와 관계없이 조건에 해당하면 노출되기 때문에 한 페이지 안에서 중복 노출될 수 있습니다. 중복 노출을 원하지 않는다면 캠페인 간 노출 조건이 겹치지 않도록 유의해 주세요)
{% endhint %}

### **캠페인 목표 설정** <a href="#campaign-goal" id="campaign-goal"></a>

* 사용자가 캠페인 진행 시 특정 상품 또는 특정 카테고리의 전환을 확인하기 위해 목표를 설정할 수 있습니다.
* 캠페인 목표 설정 시 분석 리포트에서 확인할 수 있습니다.
* 텍스트 입력 : 항목이 많지 않을 경우 텍스트 입력을 통해 목표를 입력
* 직접 업로드 : 템플릿을 다운 받아 일괄 입력하여 업로드

#### **ⓐ 직접 업로드 템플릿**

* ‘상품 코드 템플릿'을 다운로드해 예시를 지워주신 후 입력해 주세요.
* 최대 2,000건까지 입력 가능합니다.

#### **ⓑ 파일 업로드**

* 파일 업로드 후 업로드 성공 개수를 확인할 수 있습니다.
* 파일 업로드 시 동일한 값일 경우 중복처리 되어 하나만 업로드 됩니다.
* 업로드한 원본 파일은 다시 다운받아 확인할 수 있습니다.

{% hint style="danger" %}
캠페인에 설정된 목표는 **캠페인이 실행되면 수정할 수 없습니다.**
{% endhint %}


# ㅤ온사이트 캠페인 만들기 : 다이내믹 URL

다이내믹 URL은 특정 웹페이지(URL)에 도달한 타겟 고객을 별도 준비한 웹페이지로 유도(리다이렉션)합니다.

## 1단계 : 기본 설정

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

## 2단계: 메시지 설정&#x20;

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

## 3단계 : 옵션 설정

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


# ㅤ온사이트 캠페인 만들기 : 인앱 메시지

## **1단계 : 기본 설정**

<figure><img src="/files/87RtUoDxpa20QLm4cRGN" alt=""><figcaption></figcaption></figure>

인앱메시지 캠페인은 네이티브 앱을 이용 중인 고객이 타겟팅 된 순간 실시간으로 메시지를 노출합니다.

1. 캠페인명: 캠페인 생성을 위한 작성 필수 항목입니다. 한글 공백 포함 최대 40자로 작성해주세요.
2. 상세설명: 캠페인명으로 표시하기 부족한 부분을 상세하게 작성할 수 있습니다. 한글 공백 포함 최대 400자로 작성해주세요.
3. 태그: 태그를 지정하면 캠페인 관리 메뉴에서 태그 필터 기능으로 생성한 캠페인을 분류하여 관리할 수 있습니다.
4. 플랫폼: 생성할 캠페인의 환경을 표시합니다.
   1. Web/Hybrid : 기존에 그루비가 제공하던 PC/Web, 모바일웹/웹앱/하이브리드앱 플랫폼의 캠페인을 만들 수 있습니다.
   2. Native : 네이티브앱 전용 인앱 메시지 캠페인을 만들 수 있습니다.

{% hint style="warning" %}
플랫폼 변경을 원하시는 경우 캠페인 관리로 돌아간 후 생성할 캠페인을 다시 선택해 주세요.
{% endhint %}

5. 세그먼트 설정
   1. 캠페인 생성을 위한 필수 항목입니다.
   2. 세그먼트는 캠페인 1개 당 1개씩만 지정할 수 있습니다.
   3. 캠페인 생성 전 타겟팅을 위한 세그먼트를 먼저 생성해주세요.
   4. 설정한 세그먼트에 해당되지 않는 방문자에게는 캠페인이 노출되지 않습니다.

## 2단계 : 메시지 설정

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

### **1. 메시지 설정** <a href="#id-1" id="id-1"></a>

디자인 안 선택: A/B/N 테스트를 위한 디자인 안들을 추가/삭제/수정할 수 있습니다.

1. 디자인 안 추가
   1. 클릭 시 디자인 안을 추가합니다.
   2. 디자인 안은 최대 10개까지 추가 가능합니다. 디자인 안마다 각각 다른 메시지 유형을 선택할 수 있습니다.
2. 디자인 안 수정/삭제
   1. 클릭 시 메뉴가 노출됩니다.
      1. 수정하기: 선택한 디자인 안의 수정 화면으로 이동합니다.
      2. 삭제하기: 선택한 디자인 안을 삭제합니다.
3. 메시지 유형

* 1\) 팝업: 모바일 화면 중앙에 이미지 형태의 팝업을 노출합니다. 팝업 뒤의 배경은 딤 처리 됩니다.
* 2\) 스티키 배너 기본형: 모바일 화면 상단 또는 하단에 띠 형태의 배너를 노출합니다. 배너 뒤의 배경은 딤 처리되지 않습니다.
* 3\) 스티키 배너 버튼형: 모바일 화면 상단 또는 하단에 버튼과 이미지를 포함한 형태의 배너를 노출합니다. 배너 뒤의 배경은 딤 처리되지 않습니다.

3. 메시지 디자인: 선택한 메시지 유형에 따라 콘텐츠를 작성할 수 있는 영역입니다.
4. A/B/N 테스트 설정: 작성한 디자인 안 들의 A/B/N 테스트 방식을 선택하고, 노출 비율을 정할 수 있습니다.

### 2. **유형별 메시지 작성**

#### 디자인 유형: 팝업

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

1. 이미지
   1. 캠페인 생성을 위한 작성 필수 항목입니다.
   2. 이미지 사이즈는 1080 \* 1080px을 권장합니다. (가로 1080px, 세로 1080\~1440px까지 업로드 가능합니다.)
   3. JPG, PNG 파일만 업로드 가능합니다.
2. 이미지 링크
   1. 팝업 이미지를 클릭했을 때 이동할 링크를 지정할 수 있습니다.
   2. URL을 입력하지 않아도 클릭 수는 집계됩니다.
   3. 유형: 일반, 딥 링크
   4. 사용자가 팝업 이미지를 클릭할 때 앱 내의 특정 화면으로 연결할 수 있습니다.
   5. Android, iOS 두 OS 유형의 링크 값을 Scheme://Path 형태로 200자 이내로 입력해 주세요.
3. 닫기 아이콘
   1. 클릭 시 닫기 아이콘 모양을 지정할 수 있습니다.
   2. 닫기 아이콘 클릭은 캠페인 클릭 전환에 포함되지 않습니다.
4. 둥근 모서리: On인 경우 팝업의 모서리를 둥글게 처리합니다.
5. 미리보기: 작성한 내용을 실시간으로 미리보기 할 수 있습니다.

#### 디자인 유형: 스티키 배너 기본형

<figure><img src="/files/9GAWd06kUoQmDGOaroSW" alt=""><figcaption></figcaption></figure>

1. 위치: 스티키 배너가 노출될 위치를 선택할 수 있습니다.
2. 텍스트
   1. 캠페인 생성을 위한 작성 필수 항목입니다.
   2. 한글 공백 포함 최대 20자까지 입력 가능합니다.
3. 링크
   1. 스티키 배너를 클릭했을 때 이동할 링크를 지정할 수 있습니다.
   2. URL을 입력하지 않아도 클릭 수는 집계됩니다.
   3. 유형: 일반, 딥 링크
   4. 사용자가 스티키 배너를 클릭할 때 웹 브라우저를 실행해 특정 페이지로 이동시킬 수 있습니다.
   5. 이미지 링크는 http\:// 또는 <https://를> 포함하여 입력해 주세요.
4. 배경색: 스티키 배너의 배색을 지정할 수 있습니다.
5. 닫기 아이콘
   1. 클릭 시 닫기 아이콘 모양을 지정할 수 있습니다.
   2. 닫기 아이콘 클릭은 캠페인 클릭 전에 포함되지 않습니다.
6. 둥근 모서리: On인 경우 스티키 배의 모서리를 둥글게 처리합니다.
7. 미리보기: 작성한 내용을 실시간으로 미리보기 할 수 있습니다.

#### 디자인 유형: 스티키 배너 버튼형

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

1. 위치: 스티키 배너가 노출될 위치를 선택할 수 있습니다.
2. 이미지

   1. 캠페인 생성을 위한 작성 필수 항목입니다.
   2. 이미지 사이즈는 360 \* 360px만 업로드 가능합니다.
   3. JPG, PNG 파일만 업로드 가능합니다.
   4. 타이틀
      1. 캠페인 생성을 위한 작성 필수 항목입니다.
      2. 한글 공백 포함 최대 16자까지 입력 가능합니다.
   5. 텍스트
      1. 캠페인 생성을 위한 작성 필수 항목입니다.
      2. 한글 공백 포함 최대 40자까지 입력 가능합니다.
   6. 버튼
      1. 캠페인 생성을 위한 작성 필수 항목입니다.
      2. 버튼명은 한글 공백 포함 최대 15자까지 입력 가능합니다.
   7. 버튼 링크
      1. 캠페인 생성을 위한 작성 필수 항목입니다.
      2. 버튼을 클릭했을 때 이동할 링크를 지정할 수 있습니다.
      3. 유형: 일반, 딥 링크
   8. 사용자가 버튼을 클릭할 때 앱 내의 특정 화면으로 연결할 수 있습니다.
   9. Android, iOS 두 OS 유형의 링크 값을 Scheme://Path 형태로 200자 이내로 입력해 주세요.
   10. 닫기 아이콘
       1. 클릭 시 닫기 아이콘 모양을 지정할 수 있습니다.
       2. 닫기 아이콘 클릭은 캠페인 클릭 전에 포함되지 않습니다.
   11. 둥근 모서리: On인 경우 스티키 배너, 이미지, 버튼의 모서리를 둥글게 처리합니다.
   12. 미리보기: 작성한 내용을 실시간으로 미리보기 할 수 있습니다.

{% hint style="warning" %}
스티키 배너와 상태바 또는 내비게이션바 사이의 간격 수정을 원하실 경우, 그루비팀에 문의해 주세요. (☎ 02-554-5854 ✉ <groobee_sales@plateer.com>)
{% endhint %}

### **3. A/B/N 테스트 설정**

작성한 디자인 안들의 A/B/N 테스트 방식을 선택하고, 노출 비율을 정할 수 있습니다.

* 캠페인 생성을 위한 작성 필수 항목입니다.
* 테스트 방식은 AI 자동화, 수동 설정 두 가지입니다.

{% hint style="info" %}
비노출이란 성과 비교를 위한 테스트 대조군(Control Group)으로서 타겟 고객에게 메시지를 노출하지 않는 경우를 말합니다.
{% endhint %}

**수동 설정**

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

* 디자인 안들의 노출 비율을 직접 설정합니다.
* 노출 비율을 설정할 때, 비노출 비율을 포함한 전체 노출 비율의 합은 총 100%가 되어야 합니다.

**AI 자동화**

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

* AI가 디자인 안들의 성과를 실시간으로 체크하여 타겟 고객에게 성과가 좋은 최적의 디자인 안이 보여지도록 노출 비율을 최적화하는 기능입니다.

{% hint style="warning" %}
A/B/N 테스트 방식을 'AI 자동화'로 선택하고 노출 이력이 있으면 캠페인 수정이 불가능합니다.\
이외의 경우에는 '접속 유형', '메시지 유형'을 제외한 항목 수정이 가능합니다.
{% endhint %}

* AI 자동화 진행 중에는 각 디자인 안에 대한 노출 비율이 실시간으로 자동 조정됩니다.
* 테스트 진행 시 비노출은 필수로 포함되게 됩니다. (A안만 작성한 경우, A안과 비노출로 자동화가 진행됩니다.)
* 목표
  * AI가 최적의 안을 판단하는 기준입니다.
  * 설정 가능한 항목은 다음과 같습니다.\
    (1) 회원가입

    * 회원가입을 전환 목표로 놓고 디자인 안들의 성과 비교를 합니다. 설정 화면에서 등록한 회원가입 페이지 URL 방문 시 전환으로 카운트합니다.
    * 회원가입 URL이 등록되지 않았을 때는 선택 불가능합니다.

    (2) 주문

    * 주문을 전환 목표로 놓고 디자인 안들의 성과 비교를 합니다. 모든 상품 기준으로 상품 수량, 종류와 관계없이 주문 한 건 당 주문 수 1로 카운트합니다.

## 3단계 : 옵션 설정

<figure><img src="/files/0drqPyp5TvAw74RWD7lI" alt=""><figcaption></figcaption></figure>

### **1. 트리거 조건** <a href="#trigger" id="trigger"></a>

타겟팅 된 고객을 대상으로 캠페인을 노출하거나 비노출하는 조건을 설정합니다.

**1) 노출 페이지**

* 타겟팅 된 고객이 특정 화면에 방문했을 때 캠페인을 노출합니다.
* 입력한 조건에 해당하는 화면에 설정한 세그먼트 조건에 해당하는 방문자가 진입했을 때 캠페인을 노출합니다.

{% hint style="info" %}
새로운 캠페인 만들기 1단계 세그먼트 설정에서 현재 시점 변수로 '방문 페이지 ID' 변수를 단독으로 사용하고 옵션값(페이지 뷰)을 설정하지 않았다면, 트리거 조건의 '노출 페이지'는 동일한 기능이므로 설정하지 않아도 됩니다.\
그러나 '방문 페이지 ID' 변수와 다른 변수를 AND 조건으로 함께 설정한 경우에 트리거 조건의 '노출 페이지'를 설정하면,\
고객이 해당 '방문 페이지'를 방문하고 기타 다른 세그먼트 타겟팅 조건을 만족했어도 캠페인이 노출되지 않고,\
해당 '노출 페이지'에 도달해야 캠페인이 노출됩니다.
{% endhint %}

**상세 설명**

'방문 페이지 ID' 변수와 타 변수 AND 조합으로 설정한 경우 (타 변수 또한 '방문 페이지 ID'인 경우 포함)

* 세그머트 타겟팅 조건

<figure><img src="/files/9s8dGov8TQbp9nGi4Eko" alt="" width="563"><figcaption></figcaption></figure>

* 트리거 조건 미설정 시

<figure><img src="/files/zU9K4MqQcQXroTrAJOVk" alt="" width="563"><figcaption></figcaption></figure>

* 트리거 조건 설정 시 (노출 페이지: PAGE2 방문)

<figure><img src="/files/SNWN3Pq2EFhjYa5BNFV7" alt="" width="563"><figcaption></figcaption></figure>

**2) 노출 제외 페이지:** 타겟팅 된 고객이 특정 화면에 머무를 때 캠페인을 노출하지 않습니다.

### **2. 스케줄** <a href="#id-2" id="id-2"></a>

**1) 노출 기간**

* '수동 종료 전까지'를 선택하면 추천 생성 시점부터 수동으로 추천을 종료할 때까지 테스트가 진행됩니다.
* 캠페인을 특정 기간동안에만 노출하려고 한다면 '기간 지정'을 선택해 시작일과 종료일을 입력해주세요.
* 캠페인을 반복해서 노출하고 싶을 경우 '반복'을 선택해주세요. 일별, 주별, 월별 반복 설정이 가능합니다.

{% hint style="warning" %}
노출 시간 설정 시 종료시간이 시작시간보다 작거나 같은 경우, 다음날까지의 시간으로 적용됩니다.\
예를 들어 노출 시간을 20시02시로 설정한 경우, 저녁 8시부터 다음날 새벽 2시까지 캠페인이 노출됩니다. 10시10시로 설정했다면 오전 10시부터 다음날 오전 10시까지 24시간 동안 캠페인이 노출되니 참고해 주세요.
{% endhint %}

(1) 일별 반복\
노출 기간동안 캠페인을 반복할 일 간격을 설정할 수 있습니다.

(2) 주별 반복\
노출 기간동안 캠페인을 반복할 주 간격과 해당 주에 반복할 특정 요일을 설정할 수 있습니다.

(3) 월별 반복 노출 기간동안 캠페인을 반복할 월 간격과 해당 월에 반복할 특정 날짜(일) 또는 요일을 설정할 수 있습니다.

* 특정 날짜(일) 설정 예) 노출 기간 "**2020.02.05 \~ 2021.02.05**", 반복 "**월별, 매 1개월마다 1일**"로 설정한 경우
* ▶ 2020.03.01 / 2020.04.01 / . . . / 2021.01.01 / 2021.02.01 에 캠페인 노출
* 특정 요일 설정 예) 노출 기간 "**2020.02.05 \~ 2021.02.05**", 반복 "**월별, 매 1개월마다 첫번째 월요일**"로 설정한 경우
* ▶ 2020.03. 첫번째 월요일 / 2020.04. 첫번째 월요일 / . . . / 2021.01.첫번째 월요일에 캠페인 노출

### **3. 노출 옵션** <a href="#id-3" id="id-3"></a>

1\) 노출 빈도

* 타겟팅 된 방문자에게 얼마나 자주 캠페인을 노출할지 설정할 수 있습니다.
* 설정 가능한 항목은 다음과 같습니다.
  * 1 번 : 설정한 기간 내에서 한 번 노출합니다.
  * 매월 1 번 : 설정한 기간 내에서 매월 한 번 노출합니다.
  * 매주 1 번 : 설정한 기간 내에서 매주 한 번 노출합니다.
  * 매일 1 번 : 설정한 기간 내에서 매일 한 번 노출합니다.
  * 방문 세션마다 : 설정한 기간 내에서 세션 당 한 번씩 노출합니다.
  * 방문 페이지마다: 타겟팅 조건을 만족한 방문자의 방문 페이지마다 캠페인이 반복 노출되며, 캠페인 클릭 발생 시 노출을 멈춥니다. 새로운 세션(재방문)에서도 클릭 발생 전까지 매 페이지마다 반복 노출됩니다. 캠페인 피로도를 높일 수 있으므로 사용 시 유의해 주세요.
  * 기타 : 기간과 횟수를 직접 지정합니다.

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속상황의 단위를 세션이라고 합니다.

방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다.
{% endhint %}

2\) 노출 수

* 캠페인 노출 횟수를 제한하는 옵션입니다. 입력한 값만큼 캠페인이 노출되면 타겟팅 조건을 만족해도 캠페인을 더 이상 노출하지 않습니다.
* 제한된 수량의 쿠폰을 발행하려는 경우 노출 수 옵션을 활용할 수 있습니다.
* 최대 노출 설정 시 횟수 제한없이 캠페인을 노출할 수 있습니다.

3\) 우선 노출

* 중요도가 높은 특정 캠페인이 우선 노출되도록 설정할 수 있습니다.
* 사용자가 복수의 캠페인 세그먼트 조건을 만족했을 때 우선순위가 가장 높은 캠페인이 먼저 노출됩니다.
  * 우선순위 노출 기준: 1. 우선 노출 적용한 캠페인 -> 2. 가장 최근 수정한 캠페인 (우선 노출이 여러개의 캠페인에 적용 됐을 경우 적용된 캠페인 중에서 최근 수정한 캠페인이 우선 노출됩니다)

{% hint style="warning" %}
인앱 메시지 캠페인은 기본적으로 페이지 당 우선순위가 높은 1개의 캠페인만 노출되며,\
우선순위가 낮은 캠페인의 경우 사용자가 다른 페이지로 이동했을 때 노출됩니다.\
예를 들어 사용자가 장바구니 페이지에 도달했을 때 캠페인 A, 캠페인 B의 세그먼트 조건을 모두 충족한 경우\
캠페인 A가 우선순위가 높다면, 장바구니 페이지에서는 캠페인 A만 노출되며\
캠페인 B는 사용자가 다른 페이지로 이동했을 때 노출됩니다.\
(트리거 조건 사용 여부와 관계없이 우선순위에 따라 페이지당 최대 1개의 캠페인이 노출됩니다)
{% endhint %}


# 온사이트 캠페인 메시지 디자인

## **메시지 디자인 > 요소**

누구나 팝업 / 슬라이드 인 이외 다양한 메시지를 빠르고 쉽게 만들 수 있습니다.

캠페인 메시지에 사용된 요소 설명입니다.

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/d0ijjhpkb9/1727669846374/image.png" alt=""><figcaption></figcaption></figure>

### **기존 어드민의 디자인 유형 설정 방법**

팝업 / 슬라이드인 / 모바일 플로팅 바 유형을 그대로 사용하실 수 있습니다. 각 유형에 맞는 설정 요소의 설정 사항을 참고해 주세요.

#### **기존 어드민 > 디자인 유형: 팝업**

<table><thead><tr><th valign="top">PC (신규 어드민 > 설정 요소)</th><th valign="top">MO (신규 어드민 > 설정 요소)</th></tr></thead><tbody><tr><td valign="top"><p></p><div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727671045362/image.png" alt=""><figcaption></figcaption></figure></div><p></p></td><td valign="top"><p></p><div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727671048055/image.png" alt="" width="188"><figcaption></figcaption></figure></div></td></tr><tr><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>권장 사이즈 : 정사각형 모양, 1:1 비율, 400 x 400 (px)</li><li>가로 사이즈 : 400 px</li></ul></li><li>노출 위치: 중앙</li></ul></td><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>권장 사이즈 : 정사각형 모양, 1:1 비율, 400 x 400 (px)</li><li>가로 사이즈 : 320 px</li></ul></li><li>노출 위치 : 중앙</li><li>딤 효과 : on</li><li>애니메이션 : 없음</li></ul></td></tr></tbody></table>

#### **기존 어드민 > 디자인 유형: 슬라이드 인**

<table><thead><tr><th valign="top">PC (신규 어드민 > 설정 요소)</th><th valign="top">MO (신규 어드민 > 설정 요소)</th></tr></thead><tbody><tr><td valign="top"><div><figure><img src="/files/PFPb9epegSIiVhkj9Zh4" alt=""><figcaption></figcaption></figure></div></td><td valign="top"><div><figure><img src="/files/rCfjEALIkAxzBWnSWg2y" alt="" width="188"><figcaption></figcaption></figure></div></td></tr><tr><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>권장 사이즈 : 직 사각형 모양, 약 1:3 비율, 300 x 400 (px)</li><li>가로 사이즈 : 300 px</li></ul></li><li>노출 위치 : 가운데</li><li>딤 효과 : off</li><li>애니메이션 : 없음 or 아래쪽 슬라이드</li></ul></td><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>권장 사이즈 : 직 사각형 모양, 약 1:3 비율, 300 x 400 (px)</li><li>가로 사이즈 : 300 px</li></ul></li><li>노출 위치 : 가운데</li><li>딤 효과 : off</li><li>애니메이션 : 없음</li></ul></td></tr></tbody></table>

#### **기존 어드민 > 디자인 유형: 플로팅 바(모바일)**

<table><thead><tr><th valign="top">PC (신규 어드민 > 설정 요소)</th><th valign="top">MO (신규 어드민 > 설정 요소)</th></tr></thead><tbody><tr><td valign="top"><div><figure><img src="/files/h7lSoANHPA0neKVE8z5o" alt=""><figcaption></figcaption></figure></div></td><td valign="top"><div><figure><img src="/files/zSI00uZ0j1iOu4Kgbete" alt="" width="188"><figcaption></figcaption></figure></div></td></tr><tr><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>권장 사이즈 : 세로 사이즈 70px</li><li>가로 사이즈 : 100%</li></ul></li><li>노출 위치 : 가운데</li><li>딤 효과 : on</li><li>애니메이션 : 없음</li></ul></td><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>권장 사이즈 : 세로 사이즈 70px</li><li>가로 사이즈 : 100%</li></ul></li><li>노출 위치 : 가운데 위</li><li>딤 효과 : off,on</li><li>애니메이션 : 없음</li></ul></td></tr></tbody></table>

#### **기존 어드민 > 디자인 유형: 바텀 시트**

<table><thead><tr><th valign="top">PC (신규 어드민 > 설정 요소)</th><th valign="top">MO (신규 어드민 > 설정 요소)</th></tr></thead><tbody><tr><td valign="top">-</td><td valign="top"><div><figure><img src="/files/JOx1Okq9Y0T92kGOVQG6" alt="" width="188"><figcaption></figcaption></figure></div></td></tr><tr><td valign="top"><ul><li>기존 플로팅 바를 활용하여 진행</li></ul></td><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>권장 사이즈 : -</li><li>가로 사이즈 : 100%</li></ul></li><li>노출 위치 : 가운데 아래</li><li>딤 효과 : off,on</li><li>애니메이션 : 없음</li></ul></td></tr></tbody></table>

\
**기존 어드민 > 디자인 유형: 풀 스크린**

<table><thead><tr><th valign="top">PC (신규 어드민 > 설정 요소)</th><th valign="top">MO (신규 어드민 > 설정 요소)</th></tr></thead><tbody><tr><td valign="top"><div><figure><img src="/files/jHrXxutqrcARGuVecASx" alt=""><figcaption></figcaption></figure></div></td><td valign="top"><div><figure><img src="/files/lQS33o2VDJqGEaTPApkQ" alt="" width="188"><figcaption></figcaption></figure></div></td></tr><tr><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>가로 사이즈 : 95%</li><li>노출 위치 : 가운데</li></ul></li><li>딤 효과 : on</li><li>애니메이션 : 없음</li></ul></td><td valign="top"><ul><li><p>업로드 이미지</p><ul><li>가로 사이즈 : 95%</li><li>노출 위치 : 가운데</li></ul></li><li>딤 효과 : on</li><li>애니메이션 : 없음</li></ul></td></tr></tbody></table>

***

## **메시지 디자인 종류**

* 신규 어드민에서는 이미지로만 이루어진 메시지나 문구를 활용한 메시지를 설정할 수 있습니다.

### **이미지로만 이루어진 메시지**

| <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727671110167/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727671116904/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727671126932/image.png" alt=""><figcaption></figcaption></figure></div> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

### **콘텐츠를 사용한 메시지**

<table><thead><tr><th align="center">이미지+타이틀+내용</th><th align="center">이미지+타이틀+버튼</th><th width="184.5703125" align="center">이미지+내용+버튼</th><th align="center">이미지+타이틀+내용+버튼</th></tr></thead><tbody><tr><td align="center"><p></p><div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727824721783/image.png" alt=""><figcaption></figcaption></figure></div></td><td align="center"><p></p><div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727824499931/image.png" alt=""><figcaption></figcaption></figure></div></td><td align="center"><p></p><div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727824507886/image.png" alt=""><figcaption></figcaption></figure></div></td><td align="center"><p></p><div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1727824516005/image.png" alt="" width="188"><figcaption></figcaption></figure></div></td></tr></tbody></table>


# 온사이트 캠페인 분석 리포트

온사이트 캠페인 분석 리포트에서는 기본 분석, 주문 분석, A/B/N 테스트 분석, 캠페인 목표 분석 탭으로 제공하여 성과를 확인할 수 있습니다.

## **분석 리포트 구성**

<img src="/files/EY8c9p6HTYkM15SSf5dW" alt="" width="563">

1. **기간 설정**

* 캠페인의 진행 기간을 참고하여 데이터 조회 기간을 입력해주세요.\
  요약 지표, 데이터 추이, 데이터 테이블에 공통적으로 적용되는 조회 기간입니다.

2. **캠페인 정보**

* 선택한 캠페인의 기본적인 정보입니다.
* 캠페인명 옆의 새 창으로 열기 아이콘 클릭 시 캠페인의 상세 정보가 새 창으로 열립니다.

3. **분석 종류 (기본 분석, 주문 상품 분석, A/B/N 테스트 분석, 주문 상품 분석, 캠페인 목표 분석)**

{% hint style="info" %}
캠페인 목표 분석은 설정 시 확인 가능
{% endhint %}

<img src="/files/cfhJVtyo3iAzPFr1KAkB" alt="" width="563">

4. **분석 지표**

* 각 종류별로 분석 지표가 보여집니다.

<img src="/files/K1OTHD5tk6s4IoXuSNSm" alt="" width="563">

캠페인 만들기에서 설정한 이미지 맵과 버튼 요소의 상세 클릭 요소를 확인할 수 있습니다.

***

## **기본 분석**

### **요약 지표**

<img src="/files/yyWTKeCMiG98L4OhYGtR" alt="" width="563">

* 설정된 조회 기간 내의 데이터 요약 지표입니다. 상세보기 클릭 시 각 항목의 상세 데이터를 확인할 수 있습니다.
  * 노출 수
  * 클릭 수
  * 주문 수
  * 전환 금액
  * 클릭 전환율
  * 회원가입 전환율
  * 주문 전환율

### **데이터 추이**

<img src="/files/wjVJoLZr1qOzwFAXvo5e" alt="" width="563">

* 분석 리포트 설정한 기간 내 데이터 테이블에 해당하는 데이터의 일별 추이 그래프입니다.
* 노출/클릭/주문 수 데이터 추이와 클릭/회원가입/주문 전환율 데이터 추이를 꺾은선, 막대 그래프 형태로 확인할 수 있습니다.
* 데이터 추이 그래프 상의 회원가입/주문 전환율은 캠페인 클릭이 아닌 노출 후 전환 기준으로 계산된 수치입니다.

### **데이터 테이블**

<img src="/files/4Rq2rB2H0GgCb297HBlV" alt="" width="563">

* 분석 리포트 설정한 기간 내 데이터를 일별로 확인할 수 있습니다.
* 데이터 항목은 다음과 같습니다.

<table><thead><tr><th width="201.703125">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td>노출 수</td><td>세션 내 캠페인이 노출된 횟수입니다. 캠페인이 노출되는 수로 카운팅 됩니다.</td></tr><tr><td>클릭 수</td><td><ul><li>캠페인이 클릭된 횟수입니다. 여기서 클릭 수는 순 이벤트 수를 의미합니다.</li><li>예를 들어, 방문자가 캠페인에 노출된 후 A 버튼을 3번, B 버튼을 3번 클릭했다면 클릭 수는 총 2회로 기록됩니다.</li><li>클릭 수 컬럼의 데이터에 마우스 오버 시 캠페인 생성 시 설정한 클릭 클릭 ID의 개별 클릭 수를 확인할 수 있습니다.</li></ul></td></tr><tr><td>주문 수</td><td>세션 내 캠페인이 노출된 후 상품이 주문된 횟수입니다.</td></tr><tr><td>주문 수(클릭)</td><td>세션 내 캠페인이 클릭된 후 같은 세션 내에서 주문이 완료된 횟수(주문서 수)입니다.</td></tr><tr><td>클릭 전환율</td><td>세션 내 클릭 수 / 노출 수 * 100</td></tr><tr><td>회원가입 전환율</td><td>세션 내 캠페인 노출 후 회원가입 수 / 노출 수 * 100</td></tr><tr><td>회원가입(클릭) 전환율</td><td>세션 내 캠페인 클릭 후 회원가입 수 / 노출 수 * 100</td></tr><tr><td>주문 전환율</td><td>세션 내 캠페인 노출 후 주문 수 / 노출 수 * 100</td></tr><tr><td>주문(클릭) 전환율</td><td>세션 내 캠페인 클릭 후 주문 수 / 노출 수 * 100</td></tr><tr><td>전환 금액</td><td>세션 내 캠페인이 노출 후 상품이 주문된 금액의 합계입니다.</td></tr><tr><td>전환 금액(클릭)</td><td>세션 내 캠페인이 클릭 후 주문된 상품 금액의 합계입니다.</td></tr></tbody></table>

***

## **주문 상품 분석**

* 캠페인 분석 리포트의 주문 상품 분석을 통해 선택한 캠페인을 통한 주문 이력과 상품 랭킹을 확인할 수 있습니다.

<img src="/files/7TkfBkMru77elHR88LK9" alt="" width="563">

### **상세 주문 리스트**

* 세션 내 해당 캠페인이 노출 후 같은 세션 내에서 상품이 주문 되었을 때의 주문 이력입니다.
* 주문 일시, 주문 번호, 회원 ID, 주문 금액, 주문 수량, 주문 상품을 확인할 수 있습니다.
* 회원 ID 항목에는 로그인 회원의 주문인 경우 회원ID가 노출되고, 로그인하지 않은 회원의 주문인 경우 '비로그인 회원', 비회원의 주문인 경우 '비회원'이 노출됩니다.
* 주문 상품 마우스 오버 시 전체 주문 상품을 확인 할 수 있습니다.

### **상품 랭킹 TOP 100**

* 캠페인이 노출 후 같은 세션 내에서 조회 또는 주문된 상품의 랭킹입니다.
* 상품 뷰 수, 상품 뷰(클릭) 수, 주문 수, 주문(클릭) 수, 전환 금액, 전환 금액(클릭) 순으로 상품 랭킹 확인이 가능합니다.
* 예를 들어 상품 뷰 수 Top 100은 분석 리포트의 설정한 기간 내 캠페인 노출 후 많이 본 상품 순으로 기타 데이터 항목들을 표시합니다.

<table><thead><tr><th width="151.30859375">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td>상품코드</td><td>서비스에 등록된 상품의 코드가 표시됩니다.</td></tr><tr><td>상품명</td><td>서비스에 등록된 상품의 이름이 표시됩니다.</td></tr><tr><td>가격</td><td>상품의 판매가입니다.</td></tr><tr><td>상품 뷰 수</td><td>캠페인이 노출 후 같은 세션 내에서 상품이 조회된 횟수 입니다.</td></tr><tr><td>상품 뷰 (클릭) 수</td><td>캠페인이 클릭 후 같은 세션 내에서 상품이 조회된 횟수 입니다.</td></tr><tr><td>주문 수</td><td>캠페인이 노출 후 같은 세션 내에서 상품이 주문된 횟수입니다.</td></tr><tr><td>주문(클릭) 수</td><td><ul><li>캠페인이 클릭 후 같은 세션 내에서 해당 상품이 주문된 횟수입니다.</li><li>상품 랭킹의 주문 수의 합계는 개별 상품 기준으로 집계되기 때문에 기본 분석의 주문 수 보다 더 많을 수 있습니다.</li></ul></td></tr><tr><td>전환 금액</td><td>캠페인이 노출 후 같은 세션 내에서 주문된 상품 금액의 합계입니다.</td></tr><tr><td>전환 금액(클릭)</td><td>캠페인이 클릭된 후 같은 세션 내에서 주문된 상품 금액 합계입니다.</td></tr><tr><td>전환 금액</td><td>캠페인 디자인 안이 노출된 후 같은 세션 내에서 주문된 상품 금액의 합계입니다.</td></tr><tr><td>전환 금액(클릭)</td><td>캠페인 디자인 안이 클릭 후 같은 세션 내에서 주문된 상품 금액의 합계입니다.</td></tr></tbody></table>

***

## **A/B/N 테스트 분석**

* 캠페인 분석 리포트의 A/B/N 테스트 분석을 통해 선택한 캠페인의 A/B/N 테스트 결과와 디자인별 성과를 확인할 수 있습니다.

<img src="/files/N585jlRQqXimgcdllQyk" alt="" width="563">

### **A/B/N 테스트 방식**

* 캠페인 만들기 진행 시 설정한 테스트 방식(AI 자동화, 수동 설정)이 노출됩니다.

**AI 자동화**

* 노출 비율 자동화 목표 : 캠페인 생성 시 설정했던 목표를 표시합니다.\
  이 목표가 각 디자인 안들의 성과 비교를 위한 기준이 되어 노출 비율 자동화가 진행됩니다.
* 분석 결과 : A/B/N 테스트에서 AI가 가장 성과가 좋았다고 판단한 디자인 안을 표시합니다.

**수동 설정**

* 노출 비율 : 캠페인 생성 시 입력했던 디자인 안별 노출 비율을 표시합니다.

### **디자인별 데이터 추이**

* 세션 내 디자인별 데이터의 일별 추이 그래프입니다.
* 데이터 추이 그래프 상의 회원가입/주문 전환율, 전환 금액은 캠페인 클릭이 아닌 노출 후 전환 기준으로 계산된 수치입니다.
* 비노출을 포함한 디자인 안들의 데이터 색상으로 구분됩니다.
* 범례를 클릭하여 보고 싶은 디자인 안의 데이터만 선택할 수 있습니다.

### **데이터 테이블**

* 세션 내 데이터를 디자인 안별로 확인할 수 있습니다.
* 테이블 행은 설정한 디자인 안 개수만큼 추가됩니다.
* 테이블 하단에서 비노출(캠페인 설정에 따라 데이터가 표시되지 않을 수 있습니다)과 합계에 대한 데이터를 확인할 수 있습니다.데이터 항목은 다음과 같습니다.　

<table><thead><tr><th width="192.5625">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td>노출 수</td><td>세션 내 캠페인 디자인 안이 노출된 횟수입니다. 세션과 상관없이 디자인 안이 노출될 때마다 카운팅됩니다.</td></tr><tr><td>클릭 수</td><td><ul><li>세션 내 캠페인 디자인 안이 클릭된 횟수입니다. 세션과 상관없이 디자인 안이 클릭될 때마다 카운팅됩니다.</li><li>클릭 수 컬럼의 데이터에 마우스 오버 시 캠페인 생성 시 설정한 클릭 추적 ID의 개별 클릭 수를 확인할 수 있습니다.</li></ul></td></tr><tr><td>주문 수</td><td>세션 내 캠페인 디자인 안이 노출된 후 상품이 주문된 횟수입니다.</td></tr><tr><td>주문 수(클릭)</td><td>세션 내 캠페인 디자인 안이 클릭된 후 상품이 주문된 횟수입니다.</td></tr><tr><td>클릭 전환율</td><td>클릭 수 / 노출 수 * 100</td></tr><tr><td>회원가입 전환율</td><td>캠페인 디자인 안 노출 후 회원가입 수 / 노출 수 * 100</td></tr><tr><td>회원가입(클릭) 전환율</td><td>캠페인 디자인 안 클릭 후 회원가입 수 / 노출 수 * 100</td></tr><tr><td>주문 전환율</td><td>주문 수 / 노출 수 * 100</td></tr><tr><td>주문(클릭) 전환율</td><td>주문(클릭) 수 / 노출 수 * 100</td></tr><tr><td>전환 금액</td><td>세션 내 캠페인 디자인 안이 노출된 후 주문된 상품 금액의 합계입니다.</td></tr><tr><td>전환 금액(클릭)</td><td>세션 내 캠페인 디자인 안이 클릭된 후 주문된 상품 금액의 합계입니다.</td></tr></tbody></table>

### **캠페인 목표 분석** <a href="#campaign-goal" id="campaign-goal"></a>

* 두 개의 목표(상품, 카테고리) 중 하나만 설정했을 경우 설정한 목표만 보이며, 상품 구매와 카테고리 구매 **모두 설정**하였을 경우 각각 선택하여 확인할 수 있습니다. (캠페인 목표 분석 은 캠페인 목표 설정 시 보여집니다.)

<img src="/files/MyFneEvYszH8Dk5YWY02" alt="" width="563">

* 캠페인 목표 분석에서는 설정한 목표에 대한 지표에 대해서 확인할 수 있습니다. \
  (카테고리 코드는 다운로드 시 확인할 수 있습니다.)

<img src="/files/xaZa3q1IOFESUU2Bx2HB" alt="" width="563">

#### **요약 지표**

* 전환 수 : 목표건만 집계된 주문 전환 수
* 전환 금액 : 목표건만 집계된 주문 전환 금액

#### **상세 리스트**

* 주문 일시 : 목표건의 주문 일시
* 디자인 : 노출된 캠페인 디자인 안
* 전환 타입 : 노출된 캠페인이 전환 시 노출 또는 클릭으로 인한 전환건 타입
* 주문 번호 : 목표건이 포함된 주문 번호
* 회원 ID : 목표건을 주문한 회원 ID
* 주문 금액 (원) : 목표건의 상품 금액 x 주문 수량
* 주문 수량 : 목표건의 상품 수량
* 주문 상품 : 목표건의 상품명

#### **다운로드 항목**

* 상품 구매 : 목표 상품에 해당 되었는지 확인
  * Y : 목표에 해당 됨
  * N : 목표에 해당되지 않음
* 카테고리 구매 : 목표 카테고리에 해당 되었는지 확인
  * Y : 목표에 해당 됨
  * N : 목표에 해당되지 않음
* 주문 일시 : 목표건의 주문 일시
* 디자인 : 노출된 디자인 안
* 전환 타입 : 노출된 캠페인이 전환 시 노출 또는 클릭으로 인한 전환건 타입
  * 노출
  * 클릭
* 주문 번호 : 목표건이 포함된 주문 번호
* 회원 ID : 목표건을 주문한 회원 ID
  * 회원 ID
  * 비회원
* 카테고리 코드 : 목표한 설정 값의 카테고리 코드
* 대 카테고리 : 목표한 설정 값의 대 카테고리 코드
* 중 카테고리 : 목표한 설정 값의 중 카테고리 코드
* 소 카테고리 : 목표한 설정 값의 소 카테고리 코드
* 세 카테고리 : 목표한 설정 값의 세 카테고리 코드
* 상품 코드 : 목표한 설정 값의 상품 코드
* 주문 상품명 : 목표한 설정 값의 상품명
* 상품 금액 : 목표한 상품의 금액
* 주문 수량 : 목표한 상품의 주문 수량
* 주문 금액 : 목표한 상품의 금액 x 주문 수량


# 온사이트 캠페인 교육 동영상

온사이트 캠페인 에디터를 통하여 캠페인을 생성할 수 있습니다.

간편해진 에디터를 사용해서 캠페인을 생성하는 방법에 대해 알아보겠습니다.

{% embed url="<https://www.youtube.com/embed/Ft34G_5Bfqc?feature=oembed>" %}


# 푸시 알림 캠페인

## **푸시 알림이란?**

<img src="/files/84h4svDIHtzF3uPzTBHj" alt="" width="375">

푸시 알림(앱 푸시)는 모바일 앱을 기반으로 간결한 메시지를 전달하며, 사용자와의 상호 작용을 강화하는 효과가 있습니다.\
사용자가 해당 앱을 실행하지 않아도 정보를 전달할 수 있어, 마케팅, 알림, 사용자 참여 유도 등에 널리 사용할 수 있는 오프사이트 메시징 방식입니다.

### **푸시 알림 사전 설정**

푸시 알림을 발송하기 위해서는 푸시 알림 발송에 필요한 어플리케이션 정보를 우선으로 설정해야합니다.

현재 푸시 알림 설정은 기존 어드민에서만 설정할 수 있습니다.

기존 어드민에서의 설정 방법은 [푸시 알림 설정](/new-admin/settings/push) 문서를 확인해 주세요.

***

## **그루비 푸시 알림 캠페인**

* 푸시 알림 캠페인은 발송 시점에 스케줄 발송 방식, 이벤트 트리거 발송 방식으로 캠페인을 진행할 수 있습니다.
* 캠페인 만들기는 기본적으로 1단계 기본 설정, 2단계 메시지 설정, 3단계 옵션 설정의 순서로 진행됩니다.
* 각 발송 방식별 캠페인 설정 방법을 확인하여 설정해 주세요.

### **스케줄 발송 캠페인**

• 스케줄 발송 캠페인은 정해진 시간에 설정한 타겟에게 푸시 알림 메시지를 전송합니다.

• 특정 프로모션 행사를 하여 알림을 발송하거나, 주기적으로 반복해서 알림을 보내는 캠페인에 적합합니다.

• 발송하고 싶은 일자와 시간을 지정해서 한 번만 발송하거나, 정해진 주기마다 발송할 수 있습니다.

• 스케줄 발송의 발송 유형은 다음과 같습니다.

* 단일 발송 : 설정한 시간에 일회성으로 푸시 알림 캠페인을 진행합니다.
* 반복 발송 : 설정한 주기에 맞춰 반복적으로 푸시 알림 캠페인을 진행합니다.

자세한 내용은 [스케줄 발송 캠페인 만들기](/new-admin/push/push-create/schedule) 문서를 확인해 주세요.

### **이벤트 트리거 발송 캠페인**

• 이벤트 트리거 발송 캠페인은 특정 이벤트가 발생한 시점에 이벤트가 발생한 대상에게 푸시 알림 메시지를 전송합니다.

• 사용자의 행동이 발생하면 자동으로 알림을 보내는 캠페인에 적합합니다.

• 타겟을 설정하면 타겟 중 설정한 이벤트가 발생한 대상에게 그 시점에 발송되며, 타겟을 설정하지 않으면 수신 동의자 전체 중 설정한 이벤트가 발생한 대상에게 발송됩니다.

• 이벤트 발생 시점으로부터 대기 시간만큼 대기 후 발송하는 옵션을 사용할 수 있으며, 해당 옵션 사용 시 대기 시간동안 추가 이벤트가 발생한 대상은 제외하고 메시지를 발송할 수 있습니다.

자세한 내용은 [이벤트 트리거 발송 캠페인 만들기](/new-admin/push/push-create/event-trigger) 문서를 확인해 주세요.

### **API 트리거 발송 캠페인**

• API 트리거 발송 캠페인은 API 요청을 받았을 때 그루비에서 메시지를 발송하는 방식입니다.

• 그루비가 알 수 없는 우리 회사 내부 서버에서 정보가 바꼈을 시점 등에 메시지 전송을 요청하여 원하는 고객에게 메시지 발송합니다.

• 그루비 어드민에서 메시지 설정 진행하고, 발송 요청 시 요청한 대상에게 요청 시점에 요청한 데이터를 넣어서 발송한 후 이후 발송 결과 그루비 어드민에서 확인 가능합니다.

• 내부 서버의 값이 변경되는 시점에 요청을 하는 품절 상품 재입고 알림 메시지 발송, 배송 상황 알림 메시지 발송 등의 상황에 활용할 수 있습니다.

자세한 내용은 [API 트리거 발송 캠페인 만들기](/new-admin/push/personalization-push-create/api-trigger) 문서를 확인해 주세요.

{% hint style="warning" %}
API 트리거 발송 캠페인은 별도 과금 후 이용할 수 있습니다. 자세한 내용은 그루비에 문의해 주세요.\
<groobee_sales@plateer.com>
{% endhint %}


# 푸시 알림 발송을 위한 사전 준비

푸시 알림을 발송하기 위해서는 다음의 사전 준비가 필요합니다.

## **1. Firebase 비공개 키 발급 및 등록**

Android 및 iOS 기기에 푸시 알림을 발송하기 위해 필수적인 **Firebase 비공개 키**를 발급받고 등록하는 과정입니다. 비공개 키를 등록하면 별도의 개별 설정 없이 Android와 iOS 앱을 통합하여 연동할 수 있습니다.

### **1-1. Firebase 프로젝트 생성**

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

[**Firebase Console**](https://console.firebase.google.com/?authuser=6)에 접속하여 새로운 프로젝트를 생성해 주세요.\
이미 Android/iOS 앱이 등록된 프로젝트가 있다면 [**\[1-3. 비공개 키 생성\]**](#id-1-3)으로 이동해 주세요.

### **1-2. 앱 추가 (Android / iOS)**

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

생성된 프로젝트에 운영 중인 앱 정보를 등록해야 합니다.\
프로젝트 개요 화면에서 Android 및 iOS 아이콘을 클릭하여 앱을 추가해 주세요.

{% hint style="info" %}
각 OS별 상세 등록 방법은 아래 공식 도움말을 참고해 주세요.

* [**Firebase Android 앱 추가 가이드**](https://firebase.google.com/docs/android/setup?hl=ko\&authuser=6)
* [**Firebase iOS 앱 추가 가이드**](https://firebase.google.com/docs/ios/setup?hl=ko\&authuser=6)
  {% endhint %}

### **1-3. 비공개키 생성**

<figure><img src="/files/3NObbfOUSQxWNi7RAGNp" alt=""><figcaption></figcaption></figure>

(1) 왼쪽 상단의 **\[설정(⚙️) > 프로젝트 설정]**&#xC744; 클릭해 주세요.

(2) 상단 탭 메뉴 중 **\[서비스 계정]**&#xC744; 선택해 주세요.

(3) 화면 하단의 **\[새 비공개 키 생성]**&#xC744; 클릭하여 **JSON 형식의 비공개키 파일**을 다운로드해 주세요.

{% hint style="warning" %}
비공개 키 파일은 재발급이 번거로우며 보안상 중요하므로 외부 노출에 주의해 주세요.
{% endhint %}

### **1-4. 그루비에 키 등록**

<figure><img src="/files/8sWlTk9gffL1qXTSS4X0" alt=""><figcaption></figcaption></figure>

(1) [**\[설정 > 푸시 알림 설정\]**](/new-admin/settings/push)의 <img src="/files/vKPWkS30D2dPWI3B69LC" alt="" data-size="line"> 버튼을 클릭해 주세요.

(2) [**\[1-3. 비공개키 생성\]**](#id-1-3)에서 다운로드한 JSON 파일을 업로드하면 설정이 완료됩니다.

***

## **2. 앱 식별 정보 설정**

[**\[설정 > 모바일 앱\]**](/new-admin/settings/mobile-app)에서 **앱 식별 정보 및 사용 플랫폼 정보**를 설정해 주세요.

이 정보를 등록해야 방문자의 접속 환경(App/Web)을 정확히 구분할 수 있으며, 앱 사용자를 대상으로 푸시 알림 캠페인을 진행할 수 있습니다.

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


# 푸시 알림 캠페인 관리하기

## **캠페인 관리하기**

신규 어드민에서 푸시 알림 캠페인 생성 및 생성 캠페인을 관리할 수 있습니다.

* 새로운 푸시 알림 캠페인을 생성하고, 관리할 수 있습니다.
* 발송 타입별 스케줄 발송(단일/반복), 이벤트 트리거 발송, API 트리거 발송, 완료 캠페인 등 캠페인 리스트를 확인할 수 있습니다.

{% hint style="info" %}
기존 어드민에서 생성한 캠페인은 신규 어드민에서는 캠페인명만 확인 가능합니다. \
기존 어드민에서 생성한 캠페인의 수정 및 진행/중지, 분석 리포트는 기존 어드민에서 확인해 주세요.
{% endhint %}

<img src="/files/NPYfP9nLUOV90GZ5hECD" alt="" width="563">

### **푸시 알림 캠페인 만들기**

<img src="/files/Ut61j540JMHyA7dHE917" alt="" width="563">

* 새로운 캠페인을 만들기 위해 만들기 버튼을 클릭하여 원하는 캠페인 발송 타입을 선택하여 해당 캠페인 만들기 페이지로 이동할 수 있습니다.
* 그루비 푸시 알림 캠페인에서는 모든 발송 대상에게 동일한 문구를 보내는 일반 메시지와 메시지를 받는 사람별로 개인의 맞춤 데이터를 보낼 수 있는 개인화 메시지를 생성할 수 있습니다.
* 개인화 메시지 발송은 뱃지 표시가 표시되며, 이는 별도 과금이 되는 기능을 의미합니다.

### **미니 대시보드**

<img src="/files/X7gpDHSjVEJfoOXqKY8D" alt="" width="563">

미니 대시보드를 통해 발송 타입별 캠페인 진행 상황을 간단하게 표시합니다.

* 스케줄 발송
  * 오늘 발송 예정 : 오늘 발송 예정인 단일 또는 반복 발송의 스케줄 캠페인 수를 표시합니다.
  * 7일 이내 발송 예정 : 오늘 \~ 오늘+6일 총 7일 간의 발송 예정인 단일 또는 반복 발송의 스케줄 캠페인 수를 표시합니다.
* 이벤트 트리거 발송
  * 진행 중 : 이벤트 트리거 발송 캠페인 중 현재 진행 상태인 캠페인 수를 표시합니다.
* API 트리거 발송
  * 진행 중 : API 트리거 발송 캠페인 중 현재 진행 상태인 캠페인 수를 표시합니다.
* 완료 캠페인
  * 오늘 완료 : 오늘 완료 캠페인 탭으로 이동된 캠페인 수를 표시합니다.
  * 최근 7일 완료 : 오늘 \~ 오늘+6일 총 7일 간의 완료 캠페인 탭으로 이동된 캠페인 수를 표시합니다.

### **캠페인 리스트**

* 데이터 테이블에서는 발송 타입별로 생성된 캠페인 리스트를 확인할 수 있습니다.
* 테이블의 각 컬럼명을 클릭하여 정렬 또는 필터 기능을 사용할 수 있습니다.

#### **스케줄 발송**

* 발송 타입이 스케줄 발송으로 설정된 캠페인을 확인할 수 있습니다.

<img src="/files/MlZfV8BAL2XuuFoz3fnv" alt="" width="563">

스케줄 발송 탭의 데이터는 다음과 같습니다.

* 캠페인명 : 푸시 알림 캠페인 생성 시 설정한 캠페인의 이름입니다. 각 캠페인명 클릭 시 수정 화면으로 이동합니다.
* 상태 : 캠페인의 진행 상태를 표시합니다.
  * 진행 : 재생으로 표시 되며, 진행 중인 캠페인은 설정한 스케줄에 맞춰 캠페인이 진행됩니다.
  * 중지 : 일시정지로 표시 되며, 중지 중인 캠페인 설정한 스케줄이 있어도 캠페인이 진행되지 않습니다.
* 발송 예정 일시 : 캠페인 진행 시 발송 예정 일시를 표시합니다. 반복 발송은 진행 시 주기에 맞춰 발송이 나간 후 발송 예정 일시가 업데이트됩니다.
* 예상 타겟 수 : 단일 발송 만들기 시의 예상 타겟 수를 표시합니다.
* 누적 발송 수 :반복 발송에 성공한 누적된 발송 성공 수를 표시합니다.
* 발송 설정 : 캠페인 만들기 3단계에서 설정했던 스케줄 또는 반복 주기를 표시합니다.
  * 단일 발송 : 캠페인 만들기 시 설정한 발송 날짜와 시간이 표시됩니다.
  * 반복 발송 : 캠페인 만들기 시 설정한 반복 주기와 시간이 표시됩니다.
* 캠페인 기간 : 반복 발송 캠페인이 진행되는 기간을 표시합니다.
* 최종 수정일 : 캠페인이 최종으로 수정된 일자를 표시합니다.(상태 값 변경 시에도 최종 수정일은 업데이트 됩니다.)

#### **이벤트 트리거 발송**

* 발송 타입이 이벤트 트리거 발송으로 설정된 캠페인을 확인할 수 있습니다.

<img src="/files/AXiA7tsWibeUC0SHL7XK" alt="" width="563">

* 캠페인명 : 푸시 알림 캠페인 생성 시 설정한 캠페인의 이름입니다. 각 캠페인명 클릭 시 수정 화면으로 이동합니다.
* 상태 : 캠페인의 진행 상태를 표시합니다.
  * 진행 : 재생으로 표시 되며, 시작 일시에 맞춰 캠페인이 진행됩니다. 시작 일시가 지난 캠페인을 진행 시 캠페인이 즉시 진행됩니다.
  * 중지 : 일시정지로 표시 되며, 캠페인이 진행되지 않습니다.
* 누적 발송 수 : 캠페인 시작부터 해당 캠페인으로 발송 성공한 누적된 발송 성공 수를 표시합니다.
* 캠페인 기간 : 캠페인 만들기 시 설정한 캠페인 기간이 표시됩니다.
* 재발송 여부 : 트리거로 설정한 이벤트 조건을 이미 발송된 대상이 조건을 다시 만족했을 때, 메시지를 재발송 허용하는지 여부에 대해 표시합니다.
* 최종 수정일 : 캠페인이 최종으로 수정된 일자를 표시합니다.(상태 값 변경 시에도 최종 수정일은 업데이트 됩니다.)

#### **API 트리거 발송**

* 발송 타입이 API 트리거 발송으로 설정된 캠페인을 확인할 수 있습니다.

<img src="/files/Fmp9sexnDK0KdIm8Srzs" alt="" width="563">

* 캠페인명 : 푸시 알림 캠페인 생성 시 설정한 캠페인의 이름입니다. 각 캠페인명 클릭 시 수정 화면으로 이동합니다.
* 상태 : 캠페인의 진행 상태를 표시합니다.
  * 진행 : 재생으로 표시 되며, 시작 일시에 맞춰 캠페인이 진행됩니다. 시작 일시가 지난 캠페인을 진행 시 캠페인이 즉시 진행됩니다.
  * 중지 : 일시정지로 표시 되며, 캠페인이 진행되지 않습니다.
* 누적 발송 수 : 캠페인 시작부터 해당 캠페인으로 발송 성공한 누적된 발송 성공 수를 표시합니다.
* 캠페인 기간 : 캠페인 만들기 시 설정한 캠페인 기간이 표시됩니다.
* 최종 수정일 : 캠페인이 최종으로 수정된 일자를 표시합니다.(상태 값 변경 시에도 최종 수정일은 업데이트 됩니다.)

#### **완료 캠페인**

* 캠페인 진행 후 스케줄이 완료되었거나, 완료 캠페인 탭으로 이동시킨 캠페인을 확인합니다.

<img src="/files/KOerip7QF1sCCYvmLPfV" alt="" width="563">

* 캠페인명 : 푸시 알림 캠페인 생성 시 설정한 캠페인의 이름입니다. 각 캠페인명 클릭 시 캠페인 확인 화면으로 이동합니다.
* 발송 타입 : 완료된 캠페인의 발송 타입을 표시합니다.
  * 스케줄
  * 이벤트 트리거
  * API 트리거
* 발송 유형 : 스케줄 발송 방식 캠페인 발송 유형을 표시합니다.
  * 단일
  * 반복
* 발송 성공 수 : 캠페인의 총 발송 성공 수를 표시합니다.
* 발송 성공률(%) : 스케줄 발송 타입의 단일 발송 캠페인에서의 발송 성공률을 표시합니다.
* 캠페인 기간 : 기간을 설정하여 진행했던 캠페인의 설정된 캠페인 기간을 표시합니다.
* 캠페인 완료 일시 : 캠페인이 완료 탭으로 이동한 일시를 표시합니다.

{% hint style="warning" %}
푸시는 발송에 성공하였으나 디바이스의 네트워크 상황, 온라인 상태, 사용자의 앱 삭제 등으로 인해 실제 기기에 도달하지 못하는 상황이 발생할 수 있습니다. 이 때문에 발송 완료 탭의 발송 성공 수(발송 서버가 정상 접수한 기준)와 데이터 모니터링의 성공 수치(실제 기기 도달이 확인된 기준)가 다르게 보일 수 있습니다.
{% endhint %}

### **태그 및 검색**

<img src="/files/nXAQFNzUdU2XZx4JityB" alt="" width="188">

* 태그 필터 버튼 클릭 시 태그 필터창에서 캠페인 생성 시 추가한 태그로 태그 필터를 사용할 수 있습니다.
* 추가된 태그 중 조건에 맞는 태그를 체크하여 선택 버튼을 누르면 해당 태그가 추가되어 있는 캠페인만 필터링됩니다.
* 하나의 태그를 여러 캠페인에 사용할 수 있으며, 한 캠페인에서 동일한 태그를 여러 번 중복하여 추가할 수 없습니다.
* 검색을 이용하여 원하는 캠페인명을 검색할 수 있습니다.

### **관리 도구 (・・・)**

<table data-header-hidden><thead><tr><th width="87.125"></th><th width="109.109375"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/OkVlTzT9KZklvCsR87di" alt="" width="24"></p></td><td>수정</td><td>클릭 시 캠페인 수정 페이지로 이동합니다. 진행 중, 발송 이력 존재, 이벤트 트리거 캠페인 중 시작일시가 지난 캠페인, 발송 완료된 캠페인은 수정할 수 없습니다.</td></tr><tr><td><p><img src="/files/xvIqZapXARZ6p7pRLBc9" alt="" width="24"></p></td><td>복사</td><td>클릭 시 캠페인이 복사되어 새로운 캠페인 만들기 페이지로 이동합니다.</td></tr><tr><td><p><img src="/files/jMwIBTaABqzn8AWbDAul" alt="" width="24"></p></td><td>분석 리포트</td><td>발송된 캠페인의 경우, 해당 캠페인의 분석 리포트 페이지로 이동하여 캠페인 성과를 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/mEzEaXkhTzU78dwWmQel" alt="" width="24"></p></td><td>미리보기</td><td>클릭 시 해당 설정한 캠페인 메시지 내용을 미리보기로 확인 할 수 있습니다.</td></tr><tr><td><p><img src="/files/LoqzZjcUukJZbh1qSlDm" alt="" width="24"></p></td><td>완료 탭으로 이동</td><td>완료 캠페인 탭으로 캠페인을 이동합니다. 중지 중인 캠페인만 이동 가능하며, 한번 이동된 캠페인은 다시 이동할 수 없습니다.</td></tr><tr><td><p><img src="/files/PjIl2TlmjD2uGmgL2ehZ" alt="" width="24"></p></td><td>삭제</td><td>발송 완료 탭에서 선택한 캠페인을 삭제합니다. 발송 이력이 없는 캠페인만 삭제 가능합니다.</td></tr></tbody></table>

***

## FAQ

<details>

<summary>발송 완료 탭의 발송 성공 수와 데이터 모니터링의 성공 수치가 다르게 보입니다.</summary>

두 수치는 성공을 집계하는 단계가 다릅니다.

* 발송 완료 탭의 **발송 성공 수**는 그루비 서버가 구글 등의 발송 서버에 메시지를 전달하고 "정상 접수" 응답을 받은 수치입니다.
* 데이터 모니터링의 **성공**은 메시지가 실제 사용자 기기에 도달해 기기로부터 수신 확인 신호가 돌아온 경우에만 집계되는 수치입니다.

서버 입장에서는 발송 요청이 정상 처리됐더라도, 아래와 같은 사유로 실제 기기에는 도달하지 못하는 경우가 있어 두 수치 간 차이가 발생합니다.

* 사용자가 앱을 삭제한 경우
* 기기 알림 설정에서 수신을 꺼둔 경우
* 네트워크/기기 상태에 따라 일시적으로 수신이 지연되거나 안 되는 경우 (iOS에서 간헐적으로 발생)

</details>


# 일반 메시지 캠페인 만들기


# 스케줄 발송 캠페인 만들기

## **1단계 : 기본 설정** <a href="#step1" id="step1"></a>

새로운 푸시 알림 캠페인 만들기 기본 설정에서는 캠페인명, 캠페인의 상세설명, 태그 등의 캠페인 기본 정보와 캠페인 타겟을 설정할 수 있습니다.

<img src="/files/VPTd4xXox5tELIqWp4fL" alt="" width="563">

### **단계 이동**

각 단계를 클릭하여 해당하는 단계로 이동할 수 있습니다. 각 단계의 필수 값이 입력되어야만 이동 가능합니다.

### **캠페인 기본 정보**

<img src="/files/8GwiEwbUkuPXuyKggFTT" alt="" width="563">

* 캠페인명 : 해당 캠페인의 이름을 설정합니다. 한글 기준 공백 포함 최대 40자까지 설정 가능합니다.
* 상세설명 : 해당 캠페인에 대한 간략한 설명이 필요할 시 설정합니다. 한글 기준 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. 캠페인 리스트에서 태그 필터를 통해 특정 캠페인을 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="338.3984375"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/DPtW1K6gbdNYKTpo7mV5" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

![](/files/ifu1vLImV4IkMatU1XFo)

캠페인을 진행할 대상 타겟을 설정합니다. 현재는 일부 기능만 지원합니다.

* 타겟팅 유형 : 세그먼트 / 수신 동의자 전체 / 회원 정보 업로드
  * 세그먼트 : 만들어진 세그먼트를 불러와서 타겟팅 합니다.
  * 수신 동의자 전체 : 푸시 알림 수신 동의를 한 모든 대상을 타겟팅 합니다.
  * 회원 정보 업로드 : 직접 푸시 알림을 발송할 회원 ID 리스트를 업로드하여 타겟팅 합니다.

{% hint style="info" %}
푸시 수신 동의자 전체는 그루비에 유효한 푸시 토큰, 수신 동의가 된 전체 대상에게 발송됩니다.
{% endhint %}

{% hint style="warning" %}
회원 정보 업로드의 파일은 완료된 캠페인의 경우 완료 일자부터 +31일까지만 파일이 보관됩니다. 그 이후의 캠페인 복사 시에는 기존 파일을 사용할 수 없습니다.
{% endhint %}

{% hint style="warning" %}
파일명이 한글 기준 50자(164바이트) 이하인 파일만 업로드해 주세요.
{% endhint %}

* 세그먼트 설정 : 타겟팅 유형이 세그먼트일 때 표시되며, 저장된 세그먼트를 불러올 수 있습니다. 상세보기를 클릭하여 해당 세그먼트의 상세 정보를 확인합니다.<br>

  <figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/56ueklf39n/1758678893025/.png" alt=""><figcaption></figcaption></figure>

  * 세그먼트 불러오기 : ‘세그먼트 불러오기' 버튼을 클릭하여 원하는 세그먼트를 최대 3개까지 불러올 수 있습니다. 상세보기를 클릭하여 각 세그먼트의 상세 정보를 확인할 수 있습니다.
    * AI 세그먼트 : 저장된 AI 세그먼트를 선택할 수 있습니다.
    * 세그먼트 : 활용 범위가 '오프사이트'인 세그먼트만 선택 가능합니다.
  * 조건 설정 (AND, OR, NOT) : 각 세그먼트 사이에 적용할 조건을 선택합니다.
    * AND : 앞선 조건과 현재 세그먼트의 교집합에 해당하는 타겟에게 발송합니다. (예: VIP 고객 이면서 최근 30일 내 구매 고객)
    * OR : 앞선 조건과 현재 세그먼트의 합집합에 해당하는 타겟에게 발송합니다. (예: VIP 고객 이거나 최근 30일 내 구매 고객)
    * NOT : 앞선 조건에서 현재 세그먼트에 해당하는 타겟을 제외합니다. (예: VIP 고객 중 최근 30일 내 구매 고객은 제외)
  * 순서 조정 : 세그먼트는 위에서 아래 순서대로 조건이 조합됩니다. 세그먼트 좌측의 화살표 버튼을 통해 자유롭게 순서를 변경하고, 타겟 조합의 우선순위를 조정할 수 있습니다.<br>

    <figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/56ueklf39n/1758678831214/.png" alt=""><figcaption></figcaption></figure>
  * 세그먼트 조합 결과 요약 : 위에서 조합한 세그먼트의 타겟팅 정보를 알기 쉽게 제공합니다.
    * 세그먼트 조합이 어떻게 이루어지는지 궁금하신가요? ‘조합 결과 보기' 팝업을 통해 현재 설정된 세그먼트와 조건이 어떤 논리로 결합되어 타겟이 추출되는지 직관적으로 확인할 수 있습니다.
* 발송 OS : 전체 / Android / iOS
  * 전체 : Android, iOS 모든 발송 OS에 푸시 알림 메시지를 발송합니다.
  * Android(추후 오픈) : Android 기기의 푸시 알림 수신 동의자에게 푸시 알림 메시지를 발송합니다.
  * iOS(추후 오픈) : iOS 기기의 푸시 알림 수신 동의자에게 푸시 알림 메시지를 발송합니다.

***

## **2단계 : 메시지 설정** <a href="#step2" id="step2"></a>

메시지 설정에서는 실제 발송될 메시지 본문을 작성하여 작성된 메시지를 미리보기와 발송 테스트를 통해 확인할 수 있습니다.

<img src="/files/RVW9YAtZCFe3WGPY1gBG" alt="" width="563">

### **메시지 기본 설정**

<img src="/files/eIqcbb39wPAYkpqisirW" alt="" width="563">

* 알림 목적 : 광고성 / 정보성
  * 광고성 : 광고성 푸시 알림 수신 동의를 한 사용자에게만 메시지가 발송됩니다.
  * 정보성 : 광고성 푸시 알림 수신 동의와 상관없이, 푸시 알림 메시지를 수신할 수 있는 모든 대상에게 메시지가 발송됩니다.
* 광고 문구 표기 : 선택한 언어에 맞는 광고 문구 표기를 메시지 미리보기에서 확인할 수 있습니다.
  * 광고 문구 표기는 설정 > 푸시 알림 설정 > 광고 문구 표기에서 설정할 수 있습니다.
* 발송 OS : 만들기 1단계에서 설정한 발송 OS를 표시합니다.

### **예상 타겟 수**

<img src="/files/5gwjfHnzfV2kju0imQXn" alt="" width="563">

* 타겟팅 유형 및 알림 목적, 발송 OS 등의 선택한 타겟팅 조건에 맞는 대상의 예상 수치를 확인할 수 있습니다.

{% hint style="info" %}
예상 타겟 수 조회 시점의 예상 타겟 수와 실제 발송 시점의 발송 타겟 수에는 차이가 있을 수 있습니다.

자세한 내용은 [예상 타겟 수](/new-admin/push/push-create/schedule/target) 문서를 확인해 주세요.
{% endhint %}

### **메시지 작성**

<img src="/files/6uSbsWb6RwYwbOyiUQkv" alt="" width="563">

* 실제 발송될 푸시 알림 메시지 내용을 작성합니다.

#### **ⓐ 제목**

* 푸시 알림 메시지의 제목을 작성합니다.
* 알림 목적이 광고성은 최대 31자까지 작성 가능하며, 정보성은 최대 40자까지 작성 가능합니다.

#### **ⓑ 내용**

* 푸시 알림 메시지 내용을 설정합니다.&#x20;

#### **ⓒ 수신거부 표기**

* 알림 목적이 광고성인 메시지에서 고정된 수신 거부 방법을 사용하고 싶을 시 설정하면 내용 뒤에 표기되어 발송합니다.
* 설정 > 푸시 알림 설정 > 수신 거부 방법 표기 에서 값을 설정할 수 있습니다.

{% hint style="info" %}
설정된 값은 새로운 캠페인부터 적용됩니다.
{% endhint %}

{% hint style="warning" %}
알림 목적이 광고성일 경우, 메시지에 (광고) 문구가 필수로 표기되어야 합니다.

알림 목적이 광고성일 경우 수신 거부 방법을 필수로 표기해야 합니다.

광고 문구 표기 위치의 기본 값과 고정된 수신 거부 표기는 설정 > 푸시 알림 설정에서 설정할 수 있습니다.
{% endhint %}

{% hint style="info" %}
미리보기는 실제 푸시 알림과 차이가 있을 수 있습니다.
{% endhint %}

{% hint style="success" %}
메시지 내용은 125자 이하로 간결하게 작성하는 것을 권장합니다.\
글자 수가 125자가 넘어가는 경우 모바일 기기의 해상도에 따라 일부 텍스트가 표시되지 않을 수 있습니다.
{% endhint %}

#### **ⓓ 기본 이미지**

* 설정 > 푸시 알림 설정 화면 Android 기본 이미지에 업로드한 이미지를 불러옵니다.
* 해당 이미지는 Android 기기에만 표시되며, 설정 > 푸시 알림 설정 화면에 업로드된 이미지가 없을 시 사용할 수 없습니다.

#### **ⓔ 본문 이미지**

* 본문에 파일을 업로드하여 내용과 함께 이미지를 발송할 수 있습니다. 권장 이미지 사이즈는 1024 x 512px 입니다.
* 업로드한 이미지는 푸시 알림 제목 옆에는 1:1 비율로 크롭되고 푸시 알림 내용 하단에는 전체 크기의 이미지가 전송됩니다.

#### **ⓕ 클릭 동작**

* 사용자가 푸시를 터치했을 때 실행되는 동작을 선택합니다.
  * 앱 실행 : 사용자가 푸시 알림을 터치할 때 앱을 실행합니다.
  * 딥 링크 : 사용자가 푸시 알림을 터치할 때 앱 내의 특정 화면으로 랜딩합니다.
    * Scheme://Path 형식으로 입력해 주세요.
    * 해당 입력창에는 최대 1000자 까지만 입력 가능합니다.
* 웹 브라우저 실행 : 사용자가 푸시 알림을 클릭할 때 웹 브라우저를 실행해 특정 페이지로 이동합니다.
  * http\:// 나 https\:// 형식의 올바른 URL을 입력해 주세요.
  * 해당 입력창에는 최대 1,000자 까지만 입력 가능합니다.

{% hint style="warning" %}
외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.
{% endhint %}

#### **ⓖ 고급 옵션**

* 푸시 알림 메시지에 추가적인 데이터 전달이 가능합니다.
* 데이터에 담고 싶은 추가적인 정보를 입력하고, 해당 데이터를 활용하여 앱 내에서 따로 푸시 알림에 대한 처리를 할 수 있습니다.
* 앱 푸시에 대한 특정한 처리를 하고자 할 때 활용할 수 있습니다.
* 추가 데이터를 사용하면 허용 용량 범위 내에서 추가적인 데이터를 전달할 수 있습니다. 최대 500자 이내의 값을 입력해 주세요.
* 최대 10개의 key, value를 추가할 수 있습니다.

{% hint style="warning" %}
커스텀 Key-Value 쌍으로 적절한 키를 설정하여 클라이언트 앱으로 데이터 페이로드를 보내는 기능입니다.\
고급 옵션 기능은 앱 개발 담당자와 상의 후 사용하는 것을 권장합니다. [참고 문서](https://firebase.google.com/docs/cloud-messaging/concept-options?authuser=0\&hl=ko&_gl=1*13z49rc*_up*MQ..*_ga*MTk5NjQyMzk1MS4xNzIxMDMxMDQ0*_ga_CW55HF8NVT*MTcyMTAzMTA0NC4xLjEuMTcyMTAzMTg1My4wLjAuMA..#data_messages)를 확인해 주세요.
{% endhint %}

#### **ⓗ 미리보기**

* 미리보기에서는 작성한 메시지 내용을 미리 확인할 수 있습니다.
* 발송 OS별로 미리보기를 확인할 수 있습니다.

| Android                                                           | iOS                                                               |
| ----------------------------------------------------------------- | ----------------------------------------------------------------- |
| <p><img src="/files/s54qmGZymQBPeLmIALNh" alt="" width="375"></p> | <p><img src="/files/z6FJk6dOXGI3z6MXOzYn" alt="" width="375"></p> |

{% hint style="info" %}
미리보기는 메시지 발송 참고용으로, 실제 발송되는 메시지와 차이가 있을 수 있습니다.
{% endhint %}

#### **ⓘ 발송 테스트**

* 메시지 설정을 마친 후, 캠페인 진행 전 테스트 메시지를 발송할 수 있습니다.
* 발송 테스트 대상은 한 번에 5명까지 발송 테스트를 할 수 있습니다.
* 입력한 회원 ID로 로그인한 기기에 유효한 토큰이 있는 경우 푸시 알림 메시지를 받을 수 있습니다.

<img src="/files/rLveBsmckOGuWyK8ER0G" alt="" width="188">

***

## **3단계 : 옵션 설정** <a href="#step3" id="step3"></a>

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

### **1. 스케줄**

#### **1-1. 단일 발송**

설정한 발송 일시에 맞춰 한 번만 발송됩니다.

<img src="/files/nfKhPDN41JzWWlDdmkzV" alt="" width="563">

* 발송 유형 : 단일 발송 또는 반복 발송의 발송 유형을 선택합니다.
* 발송 일시 : 메시지가 발송될 발송 일자와 시간을 선택합니다.

#### **1-2. 반복 발송**

반복 주기 및 발송 시간을 선택하여 해당 캠페인을 반복하여 실행합니다.

<img src="/files/xFXwMxEoDcjganghsVwQ" alt="" width="563">

* 발송 유형 : 단일 발송 또는 반복 발송의 발송 유형을 선택합니다.
* 발송 기간
  * 수동 종료 전까지 : 캠페인 진행 시점부터 수동으로 캠페인을 종료할 때까지 캠페인을 진행합니다.
  * 기간 지정 : 캠페인을 설정한 특정 기간 동안에만 진행합니다.
* 반복 설정
  * 일별 반복 : 발송 기간동안 캠페인을 반복할 일 간격을 설정할 수 있습니다.
  * 주별 반복 : 발송 기간동안 캠페인을 반복할 주 간격과 해당 주에 반복할 특정 요일을 설정할 수 있습니다. (요일 복수 선택 가능)
* 월별 반복 : 발송 기간동안 캠페인을 반복할 월 간격과 해당 월에 반복할 특정 날짜(일)를 설정할 수 있습니다.\
  \* 말일을 선택할 시 해당 월의 마지막 날에 발송됩니다.

<img src="/files/mIXdUm2EaGZq2V3jX81T" alt="" width="563">

* 발송 시간 : 반복 주기에 맞춰 메시지가 발송될 시간을 설정합니다.

{% hint style="warning" %}
발송 시간이 심야 시간(21:00\~08:00)일 경우 야간 광고 전송 수신 동의자에게만 발송되므로 예상 타겟 수를 다시 확인해야 합니다.\
정보통신망법에 의거하여 심야 시간에 발송하도록 설정된 광고성 메시지의 경우 야간 광고 전송 수신 동의자에게만 발송됩니다.
{% endhint %}

### **2. 발송 간격 제한**

발송 간격 제한은 같은 대상에게 설정한 기간 동안 메시지가 다시 발송되지 않도록 제한하는 기능입니다. 이 캠페인의 발송 이력, 또는 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 중복·반복 발송을 막을 수 있습니다.

발송 유형(단일 발송 / 반복 발송)에 따라 **적용 범위** 영역이 다르게 표시됩니다.

{% tabs %}
{% tab title="단일 발송" %}

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

적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다.
{% endtab %}

{% tab title="반복 발송" %}

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

적용 범위를 '이 캠페인만 적용' 또는 '같은 그룹 캠페인 포함' 중 선택할 수 있습니다.
{% endtab %}
{% endtabs %}

#### **2-1. 사용 여부 선택**

* **사용 안 함:** 발송 간격 제한을 적용하지 않습니다.
* **사용:** 아래에서 설정한 기준에 따라 같은 대상에게 일정 기간 동안 다시 발송되지 않도록 제한합니다.

#### **2-2. 적용 범위**

발송 간격 제한의 기준이 될 발송 이력의 범위를 선택합니다.

* **이 캠페인만 적용:** 이 캠페인의 발송 이력만 기준으로 제한합니다. (반복 발송에서만 선택할 수 있습니다.)
* **같은 그룹 캠페인 포함:** 같은 발송 제한 그룹에 속한 캠페인의 발송 이력을 함께 확인하여, 같은 대상에게 설정한 제한 기간 동안 다시 발송되지 않도록 제한합니다.

{% hint style="info" %}
단일 발송은 이 캠페인 자체가 반복 발송되지 않으므로, 적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다. 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 제한이 적용됩니다.

e.g. 푸시와 SMS 캠페인을 같은 그룹으로 묶으면, 푸시 발송 대상을 SMS 발송에서 제외할 수 있습니다.
{% endhint %}

#### **2-3. 발송 제한 그룹**

적용 범위가 '같은 그룹 캠페인 포함'일 때 사용할 발송 제한 그룹을 선택합니다.

* **+ 새 그룹 등록:** 새로운 발송 제한 그룹을 즉시 등록할 수 있습니다.
* **그룹 캠페인 보기:** 선택한 그룹을 사용 중인 캠페인 목록을 확인할 수 있습니다.

{% hint style="info" %}
발송 제한 그룹은 설정 > 발송 제한 그룹 관리에서 미리 만들어 둘 수 있습니다. 같은 그룹에 속한 캠페인은 발송 이력을 함께 공유합니다.
{% endhint %}

#### **2-4. 대상 기준**

같은 대상으로 판단할 기준을 선택합니다.

* **기기 또는 회원 기준:** 같은 기기 또는 같은 회원으로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다. 로그인 회원이 여러 기기를 사용하는 경우에도 중복 발송을 제한할 수 있습니다.
* **기기 기준:** 같은 기기로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다.

#### **2-5. 제한 기간**

1\~31일 사이로 설정할 수 있습니다.

{% hint style="info" %}
위 기준과 일치하는 대상에게는 마지막 발송일을 기준으로 설정한 제한 기간 동안 다시 발송되지 않습니다. (1\~31일)

e.g. 5월 1일 발송 / 제한 기간 2일 → 5월 1일·2일은 발송되지 않으며, 5월 3일부터 다시 발송할 수 있습니다.
{% endhint %}


# 스케줄 발송 예상 타겟 수

스케줄 발송 시 푸시 알림 예상 타겟 수 계산에 대해 설명합니다.

### **체크 항목**

* 푸시 알림 메시지 예상 타겟 수는 다음 항목들을 확인합니다.
  * 타겟팅 유형 : 선택한 타겟 유형의 모수를 확인합니다.
  * SDK 여부 : 푸시를 발송하는 앱의 SDK가 설치되어있어야 합니다.
  * 푸시 토큰 : 푸시 알림을 발송하기 위해 필수로 있어야 하는 값이며, 만료되지 않은 유효한 값을 가진 대상에게 발송됩니다.
  * 광고성 정보 수신 동의 여부 : 알림 목적이 광고성인 메시지의 경우, 마케팅 수신 동의 또는 광고성 정보 수신 동의가 있어야 발송됩니다.

{% hint style="warning" %}
그루비에서는 예상 타겟 수 계산 시 매일 03:00 기준으로 수신 동의 여부를 체크합니다.
{% endhint %}

{% hint style="warning" %}
발송 시에는 발송 시점에서 항목들을 확인하므로, 예상 타겟 수를 계산하는 시점과 실제 발송하는 시점의 타겟 수는 차이가 있을 수 있습니다.
{% endhint %}

#### **일반 메시지**

<table><thead><tr><th width="134.2734375">타겟팅 유형</th><th width="112.28515625">알림 목적</th><th>예상 타겟 수 계산</th></tr></thead><tbody><tr><td>세그먼트</td><td>광고성</td><td>선택한 세그먼트 모수 중 SDK O / 푸시 토큰 O / 광고성 수신 동의 O</td></tr><tr><td></td><td>정보성</td><td>선택한 세그먼트 모수 중 SDK O / 푸시 토큰 O</td></tr><tr><td>수신 동의자 전체</td><td>광고성</td><td>SDK O / 푸시 토큰 O / 광고성 수신 동의 O 인 모든 대상</td></tr><tr><td></td><td>정보성</td><td>SDK O / 푸시 토큰 O</td></tr><tr><td>직접 업로드</td><td>광고성</td><td>직접 업로드한 회원 ID 중 SDK O / 푸시 토큰 O / 광고성 수신 동의 O</td></tr><tr><td></td><td>정보성</td><td>직접 업로드한 회원 ID 중 SDK O / 푸시 토큰 O</td></tr></tbody></table>

{% hint style="warning" %}
야간 수신 동의 : 정보통신망법에 의거하여 심야(21:00\~08:00) 시간에 발송하도록 설정된 광고성 메시지의 경우 야간 광고 전송 수신 동의자에게만 발송됩니다. 해당 시간에 발송한다면 캠페인 만들기 3단계에서 야간 수신 동의까지 한 예상 타겟 수를 확인하세요.
{% endhint %}

### **알림 목적**

* 푸시 알림 메시지는 알림 목적에 따라 광고성, 정보성으로 나뉘며 이에 따라 대상과 발송 가능 시간 등에 영향이 있습니다.

<img src="/files/40A9OqlPMAhz9GOtZ1Cy" alt="" width="563">


# 이벤트 트리거 발송 캠페인 만들기

## **이벤트 트리거 발송**

* 이벤트 트리거 발송은 타겟이 특정 이벤트를 충족하는 시점에 발송을 하는 발송 방식입니다.
* 이벤트가 발생되면 즉시 또는 설정한 대기 시간 후에 발송이 가능하며, 특정 행동을 하는 타겟을 적절한 시점에 타겟팅 할 수 있는 방식입니다.

{% hint style="warning" %}
이벤트 트리거 발송은 피로도 설정 여부와 상관없이 발송됩니다.
{% endhint %}

***

## **1단계 : 기본 설정** <a href="#step1" id="step1"></a>

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

### **단계 이동**

각 단계를 클릭하여 해당하는 단계로 이동할 수 있습니다. 각 단계의 필수 값이 입력되어야만 이동 가능합니다.

### **캠페인 기본 정보**

![](/files/ld6lnlm0OAKCFxQ6AjQU)

* 캠페인명 : 해당 캠페인의 이름을 설정합니다. 한글 기준 공백 포함 최대 40자까지 설정 가능합니다.
* 상세설명 : 해당 캠페인에 대한 간략한 설명이 필요할 시 설정합니다. 한글 기준 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. 캠페인 리스트에서 태그 필터를 통해 특정 캠페인을 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="306.72265625"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/qWUXSR7LGSiH78yxS2p7" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

<img src="/files/j7ARXPln1mmGvB3idigS" alt="" width="563">

캠페인을 진행할 대상 타겟을 설정합니다. 발송 타입이 이벤트 트리거 발송인 경우 세그먼트 설정은 선택 사항이며, 설정하지 않을 시 모든 사용자 대상 중 설정한 이벤트가 발생한 사용자에게 메시지가 발송됩니다.

* 세그먼트 설정 : 세그먼트 불러오기로 저장된 세그먼트를 불러올 수 있습니다. 상세보기를 클릭하여 해당 세그먼트의 상세 정보를 확인합니다.
  * AI 세그먼트 : 이벤트 트리거 캠페인에서는 사용할 수 없습니다.
  * 세그먼트 : 활용 범위가 '온사이트(Web/Hybrid, Native)'로 저장된 세그먼트만 선택 가능합니다.

{% hint style="info" %}
설정한 타겟 중 우리 사이트에서 이벤트가 발생한 대상에게 설정한 시점에 발송되며, 발송 시 발송에 필요한 정보가 있는 대상에게 발송됩니다.
{% endhint %}

{% hint style="warning" %}
세그먼트 불러오기는 현재 만드는 캠페인에서 사용 가능한 세그먼트만 표시됩니다. 오프사이트 이벤트 트리거 캠페인은 기존 어드민에서 만든 온사이트 세그먼트를 사용할 수 있습니다.
{% endhint %}

### **트리거 설정**

![](/files/QX2oIOZG19UyYtnRUu93)

* 발송 시점을 결정할 트리거 이벤트를 설정합니다.
* 해당 이벤트가 발생하고, 이벤트에 따라 필요한 설정된 조건을 만족하면 대기 시간 후 발송합니다.
* 이벤트 트리거로 선택한 이벤트에 따라 조건을 설정할 수 있습니다.
* 아래의 표를 참고해 주세요.

<table><thead><tr><th width="122.1015625">이벤트</th><th width="147.7734375">조건</th><th>설명</th></tr></thead><tbody><tr><td>장바구니 행동</td><td>담은 상품명</td><td>장바구니 행동이 발생했을 때, 입력한 상품명과 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>담은 상품 코드</td><td>장바구니 행동이 발생했을 때, 입력한 상품 코드와 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>담은 총액</td><td>장바구니 행동이 발생했을 때, 입력한 담은 총액이 선택한 조건을 충족하면 발송합니다.</td></tr><tr><td>주문 행동</td><td>주문 완료 상품명</td><td>주문 행동이 발생했을 때, 입력한 주문 완료 상품명과 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>주문 완료 상품 코드</td><td>주문 행동이 발생했을 때, 입력한 주문 완료 상품 코드와 선택한 조건이 충족되면 발송합니다.</td></tr><tr><td></td><td>주문 총액</td><td>주문 행동이 발생했을 때, 입력한 주문 총액이 선택한 조건을 충족하면 발송합니다.</td></tr><tr><td>방문 행동</td><td>회원가입</td><td>방문 행동이 발생했을 때, 회원가입이 발생하면 발송합니다.</td></tr><tr><td>커스텀 이벤트</td><td>커스텀 이벤트명</td><td>커스텀 이벤트가 발생했을 때, 선택한 커스텀 이벤트와 조건을 충족하면 발송합니다.</td></tr></tbody></table>

### **대기 시간 설정**

![](/files/CGGEDLqqygaNhWO2Vj5N)

* 이벤트가 발생한 후 조건을 만족한 대상에게 즉시 또는 지정한 시간만큼 대기 후 메시지를 발송합니다.
  * 즉시 : 이벤트 조건을 만족한 대상에게 메시지를 즉시 발송합니다.
  * 지정 : 대기 시간을 지정하면 이벤트 조건을 만족한 시점에서 지정된 시간만큼 대기 후 발송합니다. 대기 시간은 최소 1분부터 최대 24시간 사이로 지정할 수 있습니다.

{% hint style="warning" %}
이벤트 트리거를 충족하여 설정한 대기 시간 후의 시간이 21:00\~08:00에 해당되는 메시지는 야간 광고 수신에 동의한 대상에게만 발송됩니다.
{% endhint %}

{% hint style="warning" %}
캠페인 진행에서 중지 상태로 변경하면, 대기 시간에 있던 메시지는 발송되지 않습니다.
{% endhint %}

### **추가 필터 이벤트 설정**

![](/files/02KpH1kfib5aWkVXGaPo)

* 대기 시간이 '지정'일 경우 추가 필터 이벤트를 설정할 수 있습니다.
* 지정된 대기 시간 후 발송이 나갈 시점에 추가적인 이벤트가 발생한 대상을 제외하고 발송합니다.
* 추가 필터 이벤트를 설정하지 않으면 이벤트 트리거 조건을 만족한 모든 대상에게 지정한 대기 시간 후 발송됩니다
  * 예시) 장바구니에 담은 총액이 100,000 일 때 3시간 후 발송을 하는 경우, 추가 필터 이벤트로 주문 완료 이벤트를 설정한다면 3시간 동안 구매 완료 이벤트가 발생한 대상은 제외하고, 구매가 없는 대상에게만 발송됩니다.
* 아래의 표를 참고해 주세요.

<table><thead><tr><th width="136.54296875">추가 필터 이벤트</th><th width="138.203125">조건</th><th>설명</th></tr></thead><tbody><tr><td>주문 행동</td><td>주문 완료</td><td>트리거로 설정한 이벤트가 발생하고, 대기 시간동안 주문 완료가 발생한 대상은 제외하고 발송합니다.</td></tr><tr><td></td><td>주문 총액</td><td>트리거로 설정한 이벤트가 발생하고, 대기 시간동안 입력한 주문 총액이 선택한 조건을 충족한 대상은 제외하고 발송합니다.</td></tr><tr><td>커스텀 이벤트</td><td>커스텀 이벤트명</td><td>트리거로 설정한 이벤트가 발생하고, 대기 시간동안 선택한 커스텀 이벤트와 조건을 충족한 대상은 제외하고 발송합니다.</td></tr></tbody></table>

{% hint style="info" %}
추가 필터 이벤트는 대기 시간이 지정일 경우만 설정 가능합니다.
{% endhint %}

### **이벤트 트리거 요약**

![](/files/UBpmKw6so1d7PIQI5NGV)

![](/files/LN3cNITAsEN2EmEhNy4V)

* 이벤트 트리거 요약에서 현재까지 설정한 이벤트 트리거, 대기 시간, 추가 필터 이벤트 등의 요약된 내용을 확인할 수 있습니다.
* 요약을 확인하여 내용이 잘 설정됐는지 검토 해볼 수 있습니다.

{% hint style="info" %}
여러 개의 값을 입력했을 경우 하나의 값만 확인하고, 남은 값은 말줄임 처리됩니다.
{% endhint %}

***

## **2단계 : 메시지 설정** <a href="#step2" id="step2"></a>

메시지 설정에서는 실제 발송될 메시지 본문을 작성하여 작성된 메시지를 미리보기와 발송 테스트를 통해 확인할 수 있습니다.

<img src="/files/e3cv06NhoP7Lm0NQfZJb" alt="" width="563">

### **메시지 기본 설정**

![](/files/SHxFXBH6vaY1AabpXJc1)

* 알림 목적 : 광고성 / 정보성
  * 광고성 : 광고성 푸시 알림 수신 동의를 한 사용자에게만 메시지가 발송됩니다.
  * 정보성 : 광고성 푸시 알림 수신 동의와 상관없이, 푸시 알림 메시지를 수신할 수 있는 모든 대상에게 메시지가 발송됩니다.
* 광고 문구 표기 : 선택한 언어에 맞는 광고 문구 표기를 메시지 미리보기에서 확인할 수 있습니다.
  * [광고 문구 표기는 설정 > 푸시 알림 설정 > 광고 문구 표기](/new-admin/settings/push)에서 설정할 수 있습니다.

• 발송 OS : 만들기 1단계에서 설정한 발송 OS를 표시합니다.

### **메시지 작성**

![](/files/OItTqFGA4w2xH8q9PJrO)

* 실제 발송될 푸시 알림 메시지 내용을 작성합니다.

#### **ⓐ 제목**

* 푸시 알림 메시지의 제목을 작성합니다.
* 알림 목적이 광고성은 최대 31자까지 작성 가능하며, 정보성은 최대 40자까지 작성 가능합니다.

#### **ⓑ 내용**

* 푸시 알림 메시지 내용을 설정합니다.&#x20;

#### **ⓒ 수신 거부 표기**

* 고정된 수신 거부 방법을 사용하고 싶을 시 설정하면 내용 뒤에 표기되어 발송합니다.
* 설정 > 푸시 알림 설정 > 수신 거부 방법 표기 에서 값을 설정할 수 있습니다.

{% hint style="info" %}
설정된 값은 새로운 캠페인부터 적용됩니다.
{% endhint %}

{% hint style="warning" %}
알림 목적이 광고성일 경우, 메시지에 (광고) 문구가 필수로 표기되어야 합니다.

알림 목적이 광고성일 경우 수신 거부 방법을 필수로 표기해야 합니다.

광고 문구 표기 위치의 기본 값과 고정된 수신 거부 표기는 설정 > 푸시 알림 설정에서 설정할 수 있습니다.
{% endhint %}

{% hint style="info" %}
미리보기는 실제 푸시 알림과 차이가 있을 수 있습니다.
{% endhint %}

{% hint style="success" %}
메시지 내용은 125자 이하로 간결하게 작성하는 것을 권장합니다.\
글자 수가 125자가 넘어가는 경우 모바일 기기의 해상도에 따라 일부 텍스트가 표시되지 않을 수 있습니다.
{% endhint %}

#### **ⓓ 기본 이미지**

* 설정 > 푸시 알림 설정 화면 Android 기본 이미지에 업로드한 이미지를 불러옵니다.
* 해당 이미지는 Android 기기에만 표시되며, 설정 > 푸시 알림 설정 화면에 업로드된 이미지가 없을 시 사용할 수 없습니다.

#### **ⓔ 본문 이미지**

* 본문에 파일을 업로드하여 내용과 함께 이미지를 발송할 수 있습니다. 권장 이미지 사이즈는 1024 x 512px 입니다.
* 업로드한 이미지는 푸시 알림 제목 옆에는 1:1 비율로 크롭되고 푸시 알림 내용 하단에는 전체 크기의 이미지가 전송됩니다.

#### **ⓕ 클릭 액션**

* 사용자가 푸시를 터치했을 때 실행되는 액션을 선택합니다.
  * 앱 실행 : 사용자가 푸시 알림을 터치할 때 앱을 실행합니다.
  * 딥 링크 : 사용자가 푸시 알림을 터치할 때 앱 내의 특정 화면으로 랜딩합니다.
    * 딥 링크 형식으로 입력해 주세요.
    * 해당 입력창에는 최대 1,000자 까지만 입력 가능합니다.
  * 웹 브라우저 실행 : 사용자가 푸시 알림을 클릭할 때 웹 브라우저를 실행해 특정 페이지로 이동합니다.
    * http\:// 나 https\:// 형식의 올바른 URL을 입력해 주세요.
    * 해당 입력창에는 최대 1,000자 까지만 입력 가능합니다.

{% hint style="warning" %}
외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.
{% endhint %}

#### **ⓖ 고급 옵션**

* 푸시 알림 메시지에 추가적인 데이터 전달이 가능합니다.
* 데이터에 담고 싶은 추가적인 정보를 입력하고, 해당 데이터를 활용하여 앱 내에서 따로 푸시 알림에 대한 처리를 할 수 있습니다.
* 앱 푸시에 대한 특정한 처리를 하고자 할 때 활용할 수 있습니다.
* 추가 데이터를 사용하면 허용 용량 범위 내에서 추가적인 데이터를 전달할 수 있습니다. 최대 500자 이내의 값을 입력해 주세요.
* 최대 10개의 key, value를 추가할 수 있습니다.

{% hint style="info" %}
커스텀 Key-Value 쌍으로 적절한 키를 설정하여 클라이언트 앱으로 데이터 페이로드를 보내는 기능입니다.\
고급 옵션 기능은 앱 개발 담당자와 상의 후 사용하는 것을 권장합니다. [참고 문서](https://firebase.google.com/docs/cloud-messaging/concept-options?authuser=0\&hl=ko&_gl=1*13z49rc*_up*MQ..*_ga*MTk5NjQyMzk1MS4xNzIxMDMxMDQ0*_ga_CW55HF8NVT*MTcyMTAzMTA0NC4xLjEuMTcyMTAzMTg1My4wLjAuMA..#data_messages)를 확인해 주세요.
{% endhint %}

#### **ⓗ 미리보기**

|                                                                   | iOS                                                               |
| ----------------------------------------------------------------- | ----------------------------------------------------------------- |
| <p><img src="/files/6G0sCZqeSBtI1nmAikAt" alt="" width="375"></p> | <p><img src="/files/jP12c4aG9fRzKZXRzjJ6" alt="" width="375"></p> |

* 미리보기에서는 작성한 메시지 내용을 미리 확인할 수 있습니다.
* 발송 OS별로 미리보기를 확인할 수 있습니다.

{% hint style="info" %}
미리보기는 메시지 발송 참고용으로, 실제 발송되는 메시지와 차이가 있을 수 있습니다.
{% endhint %}

#### **ⓘ 발송 테스트**

<img src="/files/UUlbtuds1XTwkpD0zNzE" alt="" width="188">

* 메시지 설정을 마친 후, 캠페인 진행 전 테스트 메시지를 발송할 수 있습니다.
* 발송 테스트 대상은 한 번에 5명까지 발송 테스트를 할 수 있습니다.
* 입력한 회원 ID로 로그인한 기기에 유효한 토큰이 있는 경우 푸시 알림 메시지를 받을 수 있습니다.

***

## **3단계 : 옵션 설정** <a href="#step3" id="step3"></a>

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

### **1. 스케줄**

<img src="/files/vvL2V1atFWe4qwFefqhk" alt="" width="563">

* 캠페인의 진행 스케줄을 설정할 수 있습니다.
  * 수동 종료 전까지 : 설정한 시작 일시부터 직접 완료 처리하기 전까지 캠페인이 진행됩니다.
  * 기간 지정 : 설정한 시작 일시 \~ 종료 일시동안 캠페인이 진행됩니다.

{% hint style="warning" %}
정보통신망법에 의거하여 심야 시간(21:00\~08:00)에 발송하도록 설정된 광고성 메시지의 경우 야간 광고 전송 수신 동의자에게만 발송됩니다.
{% endhint %}

{% hint style="warning" %}
캠페인 진행 스케줄을 설정하여 저장 후 캠페인 진행을 해야 설정한 시간에 맞춰 캠페인이 시작됩니다.
{% endhint %}

### **2. 메시지 발송 제어**

메시지 발송 제어에서는 재발송 허용 여부를 선택합니다.

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

* **재발송 허용 안 함(체크 해제):** 한 번 발송된 대상은 이벤트 조건을 다시 만족하더라도 메시지를 다시 발송하지 않습니다.
* **재발송 허용(체크):** 이미 메시지가 발송된 대상이 같은 이벤트 트리거 조건을 다시 만족하면 메시지를 재발송합니다.

{% hint style="warning" %}
재발송을 허용하면 동일 회원이 같은 트리거에 다시 걸릴 때마다 메시지가 다시 발송됩니다. 과도한 발송을 막기 위해 아래 **발송 간격 제한**을 함께 사용하는 것을 권장합니다.
{% endhint %}

{% hint style="info" %}
재발송 허용과 발송 간격 제한은 서로 다른 기능입니다.\
두 설정을 함께 사용하면 재발송은 허용하되, 설정한 간격 안에서는 중복 발송을 막을 수 있습니다.

* **재발송 허용:** 같은 트리거 조건을 다시 만족했을 때 메시지를 또 보낼지 여부를 결정합니다.
* **발송 간격 제한:** 재발송이 허용되더라도, 마지막 발송일로부터 설정한 기간 안에는 다시 발송되지 않도록 막습니다.
  {% endhint %}

### **3. 발송 간격 제한**

발송 간격 제한은 같은 대상에게 설정한 기간 동안 메시지가 다시 발송되지 않도록 제한하는 기능입니다. 이 캠페인의 발송 이력, 또는 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 중복·반복 발송을 막을 수 있습니다.

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

#### **3-1. 사용 여부 선택**

* **사용 안 함:** 발송 간격 제한을 적용하지 않습니다.
* **사용:** 아래에서 설정한 기준에 따라 같은 대상에게 일정 기간 동안 다시 발송되지 않도록 제한합니다.

#### **3-2. 적용 범위**

발송 간격 제한의 기준이 될 발송 이력의 범위를 선택합니다.

* **이 캠페인만 적용:** 이 캠페인의 발송 이력만 기준으로 제한합니다.
* **같은 그룹 캠페인 포함:** 같은 발송 제한 그룹에 속한 캠페인의 발송 이력을 함께 확인하여, 같은 대상에게 설정한 제한 기간 동안 다시 발송되지 않도록 제한합니다.

{% hint style="info" %}
재발송을 허용한 경우, '이 캠페인만 적용'을 설정하면 이 캠페인에서 마지막으로 발송된 시점을 기준으로 재발송 간격을 제한할 수 있습니다.
{% endhint %}

#### **3-3. 발송 제한 그룹**

적용 범위가 '같은 그룹 캠페인 포함'일 때 사용할 발송 제한 그룹을 선택합니다.

* **+ 새 그룹 등록:** 새로운 발송 제한 그룹을 즉시 등록할 수 있습니다.
* **그룹 캠페인 보기:** 선택한 그룹을 사용 중인 캠페인 목록을 확인할 수 있습니다.

{% hint style="info" %}
발송 제한 그룹은 설정 > 발송 제한 그룹 관리에서 미리 만들어 둘 수 있습니다. 같은 그룹에 속한 캠페인은 발송 이력을 함께 공유합니다.
{% endhint %}

#### **3-4. 대상 기준**

같은 대상으로 판단할 기준을 선택합니다.

* **기기 또는 회원 기준:** 같은 기기 또는 같은 회원으로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다. 로그인 회원이 여러 기기를 사용하는 경우에도 중복 발송을 제한할 수 있습니다.
* **기기 기준:** 같은 기기로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다.

#### **3-5. 제한 기간**

1\~31일 사이로 설정할 수 있습니다.

{% hint style="info" %}
위 기준과 일치하는 대상에게는 마지막 발송일을 기준으로 설정한 제한 기간 동안 다시 발송되지 않습니다. (1\~31일)

e.g. 5월 1일 발송 / 제한 기간 2일 → 5월 1일·2일은 발송되지 않으며, 5월 3일부터 다시 발송할 수 있습니다.
{% endhint %}


# 개인화 메시지 캠페인 만들기


# API 트리거 발송 캠페인 만들기

{% hint style="info" %}
API 트리거 발송 사용 방법을 확인하여 개발자와 소통 후 캠페인을 설정해 주세요.
{% endhint %}

{% hint style="warning" %}
API 트리거 발송은 별도 과금이 되는 캠페인 유형입니다. 사용을 원하시면 그루비팀에 문의해 주세요.

<groobee_sales@plateer.com>
{% endhint %}

## **API 트리거 발송**

* API 트리거 발송은 API 요청을 받았을 때 메시지를 발송하는 방식입니다.
* 그루비에서 알 수 없는 우리 회사 내부 정보가 바뀌는 시점 등에 메시지 발송 요청하여 요청한 시점에 메시지를 발송할 수 있습니다.
* 과금을 하지 않은 어드민에서는 캠페인 만들기까지 가능하지만, 캠페인 진행은 불가합니다.

{% hint style="warning" %}
API 트리거 발송은 피로도 설정 여부와 상관없이 발송됩니다.
{% endhint %}

{% hint style="warning" %}
API 트리거 발송 설정 후 개인화 변수 수정이 있을 시 개발자와 상의 후 진행해 주세요.
{% endhint %}

## **1단계 : 기본 설정**

<img src="/files/HZDyA5mYISPSCP0taQF7" alt="" width="563">

### **단계 이동**

각 단계를 클릭하여 해당하는 단계로 이동할 수 있습니다. 각 단계의 필수 값이 입력되어야만 이동 가능합니다.

### **캠페인 기본 정보**

![](/files/CR9vobj81Z4Uq6Qj9dMS)

* 캠페인명 : 해당 캠페인의 이름을 설정합니다. 한글 기준 공백 포함 최대 40자까지 설정 가능합니다.
* 상세 설명 : 해당 캠페인에 대한 간략한 설명이 필요할 시 설정합니다. 한글 기준 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. 캠페인 리스트에서 태그 필터를 통해 특정 캠페인을 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="315.234375"></th><th></th></tr></thead><tbody><tr><td><img src="/files/abMY74vjcAAC55syRLoy" alt="" data-size="original"></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

## **2단계 : 메시지 설정**

메시지 설정에서는 실제 발송될 메시지 본문을 작성하여 작성된 메시지를 미리보기를 통해 확인할 수 있습니다.

<img src="/files/N6m8I1ssQqZkAPD0Dwe5" alt="" width="563">

### **메시지 기본 설정**

![](/files/dHa62i78zxqGk9WjLTpS)

메시지의 알림 목적을 설정하고, 발송 OS를 확인합니다.

* 알림 목적
  * 광고성 : 메시지 내용이 광고 성격을 띈 메시지 작성 시 선택합니다. 광고성 선택 시 광고성 푸시 알림 수신 동의를 한 유효한 푸시 토큰 정보를 가진 고객에게 발송됩니다. 푸시 알림 메시지 중 21:00\~08:00 시간에 발송 요청되는 메시지는 광고성 야간 수신 동의를 한 고객에게만 발송됩니다.
  * 정보성 : 광고성 푸시 알림 수신 동의 여부와 시간에 상관없이, 유효한 푸시 토큰을 가진 고객에게 모두 발송 요청됩니다.
* 광고 문구 표기 : 선택한 언어에 맞는 광고 문구 표기를 메시지 미리보기에서 확인할 수 있습니다.
  * 광고 문구 표기는 [설정 > 푸시 알림 설정 > 광고 문구 표기](/new-admin/settings/push)에서 설정할 수 있습니다.
* 발송 OS : 푸시 알림 메시지가 발송될 OS를 표시합니다.

{% hint style="warning" %}
알림 목적이 광고성일 경우, 메시지에 (광고) 문구를 필수로 표기해야 합니다.

알림 목적이 광고성일 경우 수신거부 방법을 필수로 표기해야 합니다.

광고 문구 표기 위치의 기본 값과 고정된 수신거부 표기 문구는 설정 > 푸시 알림 설정에서 설정할 수 있습니다.
{% endhint %}

{% hint style="danger" %}
알림 목적에 따른 필수 표기 사항을 따르지 않았을 시의 법적 책임은 그루비에게 있지 않습니다.
{% endhint %}

### **개인화 설정** <a href="#personalization" id="personalization"></a>

![](/files/s8etvYBvg7LhrlDyM2ou)

• 변수 설정을 클릭하면 열리는 개인화 변수 설정 창에서 개인화 변수로 사용할 개인화 키를 설정할 수 있습니다.

<img src="/files/SACLAQwVu4VsmRENfs4y" alt="" width="563">

* 변수 추가 버튼을 눌러 개인화 변수로 사용할 개인화 키를 최대 10개까지 설정할 수 있습니다.
* 개인화 키는 대소문자가 구분하여 영문과 언더스코어(\_)만 사용할 수 있습니다.
* 개인화 키를 넣어 확인 후 개인화 키를 수정하면 메시지 작성에 넣은 개인화 변수는 모두 삭제됩니다.
* 개발자와 약속한 개인화 키를 정확히 입력해 주세요.
* 설정한 개인화 키는 캠페인 만들기 3단계 코드 샘플에서도 확인할 수 있습니다.

{% hint style="warning" %}
실제 API 요청 시 properties에 담아보낼 key를 설정하는 영역입니다. 개발자와 key, value를 약속하여 작성할 것을 권장합니다.
{% endhint %}

* 개인화 변수 설정 후 하위 메시지 작성에서 변수 추가 버튼을 클릭하여 설정한 변수를 메시지 안에 넣어 작성할 수 있습니다.

<img src="/files/u2mibx0x7vpc1S0KUsov" alt="" width="563">

* 위의 개인화 변수 설정에서 설정한 개인화 키를 변수 항목으로 선택할 수 있습니다.
* 입력된 개인화 변수에는 발송 시 전달된 사용자별 데이터가 치환되어서 발송됩니다.
* 변수를 선택하면 대체 발송 값을 설정할 수 있으며, 설정 시 전달된 데이터가 없는 경우 설정된 내용으로 발송됩니다.\
  설정하지 않을 시 값이 공백으로 비어서 발송됩니다.
* 치환된 가변적인 변수의 길이를 고려하여 메시지를 작성해 주세요.

### **메시지 작성** <a href="#message" id="message"></a>

* 실제 발송될 푸시 알림 메시지 내용을 작성합니다.

<img src="/files/FrlpJGqIo9nbGa6vMXBB" alt="" width="563">

**<작성 예시>**

<img src="/files/LkXephw8tnYHuMDfhxiR" alt="" width="563">

#### **ⓐ 제목**

* 푸시 알림 메시지의 제목을 작성합니다.
* 알림 목적이 광고성은 최대 31자까지 작성 가능하며, 정보성은 최대 40자까지 작성 가능합니다.
* 텍스트 변수 추가 버튼을 클릭하여 개인화 변수를 추가할 수 있습니다.

{% hint style="info" %}
개인화 변수 추가 시 가변하는 변수의 글자 수를 고려하여 메시지를 작성해 주세요.

[개인화 설정](#undefined-3)을 참고해 주세요.
{% endhint %}

#### **ⓑ 내용**

* 푸시 알림 메시지 내용을 설정합니다. 알림 목적에 따라 알맞은 메시지를 작성해 주세요.
* 광고성 메시지의 경우 수신거부 표기를 제외하여 최대 210자까지 작성 가능하며, 정보성 메시지의 경우 최대 260자까지 작성 가능합니다.
* 텍스트 변수 추가 버튼을 클릭하여 개인화 변수를 추가할 수 있습니다.

{% hint style="info" %}
개인화 변수 추가 시 가변하는 변수의 글자 수를 고려하여 메시지를 작성해 주세요.

[개인화 설정](#undefined-3)을 참고해 주세요.
{% endhint %}

#### **ⓒ 수신 거부 표기**

* 정보성 메시지에서는 설정하지 않으며, 광고성 메시지에서 고정된 수신 거부 방법을 사용하고 싶을 시 설정하면 내용 뒤에 표기되어 발송합니다.
* 설정 > 푸시 알림 설정 > 수신 거부 방법 표기 에서 값을 설정할 수 있습니다.

{% hint style="info" %}
설정된 값은 새로운 캠페인부터 적용됩니다.
{% endhint %}

{% hint style="warning" %}
알림 목적이 광고성일 경우, 메시지에 (광고) 문구 필수로 표기야 합니다.

알림 목적이 광고성일 경우 수신거부 방법을 필수로 표기해야 합니다.

광고 문구 표기 위치의 기본 값과 고정된 수신거부 표기 문는 설정 > 푸시 알림 설정에서 설정할 수 있습니다.
{% endhint %}

{% hint style="info" %}
미리보기는 실제 푸시 알림과 차이가 있을 수 있습니다.
{% endhint %}

{% hint style="success" %}
메시지 내용은 125자 이하로 간결하게 작성하는 것을 권장합니다.\
글자 수가 125자가 넘어가는 경우 모바일 기기의 해상도에 따라 일부 텍스트가 표시되지 않을 수 있습니다.
{% endhint %}

#### **ⓓ 기본 이미지**

* 설정 > 푸시 알림 설정 화면 Android 기본 이미지에 업로드한 이미지를 불러옵니다.
* 해당 이미지는 Android 기기에만 표시되며, 설정 > 푸시 알림 설정 화면에 업로드된 이미지가 없을 시 사용할 수 없습니다.

#### **ⓔ 본문 이미지**

* 본문에 파일을 업로드하여 내용과 함께 이미지를 발송할 수 있습니다. 권장 이미지 사이즈는 1024 x 512px 입니다.
* 업로드한 이미지는 푸시 알림 제목 옆에는 1:1 비율로 크롭되고 푸시 알림 내용 하단에는 전체 크기의 이미지가 전송됩니다.

#### **ⓕ 클릭 액션**

* 사용자가 푸시를 터치했을 때 실행되는 액션을 선택합니다.
  * 앱 실행 : 사용자가 푸시 알림을 터치할 때 앱을 실행합니다.
  * 딥 링크 : 사용자가 푸시 알림을 터치할 때 앱 내의 특정 화면으로 랜딩합니다.
    * 딥 링크 형식으로 입력해 주세요.
    * 해당 입력창에는 최대 1,000자까지만 입력 가능합니다.
  * 웹 브라우저 실행 : 사용자가 푸시 알림을 클릭할 때 웹 브라우저를 실행해 특정 페이지로 이동합니다.
    * http\:// 나 https\:// 형식의 올바른 URL을 입력해 주세요.
    * 해당 입력창에는 최대 1,000자까지만 입력 가능합니다.

#### **ⓖ 고급 옵션**

* 푸시 알림 메시지에 추가적인 데이터 전달이 가능합니다.
* 데이터에 담고 싶은 추가적인 정보를 입력하고, 해당 데이터를 활용하여 앱 내에서 따로 푸시 알림에 대한 처리를 할 수 있습니다.
* 앱 푸시에 대한 특정한 처리를 하고자 할 때 활용할 수 있습니다.
* 추가 데이터를 사용하면 허용 용량 범위 내에서 추가적인 데이터를 전달할 수 있습니다. 최대 500자 이내의 값을 입력해 주세요.
* 최대 10개의 key, value를 추가할 수 있습니다.

{% hint style="info" %}
커스텀 Key-Value 쌍으로 적절한 키를 설정하여 클라이언트 앱으로 데이터 페이로드를 보내는 기능입니다.\
고급 옵션 기능은 앱 개발 담당자와 상의 후 사용하는 것을 권장합니다. [참고 문서](https://firebase.google.com/docs/cloud-messaging/customize-messages/set-message-type?hl=ko#optional-data-payload)를 확인해 주세요.
{% endhint %}

#### **ⓗ 미리보기**

| Android                                                             | iOS                                                                 |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| <img src="/files/76bIp2BDQ3Woc1DgRXPX" alt="" data-size="original"> | <img src="/files/r40quyCQaYmxzqjjcdoI" alt="" data-size="original"> |

* 미리보기에서는 작성한 메시지 내용을 미리 확인할 수 있습니다.
* 발송 OS별로 미리보기를 확인할 수 있습니다.

{% hint style="info" %}
미리보기는 메시지 발송 참고용으로, 실제 발송되는 메시지와 차이가 있을 수 있습니다.
{% endhint %}

{% hint style="warning" %}
API 트리거 발송은 발송 테스트를 제공하지 않습니다. 코드 샘플을 참고하여 개발자와 테스트 후 사용해 주세요.
{% endhint %}

***

## **3단계 : 옵션 설정**

<img src="/files/FLtPwIcidBTqTYEptaJV" alt="" width="563">

### **스케줄**

![](/files/o066kCLHg52T4NTQtHUG)

* 캠페인의 진행 스케줄을 설정할 수 있습니다.
  * 수동 종료 전까지 : 설정한 시작 일시부터 직접 완료 처리하기 전까지 캠페인이 진행됩니다.
  * 기간 지정 : 설정한 시작 일시 \~ 종료 일시동안 캠페인이 진행됩니다.

{% hint style="warning" %}
정보통신망법에 의거하여 심야 시간(21:00\~08:00)에 발송하도록 설정된 광고성 메시지의 경우 야간 광고 전송 수신 동의자에게만 발송됩니다.
{% endhint %}

{% hint style="warning" %}
캠페인 진행 스케줄을 설정하여 저장 후 캠페인 진행을 해야 설정한 시간에 맞춰 캠페인이 시작됩니다.
{% endhint %}

### **API 트리거 코드 샘플**

* 작성 후 코드 샘플을 확인하여 개발자와 소통 시 사용할 수 있습니다.

<img src="/files/ZQkX0K59B1Pvd7SRDZ5t" alt="" width="563">

* API 요청 시 참고할 수 있는 코드 샘플을 확인합니다.
* 캠페인 키 : 캠페인마다 발행되는 고유 ID입니다. API 요청 시 필수 값이며, 요청 시에 캠페인 키로 식별하여 설정한 메시지를 보냅니다.
* 코드 샘플
  * 표시된 주소를 참고하여 발급받은 API 키 값을 넣어 발송을 요청해 주세요.
  * campaignKey : 필수로 요청되어야 하는 값이며, 해당 키로 캠페인을 식별할 수 있습니다.
  * users : 한 번에 100명의 대상을 요청할 수 있습니다.
    * memberId : 발송할 대상의 회원 ID입니다.
    * properties : 개인화 메시지를 보낼 경우 설정해서 보냅니다. \
      개인화 변수는 최대 10개까지 사용 가능하며, 요청하는 key 값이 캠페인 만들기 2단계에서 설정한 개인화 변수여야만 치환되어서 메시지를 발송할 수 있습니다. 설정하지 않았을 시 2단계에서 작성한 고정된 문구의 메시지가 요청한 회원에게 발송됩니다.

{% hint style="warning" %}
코드 샘플을 참고하여 설정한 메시지에 맞는 발송 대상별의 데이터를 담아 요청해 주세요.
{% endhint %}

{% hint style="warning" %}
사전에 그루비 캠페인 설정 시 개발자와 충분히 상의하여 캠페인을 만들어 주세요.
{% endhint %}


# 푸시 알림 분석 리포트


# 푸시 알림 분석 리포트: 단일 발송

단일 발송으로 발송된 푸시 알림 캠페인의 성과 등의 분석 리포트를 확인합니다.

![](/files/Qjbmqjpl9L5OMa67quAI)

## **캠페인 정보**

<img src="/files/GkLaNnpUWyYagUZ0bbat" alt="" width="563">

* 캠페인명 : 선택한 캠페인의 기본적인 정보 입니다. 캠페인명 클릭 시 캠페인의 상세 정보가 새 창으로 열립니다.
* 상세 설명 : 캠페인 만들기 진행 시 입력한 상세 설명입니다.
* 전환 기여 기간 : 캠페인의 리포트 기간을 선택할 수 있습니다. 3시간, 6시간, 발송 당일, 3일, 7일의 기간 중 한 기간을 선택하여 볼 수 있습니다.
* 리포트 기간 : 발송 후 선택된 전환 기여 기간 만큼에 해당되는 리포트 시작 일자와 마지막 일자를 보여줍니다.
* 발송 날짜/시간 : 발송이 진행된 일시를 보여줍니다.
* 상세보기 : 클릭 시 해당 캠페인의 발송 OS, 알림 목적, 작성일, 최종 수정일 정보를 확인할 수 있습니다.

{% hint style="info" %}
기간에 대한 자세한 설명은 [캠페인 분석 리포트 전환 기여 기간](http://doc.groobee.io/article/d9646n2jjl-) 정책을 확인하세요.
{% endhint %}

***

## **기본 분석**

<img src="/files/6Ld9BmyxTH3Z61cSnKNB" alt="" width="563">

### **요약 지표**

![](/files/q4m6Hyejesr6eOVclRF0)

* 전체 : 전환 기여 기간 동안의 수집된 통계입니다.
* 발송 후 30분 : 푸시 발송 후 30분 이내의 수집된 통계입니다.
* 발송 수 : 푸시 발송 수 입니다. 피로도가 적용된 캠페인은 피로도 적용이 표시가 됩니다.
* 상세보기 : 발송 수 상세를 확인합니다. 피로도 적용했을 시 피로도가 적용되기 전의 발송 대상 수, 피로도가 적용된 수, 실제 발송 요청 수를 확인할 수 있습니다.<br>

  <img src="/files/aoNWhgcpnx29vvb5rmaG" alt="" width="375">

  * 발송 대상 수 : 피로도 적용 전 선택한 전체 타겟의 수 입니다.
  * 피로도 적용 수 : 피로도가 적용되어 발송 요청 대상에서 제외된 수 입니다.
  * 발송 수 : 실제 해당 캠페인에서 발송 요청된 수 입니다.
* 오픈 수 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈한 사용자 수 입니다.
* 회원가입 수 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈하여 회원가입한 회원 수(ID) 입니다.
* 주문 수 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 사용자 수 입니다.
* 전환 금액 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 총 금액입니다.
* 전환율(%)
  * 오픈 전환율 : \[오픈 수 / 발송 수 \* 100] %
  * 회원가입 전환율 : \[회원 가입 수 / 발송 수 \* 100] %
  * 주문 전환율 : \[주문 수 / 발송 수 \* 100] %

### **퍼널 분석**

<img src="/files/yM0n9lFmsVn9dMgUzPL9" alt="" width="563">

캠페인 발송에서 주문 전환에 이르기까지의 흐름을 시각화하고 단계별 수치를 시각적으로 확인합니다.

* 발송 : 기간 내 푸시가 발송된 사용자 수
* 성공 : 발송 수에서 발송 실패한 수를 제외한 수 (= 발송 - 발송 실패)
* 오픈하지 않음 : 푸시를 발송 했지만 푸시 메시지를 오픈 하지 않은 사용자 수 (= 성공 - 오픈)
* 오픈 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈한 사용자 수 (= 성공 - 오픈하지 않음)
* (주문 페이지) 진입하지 않음 : 앱 오픈 후 주문 페이지에 도달하지 않은 사용자 수, 오픈 수 에서 주문 페이지 값을 제외한 수 (= 오픈 - 주문 페이지 진입)
* (주문 페이지) 진입 : 앱 오픈 후 주문 페이지에 도달한 사용자 수 (= 오픈 - 주문 페이지 진입하지 않음)
* 주문하지 않음 : 주문 페이지에 도달했지만 주문하지 않은 사용자 수 (= 주문 페이지 - 주문 완료)
* 주문 : 주문을 완료한 사용자 수

{% hint style="danger" %}
**발송 실패 원인**으로는 여러 케이스가 있지만, 크게 3가지 경우가 있습니다.\
1\) PushToken이 유효하지 않을 때 (사용자의 기기가 바뀌거나, 해당 토큰이 expire된 경우)\
2\) 사용자의 디바이스 OS 설정에서 해당 앱의 알림 수신을 OFF한 경우\
3\) 앱을 삭제한 경우
{% endhint %}

{% hint style="warning" %}
iOS 사용자의 경우 간헐적으로 푸시 발송에 성공하였으나 디바이스의 네트워크 상황, 온라인 상태 등으로 인해 실제 기기에 도달하지 못하는 상황이 발생할 수 있습니다.
{% endhint %}

### **데이터 추이**

<img src="/files/u69kkSYbPOIfrenhmaCx" alt="" width="563">

* 선택한 전환 기여 기간에 따른 조회 기간 내 데이터 테이블에 해당하는 데이터의 시간별 추이 그래프입니다.
* 데이터 추이를 꺾은선 그래프, 막대 그래프 형태로 확인할 수 있습니다.

### **데이터 테이블**

<img src="/files/ViRnGdyKxSlMhXYQk4z9" alt="" width="563">

선택한 전환 기여 기간에 따른 조회 기간 내 데이터를 시간별로 확인할 수 있습니다.

* 발송 수 : 푸시 발송 건 수
* 오픈 수 : 푸시 메시지를 받은 후 앱을 오픈한 사용자 수
* 회원가입 수 : 푸시 메시지를 받은 후 앱을 오픈하여 회원 가입한 회원 수(ID)
* 주문 수 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 사용자 수
* 전환 금액 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 총 금액

***

## **주문 상품 분석**

* 캠페인 분석 리포트의 주문 상품 분석을 통해 선택한 캠페인을 통한 주문 이력과 상품 랭킹을 확인할 수 있습니다.

<img src="/files/oABbHbQG5OI8Yjr6Tcb8" alt="" width="563">

### **상세 주문 리스트**

<img src="/files/Wbw218Xu7zsDc9qQK5nC" alt="" width="563">

* 선택한 전환 기여 기간에 따른 조회 기간 내 해당 캠페인의 클릭 요소가 클릭된 후 같은 세션 내에서 상품이 주문 되었을 때의 주문 이력입니다.
* 주문 일시, 주문 번호, 회원 ID, 주문 금액, 주문 수량, 주문 상품을 확인할 수 있습니다.
* 다건으로 주문은 테이블 행을 클릭하면 주문 상세를 확인할 수 있습니다.
* 회원 ID
  * 회원 ID : 로그인 회원의 주문인 경우 노출
  * "비회원" : 비회원의 주문인 경우

### **상품 랭킹 TOP 100**

<img src="/files/6PPbvYiCqeej7nvzNw72" alt="" width="563">

* 조회 선택
  * 전체 결과 : 전체 기간 동안의 상품 랭킹입니다.
  * 발송 후 30분 : 푸시 발송 후 30분 이내의 상품 랭킹입니다.
* 선택한 전환 기여 기간에 따른 조회 기간 내 해당 캠페인의 푸시를 받고 앱이 오픈된 후 같은 세션 내에서 조회 또는 주문된 상품의 랭킹입니다.
* 상품 랭킹은 1일(발송 당일) 이상의 전환 기여 기간이 선택될 시 표시됩니다. (시간 단위의 전환 기여 기간에서는 제한됩니다.)
* 상품 뷰 수, 주문 수, 전환 금액 순으로 상품 랭킹 확인이 가능합니다
* 해당하는 탭의 데이터가 0인 경우는 제외하고 표시됩니다.
* 상품 랭킹 테이블
  * 상품명 : 등록된 상품의 이름
  * 카테고리 코드 : 상품이 속한 카테고리 코드, 여러 개 카테고리에 등록 됐을 경우 모두 표시
  * 가격 : 상품의 판매가
  * 상품 뷰 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 조회된 횟수
  * 주문 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 주문된 횟수
  * 전환 금액 : 푸시를 받은 후 앱을 열어 해당 세션 내에 주문된 상품 금액의 합계

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}


# 푸시 알림 분석 리포트: 반복 발송

반복 발송으로 발송된 푸시 알림 캠페인의 성과 등의 분석 리포트를 확인합니다.

![](/files/jtbnWPF6cgEXHQR15XUQ)

## **조회 조건**

### **일자별**

발송이 진행된 일자의 독립적인 발송의 통계를 조회하는 방법입니다.

<img src="/files/yeXyGme7JBv30BqGRDNb" alt="" width="563">

#### **조회 조건 선택 - 일자별**

* 발송일 선택 : 푸시 발송이 진행된 일자를 캘린더에서 선택하여 통계를 확인합니다. 발송이 진행된 일자에는 파란 표시가 있습니다.
* 전환 기여 기간 : 푸시 발송일부터 얼마만큼의 기간의 통계를 확인할지 선택합니다.

#### **캠페인 및 리포트 정보**

* 캠페인명 : 캠페인명을 확인합니다. 클릭 시 해당 캠페인의 페이지를 확인할 수 있습니다.
* 상세 설명 : 캠페인의 상세 설명을 확인합니다.
* 상세보기 : 클릭 시 캠페인 설정 요약 사항을 확인할 수 있습니다.
  * 발송 OS : 캠페인 생성 시 설정한 발송 OS를 표시합니다. (전체 / Android / iOS)
  * 발송 목적 : 캠페인 생성 시 설정한 발송 목적을 표시합니다.(광고성 / 정보성)
  * 캠페인 기간
    * 수동 종료 전까지 : "수동 종료 전까지"로 표시되며, 발송 완료 탭으로 이동 시 첫 발송일 \~ 완료일을 표시합니다.
    * 기간 지정 : 캠페인 만들기 시 지정한 기간을 표시합니다.
* 최초 발송일 : 반복 캠페인에서 처음으로 메시지가 발송된 일자입니다.
* 최근 발송 일시 : 현 시점에서 가장 최근에 발송된 푸시의 발송 일시입니다.
* 리포트 기간 : 선택한 발송일과 전환 기여 기간에 따른 분석 리포트 기간입니다.

### **기간별**

<img src="/files/tD6hWOqHW6wowee5WnDD" alt="" width="563">

#### **조회 조건 선택 - 기간별**

* 기간 선택 : 조회하고 싶은 기간의 범위를 선택해서 조회합니다. 발송이 진행된 일자에는 파란 표시가 있습니다.
  * 선택한 기간에 발송된 일자별 통계의 합계를 확인합니다.
  * 한 번에 조회할 수 있는 기간의 최대 범위는 31일이며, 서버 시간 기준 오늘 이전 기간(오늘 제외)을 조회할 수 있습니다.
* 전환 기여 기간 : 푸시 발송일부터 얼마동안의 기간의 통계를 확인할지 선택합니다.
  * 3시간, 6시간, 발송 당일, 3일, 7일의 기간 중 한 기간을 선택하여 해당 기간만큼의 데이터를 확인할 수 있습니다.

#### **캠페인 및 리포트 정보**

* 캠페인명 : 캠페인명을 확인합니다. 클릭 시 해당 캠페인의 페이지를 확인할 수 있습니다.
* 상세 설명 : 캠페인의 상세 설명을 확인합니다.
* 상세보기 : 클릭 시 캠페인 설정 요약 사항을 확인할 수 있습니다.
  * 발송 OS : 캠페인 생성 시 설정한 발송 OS를 표시합니다. (전체 / Android / iOS)
  * 발송 목적 : 캠페인 생성 시 설정한 발송 목적을 표시합니다.(광고성 / 정보성)
* 캠페인 기간
  * 수동 종료 전까지 : "수동 종료 전까지"로 표시되며, 발송 완료 탭으로 이동 시 첫 발송일 \~ 완료일을 표시합니다.
  * 기간 지정 : 캠페인 만들기 시 지정한 기간을 표시합니다.
* 최종 수정일 : 캠페인을 최종으로 수정한 일자가 표시됩니다.
* 최초 발송일 : 반복 캠페인에서 처음으로 메시지가 발송된 일자입니다.
* 최근 발송 일시 : 현 시점에서 가장 최근에 발송된 푸시의 발송 일시입니다.

{% hint style="warning" %}
[반복 발송 캠페인 분석 리포트 조회 유형](/new-admin/notes/report-type) 정책을 확인하세요.

기간에 대한 자세한 설명은 [캠페인 분석 리포트 전환 기여 기간](/new-admin/notes/report-time) 정책을 확인하세요.
{% endhint %}

{% hint style="info" %}
전환 기여 기간은 요약 지표, 퍼널 분석, 데이터 추이, 데이터 테이블에 공통적으로 적용되는 기간입니다.
{% endhint %}

***

## **기본 분석**

<img src="/files/4SgPymtMlHvZHXauskai" alt="" width="563">

### **요약 지표**

<img src="/files/ic6lYRlivkjJ3tHQ0AOi" alt="" width="563">

* 전체 : 전환 기여 기간 동안의 수집된 통계입니다.
* 발송 후 30분 : 푸시 발송 후 30분 이내의 수집된 통계입니다.
* 발송 수 : 푸시 발송 수 입니다. 피로도가 적용된 캠페인은 피로도 적용이 표시가 됩니다.
* 상세보기 : 발송 수 상세를 확인합니다. 피로도 적용했을 시 피로도가 적용되기 전의 발송 대상 수, 피로도가 적용된 수, 실제 발송 요청 수를 확인할 수 있습니다.<br>

  <img src="/files/q6HPVawtnb6vdd1pXfWk" alt="" width="375">

  * 발송 대상 수 : 피로도 적용 전 선택한 전체 타겟의 수 입니다.
  * 피로도 적용 수 : 피로도가 적용되어 발송 요청 대상에서 제외된 수 입니다.
  * 발송 수 : 실제 해당 캠페인에서 발송 요청된 수 입니다.
* 오픈 수 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈한 사용자 수 입니다.
* 회원가입 수 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈하여 회원가입한 회원 수(ID) 입니다.
* 주문 수 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 사용자 수 입니다.
* 전환 금액 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 총 금액입니다.
* 전환율(%)
  * 오픈 전환율 : \[오픈 수 / 발송 수 \* 100] %
  * 회원가입 전환율 : \[회원 가입 수 / 발송 수 \* 100] %
  * 주문 전환율 : \[주문 수 / 발송 수 \* 100] %

### **퍼널 분석**

<img src="/files/1DEfKQkRtmVZ7aHQTzvr" alt="" width="563">

캠페인 발송에서 주문 전환에 이르기까지의 흐름을 시각화하고 단계별 수치를 시각적으로 확인합니다.

* 발송 : 기간 내 푸시가 발송된 사용자 수
* 성공 : 발송 수에서 발송 실패한 수를 제외한 수 (= 발송 - 발송 실패)
* 오픈하지 않음 : 푸시를 발송 했지만 푸시 메시지를 오픈 하지 않은 사용자 수 (= 성공 - 오픈)
* 오픈 : 분석 리포트의 전환 기여 기간 동안 푸시 메시지의 영향을 받아 앱을 오픈한 사용자 수 (= 성공 - 오픈하지 않음)
* (주문 페이지) 진입하지 않음 : 앱 오픈 후 주문 페이지에 도달하지 않은 사용자 수, 오픈 수 에서 주문 페이지 값을 제외한 수 (= 오픈 - 주문 페이지 진입)
* (주문 페이지) 진입 : 앱 오픈 후 주문 페이지에 도달한 사용자 수 (= 오픈 - 주문 페이지 진입하지 않음)
* 주문하지 않음 : 주문 페이지에 도달했지만 주문하지 않은 사용자 수 (= 주문 페이지 - 주문 완료)
* 주문 : 주문을 완료한 사용자 수

{% hint style="danger" %}
**발송 실패 원인**으로는 여러 케이스가 있지만, 크게 3가지 경우가 있습니다.\
1\) PushToken이 유효하지 않을 때 (사용자의 기기가 바뀌거나, 해당 토큰이 expire된 경우)\
2\) 사용자의 디바이스 OS 설정에서 해당 앱의 알림 수신을 OFF한 경우\
3\) 앱을 삭제한 경우
{% endhint %}

{% hint style="warning" %}
iOS 사용자의 경우 간헐적으로 푸시 발송에 성공하였으나 디바이스의 네트워크 상황, 온라인 상태 등으로 인해 실제 기기에 도달하지 못하는 상황이 발생할 수 있습니다.
{% endhint %}

### **데이터 추이**

<img src="/files/8SvRzABXK0vnQDva4CQ4" alt="" width="563">

* 선택한 전환 기여 기간에 따른 조회 기간 내 데이터 테이블에 해당하는 데이터의 시간별 추이 그래프입니다.
* 데이터 추이를 꺾은선 그래프, 막대 그래프 형태로 확인할 수 있습니다.

### **데이터 테이블**

<img src="/files/XIP65FFjQSaJ2mnpfMou" alt="" width="563">

선택한 전환 기여 기간에 따른 조회 기간 내 데이터를 시간별로 확인할 수 있습니다.

* 발송 수 : 푸시 발송 건 수
* 오픈 수 : 푸시 메시지를 받은 후 앱을 오픈한 사용자 수
* 회원가입 수 : 푸시 메시지를 받은 후 앱을 오픈하여 회원 가입한 회원 수(ID)
* 주문 수 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 사용자 수
* 전환 금액 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 총 금액

***

## **주문 상품 분석**

• 캠페인 분석 리포트의 주문 상품 분석을 통해 선택한 캠페인을 통한 주문 이력과 상품 랭킹을 확인할 수 있습니다.

<img src="/files/2i2jEipYh71bsO0TlLIg" alt="" width="563">

### **상세 주문 리스트**

<img src="/files/A145nSZ1HqyufIYHp7p4" alt="" width="563">

* 선택한 전환 기여 기간에 따른 조회 기간 내 해당 캠페인의 클릭 요소가 클릭된 후 같은 세션 내에서 상품이 주문 되었을 때의 주문 이력입니다.
* 주문 일시, 주문 번호, 회원 ID, 주문 금액, 주문 수량, 주문 상품을 확인할 수 있습니다.
* 다건으로 주문은 테이블 행을 클릭하면 주문 상세를 확인할 수 있습니다.
* 회원 ID
  * 회원 ID : 로그인 회원의 주문인 경우 노출
  * "비회원" : 비회원의 주문인 경우

### **상품 랭킹 TOP 100**

<img src="/files/c43qKgpLiKrQwdYP6aZX" alt="" width="563">

* 조회 선택
  * 전체 결과 : 전체 기간 동안의 상품 랭킹입니다.
  * 발송 후 30분 : 푸시 발송 후 30분 이내의 상품 랭킹입니다.
* 선택한 전환 기여 기간에 따른 조회 기간 내 해당 캠페인의 푸시를 받고 앱이 오픈된 후 같은 세션 내에서 조회 또는 주문된 상품의 랭킹입니다.
* 상품 랭킹은 1일(발송 당일) 이상의 전환 기여 기간이 선택될 시 표시됩니다. (시간 단위의 전환 기여 기간에서는 제한됩니다.)
* 상품 뷰 수, 주문 수, 전환 금액 순으로 상품 랭킹 확인이 가능합니다
* 해당하는 탭의 데이터가 0인 경우는 제외하고 표시됩니다.
* 상품 랭킹 테이블
  * 상품명 : 등록된 상품의 이름
  * 카테고리 코드 : 상품이 속한 카테고리 코드, 여러 개 카테고리에 등록 됐을 경우 모두 표시
  * 가격 : 상품의 판매가
  * 상품 뷰 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 조회된 횟수
  * 주문 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 주문된 횟수
  * 전환 금액 : 푸시를 받은 후 앱을 열어 해당 세션 내에 주문된 상품 금액의 합계

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}


# 푸시 알림 분석 리포트: 이벤트 트리거 발송

{% hint style="info" %}
이벤트 트리거 발송 캠페인은 전환 기여 기간 및 퍼널 그래프가 제공되지 않습니다.
{% endhint %}

![](/files/feXcGr9lzlKT3S8gFaJA)

## **조회 조건**

<img src="/files/qtz75tJxLvf2eXOKODyR" alt="" width="563">

### **조회 기간**&#x20;

조회하고 싶은 기간의 범위를 캘린더에서 선택하여 통계를 확인합니다.

### **캠페인 및 리포트 정보**

* 캠페인명 : 캠페인명을 확인합니다. 클릭 시 해당 캠페인의 페이지를 확인할 수 있습니다.
* 상세 설명 : 캠페인의 상세 설명을 확인합니다.
* 상세보기 : 클릭 시 캠페인 설정 요약 사항을 확인할 수 있습니다.
  * 재발송 허용 : 이벤트 트리거 조건을 충족하여 해당 캠페인으로 메시지를 받은 대상이 다시 조건을 충족하면 메시지 재발송 허용 여부를 표시합니다.
    * 허용 : 한 사용자가 조건을 계속 충족하면 같은 캠페인으로 여러 번 메시지를 발송할 수 있습니다.
    * 허용 안 함 : 한 사용자가 조건을 만족했을 최초 한 번만 메시지를 발송합니다.
* 발송 OS : 캠페인 생성 시 설정한 발송 OS를 표시합니다. (전체 / Android / iOS)
* 발송 목적 : 캠페인 생성 시 설정한 발송 목적을 표시합니다.(광고성 / 정보성)
  * 캠페인 기간
    * 수동 종료 전까지 : "수동 종료 전까지"로 표시되며, 발송 완료 탭으로 이동 시 첫 발송일 \~ 완료일을 표시합니다.
    * 기간 지정 : 캠페인 만들기 시 지정한 기간을 표시합니다.
* 최종 수정일 : 캠페인을 최종으로 수정한 일자가 표시됩니다.
* 최초 발송일 : 반복 캠페인에서 처음으로 메시지가 발송된 일자입니다.
* 최근 발송일 : 현 시점에서 가장 최근에 발송된 푸시의 발송 일자입니다.

{% hint style="warning" %}
트리거 발송 분석 리포트는 다음과 같이 적용됩니다.\
\- 동일한 캠페인으로 여러 개의 푸시가 쌓였을 때 푸시 터치없이 앱 오픈 시에는 가장 최근의 푸시에 오픈 수가 집계됩니다.\
\- 발송 한 건에 대한 트래킹(발송일 +7일, 총 8일)기간 안에 전환 이벤트가 발생하면 전환 이벤트 발생일 기준으로 집계됩니다.\
\- 푸시 발송을 여러 번 받았을 시 같은 세션이라면 안에서는 발송 수는 올라가지만, 기타 전환 트래킹은 한 번만 집계될 수 있습니다.
{% endhint %}

***

## **기본 분석**

<img src="/files/VseBiXPTjaTD3ncIoLzD" alt="" width="563">

### **요약 지표**

<img src="/files/4pNvbfEnu0NNEbEL5kt6" alt="" width="563">

* 전체 : 조회 기간 동안의 수집된 통계입니다.
* 발송 후 30분 : 푸시 발송 후 30분 이내의 수집된 통계입니다.
* 발송 수 : 해당 캠페인에서 발송 요청된 수 입니다.
* 오픈 수 : 푸시 메시지의 영향을 받아 앱을 오픈한 사용자 수 입니다.
* 회원가입 수 : 푸시 메시지의 영향을 받아 앱을 오픈하여 회원가입한 회원 수(ID) 입니다.
* 주문 수 : 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 사용자 수 입니다.
* 전환 금액 : 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 총 금액입니다.
* 전환율(%)
  * 오픈 전환율 : \[오픈 수 / 발송 수 \* 100] %
  * 회원가입 전환율 : \[회원 가입 수 / 발송 수 \* 100] %
  * 주문 전환율 : \[주문 수 / 발송 수 \* 100] %

{% hint style="danger" %}
**발송 실패 원인**으로는 여러 케이스가 있지만, 크게 3가지 경우가 있습니다.\
1\) PushToken이 유효하지 않을 때 (사용자의 기기가 바뀌거나, 해당 토큰이 expire된 경우)\
2\) 사용자의 디바이스 OS 설정에서 해당 앱의 알림 수신을 OFF한 경우\
3\) 앱을 삭제한 경우
{% endhint %}

{% hint style="warning" %}
iOS 사용자의 경우 간헐적으로 푸시 발송에 성공하였으나 디바이스의 네트워크 상황, 온라인 상태 등으로 인해 실제 기기에 도달하지 못하는 상황이 발생할 수 있습니다.
{% endhint %}

### **데이터 추이**

<img src="/files/czkniwousftEzUz5urKM" alt="" width="563">

* 선택한 조회 기간 내 데이터 테이블에 해당하는 데이터의 시간별 추이 그래프입니다.
* 데이터 추이를 꺾은선 그래프, 막대 그래프 형태로 확인할 수 있습니다.

### **데이터 테이블**

<img src="/files/kDqKnNVnhiMDuGFUdcPe" alt="" width="563">

조회 기간 내 데이터를 시간별로 확인할 수 있습니다.

* 발송 수 : 푸시 발송 건 수
* 오픈 수 : 푸시 메시지를 받은 후 앱을 오픈한 사용자 수
* 회원가입 수 : 푸시 메시지를 받은 후 앱을 오픈하여 회원 가입한 회원 수(ID)
* 주문 수 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 사용자 수
* 전환 금액 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 총 금액

***

## **주문 상품 분석**

* 캠페인 분석 리포트의 주문 상품 분석을 통해 선택한 캠페인을 통한 주문 이력과 상품 랭킹을 확인할 수 있습니다.

<img src="/files/QYKUzMFFWOw8zHhCjsU4" alt="" width="563">

### **상세 주문 리스트**

<img src="/files/ofRKN7qNyy1ZiUyF8mZx" alt="" width="563">

* 조회 기간 내 해당 캠페인의 클릭 요소가 클릭된 후 같은 세션 내에서 상품이 주문 되었을 때의 주문 이력입니다.
* 주문 일시, 주문 번호, 회원 ID, 주문 금액, 주문 수량, 주문 상품을 확인할 수 있습니다.
* 다건으로 주문은 테이블 행을 클릭하면 주문 상세를 확인할 수 있습니다.
* 회원 ID
  * 회원 ID : 로그인 회원의 주문인 경우 노출
  * "비회원" : 비회원의 주문인 경우

### **상품 랭킹 TOP 100**

<img src="/files/0wTalqL2FKBcs0EqxJu0" alt="" width="563">

* 조회 선택
  * 전체 결과 : 전체 기간 동안의 상품 랭킹입니다.
  * 발송 후 30분 : 푸시 발송 후 30분 이내의 상품 랭킹입니다.
* 조회 기간 내 해당 캠페인의 푸시를 받고 앱이 오픈된 후 같은 세션 내에서 조회 또는 주문된 상품의 랭킹입니다.
* 상품 뷰 수, 주문 수, 전환 금액 순으로 상품 랭킹 확인이 가능합니다
* 해당하는 탭의 데이터가 0인 경우는 제외하고 표시됩니다.
* 상품 랭킹 테이블
  * 상품명 : 등록된 상품의 이름
  * 카테고리 코드 : 상품이 속한 카테고리 코드, 여러 개 카테고리에 등록 됐을 경우 모두 표시
  * 가격 : 상품의 판매가
  * 상품 뷰 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 조회된 횟수
  * 주문 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 주문된 횟수
  * 전환 금액 : 푸시를 받은 후 앱을 열어 해당 세션 내에 주문된 상품 금액의 합계

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}


# 푸시 알림 분석 리포트: API 트리거 발송

{% hint style="info" %}
API 트리거 발송 캠페인은 전환 기여 기간 및 퍼널 그래프가 제공되지 않습니다.
{% endhint %}

![](/files/nZWvgmMdIRXxFlLeosbO)

## **조회 조건**

<img src="/files/LFtnQGFDl4UZAIljUroU" alt="" width="563">

### **조회 기간**

* 조회하고 싶은 기간의 범위를 캘린더에서 선택하여 통계를 확인합니다.

### **캠페인 및 리포트 정보**

* 캠페인명 : 캠페인명을 확인합니다. 클릭 시 해당 캠페인의 페이지를 확인할 수 있습니다.
* 상세 설명 : 캠페인의 상세 설명을 확인합니다.
* 상세보기 : 클릭 시 캠페인 설정 요약 사항을 확인할 수 있습니다.
  * 발송 OS : 캠페인 생성 시 설정한 발송 OS를 표시합니다. (전체 / Android / iOS)
  * 발송 목적 : 캠페인 생성 시 설정한 발송 목적을 표시합니다.(광고성 / 정보성)
  * 캠페인 기간
    * 수동 종료 전까지 : "수동 종료 전까지"로 표시되며, 발송 완료 탭으로 이동 시 첫 발송일 \~ 완료일을 표시합니다.
    * 기간 지정 : 캠페인 만들기 시 지정한 기간을 표시합니다.
* 최종 수정일 : 캠페인을 최종으로 수정한 일자가 표시됩니다.
* 최초 발송일 : 반복 캠페인에서 처음으로 메시지가 발송된 일자입니다.
* 최근 발송일 : 현 시점에서 가장 최근에 발송된 푸시의 발송 일자입니다.

{% hint style="warning" %}
트리거 발송 분석 리포트는 다음과 같이 적용됩니다.\
\- 동일한 캠페인으로 여러 개의 푸시가 쌓였을 때 푸시 터치없이 앱 오픈 시에는 가장 최근의 푸시에 오픈 수가 집계됩니다.\
\- 발송 한 건에 대한 트래킹(발송일 +7일, 총 8일)기간 안에 전환 이벤트가 발생하면 전환 이벤트 발생일 기준으로 집계됩니다.\
\- 푸시 발송을 여러 번 받았을 시 같은 세션이라면 안에서는 발송 수는 올라가지만, 기타 전환 트래킹은 한 번만 집계될 수 있습니다.
{% endhint %}

***

## **기본 분석**

<img src="/files/B8DdpBYOiHLXg8zIjKXs" alt="" width="563">

### **요약 지표**

<img src="/files/vpNjbTGJw3iQxGDWmhRj" alt="" width="563">

* 전체 : 조회 기간 동안의 수집된 통계입니다.
* 발송 후 30분 : 푸시 발송 후 30분 이내의 수집된 통계입니다.
* 오픈 수 : 푸시 메시지의 영향을 받아 앱을 오픈한 사용자 수 입니다.
* 주문 수 : 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 사용자 수 입니다.
* 전환 금액 : 푸시 메시지의 영향을 받아 앱을 오픈하여 주문을 완료한 총 금액입니다.
* 전환율(%)
  * 오픈 전환율 : \[오픈 수 / 발송 수 \* 100] %
  * 주문 전환율 : \[주문 수 / 발송 수 \* 100] %

{% hint style="danger" %}
**발송 실패 원인**으로는 여러 케이스가 있지만, 크게 3가지 경우가 있습니다.\
1\) PushToken이 유효하지 않을 때 (사용자의 기기가 바뀌거나, 해당 토큰이 expire된 경우)\
2\) 사용자의 디바이스 OS 설정에서 해당 앱의 알림 수신을 OFF한 경우\
3\) 앱을 삭제한 경우
{% endhint %}

{% hint style="warning" %}
iOS 사용자의 경우 간헐적으로 푸시 발송에 성공하였으나 디바이스의 네트워크 상황, 온라인 상태 등으로 인해 실제 기기에 도달하지 못하는 상황이 발생할 수 있습니다.
{% endhint %}

### **데이터 추이**

<img src="/files/F3VvCNHkJdS4Y23rLWXN" alt="" width="563">

* 선택한 조회 기간 내 데이터 테이블에 해당하는 데이터의 시간별 추이 그래프입니다.
* 데이터 추이를 꺾은선 그래프, 막대 그래프 형태로 확인할 수 있습니다.

### **데이터 테이블**

<img src="/files/ChR90F4PprMnbT2Qn82B" alt="" width="563">

조회 기간 내 데이터를 시간별로 확인할 수 있습니다.

* 발송 수 : 푸시 발송 건 수
* 오픈 수 : 푸시 메시지를 받은 후 앱을 오픈한 사용자 수
* 주문 수 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 사용자 수
* 전환 금액 : 푸시 메시지를 받은 후 앱을 오픈하여 주문을 완료한 총 금액

***

## **주문 상품 분석**

* 캠페인 분석 리포트의 주문 상품 분석을 통해 선택한 캠페인을 통한 주문 이력과 상품 랭킹을 확인할 수 있습니다.

<img src="/files/JF3j8pGnL93y4zC7Q5hV" alt="" width="563">

### **상세 주문 리스트**

<img src="/files/aFh8aT9vZB9oyUa9O0Jx" alt="" width="563">

* 조회 기간 내 해당 캠페인의 클릭 요소가 클릭된 후 같은 세션 내에서 상품이 주문 되었을 때의 주문 이력입니다.
* 주문 일시, 주문 번호, 회원 ID, 주문 금액, 주문 수량, 주문 상품을 확인할 수 있습니다.
* 다건으로 주문은 테이블 행을 클릭하면 주문 상세를 확인할 수 있습니다.
* 회원 ID
  * 회원 ID : 로그인 회원의 주문인 경우 노출
  * "비회원" : 비회원의 주문인 경우

### **상품 랭킹 TOP 100**

<img src="/files/rEYwhVV8qR9UNrvExbYa" alt="" width="563">

* 조회 선택
  * 전체 결과 : 전체 기간 동안의 상품 랭킹입니다.
  * 발송 후 30분 : 푸시 발송 후 30분 이내의 상품 랭킹입니다.
* 조회 기간 내 해당 캠페인의 푸시를 받고 앱이 오픈된 후 같은 세션 내에서 조회 또는 주문된 상품의 랭킹입니다.
* 상품 뷰 수, 주문 수, 전환 금액 순으로 상품 랭킹 확인이 가능합니다
* 해당하는 탭의 데이터가 0인 경우는 제외하고 표시됩니다.
* 상품 랭킹 테이블
  * 상품명 : 등록된 상품의 이름
  * 카테고리 코드 : 상품이 속한 카테고리 코드, 여러 개 카테고리에 등록 됐을 경우 모두 표시
  * 가격 : 상품의 판매가
  * 상품 뷰 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 조회된 횟수
  * 주문 수 : 푸시를 받은 후 앱을 열어 해당 세션 내에 상품이 주문된 횟수
  * 전환 금액 : 푸시를 받은 후 앱을 열어 해당 세션 내에 주문된 상품 금액의 합계

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}


# 카카오톡 캠페인: 브랜드 메시지

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

## **카카오 브랜드 메시지란?**

카카오 브랜드 메시지는 고객에게 **광고성 메시지**를 발송할 수 있는 서비스입니다.

브랜드 메시지의 가장 큰 특징은 **카카오톡 채널 친구뿐만 아니라 광고성 정보 수신에 동의한 유저**에게도 발송할 수 있다는 점으로, 이벤트, 프로모션 등 다양한 목적의 메시지를 효과적으로 전달할 수 있습니다. 주로 다음과 같은 메시지를 발송하는 데 사용됩니다.

* **프로모션/이벤트 안내:** 할인 행사, 기획전 홍보, 쿠폰 발급, 타임 세일 등 고객의 구매를 유도하는 마케팅 정보를 알립니다.
* **신상품/브랜드 소식:** 신규 상품 출시, 룩북 공개, 브랜드 뉴스레터 등 고객의 관심을 지속시킬 수 있는 소식을 전달합니다.
* **개인화 맞춤 메시지:** 장바구니 미구매 알림, 생일 축하 쿠폰, 등급별 혜택 안내 등 고객의 행동이나 속성에 맞춘 맞춤형 혜택을 제공합니다.

{% hint style="info" %}
광고성 메시지란 정보통신망법상 ‘영리목적의 광고성 정보’에 해당하는 메시지로, 수익을 목적으로 보내는 브랜드 소식이나 상품·서비스 광고를 의미힙니다.
{% endhint %}


# 브랜드 메시지 발송을 위한 사전 준비

카카오 브랜드 메시지를 발송하기 위해서는 다음의 사전 준비가 필요합니다.

## **1. 카카오톡 비즈니스 채널 개설**

기존에 개설된 채널이 없다면, [**카카오톡 비즈니스 채널 만들기**](https://kakaobusiness.gitbook.io/main/channel/start) 가이드를 참고하여 [**카카오 비즈니스**](https://business.kakao.com/)에서 채널을 새로 개설해 주세요.

{% hint style="info" %}
새롭게 개설한 비즈니스 채널의 심사 및 승인까지는 영업일 기준 3\~5일이 소요됩니다.
{% endhint %}

***

## **2. 카카오톡 채널 연동**

{% hint style="warning" %}
카카오톡 채널은 개설 후 다음의 설정이 완료되어야 연동할 수 있습니다.

(1) \[카카오 비즈니스 파트너센터 > 채널 > 채널 정보 > 고객센터 연락처] 전화번호 입력\
(2) \[카카오 비즈니스 파트너센터 > 채널 > 채널 정보 > 옵션 설정 > 채널 공개] ON 상태로 설정
{% endhint %}

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

(1) [**\[카카오톡 설정 > 채널 연동\]**](/new-admin/settings/kakao/channel)에서 <img src="/files/9VHnsJNqVKQBH8eF8VIJ" alt="" data-size="line"> 버튼을 클릭해 주세요.

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

(2) 카카오톡 채널 아이디와 관리자 전화번호를 입력하고 카테고리를 선택한 뒤, <img src="/files/VAxAJpOAzOBaPsmTu4HM" alt="" data-size="line"> 버튼을 클릭해 주세요.

(3) 카카오톡으로 전송된 **인증번호 6자리**를 입력하고 <img src="/files/8Fasg9oMIdyelaojap6z" alt="" data-size="line"> 버튼을 클릭하면 카카오톡 채널 연동이 완료됩니다.&#x20;

{% hint style="danger" %}
채널 연동 오류 시, [**채널 연동 오류 사유별 해결 방법**](/new-admin/settings/kakao/channel)을 참고해 주세요.
{% endhint %}

***

## **3. 개인정보 처리방침 내 수탁자 고지 안내**

관련 법령 미준수로 인한 과태료 부과 등의 불이익을 받지 않도록, [**\[개인정보 처리방침\]**](/new-admin/notes/privacy-policy) 문서를 참고하여 귀사의 개인정보 처리방침 내 '개인정보 처리 위탁 현황' 항목에 수탁자를 고지해 주세요.


# 캠페인 관리

생성한 카카오 브랜드 메시지 캠페인의 현황을 확인하고, 관리(진행, 수정, 삭제 등)하는 페이지입니다.

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

{% hint style="warning" %}
캠페인을 정상적으로 관리하려면, 다음 조건을 모두 만족해야 합니다.

(1) 카카오톡 채널 연동\
(2) 카카오톡 채널 정상 상태\
(3) 발신 프로필 정상 상태\
(4) 캠페인에서 활용 중인 템플릿 승인 상태
{% endhint %}

## **1. 만들기**

<img src="/files/IjgYkvXHKvQx87hawvIp" alt="" data-size="line"> 버튼 클릭 시 **새로운 카카오 브랜드 메시지 캠페인 만들기** 페이지로 이동합니다.

***

## **2. 템플릿 관리**

<img src="/files/jcgnv2bWRClQ7l9EVrNY" alt="" data-size="line"> 버튼 클릭 시 **템플릿 관리** 페이지로 이동합니다.&#x20;

{% hint style="warning" %}
템플릿 관리 페이지로 이동하려면, 다음 조건을 모두 만족해야 합니다.

(1) 카카오톡 채널 정상 상태\
(2) 발신 프로필 정상 상태
{% endhint %}

***

## **3. 미니 대시보드**

미니 대시보드에서는 캠페인 현황과 당월 사용료를 한눈에 파악할 수 있습니다.

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

* **발송 예정:** 오늘 및 7일 이내 발송 예정된 캠페인의 수를 각각 보여줍니다.
* **발송 완료:** 오늘 및 최근 7일 동안 발송 완료된 캠페인의 수를 각각 보여줍니다.
* **당월 사용료:** 이번 달에 발생한 총발송 비용과 지난달 대비 비용 증감률을 함께 보여줍니다. '상세보기'를 클릭하면 월별 상세 내역을 확인할 수 있습니다.

***

## **4. 캠페인 리스트**

### **4-1. 단일 발송**

생성한 단일 발송 캠페인 목록입니다.

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

<table><thead><tr><th width="159.8359375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>캠페인명</strong></td><td>캠페인 생성 시 설정한 이름이며, 클릭 시 수정 페이지로 이동합니다.</td></tr><tr><td><strong>상태</strong></td><td><p>캠페인의 진행 상태를 나타내며, 클릭하여 '진행' 또는 '중지'로 변경할 수 있습니다.</p><ul><li><strong>진행중</strong><img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">: 설정된 스케줄에 따라 캠페인이 진행 중인 상태입니다. 예정된 발송이 완료된 캠페인은 완료 탭으로 자동 이동합니다.</li><li><strong>중지</strong><img src="/files/TRr31QJE6zxLsx5PmtD2" alt="" data-size="line"><strong>:</strong> 캠페인이 일시적으로 중지된 상태입니다. 발송 예정 일시가 되어도 자동으로 진행되지 않습니다.</li></ul></td></tr><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>캠페인 생성 시 집계된 발송 예상 수입니다. 실제 발송 수는 발송 시점에 따라 달라질 수 있습니다.</td></tr><tr><td><strong>발송 예정 일시</strong></td><td>메시지가 발송될 예정 일시 입니다.</td></tr><tr><td><strong>최종 수정일</strong></td><td>캠페인을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

### **4-2. 반복 발송**

생성한 반복 발송 캠페인 목록입니다.

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

<table><thead><tr><th width="159.8359375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>캠페인명</strong></td><td>캠페인 생성 시 설정한 이름이며, 클릭 시 수정 페이지로 이동합니다.</td></tr><tr><td><strong>상태</strong></td><td><p>캠페인의 진행 상태를 나타내며, 클릭하여 '진행' 또는 '중지'로 변경할 수 있습니다.</p><ul><li><strong>진행중</strong><img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">: 설정된 스케줄에 따라 캠페인이 진행 중인 상태입니다.</li><li><strong>중지</strong><img src="/files/TRr31QJE6zxLsx5PmtD2" alt="" data-size="line"><strong>:</strong> 캠페인이 일시적으로 중지된 상태입니다. 발송 예정 일시가 되어도 자동으로 진행되지 않습니다.</li></ul></td></tr><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>메시지가 발송될 예정 일시 입니다.</td></tr><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>캠페인이 진행되는 시작 및 종료 일자입니다. 종료 시점이 지난 캠페인은 완료 탭으로 자동 이동합니다.</td></tr><tr><td><strong>최종 수정일</strong></td><td>캠페인을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

### **4-3. 발송 완료**

설정된 기간이 종료되었거나 수동으로 완료 처리한 캠페인 목록입니다.

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

<table><thead><tr><th width="159.8359375">헤더</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>캠페인에 사용된 템플릿의 현재 상태입니다. (예: 승인, 차단 등)</td></tr><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><ul><li><strong>단일 발송:</strong> 메시지 발송 일시입니다.</li><li><strong>반복 발송:</strong> 캠페인 기간 및 반복 발송 규칙(빈도, 요일, 시간)입니다.</li></ul></td></tr><tr><td><strong>완료 일시</strong></td><td>캠페인이 완료 탭으로 이동한 일시입니다.</td></tr></tbody></table>

### **4-4. 관리 도구**

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

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

<table><thead><tr><th width="160.1015625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/wIrIsQFbNXIu35OPhaS4" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 캠페인을 수정합니다. 단, <strong>이미 발송이 시작된(진행 중, 완료) 캠페인</strong>은 수정할 수 없으며 내용 확인만 가능합니다.</td></tr><tr><td><img src="/files/xHwQYOmNds52LGsy65QX" alt="" data-size="line"> <strong>복사</strong></td><td>선택한 캠페인을 복사하여 동일한 내용의 새로운 캠페인을 생성합니다. 복사된 캠페인은 캠페인명 뒤에 '-COPY'가 추가됩니다.</td></tr><tr><td><img src="/files/96B2sMaulgkXFwUtFWB7" alt="" data-size="line"> <strong>분석 리포트</strong></td><td>해당 캠페인의 성과를 분석 리포트로 확인합니다. <strong>캠페인 발송 이력이 있는 경우(발송 수 1건 이상)에만 활성화</strong>됩니다.</td></tr><tr><td><img src="/files/sdXrs7KYamhq83aIzqbu" alt="" data-size="line"> <strong>미리보기</strong></td><td>메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.</td></tr><tr><td><img src="/files/nZKGcuZF4mQ9N3pUQ4TI" alt="" data-size="line"> <strong>완료 탭으로 이동</strong></td><td>캠페인을 '완료' 탭으로 이동시켜 보관합니다. <strong>'중지' 상태인 캠페인만 이동</strong>할 수 있습니다.</td></tr><tr><td><img src="/files/WCemdenye04VXDipLJHP" alt="" data-size="line"> <strong>삭제</strong></td><td>캠페인을 영구적으로 삭제합니다. <strong>'완료' 상태의 캠페인만 삭제</strong>할 수 있으며, 삭제된 캠페인은 복구할 수 없습니다.</td></tr></tbody></table>

***

## **5. 태그 필터**

캠페인 생성 시 추가한 태그를 기준으로, 원하는 캠페인만 목록에서 필터링하여 볼 수 있습니다.

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

(1) 원하는 태그를 모두 선택(체크)한 후 **\[선택] 버튼**을 클릭해 주세요.

(2) 선택한 태그가 포함된 캠페인만 목록에 표시됩니다.

***

## **6. 검색**

검색창에 캠페인명을 직접 입력하여 원하는 캠페인을 찾을 수 있습니다.


# 캠페인 만들기

캠페인 관리 페이지의 <img src="/files/qhaztNoJhinW5vVJcVDd" alt="" data-size="line"> **버튼**을 클릭하여 새로운 카카오 브랜드 메시지 캠페인을 생성할 수 있습니다.

{% hint style="info" %}
카카오 브랜드 메시지 캠페인은 '스케줄' 발송 방식만 지원됩니다.
{% endhint %}

{% hint style="success" %}
카카오 브랜드 메시지 캠페인은 **승인 상태의 템플릿**이 있어야만 생성할 수 있습니다.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>스케줄 발송</strong></td><td>지정한 발송 일시에 1회 발송하거나, 설정한 반복 주기에 따라 타겟 고객에게 메시지를 정기적으로 발송하는 방식입니다.</td><td><a href="/files/TOBDIImM4HGcI9qaCJdo">/files/TOBDIImM4HGcI9qaCJdo</a></td><td><a href="/pages/FTbgvb3ortgX9R5FvEXy">/pages/FTbgvb3ortgX9R5FvEXy</a></td></tr></tbody></table>


# 스케줄 발송

지정한 발송 일시에 **1회 발송**하거나, 설정한 반복 주기에 따라 타겟 고객에게 메시지를 **정기적으로 발송**하는 방식입니다.

## **1단계: 기본 설정**

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

### **1. 기본 설정**

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

* **캠페인명:** 캠페인의 이름을 입력해 주세요. (문자 구분 없이 최대 40자 입력 가능)
* **상세 설명:** 필요시 캠페인에 대한 상세 설명을 입력해 주세요. (문자 구분 없이 최대 400자 입력 가능)
* **태그 #:** 캠페인에 태그를 설정해 주세요. 캠페인 리스트에서 태그 필터를 통해 캠페인을 필터링할 때 활용됩니다.

### **2. 타겟 설정**

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

#### **2-1. 타겟팅 유형**

메시지를 발송할 타겟을 설정해 주세요.&#x20;

* **모든 회원:** 가입된 전체 회원을 타겟으로 설정합니다.
* **세그먼트:** 미리 생성해 둔 세그먼트를 불러와 해당 조건에 부합하는 고객을 타겟으로 설정합니다.
* **직접 업로드:** 발송할 고객의 전화번호 목록(CSV 파일)을 직접 업로드하여 타겟을 설정합니다.

{% hint style="warning" %}
**모든 회원** 또는 **세그먼트**를 대상으로 발송하려면, 회원 데이터 연동이 필요합니다. **\[설정 > 회원 정보 연동]**&#xC744; 확인해 주세요.
{% endhint %}

{% hint style="info" %}

* 직접 업로드 시 템플릿 파일을 다운로드한 후, [**도움말**](/new-admin/notes/member-upload)을 참고하여 작성해 주세요.
* 업로드된 파일은 캠페인이 **\[발송 완료]** 탭으로 이동한 날로부터 31일간 보관되며, 이후에는 보안을 위해 자동 삭제되어 재사용이 불가능합니다.
  {% endhint %}

#### **2-2. 발송 대상**

설정한 타겟 내에서, 카카오톡 채널 친구 여부 및 광고성 정보 수신 동의 여부에 따라 최종 발송 대상을 선별합니다.

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

* **채널 친구:** 설정한 타겟 중 채널 친구인 사용자에게 메시지를 발송합니다.
* **수신 동의자 중 채널 친구만:** 설정한 타겟 중, 광고성 정보 수신에 동의했으며 채널 친구인 사용자에게 메시지를 발송합니다.
* **수신 동의자 중 채널 친구 제외:** 설정한 타겟 중, 광고성 정보 수신에 동의했으나 채널 친구가 아닌 사용자에게 메시지를 발송합니다.
* **수신 동의자 전체:** 설정한 타겟 중, 광고성 정보 수신에 동의한 모든 사용자에게 메시지를 발송합니다.

#### **2-3. 예상 타겟 수**

설정한 타겟과 발송 대상 조건에 따라 메시지를 받게 될 예상 인원을 확인해 주세요.

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

{% hint style="info" %}

* **메시지 발송 시점**의 **대상자 변동 또는 채널 친구/수신 동의 여부**에 따라, 실제 발송 건수는 예상과 다를 수 있습니다.
* **수신 동의 여부**는 **매일 오전 3시**에 갱신되며, **채널 친구 여부**는 **최근 발송 이력**을 기준으로 추정합니다.
  {% endhint %}

<details>

<summary><strong>예상 타겟 수 산출 방식</strong></summary>

<table><thead><tr><th width="159.8125">발송 대상</th><th>산출 방식</th><th data-hidden>이력상 친구</th><th data-hidden>이력상 비친구</th><th data-hidden>이력 없음</th></tr></thead><tbody><tr><td><strong>채널 친구</strong></td><td><p>최근 이력상 친구 + 확인 예정(미이력) = 예상 타겟 수</p><ul><li>설정한 타겟 전체를 대상으로, 친구일 가능성이 있는 사용자 수</li><li>최근 이력상 '비친구'로 확인된 대상은 제외</li></ul></td><td>O</td><td>X</td><td>O</td></tr><tr><td><p><strong>수신 동의자 중</strong></p><p><strong>채널 친구만</strong></p></td><td><p>수신 동의자 중 이력상 친구 + 수신 동의자 중 확인 예정(미이력) = 예상 타겟 수</p><ul><li>설정한 타겟 중 '광고성 정보 수신 동의자'를 대상으로, 친구일 가능성이 있는 사용자 수</li><li>최근 이력상 '비친구'로 확인된 대상은 제외</li></ul></td><td>O</td><td>X</td><td>O</td></tr><tr><td><p><strong>수신 동의자 중</strong></p><p><strong>채널 친구 제외</strong></p></td><td><p>수신 동의자 중 이력상 비친구 + 수신 동의자 중 확인 예정(미이력) = 예상 타겟 수</p><ul><li>설정한 타겟 중 '광고성 정보 수신 동의자'를 대상으로, 친구가 아닐 가능성이 있는 사용자 수</li><li>최근 이력상 '친구'로 확인된 대상은 제외</li></ul></td><td>X</td><td>O</td><td>O</td></tr><tr><td><strong>수신 동의자 전체</strong></td><td><p>수신 동의자 중 이력상 친구 + 수신 동의자 중 이력상 비친구 + 수신 동의자 중 확인 예정(미이력) = 예상 타겟 수 (설정한 타겟 모수와 동일)</p><ul><li>설정한 타겟 중 '광고성 정보 수신 동의자' 수</li><li>친구 여부와 관계없이 모두 포함</li></ul></td><td>O</td><td>O</td><td>O</td></tr></tbody></table>

{% hint style="info" %}
직접 업로드한 경우 **예상 타겟 수**는 업로드에 성공한 **유효한 전화번호 수**로 표시됩니다.
{% endhint %}

</details>

***

## **2단계: 메시지 설정**

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

### **1. 템플릿 선택**

캠페인에 사용할 템플릿을 선택해 주세요. 템플릿은 검수가 완료된 **승인 상태의 템플릿**만 선택할 수 있습니다.

### **2. 템플릿 정보**

선택한 템플릿에 설정된 상세 정보를 확인할 수 있습니다.

* **기본 설정:** 템플릿의 이름, 메시지 유형과 같은 기본 정보를 보여줍니다.
* **템플릿 메시지:** 실제 발송될 메시지의 본문, 버튼, 쿠폰 등의 내용을 보여줍니다.
* **미리보기:** 메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.

<details>

<summary>메시지 구성 요소별 발송 가능 최대 글자 수</summary>

| 구성 요소       | 발송 가능 최대 글자 수                                                                                                                                                     |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **메시지 본문**  | <ul><li><strong>텍스트 유형:</strong> 1,300자</li><li><strong>이미지 유형:</strong> 1,300자</li><li><strong>와이드 이미지 유형:</strong> 76자 </li></ul>                               |
| **버튼 > 링크** | <ul><li><strong>모바일:</strong> 920자 </li><li><strong>PC:</strong> 920자</li><li><strong>Android:</strong> 1,000자</li><li><strong>iOS:</strong> 1,000자</li></ul>     |
| **쿠폰 > 링크** | <ul><li><strong>모바일:</strong> 1,000자 </li><li><strong>PC:</strong> 1,000자</li><li><strong>Android:</strong> 1,000자</li><li><strong>iOS:</strong> 1,000자</li></ul> |

</details>

### **3. 발송 테스트**

발송하기 전, 메시지가 사용자에게 어떻게 보이는지 미리 확인해볼 수 있습니다.

<figure><img src="/files/8vN0VAaJtXWK8UmuxCh9" alt=""><figcaption></figcaption></figure>

* **전화번호:** 카카오톡 채널 친구로 등록된 전화번호를 입력해 주세요.
* **발송:** 클릭 시 입력한 전화번호로 선택한 템플릿 내용을 담은 메시지가 발송됩니다.

{% hint style="warning" %}
테스트 발송은 **1회 1명**에게만 가능하며, **일반 발송과 동일한 비용**이 발생합니다.
{% endhint %}

***

## **3단계: 옵션 설정**

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

### **1. 스케줄 설정**

#### **1-1. 단일 발송**

지정한 날짜와 시간에 메시지를 한 번만 발송합니다.

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

* **발송 일시:** 메시지를 발송할 날짜와 시간을 지정해 주세요.

#### **1-2. 반복 발송**

캠페인 성격에 따라 설정한 주기(매일, 매주, 매월)에 맞춰 지정된 시간에 메시지를 자동으로 발송합니다.

<figure><img src="/files/7gUQlsMdpELQjq9ohZge" alt=""><figcaption></figcaption></figure>

* **수동 종료 전까지:** 직접 종료하기 전까지 캠페인이 계속 진행됩니다.
* **기간 지정:** 시작일과 종료일을 미리 설정하여, 해당 기간 내에만 캠페인이 진행됩니다.
* **반복 주기:** 캠페인 기간 내 메시지가 발송될 반복 규칙(빈도, 요일)을 설정해 주세요.
* **발송 시간:** 메시지가 발송될 시간을 지정해 주세요.

{% hint style="info" %}
정보통신망법 및 카카오톡 채널 운영 정책에 따라, 브랜드 메시지는 **08:00부터 20:50까지 발송**할 수 있습니다.
{% endhint %}

### **2. 발송 간격 제한**

발송 간격 제한은 같은 대상에게 설정한 기간 동안 메시지가 다시 발송되지 않도록 제한하는 기능입니다. 이 캠페인의 발송 이력, 또는 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 중복·반복 발송을 막을 수 있습니다.

발송 유형(단일 발송 / 반복 발송)에 따라 **적용 범위** 영역이 다르게 표시됩니다.

{% tabs %}
{% tab title="단일 발송" %}

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

적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다.
{% endtab %}

{% tab title="반복 발송" %}

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

적용 범위를 '이 캠페인만 적용' 또는 '같은 그룹 캠페인 포함' 중 선택할 수 있습니다.
{% endtab %}
{% endtabs %}

#### **2-1. 사용 여부 선택**

* **사용 안 함:** 발송 간격 제한을 적용하지 않습니다.
* **사용:** 아래에서 설정한 기준에 따라 같은 대상에게 일정 기간 동안 다시 발송되지 않도록 제한합니다.

#### **2-2. 적용 범위**

발송 간격 제한의 기준이 될 발송 이력의 범위를 선택합니다.

* **이 캠페인만 적용:** 이 캠페인의 발송 이력만 기준으로 제한합니다. (반복 발송에서만 선택할 수 있습니다.)
* **같은 그룹 캠페인 포함:** 같은 발송 제한 그룹에 속한 캠페인의 발송 이력을 함께 확인하여, 같은 대상에게 설정한 제한 기간 동안 다시 발송되지 않도록 제한합니다.

{% hint style="info" %}
단일 발송은 이 캠페인 자체가 반복 발송되지 않으므로, 적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다. 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 제한이 적용됩니다.

e.g. 푸시와 SMS 캠페인을 같은 그룹으로 묶으면, 푸시 발송 대상을 SMS 발송에서 제외할 수 있습니다.
{% endhint %}

#### **2-3. 발송 제한 그룹**

적용 범위가 '같은 그룹 캠페인 포함'일 때 사용할 발송 제한 그룹을 선택합니다.

* **+ 새 그룹 등록:** 새로운 발송 제한 그룹을 즉시 등록할 수 있습니다.
* **그룹 캠페인 보기:** 선택한 그룹을 사용 중인 캠페인 목록을 확인할 수 있습니다.

{% hint style="info" %}
발송 제한 그룹은 설정 > 발송 제한 그룹 관리에서 미리 만들어 둘 수 있습니다. 같은 그룹에 속한 캠페인은 발송 이력을 함께 공유합니다.
{% endhint %}

#### **2-4. 대상 기준**

같은 대상으로 판단할 기준을 선택합니다.

* **전화번호 또는 회원 기준:** 같은 전화번호 또는 같은 회원으로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다. 한 회원이 여러 전화번호를 사용하는 경우에도 중복 발송을 제한할 수 있습니다.
* **전화번호 기준:** 같은 전화번호로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다.

#### **2-5. 제한 기간**

1\~31일 사이로 설정할 수 있습니다.

{% hint style="info" %}
위 기준과 일치하는 대상에게는 마지막 발송일을 기준으로 설정한 제한 기간 동안 다시 발송되지 않습니다. (1\~31일)

e.g. 5월 1일 발송 / 제한 기간 2일 → 5월 1일·2일은 발송되지 않으며, 5월 3일부터 다시 발송할 수 있습니다.
{% endhint %}

### **3. 예상 발송 비용**

예상 타겟 수와 메시지 유형별 단가를 기준으로 산출된 1회 발송 예상 비용을 확인할 수 있습니다.

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

{% hint style="info" %}
예상 비용은 타겟 수를 기준으로 산출된 **부가세(VAT) 별도 금액**이며, 실제 발송 비용과 다를 수 있습니다.
{% endhint %}


# 캠페인 분석 리포트

발송 이력이 있는 캠페인의 성과를 확인하는 페이지입니다.

**링크 버튼 외 클릭 지표(이미지 클릭 수/채널 추가 수/상담**·**문의 수/쿠폰 다운 시도 수)**&#xB294; 템플릿 분석 리포트에서 확인할 수 있습니다.

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

{% hint style="info" %}

* 캠페인 성과는 **발송일로부터 7일간** 집계합니다.
* 클릭 지표는 **링크 버튼(웹/앱)**&#xC5D0; 설정된 **모바일 및 PC 링크**의 클릭 수만 집계합니다
  {% endhint %}

## **1. 조회 기간**

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

* **리포트 기간:** 캠페인 발송일을 시작으로, 설정한 전환 기여 기간까지의 범위입니다.
* **일자별:** 특정 날짜 하루에 대한 발송 성과를 확인합니다.
* **기간별:** 설정한 기간 동안의 발송 성과를 합산하여 확인합니다.
* **전환 기여 기간:** 발송일을 기준으로 설정한 기간 동안 발생한 캠페인 성과를 확인합니다.

{% hint style="info" %}
전환 기여 기간은 메시지 발송 후, 언제까지 발생한 데이터(클릭, 주문 등)를 이 캠페인의 성과로 인정할지 설정하는 기준입니다. 자세한 내용은 [**\[분석 리포트 전환 기여 기간\]**](/new-admin/notes/report-time) 문서를 참고해 주세요.
{% endhint %}

***

## 2. 캠페인 정보

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

* **캠페인명:** 캠페인 생성 시 설정한 이름입니다. 클릭 시 설정한 내용을 확인할 수 있습니다.
* **상세 설명:** 캠페인 생성 시 설정한 상세 설명입니다.
* **발송 일시:** 단일 발송 캠페인을 발송한 날짜와 시간입니다.
* **최초 발송 일시:** 반복 발송 캠페인에서 가장 처음 발송한 날짜와 시간입니다.
* **최근 발송 일시:** 반복 발송 캠페인에서 가장 최근에 발송한 날짜와 시간입니다.
* **활용 템플릿:** 캠페인에 사용된 템플릿의 이름 및 메시지 유형입니다.
* **템플릿 분석 리포트**<img src="/files/ZI01fyOKmb8Uv8Fmqzd3" alt="" data-size="line">**:** 클릭 시 활용 템플릿의 분석 리포트로 이동합니다.

### **2.1 캠페인 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 캠페인 상세 정보를 확인할 수 있습니다.

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

* **작성일:** 캠페인이 생성된 날짜입니다.
* **반복 주기:** 캠페인 기간 내 메시지가 발송되는 반복 규칙(빈도, 요일, 시간)입니다.
* **캠페인 기간:** 캠페인이 진행되는 시작 및 종료 일자입니다.
* **최종 수정일:** 캠페인을 가장 최근에 수정한 날짜입니다.

***

## **3. 기본 분석**

### **3-1. 요약 지표**

<figure><img src="/files/5yC7eUThdcoW293OPKZN" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="159.7109375">지표</th><th>설명</th></tr></thead><tbody><tr><td><strong>발송 수</strong></td><td><ul><li><strong>단일 발송:</strong> 발송을 요청한 수입니다.</li><li><strong>반복 발송:</strong> 설정한 조회 기간 동안 발송을 요청한 수입니다.</li></ul></td></tr><tr><td><strong>발송 성공 수</strong></td><td><ul><li><strong>단일 발송:</strong> 발송을 성공한 수입니다.</li><li><strong>반복 발송:</strong> 설정한 조회 기간 동안 발송을 성공한 수입니다.</li></ul></td></tr><tr><td><strong>클릭 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액</strong></td><td>전환 기여 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>발송 성공률</strong></td><td>발송 수 대비 발송에 성공한 비율입니다. (발송 성공 수/발송 수 * 100%)</td></tr><tr><td><strong>클릭 전환율</strong></td><td>발송 성공 수 대비 웹 링크 또는 앱 링크 버튼을 클릭한 비율입니다. (클릭 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>주문 전환율</strong></td><td>발송 성공 수 대비 주문을 완료한 비율입니다. (주문 수/발송 성공 수 * 100%)</td></tr></tbody></table>

{% hint style="info" %}
**세션(Session)이란?:** 한 명의 방문자가 사이트에 접속해서 활동하는 시간의 단위를 의미합니다.

* **세션 종료:** 마지막 행동 후 30분 동안 아무런 움직임이 없으면 세션은 자동으로 종료됩니다.
* **세션 기준:** 세션은 그루비가 발행하는 쿠키(Cookie)를 기준으로 구분됩니다.
  {% endhint %}

### **3-2. 발송 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 전체 타겟 수와 피로도 관리로 인해 제외된 상세 수치를 확인할 수 있습니다.

<figure><img src="/files/5rnxJ3rcAtB032x9MGtM" alt=""><figcaption></figcaption></figure>

* **발송 대상 수:** 피로도를 적용하기 전 최초 타겟 수입니다.
* **피로도 적용 수:** 설정된 피로도로 인해 발송 대상에서 제외된 수입니다.
* **발송 수:** 발송 대상에서 피로도 적용 수를 제외한, 실제로 발송을 요청한 수입니다.

### **3-3. 클릭 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 수**를 확인할 수 있습니다.

<figure><img src="/files/9rpmftQ07DQpizjqXjQ3" alt=""><figcaption></figcaption></figure>

* **클릭 요소:** 템플릿 메시지에 추가된 **웹 링크 또는 앱 링크 버튼**입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 수:** 해당 클릭 요소에서 발생한 클릭 수입니다.

### 3-4. 클릭 전환율 상세

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 전환율**을 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가된 웹 링크 또는 앱 링크 버튼입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 전환율:** 해당 클릭 요소에 대한 클릭 전환율입니다.

### **3-5. 퍼널 분석**

조회한 모든 발송일 기준, 전환 기여 기간 동안 클릭부터 최종 주문까지 이어지는 단계별 전환 성과를 퍼널 그래프로 확인할 수 있습니다.

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

### **3-6. 데이터 추이**

조회한 모든 발송일 기준, 전환 기여 기간 동안의 클릭 및 주문 수 변화 추이를 시간별 그래프로 확인할 수 있습니다.

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

### **3-7. 데이터 테이블**

조회한 모든 발송일 기준, 전환 기여 기간 동안의 시간별 성과 데이터를 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>해당 시간에 발송 수 대비 발송에 성공한 비율입니다.</td></tr><tr><td><strong>클릭 수</strong></td><td>해당 시간에 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>해당 시간에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>해당 시간에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>

***

## **4. 주문 상품 분석**

### **4-1. 상세 주문 리스트**

조회한 모든 발송일 기준, 전환 기여 기간 동안 클릭 후 발생한 주문의 상세 이력을 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>회원 ID</strong></td><td>주문한 회원의 ID입니다. 비로그인 또는 비회원 주문 시 '비로그인'으로 표시됩니다.</td></tr><tr><td><strong>주문 금액(원)</strong></td><td>해당 주문에서 발생한 주문 금액입니다.</td></tr><tr><td><strong>주문 수량</strong></td><td>해당 주문에 포함된 상품의 총 수량입니다.</td></tr><tr><td><strong>주문 상품</strong></td><td>해당 주문에 포함된 모든 상품 목록입니다. 행(Row)을 클릭하면 전체 상품명을 확인할 수 있습니다.</td></tr></tbody></table>

### **4-2. 상품 랭킹 TOP 100**

조회한 모든 발송일 기준, 전환 기여 기간 동안 주문된 상품의 랭킹을 상품 뷰 수, 주문 수, 전환 금액 순으로 확인할 수 있습니다.

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

<table><thead><tr><th width="159.64453125">헤더</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>상품의 판매가입니다.</td></tr><tr><td><strong>상품 뷰 수</strong></td><td><strong>클릭 후 해당 상품이 조회된 수</strong>입니다. 같은 세션 내 모든 조회 수를 합산하여 집계합니다.</td></tr><tr><td><strong>주문 수</strong> </td><td><strong>클릭 후 해당 상품이 주문된 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td><strong>클릭 후 해당 상품이 주문된 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>


# 템플릿 관리

생성한 카카오 브랜드 메시지 템플릿의 현황을 확인하고, 관리(수정, 삭제 등)하는 페이지입니다.

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

## **1. 만들기**

<img src="/files/XiTtBIlKuzfnmh0jhP4W" alt="" data-size="line"> 버튼 클릭 시 **새로운** **카카오 브랜드 메시지 템플릿 만들기 페이지**로 이동합니다.

{% hint style="warning" %}
템플릿을 생성하려면, **카카오톡 채널을 연동**해야합니다.
{% endhint %}

***

## **2. 템플릿 리스트**

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

<table><thead><tr><th width="159.8359375">헤더</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>가장 최근에 템플릿 상태가 변경된 날짜입니다.</td></tr><tr><td><strong>캠페인 활용</strong></td><td><p>해당 템플릿이 현재 캠페인에서 사용 중인지 여부를 나타냅니다.</p><ul><li><strong>활용:</strong> 1개 이상의 캠페인에서 사용 중인 상태입니다.</li><li><strong>미활용:</strong> 해당 템플릿을 사용 중인 캠페인이 없는 상태입니다.</li></ul></td></tr><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>템플릿을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

<details>

<summary><strong>템플릿 상태</strong></summary>

<table><thead><tr><th width="159.796875">상태</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/bsqlvvYC9RLLrxdEBt3B" alt="" data-size="line"> <strong>승인</strong></td><td>생성이 완료되어 즉시 발송 가능한 상태입니다. 별도의 검수 과정이 없습니다.</td></tr><tr><td><img src="/files/gFs0pzJZd9JoHmUNLlxx" alt="" data-size="line"> <strong>차단</strong></td><td>카카오 운영 정책 위반으로 관리자에 의해 차단된 상태입니다.<br>차단 해제는 groobee_sales@plateer.com로 문의해 주세요.</td></tr></tbody></table>

</details>

***

## **3. 템플릿 상세**

템플릿 리스트의 행(Row) 클릭 시 해당 템플릿에 대한 세부 정보를 확인할 수 있습니다.

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

* **상태 변경 이력:** 템플릿의 상태가 '승인', '차단' 등으로 변경된 모든 이력을 보여줍니다.
* **캠페인 활용 목록:** 템플릿을 사용중인 모든 캠페인을 확인할 수 있습니다.

***

## **4. 관리 도구**

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

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

<table><thead><tr><th width="160.03515625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/0XwdQjEr68wmbufloTF3" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 템플릿의 내용을 수정합니다. 발송 이력이 없는 <strong>'승인' 상태의 템플릿만</strong> 수정할 수 있으며, 다른 상태에서는 내용 확인만 가능합니다.</td></tr><tr><td><img src="/files/lKGhMBRAGoYf4ibAMzxK" alt="" data-size="line"> <strong>복사</strong></td><td>선택한 템플릿과 동일한 내용의 새 템플릿을 생성합니다. 복사본은 '승인' 상태이며, 템플릿명 뒤에 '-COPY'가 붙습니다.</td></tr><tr><td><img src="/files/TRzD5KfQecFQfReTpyh1" alt="" data-size="line"> <strong>분석 리포트</strong></td><td>해당 템플릿의 성과를 분석 리포트로 확인합니다. <strong>템플릿을 사용한 캠페인의 발송 이력이 있는 경우(발송 수 1건 이상)에만</strong> 활성화됩니다.</td></tr><tr><td><img src="/files/nJZj5U3HnszH6eILSoJx" alt="" data-size="line"> <strong>미리보기</strong></td><td>메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.</td></tr><tr><td><img src="/files/IMev3uE8t5yBMwGc1BIj" alt="" data-size="line"> <strong>삭제</strong></td><td>템플릿을 영구적으로 삭제합니다. 발송 이력이 없는 <strong>'승인' 상태의 템플릿또는 차단 상태의 템플릿만</strong> 삭제할 수 있으며, 삭제된 템플릿은 복구할 수 없습니다.</td></tr></tbody></table>

***

## **5. 태그 필터**

템플릿 생성 시 추가한 태그를 기준으로, 원하는 캠페인만 목록에서 필터링하여 볼 수 있습니다.

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

(1) 원하는 태그를 모두 선택(체크)한 후 **\[선택] 버튼**을 클릭해 주세요.

(2) 선택한 태그가 포함된 템플릿만 목록에 표시됩니다.

***

## **6. 검색**

검색창에 템플릿명을 직접 입력하여 원하는 템플릿을 찾을 수 있습니다.


# 템플릿 만들기

템플릿 관리 페이지의 <img src="/files/5B0jn1jTvVpKXqBmXUxB" alt="" data-size="line"> 버튼을 클릭하여 새로운 카카오 브랜드 메시지 템플릿을 생성할 수 있습니다.

<figure><img src="/files/0SfDaWDgJt4V1A8jDG4E" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
브랜드 메시지 템플릿은 별도의 검수 절차 없이, 생성 즉시 사용할 수 있습니다.
{% endhint %}

## **1. 기본 설정**

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

* **템플릿명:** 템플릿의 이름을 입력해 주세요. (문자 구분 없이 최대 200자 입력 가능)
* **메시지 유형:** 캠페인 목적에 적합한 메시지 유형을 선택해 주세요. 유형 변경 시, 입력한 내용은 해당 유형의 최대 규격에 맞춰 자동으로 조정됩니다.
* **태그 #:** 템플릿에 태그를 설정해 주세요. 템플릿 리스트에서 태그 필터를 통해 템플릿을 필터링할 때 활용됩니다.

***

## **2. 템플릿 메시지 작성**

캠페인 목적에 맞는 유형을 선택하고, 필요한 구성 요소를 활성화하여 메시지를 작성해 주세요.

### **2-1. 메시지 유형별 안내**

{% tabs %}
{% tab title="텍스트" %}

<figure><img src="/files/8vOETHhE4xUmf3nJYgpv" alt=""><figcaption></figcaption></figure>

| 구성 요소        | 설명                                                                                                                                              |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **내용**       | <ul><li><strong>입력 제한:</strong> 문자 구분 없이 최대 1,000자 입력 가능 (줄바꿈 최대 99회) </li><li><strong>발송 제한:</strong> 치환될 변수 값을 포함하여 최대 1,300자 발송 가능</li></ul> |
| **버튼**       | <ul><li><strong>버튼 개수:</strong> 최대 5개 추가 가능</li><li><strong>쿠폰 첨부 시:</strong> 최대 4개 추가 가능</li></ul>                                             |
| **쿠폰**       | <ul><li><strong>쿠폰 개수:</strong> 최대 1개 추가 가능</li><li><strong>버튼 5개 추가 시:</strong> 추가 불가</li></ul>                                                |
| {% endtab %} |                                                                                                                                                 |

{% tab title="이미지" %}

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

| 구성 요소        | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이미지**      | <ul><li><p><strong>파일 업로드</strong></p><ul><li><strong>파일 형식:</strong> JPG, JPEG, PNG</li><li><strong>파일 용량:</strong> 최대 5MB</li><li><strong>파일 개수:</strong> 최대 1개</li><li><strong>이미지 비율:</strong> 가로:세로 2:1 \~ 3:4</li><li><strong>이미지 사이즈:</strong> 가로 500px 이상, 800x400 권장</li></ul></li><li><p><strong>이미지 링크</strong></p><ul><li>이미지 클릭 시 이동할 랜딩 페이지를 설정할 수 있습니다.</li><li>http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li></ul></li></ul> |
| **내용**       | <ul><li><strong>입력 제한:</strong> 문자 구분 없이 최대 1,000자 입력 가능 (줄바꿈 최대 99회) </li><li><strong>발송 제한:</strong> 치환될 변수 값을 포함하여 최대 1,300자 발송 가능</li></ul>                                                                                                                                                                                                                                                                                                                                   |
| **버튼**       | <ul><li><strong>버튼 개수:</strong> 최대 5개 추가 가능</li><li><strong>쿠폰 첨부 시:</strong> 최대 4개 추가 가능</li></ul>                                                                                                                                                                                                                                                                                                                                                                               |
| **쿠폰**       | <ul><li><strong>쿠폰 개수:</strong> 최대 1개 추가 가능</li><li><strong>버튼 5개 추가 시:</strong> 추가 불가</li></ul>                                                                                                                                                                                                                                                                                                                                                                                  |
| {% endtab %} |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

{% tab title="와이드 이미지" %}

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

| 구성 요소         | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이미지**       | <ul><li><p><strong>파일 업로드</strong></p><ul><li><strong>파일 형식:</strong> JPG, JPEG, PNG</li><li><strong>파일 용량:</strong> 최대 5MB</li><li><strong>파일 개수:</strong> 최대 1개</li><li><strong>이미지 비율:</strong> 가로:세로 2:1 \~ 1:1</li><li><strong>이미지 사이즈:</strong> 가로 500px 이상, 800x600 권장</li></ul></li><li><p><strong>이미지 링크</strong></p><ul><li>이미지 클릭 시 이동할 랜딩 페이지를 설정할 수 있습니다.</li><li>http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li></ul></li></ul> |
| **내용**        | <ul><li><strong>입력 제한:</strong> 문자 구분 없이 최대 76자 입력 가능 (줄바꿈 최대 5회) </li><li><strong>발송 제한:</strong> 치환될 변수 값을 포함하여 최대 1,300자 발송 가능</li></ul>                                                                                                                                                                                                                                                                                                                                       |
| **버튼**        | <ul><li><strong>버튼 개수:</strong> 최대 5개 추가 가능</li><li><strong>쿠폰 첨부 시:</strong> 최대 4개 추가 가능</li></ul>                                                                                                                                                                                                                                                                                                                                                                               |
| **쿠폰**        | <ul><li><strong>쿠폰 개수:</strong> 최대 1개 추가 가능</li><li><strong>버튼 5개 추가 시:</strong> 추가 불가</li></ul>                                                                                                                                                                                                                                                                                                                                                                                  |
| {% endtab %}  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| {% endtabs %} |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

{% hint style="warning" %}
아래 유의사항을 참고하여 메시지를 작성해 주세요.

(1) 실제 데이터(변수 또는 대체값)로 치환된 최종 길이가 발송 제한 글자 수를 넘지 않도록 주의해 주세요.\
(2) 메시지에는 [**https://www.emojiengine.com/ko**](https://www.emojiengine.com/ko)에서 확인되는 기본 이모지 및 카카오톡 이모티콘만 사용할 수 있습니다.
{% endhint %}

### **2-2. 개인화 변수 추가**

<img src="/files/eruMmrftrvYAsSBxEPLE" alt="" data-size="line"> 버튼을 클릭하여 개인화 변수를 메시지 내용에 추가할 수 있습니다.

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

* **변수:** 메시지에 추가할 개인화 변수를 선택해 주세요.&#x20;
* **대체 발송 값:** 회원의 정보가 없을 경우 대체하여 발송할 값을 입력해 주세요. (문자 구분 없이 최대 10자 입력 가능)
* **미리보기:** 메시지에 삽입되는 텍스트입니다. 발송 시에는 각 회원의 개인화된 정보(예: 회원 이름)로 치환하여 메시지를 발송합니다.

{% hint style="warning" %}
서로 다른 변수는 **최대 10개**까지 추가할 수 있습니다.
{% endhint %}

{% hint style="info" %}
사용할 변수는 [**\[설정 > 개인화 변수 설정\]**](/new-admin/settings/user-property)에서 추가해 주세요.
{% endhint %}

### **2-3. 버튼**

<img src="/files/UgNjq0tMlWtmJ1ZPwA8E" alt="" data-size="line"> 버튼을 클릭하여 메시지에 버튼을 추가할 수 있습니다.

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

| 버튼 유형      | 버튼명                                                                                                                             | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **채널 추가**  | '채널 추가' 고정 노출                                                                                                                   | <p>클릭 시 발신자의 채널을 추가합니다.</p><p>이미 채널을 추가한 수신자에게는 버튼이 보이지 않습니다.</p>                                                                                                                                                                                                                                                                                                                                                                                      |
| **웹 링크**   | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul>        | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 920자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 920자 발송 가능)</li></ul>                                                                                                                                                                                         |
| **앱 링크**   | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>Android:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>iOS:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 920자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 920자 발송 가능)</li></ul> |
| **봇 키워드**  | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <p>클릭 시 '버튼명'을 상담원에게 전달합니다. </p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채팅 > 채팅 설정]에서 '<strong>1:1 채팅 사용' ON</strong>한 채널에서만 정상 동작합니다.</li><li>'1:1 채팅 사용 OFF'한 경우 채팅이 OFF 되었다는 안내 메시지가 전달됩니다.</li></ul>                                                                                                                                                                                                 |
| **메시지 전달** | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <p>클릭 시 '버튼명+메시지 본문'을 상담원에게 전달합니다. </p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채팅 > 채팅 설정]에서 '<strong>1:1 채팅 사용' ON</strong>한 채널에서만 정상 동작합니다.</li><li>'1:1 채팅 사용 OFF'한 경우 채팅이 OFF 되었다는 안내 메시지가 전달됩니다.</li></ul>                                                                                                                                                                                          |
| **상담톡 전환** | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <p>클릭 시 상담톡으로 전환됩니다.</p><ul><li>상담톡을 이용하지 않는 채널에서 해당 버튼을 추가할 경우 발송 실패 처리됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                 |
| **봇 전환**   | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 14자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 8자 입력 가능</li></ul> | <p>클릭 시 챗봇이 호출됩니다.</p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채널 > 챗봇 연결]에서 챗봇과 채널을 연결해야 정상 동작합니다.</li></ul>                                                                                                                                                                                                                                                                                             |

{% hint style="info" %}
모바일 환경 전용 링크 버튼(모바일/Android/iOS)은 PC 카카오톡에서 노출되지 않습니다.&#x20;
{% endhint %}

{% hint style="warning" %}
버튼명에는 이모지 또는 이모티콘을 사용할 수 없습니다.
{% endhint %}

<details>

<summary><strong>수신자의 실행 환경에 따른 링크 동작</strong></summary>

| 실행 환경   | 1순위        | 2순위    | 3순위   |
| ------- | ---------- | ------ | ----- |
| Android | Android 링크 | 모바일 링크 | PC 링크 |
| iOS     | iOS 링크     | 모바일 링크 | PC 링크 |
| PC      | PC 링크      | 모바일 링크 | -     |

{% hint style="info" %}
수신 환경에 맞는 1순위 링크(앱)가 실행되지 않을 경우 자동으로 2순위 링크(웹)로 연결됩니다.
{% endhint %}

</details>

### **2-4. 쿠폰**

<img src="/files/O6dnb9RjN86R3m4Xdzqc" alt="" data-size="line"> 버튼을 클릭하여 쿠폰을 활성화하면, 메시지에 쿠폰을 추가할 수 있습니다.

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

| 쿠폰 유형      | 쿠폰명                         | 쿠폰 설명                                                                                                                            |
| ---------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **할인 금액**  | 1\~99,999,999 범위의 숫자만 입력 가능 | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul>        |
| **할인율**    | 1\~100 범위의 숫자만 입력 가능        | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul>        |
| **배송비 할인** | '배송비 할인 쿠폰' 고정 노출           | <ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul>        |
| **무료 증정**  | 문자 구분 없이 최대 7자 입력 가능        | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul> |
| **업그레이드**  | 문자 구분 없이 최대 7자 입력 가능        | <p></p><ul><li><strong>텍스트/이미지:</strong> 문자 구분 없이 최대 12자 입력 가능</li><li><strong>와이드 이미지:</strong> 문자 구분 없이 최대 18자 입력 가능</li></ul> |

#### **2-4-1. 쿠폰 링크**

쿠폰 클릭 시 연결될 페이지의 링크를 입력해 주세요.

| 링크 유형     | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **직접 입력** | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>Android:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>iOS:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li></ul> |
| **채널 쿠폰** | <p><a href="https://kakaobusiness.gitbook.io/main/channel/run/biztool#id-1"><strong>카카오 쿠폰 작성 가이드</strong></a>를 참고하여 쿠폰을 작성 후, 해당 쿠폰의 URL을 입력해 주세요.</p><p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>Android:</strong> alimtalk=coupon://를 포함한 딥 링크를 입력해 주세요.</li><li><strong>iOS:</strong> alimtalk=coupon://를 포함한 딥 링크를 입력해 주세요.</li></ul>                                                                                                             |

{% hint style="info" %}
모바일 환경 전용 쿠폰(모바일/Android/iOS)은 PC 카카오톡에서 노출되지 않습니다.&#x20;
{% endhint %}

{% hint style="warning" %}
외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.
{% endhint %}

{% tabs %}
{% tab title="채널 쿠폰 URL 위치" %}
**\[카카오톡 채널 관리자 센터 > 비즈니스 도구 > 쿠폰 목록 > 쿠폰 상세 > 브랜드 메시지 URL 복사]** &#x20;

<figure><img src="/files/XA9Yj2lVxkQlim0CBgLj" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="채널 쿠폰 예시" %}
**\[온라인 쿠폰]**

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

**\[오프라인 쿠폰]**

<figure><img src="/files/Se3BxiXUJAEBA6feqQBQ" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

<details>

<summary><strong>수신자의 실행 환경에 따른 링크 동작</strong></summary>

| 실행 환경   | 1순위        | 2순위    | 3순위   |
| ------- | ---------- | ------ | ----- |
| Android | Android 링크 | 모바일 링크 | PC 링크 |
| iOS     | iOS 링크     | 모바일 링크 | PC 링크 |
| PC      | PC 링크      | 모바일 링크 | -     |

{% hint style="info" %}
수신 환경에 맞는 1순위 링크(앱)가 실행되지 않을 경우 자동으로 2순위 링크(웹)로 연결됩니다.
{% endhint %}

</details>

### **2-5. 연령 인증 메시지**

청소년에게 부적절한 업종 및 관련 콘텐츠 포함된 경우, 성인 인증을 완료한 사용자만 내용을 볼 수 있도록 설정할 수 있습니다.

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

{% hint style="info" %}
연령 인증 메시지는 **20세 이상 성인만 확인**할 수 있으며, 인증 전까지는 내용이 가려집니다.&#x20;
{% endhint %}

<details>

<summary><strong>연령 인증 메시지 가이드</strong></summary>

청소년에게 부적절한 콘텐츠가 포함된 경우, 아래 기준을 준수해야만 발송 가능합니다.

* **일반 유해 콘텐츠:** 메시지 발송 설정 시 ‘연령 인증 메시지’로 설정해야 합니다.
* **주류 및 전자담배 (판매/제조 등):** 카카오톡 채널 자체를 ‘성인인증 채널’로 전환해야 합니다. *(※ 단, 성인인증 채널인 경우 메시지 내 연령 인증 기능은 생략 가능)*

**\[필수 적용 대상]**\
청소년 이용불가 등급의 게임, 영화/비디오, 음반, 웹툰, 간행물/서적, 기타 청소년 유해 업종 및 콘텐츠

</details>

***

## **3. 미리보기**

작성 중인 메시지가 사용자에게 어떻게 보일지 실시간으로 확인할 수 있습니다.

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

{% hint style="info" %}
미리보기는 **참고용으로 제공**되며, 실제 메시지는 수신자의 기기나 앱 환경에 따라 다르게 보일 수 있습니다.
{% endhint %}


# 템플릿 분석 리포트

발송 이력이 있는 템플릿의 성과를 확인하는 페이지입니다.&#x20;

템플릿 분석 리포트는 **해당 템플릿을 활용한 모든 캠페인의 종합 성과**를 보여주며, **링크 버튼 외 클릭 지표(이미지 클릭 수/채널 추가 수/상담**·**문의 수/쿠폰 다운 시도 수)**&#xB294; **다음 날 오전 7시**에 업데이트됩니다.

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

{% hint style="info" %}

* 템플릿 성과는 **발송일로부터 3일간** 집계합니다.
* 클릭 지표는 **링크 버튼(웹/앱)**&#xC5D0; 설정된 **모바일 및 PC 링크**의 클릭 수만 집계합니다
  {% endhint %}

{% hint style="warning" %}
템플릿의 **발송 성공 수가 11건 이상**일 경우에만 **이미지 클릭 수,** **채널 추가 수, 상담·문의 수, 쿠폰 다운 시도 수를 집계**할 수 있습니다.
{% endhint %}

## **1. 조회 기간**

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

* **일자별:** 특정 날짜 하루 동안의 발송 성과를 합산하여 확인합니다.
* **기간별:** 설정한 기간 동안의 발송 성과를 합산하여 확인합니다.
* **전환 기여 기간:** 발송일을 기준으로 설정한 기간 동안 발생한 템플릿 성과를 확인합니다. (카카오 통계 정책에 따라, 브랜드 메시지 템플릿 분석 리포트의 전환 기여 기간은 **3일**로 고정되어 제공됩니다.)

{% hint style="info" %}
전환 기여 기간은 메시지 발송 후, 언제까지 발생한 데이터(클릭, 주문 등)를 이 캠페인의 성과로 인정할지 설정하는 기준입니다. 자세한 내용은 [**\[분석 리포트 전환 기여 기간\]**](/new-admin/notes/report-time) 문서를 참고해 주세요.
{% endhint %}

***

## **2. 템플릿 정보**

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

* **템플릿명:** 템플릿 생성 시 설정한 이름이며, 클릭 시 수정 페이지로 이동합니다.
* **최초 발송 일시:** 템플릿을 활용하여 가장 처음 발송한 날짜 및 시간입니다.
* **최근 발송 일시:** 템플릿을 활용하여 가장 최근에 발송한 날짜 및 시간입니다.

### **2-1. 템플릿 상세**

<img src="/files/f9bhtA3sNXdSCES9ZfLV" alt="" data-size="line"> 클릭 시 템플릿 상세 정보를 확인할 수 있습니다.

<figure><img src="/files/91YmoWaspIICNsXv6SDe" alt=""><figcaption></figcaption></figure>

* **템플릿 상태:** 템플릿의 현재 상태입니다. (예: 승인, 차단)
* **작성일**: 템플릿이 생성된 날짜입니다.
* **최종 수정일:** 템플릿을 가장 최근에 수정한 날짜입니다.

***

## **3. 기본 분석**

### **3-1. 요약 지표**

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

<table><thead><tr><th width="159.7109375">지표</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>전환 기여 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액</strong></td><td>전환 기여 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>이미지 클릭 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>이미지를 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>채널 추가 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>채널 추가 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>상담·문의 수</strong></td><td>전환 기여 동안 메시지의 <strong>봇 키워드, 메시지 전달, 봇 전환, 상담톡 전환, 전화하기 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>쿠폰 다운 시도 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>쿠폰을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>발송 성공률</strong></td><td>발송 수 대비 발송에 성공한 비율입니다. (발송 성공 수/발송 수 * 100%)</td></tr><tr><td><strong>클릭 전환율</strong></td><td>발송 성공 수 대비 웹 링크 또는 앱 링크 버튼을 클릭한 비율입니다. (클릭 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>채널 추가 전환율</strong></td><td>발송 성공 수 대비 채널을 추가한 비율입니다. (채널 추가 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>쿠폰 다운 시도 전환율</strong></td><td>발송 성공 수 대비 쿠폰을 클릭한 비율입니다. (쿠폰 다운 시도 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>주문 전환율</strong></td><td>발송 성공 수 대비 주문을 완료한 비율입니다. (주문 수/발송 성공 수 * 100%)</td></tr></tbody></table>

{% hint style="info" %}
**세션(Session)이란?:** 한 명의 방문자가 사이트에 접속해서 활동하는 시간의 단위를 의미합니다.

* **세션 종료:** 마지막 행동 후 30분 동안 아무런 움직임이 없으면 세션은 자동으로 종료됩니다.
* **세션 기준:** 세션은 그루비가 발행하는 쿠키(Cookie)를 기준으로 구분됩니다.
  {% endhint %}

### **3-2. 발송 수 상세**

<img src="/files/f9bhtA3sNXdSCES9ZfLV" alt="" data-size="line"> 클릭 시 전체 타겟 수와 피로도 관리로 인해 제외된 상세 수치를 확인할 수 있습니다.

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

* **발송 대상 수:** 피로도를 적용하기 전 최초 타겟 수입니다.
* **피로도 적용 수:** 설정된 피로도로 인해 발송 대상에서 제외된 수입니다.
* **발송 수:** 발송 대상에서 피로도 적용 수를 제외한, 실제로 발송을 요청한 수입니다.

### **3-3. 클릭 수 상세**

<img src="/files/f9bhtA3sNXdSCES9ZfLV" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 수**를 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가된 웹 링크 또는 앱 링크 버튼입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 수:** 해당 클릭 요소에서 발생한 클릭 수입니다.

### **3-4. 상담·문의 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **상담·문의 버튼별 클릭 수**를 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가된 상담·문의(봇 키워드, 메시지 전달, 봇 전환, 상담톡 전환) 버튼입니다.
* **클릭 수:** 해당 클릭 요소에서 발생한 클릭 수입니다.

### **3-5. 클릭 전환율 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 전환율**을 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가된 웹 링크 또는 앱 링크 버튼입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 전환율:** 해당 클릭 요소에 대한 클릭 전환율입니다.

### **3-6. 퍼널 분석**

조회한 모든 발송일 기준, 전환 기여 기간 동안 발송부터 최종 주문까지 이어지는 단계별 전환 성과를 퍼널 그래프로 확인할 수 있습니다.

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

### **3-7. 데이터 추이**

조회한 모든 발송일 기준, 전환 기여 기간 동안의 일별 클릭 수와 주문 수 변화를 그래프로 확인할 수 있습니다.

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

### **3-8. 데이터 테이블**

조회한 모든 발송일 기준, 전환 기여 기간 동안의 일별 성과 데이터를 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

<figure><img src="/files/6EO9Gh8HuJFuVHaVOLDP" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.33984375">헤더</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>해당 날짜에 발송 수 대비 발송에 성공한 비율입니다.</td></tr><tr><td><strong>클릭 수</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>이미지 클릭 수</strong></td><td>해당 날짜에 <strong>이미지를 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>채널 추가 수</strong></td><td>해당 날짜에 <strong>채널 추가 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>상담·문의 수</strong></td><td>해당 날짜에 <strong>봇 키워드, 메시지 전달, 봇 전환, 상담톡 전환 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>쿠폰 다운 시도 수</strong></td><td>해당 날짜에 <strong>쿠폰을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr></tbody></table>

***

## **4. 주문 상품 분석**

### **4-1. 상세 주문 리스트**

조회한 모든 발송일 기준, 전환 기여 기간 동안 클릭 후 발생한 주문의 상세 이력을 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>회원 ID</strong></td><td>주문한 회원의 ID입니다. 비로그인 또는 비회원 주문 시 '비로그인'으로 표시됩니다.</td></tr><tr><td><strong>주문 금액(원)</strong></td><td>해당 주문에서 발생한 주문 금액입니다.</td></tr><tr><td><strong>주문 수량</strong></td><td>해당 주문에 포함된 상품의 총 수량입니다.</td></tr><tr><td><strong>주문 상품</strong></td><td>해당 주문에 포함된 모든 상품 목록입니다. 행(Row)을 클릭하면 전체 상품명을 확인할 수 있습니다.</td></tr></tbody></table>

### **4-2. 상품 랭킹 TOP 100**

조회한 모든 발송일 기준, 전환 기여 기간 동안 주문된 상품의 랭킹을 상품 뷰 수, 주문 수, 전환 금액 순으로 확인할 수 있습니다.

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

<table><thead><tr><th width="159.64453125">헤더</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>상품의 판매가입니다.</td></tr><tr><td><strong>상품 뷰 수</strong></td><td><strong>클릭 후 해당 상품이 조회된 수</strong>입니다. 같은 세션 내 모든 조회 수를 합산하여 집계합니다.</td></tr><tr><td><strong>주문 수</strong> </td><td><strong>클릭 후 해당 상품이 주문된 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td><strong>클릭 후 해당 상품이 주문된 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>

***

## **5. 활용 캠페인별 분석**

해당 템플릿을 사용 중인 캠페인별로, 전환 기여 기간 동안의 성과를 확인할 수 있습니다.

<figure><img src="/files/2NuQ6tgT5et3meE0YAEu" alt=""><figcaption></figcaption></figure>

| 헤더           | 설명                                                                                        |
| ------------ | ----------------------------------------------------------------------------------------- |
| **캠페인명**     | 캠페인 생성 시 설정한 이름입니다.                                                                       |
| **발송 유형**    | 메시지를 발송하는 방식입니다. (예: 단일, 반복 )                                                             |
| **발송 수**     | 해당 캠페인에서 발송을 요청한 수입니다.                                                                    |
| **클릭 수**     | 해당 캠페인을 통해 발송한 메시지의 **웹 링크 또는 앱 링크 버튼을 클릭한 수**입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.              |
| **주문 수**     | 해당 캠페인을 통해 발송한 메시지의 **웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수**입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.     |
| **전환 금액(원)** | 해당 캠페인을 통해 발송한 메시지의 **웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액**입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다. |
| **최초 발송 일시** | 해당 캠페인에서 가장 처음 발송한 날짜 및 시간입니다.                                                            |
| **최근 발송 일시** | 해당 캠페인에서 가장 최근에 발송한 날짜 및 시간입니다.                                                           |
| **분석 리포트**   | 클릭 시 해당 캠페인의 분석 리포트로 이동합니다.                                                               |


# 사용료

[**\[캠페인 관리 > 미니 대시보드 > 당월 사용료\]**](/new-admin/kakao-brandmessage/manage#id-3)의 <img src="/files/JZ9PwPUAZ5er8znIWTa2" alt="" data-size="line"> 버튼을 클릭하여 브랜드 메시지 사용료를 확인할 수 있습니다.

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

{% hint style="info" %}

* 브랜드 메시지 수신 확인은 **최대 1일**이 소요될 수 있습니다. 정확한 사용료 산정을 위해 **당일 사용료**는 다음 날 **오전 8시**에 업데이트됩니다.
* 모든 사용료는 **부가세(VAT)가 포함되지 않은 금액**이며, **발송 시점별 단가 변동이 모두 반영**되어 계산됩니다.
  {% endhint %}

## **1. 당월 사용료**

이번 달 1일부터 조회 당일까지의 누적 사용료를 확인할 수 있습니다.

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

* **발송 단가:** 발송 대상별 1건을 발송하는 데 드는 비용입니다.
* **과금 성공 수:** 이번 달 발송 성공 건 중 실제로 과금이 발생한 건수입니다. 사용자에게 메시지가 정상적으로 도달하여 카카오 정책에 따라 과금 처리된 건을 의미합니다.
* **예상 사용료:** 현재까지 과금 성공 건수를 기준으로 산정된 예상 금액입니다.

### **1-1. 과금 성공 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 메시지 유형별 과금 성공 수를 확인할 수 있습니다.

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

### **1-2. 예상 사용료 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 메시지 유형별 예상 사용료를 확인할 수 있습니다.

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

### **1-3. 발송 단가 변경 이력**

**\[당월 사용료 > 발송 단가]**&#xC758; <img src="/files/a0ElYfc3ZnK05HJ0Z6m0" alt="" data-size="line"> 버튼을 클릭하여 발송 대상별 발송 단가 변경 이력을 확인할 수 있습니다.

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

* **현재 발송 단가:** 조회일을 기준으로 적용되고 있는 발송 단가입니다.
* **적용일:** 해당 발송 단가가 적용되기 시작한 날짜입니다.

| 헤더명             | 설명                        |
| --------------- | ------------------------- |
| **이전 발송 단가(원)** | 과거에 적용되었던 발송 단가 목록입니다.    |
| **적용일**         | 이전 발송 단가가 적용되기 시작한 날짜입니다. |

### **1-4. 사용료 상세**

당월 사용료의 <img src="/files/9h9D8CSioaC8XBAOiIfW" alt="" data-size="line"> 버튼 또는 월별 사용료의 행(Row)을 클릭하여 해당 월에 대한 템플릿별 사용료를 확인할 수 있습니다.

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

* **사용료:** 해당 월에 대한 메시지 발송 비용 총합입니다.

<table><thead><tr><th width="160.41796875">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>템플릿명</strong></td><td>해당 월에 1건 이상 발송 성공한 템플릿의 이름입니다.</td></tr><tr><td><strong>메시지 유형</strong></td><td>해당 템플릿의 메시지 유형입니다.</td></tr><tr><td><strong>과금 성공 수</strong></td><td>이번 달 해당 템플릿으로 발송을 성공한 건 중 실제로 과금이 발생한 건수입니다.</td></tr><tr><td><strong>사용료(원)</strong></td><td>과금 성공 건수를 기준으로 산정된 금액입니다.</td></tr></tbody></table>

***

## **2. 월별 사용료**

월별 브랜드 메시지 사용 내역을 확인할 수 있으며,  <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.31640625">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>사용 기간</strong></td><td>월별 사용 기간은 매월 1일부터 말일까지입니다.</td></tr><tr><td><strong>과금 성공 수</strong></td><td>해당 월에 발송을 성공한 건 중 실제로 과금이 발생한 건수입니다.</td></tr><tr><td><strong>사용료(원)</strong></td><td>과금 성공 건수를 기준으로 산정된 금액입니다.</td></tr></tbody></table>


# 카카오톡 캠페인: 모먼트

{% hint style="info" %}
카카오 모먼트 기능은 신규 어드민에서 사용 가능합니다.
{% endhint %}

그루비의 추천 기능으로 추천된 상품 등 카카오 모먼트 API를 이용하여 회원 개인 맞춤형 카카오톡 메시지를 발송할 수 있습니다.

## **개인화 메시지란?**

메시지를 받는 회원별로 회원의 맞춤 정보로 보내는 메시지입니다.

그루비에서 카카오 모먼트 개인화 메시지를 발송하기 위한 사전 설정을 마친 후, 회원별 상품 학습 데이터가 있으면 해당 회원에게 상품의 정보를 담아 개인화 메시지 발송이 가능합니다.

그루비에서는 회원별 맞춤 그루비 추천 상품, 회원 이름 등의 회원 개인화 정보를 담아서 보낼 수 있습니다.

<img src="/files/4r1EyZhO15IeDJg8REEy" alt="" width="238">

***

## **그루비 개인화 메시지 : 카카오 모먼트**

그루비에서는 그루비 추천 상품 및 회원 정보를 담은 카카오톡 개인화 메시지를 발송할 수 있습니다.

카카오 모먼트 제공 변수를 활용하여, 우리 사이트의 회원들에게 그루비 추천 알고리즘을 활용한 회원 개인에게 각각 맞춤형 상품을 발송할 수 있습니다.

그루비에서 사용 가능한 그루비 개인화 변수 항목과 그루비 추천 상품의 종류는 다음과 같습니다.

### **그루비 개인화 변수 항목**

카카오 모먼트에서 제공하는 개인화 변수 중 그루비에서 사용 가능한 개인화 변수는 다음과 같습니다.

각 개인화 변수별 그루비 상품 적재 시에 카카오 모먼트에서 정의한 최대 글자 수 내로 적재되며, 초과 시 말줄임 처리가 됩니다.

[카카오 모먼트 변수 입력 요소](https://developers.kakao.com/docs/latest/ko/kakaomoment/creatives-personalized-message#variable-specification)를 확인해 주세요.

<table><thead><tr><th width="114.58984375">데이터</th><th width="137.078125">변수 항목 표기</th><th width="362.6953125">설명</th><th>제한 사항</th></tr></thead><tbody><tr><td>상품명</td><td>${상품명_그루비 추천 상품}</td><td>선택한 그루비 추천 상품의 상품 이름</td><td>문자형<br>길이 : 20</td></tr><tr><td>가격</td><td>${가격_그루비 추천 상품}</td><td>선택한 그루비 추천 상품의 정가</td><td>숫자형<br>길이 : 8</td></tr><tr><td>회원 이름</td><td>${회원 이름}</td><td>회원 API로 값을 요청하여 저장되어 있는 회원 이름</td><td>문자형<br>길이 : 20</td></tr><tr><td>이미지 URL</td><td>${이미지 URL_그루비 추천 상품}</td><td>선택한 그루비 추천 상품의 이미지를 발송을 위해 변수 처리한 URL</td><td>문자형<br>길이 : 1000</td></tr><tr><td>모바일 URL</td><td>${모바일 URL_그루비 추천 상품}</td><td>선택한 그루비 추천 상품의 상세 페이지 등의 랜딩 URL</td><td>문자형<br>길이 : 1000</td></tr><tr><td>PC URL</td><td>${PC URL_그루비 추천 상품}</td><td>선택한 그루비 추천 상품의 PC URL<br>PC URL은 선택 값, 사용 시 PC 카카오톡에서 별도의 URL로 랜딩</td><td>문자형<br>길이 : 1000</td></tr></tbody></table>

### **그루비 추천 상품 (모먼트)** <a href="#reco-moment" id="reco-moment"></a>

그루비는 회원 한 명 한 명의 행동 데이터(상세보기·장바구니·구매)를 매일 학습해서, 그 회원에게 가장 잘 맞는 상품을 자동으로 골라 보여줍니다. 추천 방식은 크게 네 가지이며, 목적에 맞게 골라서 쓸 수 있습니다.

<table><thead><tr><th width="150.01953125">추천 유형</th><th width="270.56640625">어떤 상품을 보여주나요?</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>다시 살 때가 된 상품</td><td>소모품·식품처럼 재구매가 잦은 상품을 다룰 때</td></tr></tbody></table>

**1. 연관 상품: 비슷한 상품을 새로 제안**

회원이 관심을 보인 상품을 기준으로, 함께 조회·구매되는 비율이 높은 유사 상품을 찾아 추천합니다. 아직 만나지 못한 새로운 상품을 소개하는 데 잘 맞습니다.

* 장바구니 연관 상품: 최근 장바구니에 담은 상품과 비슷한 상품
* 최근 상세보기 연관 상품: 최근 조회한 상품과 비슷한 상품
* 최다 상세보기 연관 상품: 최근 1개월간 가장 많이 본 상품과 비슷한 상품

**2. 활동 기반 상품: 봤던 상품을 다시 보여줌**

회원이 관심을 보였지만 아직 구매하지 않은 상품을 그대로 다시 노출합니다. 구매를 망설이던 상품의 전환을 끌어내는 데 적합합니다.

* 최근 장바구니 상품: 가장 최근에 장바구니에 담은 상품
* 최근 상세보기 상품: 가장 최근에 조회한 상품
* 최다 상세보기 상품: 최근 1개월간 가장 많이 본 상품

**3. 반복 구매 상품: 다시 살 때가 된 상품 추천**

2회 이상 구매한 상품의 평균 구매 주기를 계산해서, 재구매 시기가 다가온 상품을 추천합니다. 화장품·식품처럼 주기적으로 소비하는 상품을 다루는 사이트에서 효과적입니다.

**※ 모든 추천에 공통으로 적용되는 기준**

* 이미 구매한 상품은 빼고, 다음에 살 가능성이 높은 상품 위주로 추천합니다.
* 품절·판매종료 상품이나 이미지·가격 정보가 없는 상품은 제외됩니다.
* 학습 기준 기간은 상세보기·장바구니는 최근 1개월, 구매는 최근 1년입니다.
* 매일 학습이 이뤄지기 때문에, '최근·최다'는 전일까지의 활동을 기준으로 합니다.

**자주 묻는 질문 (FAQ)**

<details>

<summary><strong>Q. 담거나 본 상품이 여러 개면 어떤 걸 기준으로 추천되나요?</strong></summary>

먼저 기준이 되는 상품 1개를 선정합니다. '최근' 유형은 가장 마지막에 담거나 본 상품, '최다' 유형은 기간 내 가장 많이 본 상품이 기준이 됩니다. 연관 상품은 이 기준 상품과 가장 비슷한 상품 1개를 추천합니다.

</details>

<details>

<summary><strong>Q. 추천할 상품이 없는 회원에게도 메시지가 발송되나요?</strong></summary>

발송 정보가 있어도, 활동 데이터가 없거나, 제외 조건(구매 완료·품절·정보 없음 등)을 적용한 뒤 남는 상품이 없으면 그 회원은 발송 대상에서 제외됩니다.&#x20;

</details>

{% hint style="info" %}
자세한 그루비 개인화 메시지 만들기는 [캠페인 만들기](/new-admin/kakao-moment/kakao-moment-create) / [메시지 설정 가이드](/new-admin/kakao-moment/kakao-moment-create/message-guide) 문서를 참고해 주세요.
{% endhint %}

***

## **주의사항**

### **카카오 모먼트 주의사항**

* 개인화 메시지 발송은 카카오 모먼트 개인화 메시지 API 화이트리스트에 등록된 광고 계정만 발송 가능합니다.
* 그루비에서 권한 신청 후 발송할 카카오톡 채널에 그루비 초대 등의 과정을 위한 온보딩을 진행합니다.
* 회원 개인정보 사용을 위한 내 사이트에서 개인정보 동의 사항을 표시하여야 합니다.
* 개인화 메시지 내 변수를 이용하여 수신자의 개인정보를 침해하거나 개인적인 특성이나 민감한 정보를 언급 또는 암시하여 타인의 권리를 침해할 수 있는 내용이 포함된 메시지를 발송한 채널은 카카오 광고 운영정책에 따라 한시적 또는 영구적으로 메시지 발송이 제한될 수 있습니다.
* 기타 카카오 모먼트의 채널 메시지 집행 가이드 및 채널 메시지 발송 유의 사항을 준수하지 않으면 발송할 수 없습니다.

{% hint style="danger" %}
**개인정보 처리에 따른 의무사항**\
카카오 광고 통합서비스 이용을 위해 이용자의 개인정보를 카카오에 위탁하는 경우 광고주는 이 사실을 이용자에게 안내해야 합니다. 또한 광고주는 관련된 법률에 따라 이용자에게 동의받은 목적으로만 개인정보를 이용해야 합니다.

카카오톡 채널을 이용하여 메시지 광고를 운영함에 있어 카카오톡이 제공하는\
[채널 메시지 집행 가이드](https://kakaobusiness.gitbook.io/main/ad/moment/start/messagead/guide) 및 [채널 메시지 발송 유의사항](https://kakaobusiness.gitbook.io/main/ad/moment/start/messagead/operations)을 준수하여야 합니다.
{% endhint %}

### **그루비 상품 학습 데이터 주의사항**

* 카카오톡 개인화 메시지에 그루비 추천 상품을 넣기 위해서는 그루비 추천 상품 학습이 필요합니다.
* 우리 사이트에서 성인 인증이 필요한 상품 등의 카카오 규정에 맞지 않은 콘텐츠의 경우 사전 신청 전 확인 후 신청해야 합니다. 해당 내용에 대한 책임 귀사에게 있습니다.
* 권한 신청 후 그루비 추천 상품 학습 데이터 준비가 진행됩니다.
* 그루비의 추천 상품 학습 후 카카오 모먼트의 메시지 발송 요청 시 필요한 이미지 처리를 위한 시간이 소요될 수 있습니다.
* 그루비 추천 상품의 상품 상세 랜딩 URL은 기본적으로 상품 상세 URL 패턴이 있을 시 발송 가능합니다.

{% hint style="warning" %}
그루비 추천 상품을 메시지에 담아 보내지 않을 경우 회원 이름 등의 변수는 권한 승인 후 개인화 회원 정보 연동 시 바로 사용 가능합니다.
{% endhint %}

{% hint style="danger" %}
그루비 수집 이미지는 카카오에서 지원하는 JPG, JPEG, PNG가 아닐 시에 카카오에 이미지 처리 요청을 할 수 없습니다.\
(webp 등의 이미지 확장자는 카카오 모먼트에서 지원되지 않습니다.)
{% endhint %}


# 사전 설정하기

## **1. 권한 신청하기**

그루비에서 카카오 모먼트 개인화 메시지 API를 통해 카카오톡 개인화 메시지 발송을 하기 위해서는 몇 가지 사전 설정이 필요합니다.

다음 사항에 맞춰 발송 사전 설정을 진행해 주세요.

![](/files/iObvw6y1kFHuHYds9uN7)

### **① 카카오 모먼트 권한 신청 작성**

카카오 모먼트 개인화 API 사용을 위해서는 카카오 모먼트 광고 계정을 생성하여, 해당 광고 계정에 대해 카카오 모먼트 개인화 메시지 API 화이트리스트 등록을 필수로 진행하여야 합니다.

✓ 그루비에서 \[설정 > 카카오톡 : 모먼트 설정]에서 권한 신청을 합니다.

해당 정보로 그루비에서 광고 계정 생성 및 영업권 설정, 카카오 모먼트 개인화 메시지 API 화이트리스트 등록 과정을 진행합니다.

카카오 모먼트 설정 페이지에서 신청 방법은 다음과 같습니다.

#### **신청 양식 작성**

* 신청자 이름 : 신청하는 신청자 이름을 작성해 주세요.
* 신청자 연락처 : 신청하는 신청자의 연락처를 작성해 주세요. 올바른 전화번호 양식으로 '-' 없이 작성해 주세요.
* 신청자 이메일 : 신청 후 연락받을 올바른 이메일을 입력해 주세요.
* 카카오톡 채널명 : 신청 후 카카오톡을 발송할 카카오톡 채널의 이름을 작성해 주세요.
* 카카오톡 채널 아이디 : 카카오 채널 관리자 계정의 아이디를 이메일 형식으로 작성해 주세요.

<img src="/files/G9H3wy8CR9uREljUoS6J" alt="" width="563">

### **② 광고 계정 초대 수락 및 카카오톡 채널에 그루비 초대**

✓ 광고 계정 생성 후 그루비는 담당자를 해당 광고 계정의 멤버로 초대하고, 담당자는 발송할 카카오톡 채널의 관리자로 그루비를 초대합니다.

담당자는 초대 수락 후 광고 계정에 발송 금액을 충전하여 발송 준비를 해야합니다.

그루비를 발송할 카카오톡 채널의 관리자로 초대하여야 해당 카카오톡 채널로 개인화 메시지 발송이 가능합니다.

{% hint style="warning" %}
CS 전화번호는 필수 사항입니다. 별다른 요청이 없을 시 카카오톡 채널의 CS 전화번호로 설정됩니다.

[카카오 모먼트](https://moment.kakao.com/adaccount/all)와 [카카오톡 채널 관리자](https://center-pf.kakao.com/profiles) 사이트를 확인해 주세요.
{% endhint %}

### **③ 신청 완료 확인**

✓ 신청 완료 시 \[설정 > 카카오톡 : 모먼트 설정]에 광고 계정 ID와 카카오톡 채널명이 표시됩니다.

![](/files/V3eIUCRupmxida8HvHr3)

***

## **2. 발송 데이터 준비하기**

카카오톡 개인화 메시지를 발송하기 위해 회원 ID와 전화번호 등의 발송할 대상의 정보 연동이 필요합니다.

### **회원 정보 연동**

카카오톡 발송을 위해 회원 발송 정보를 연동합니다.

* 회원 ID / 전화번호 / 회원 이름을 연동할 수 있습니다. 회원 이름은 선택 값으로, 연동하면 개인화 메시지에 각 회원의 이름을 변수에 담아 보낼 수 있습니다.
* \[회원 API]를 호출하여 회원 정보를 연동합니다.

**연동 데이터 예시**

| 회원 ID       | 전화번호          | 회원 이름 |
| ----------- | ------------- | ----- |
| groobee\_a1 | 010-1111-2222 | 김루비   |
| groobee\_b1 | 010-3333-4444 | 이루비   |
| ...         | ...           | ...   |

{% hint style="warning" %}
[회원 API](/developer-guide/api-guide/member/v2) 문서를 확인해 주세요.

API 사용 시의 주의사항을 확인하여 사용해 주세요.
{% endhint %}


# 카카오톡 캠페인: 모먼트 관리하기

## **카카오톡 캠페인: 모먼트 관리하기**

* 카카오톡 캠페인 : 모먼트 메뉴에서 새로운 카카오톡 캠페인 생성 및 생성 캠페인을 관리할 수 있습니다.
* 새로운 카카오톡 캠페인 : 모먼트를 만들고, 생성한 캠페인을 관리할 수 있습니다.
* 카카오톡 발송 유형별(단일 발송, 발송 완료) 캠페인 리스트, 발송 예정, 발송 완료, 당월 사용료를 확인할 수 있습니다.

<img src="/files/QGBY0k1MCduZx3K6JhIn" alt="" width="563">

***

### **카카오톡 캠페인: 모먼트 만들기**

* 새로운 캠페인을 만들기 위해 만들기 버튼을 클릭하여 캠페인 만들기 페이지로 이동할 수 있습니다.
* 카카오톡 캠페인 : 모먼트 메뉴에서는 만들기 버튼 클릭 시 새로운 카카오톡 개인화 메시지 만들기 페이지로 이동하여, 카카오톡 개인화 메시지 캠페인을 만들 수 있습니다.

### **미니 대시보드**

발송 예정, 발송 완료, 당월 사용료

<img src="/files/moMoISdMY8GR4GTbe1Jb" alt="" width="563">

미니 대시보드를 통해 발송 예정 / 발송 완료인 캠페인 건수를 간략하게 확인할 수 있고, 현재까지의 당월 사용료 및 당월 사용료 상세를 확인할 수 있는 페이지로 이동할 수 있습니다.

* 발송 예정 : 오늘 발송 예정인 캠페인의 건수와 오늘 \~ 오늘+6일 총 7일간의 발송 예정 캠페인 건수를 확인할 수 있습니다.
* 발송 완료 : 오늘 발송 완료된 캠페인의 건수와 이전-6일 \~ 오늘 총 7일간의 발송 완료 캠페인 건수를 확인할 수 있습니다.
* 당월 사용료 : 이번 달 발송된 캠페인 발송 비용과 전월 대비 사용료의 증감률을 함께 확인할 수 있습니다.
* 상세보기를 클릭하면 당월 및 이전 발송 사용에 대한 캠페인별 상세 비용을 확인할 수 있는 페이지로 이동합니다.

### **캠페인 리스트**

#### **데이터 테이블**

* 데이터 테이블에서는 발송 유형별로 생성된 캠페인을 확인할 수 있습니다.
* 테이블의 각 컬럼명을 클릭하여 정렬 또는 필터 기능을 사용할 수 있습니다.

#### **단일 발송**

발송 유형이 단일 발송으로 설정된 아직 진행하지 않은 캠페인의 리스트를 확인할 수 있습니다.

<img src="/files/6zcFX90bDqKPQ3VQijbK" alt="" width="563">

* 캠페인명 : 카카오톡 캠페인 : 모먼트 생성 시 설정한 캠페인의 이름입니다. 각 캠페인명 클릭 시 수정 화면으로 이동합니다.
* 상태 : 캠페인의 진행 상태를 표시합니다.
  * 진행 : 재생으로 표시 되며, 진행 중인 캠페인은 설정한 스케줄에 맞춰 캠페인이 진행됩니다.
  * 중지 : 일시정지로 표시 되며, 중지 중인 캠페인 설정한 스케줄이 있어도 캠페인이 진행되지 않습니다.
* 캠페인 유형 : 개인화 메시지 캠페인 유형을 표시합니다.
* 메시지 유형 : 캠페인 2단계 메시지 설정에서 설정한 카카오톡 메시지 유형을 표시합니다.
* 예상 타겟 수 : 캠페인 저장 시점에 계산된 카카오톡 예상되는 발송 대상 타겟 수를 표시합니다.
* 발송 예정 일시 : 캠페인 옵션 설정에서 설정한 발송 일시를 표시합니다.
* 최종 수정일 : 캠페인을 마지막으로 수정한 일자를 표시합니다. (캠페인 상태 변경 시에도 업데이트 됩니다.)

#### **발송 완료**

실제 캠페인이 진행되어서 발송이 완료되었거나, 완료 탭으로 이동시킨 캠페인의 리스트를 확인할 수 있습니다.

<img src="/files/ahy8MSzIElKZnTQ1FgNn" alt="" width="563">

* 캠페인명 : 카카오톡 캠페인 : 모먼트 생성 시 설정한 캠페인의 이름입니다. 각 캠페인명 클릭 시 캠페인 확인 화면으로 이동합니다.
* 캠페인 유형 : 개인화 메시지 캠페인 유형을 표시합니다.
* 발송 유형 : 캠페인 옵션 설정에서 설정한 발송 유형을 표시합니다.
* 발송 수 : 실제 발송된 발송 건수를 표시합니다. 발송되지 않았던 캠페인의 경우 예상 타겟 수를 표시합니다.
* 발송 기간 : 반복 발송 캠페인에서 설정한 캠페인 기간을 표시합니다. 단일 발송 캠페인은 표시되지 않습니다.
* 발송 설정 : 캠페인 옵션 설정에서 설정한 발송 일시를 표시합니다.
* 완료 일시 : 캠페인이 완료 탭으로 이동한 일시를 표시합니다.

### **태그 및 검색**

<img src="/files/y0MOLeGrjQYhpnVYUV59" alt="" width="188">

* 태그 필터 버튼 클릭 시 태그 필터창에서 캠페인 생성 시 추가한 태그로 태그 필터를 사용할 수 있습니다.
* 추가된 태그 중 조건에 맞는 태그를 체크하여 선택 버튼을 누르면 해당 태그가 추가되어 있는 캠페인만 필터링됩니다.
* 하나의 태그를 여러 캠페인에 사용할 수 있으며, 한 캠페인에서 동일한 태그를 여러 번 중복하여 추가할 수 없습니다.
* 검색을 이용하여 원하는 캠페인명을 검색할 수 있습니다.

### **관리 도구 (・・・)**

<table data-header-hidden><thead><tr><th width="104.0859375"></th><th width="136.90234375"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/V53JGYZivWWarSrVgoOu" alt="" width="24"></p></td><td>수정</td><td>클릭 시 캠페인 수정 페이지로 이동합니다. 진행 중, 발송 이력 존재, 발송 완료된 캠페인은 수정할 수 없습니다.</td></tr><tr><td><p><img src="/files/3KyjtUmEnbtLTf6EecmF" alt="" width="24"></p></td><td>복사</td><td>클릭 시 캠페인이 복사되어 새로운 캠페인 만들기 페이지로 이동합니다.</td></tr><tr><td><p><img src="/files/F4BpVnbn7boXsKbOJWaA" alt="" width="24"></p></td><td>분석 리포트</td><td>발송된 캠페인의 경우, 해당 캠페인의 분석 리포트 페이지로 이동하여 캠페인 성과를 확인할 수 있습니다.</td></tr><tr><td><p><img src="/files/x5JmYGYhqJfi7wPdJQBY" alt="" width="24"></p></td><td>미리보기</td><td>클릭 시 해당 설정한 캠페인 메시지 내용을 미리보기로 확인 할 수 있습니다.</td></tr><tr><td><p><img src="/files/o0mQZZXXCwDnbqW1moNC" alt="" width="24"></p></td><td>완료 탭으로 이동</td><td>발송 완료 이외의 탭에서 발송 완료 탭으로 캠페인을 이동합니다. 중지 중인 캠페인만 이동 가능합니다.</td></tr><tr><td><p><img src="/files/lKm9bQX73YvxpYeQDfRO" alt="" width="24"></p></td><td>삭제</td><td>발송 완료 탭에서 선택한 캠페인을 삭제합니다. 발송 이력이 없는 캠페인만 삭제 가능합니다.</td></tr></tbody></table>


# 캠페인 만들기

## **1단계 : 기본 설정**

새로운 카카오톡 개인화 메시지 캠페인 만들기 기본 설정에서는 캠페인명, 캠페인의 상세 설명, 태그 등의 캠페인 기본 정보와 캠페인 타겟을 설정할 수 있습니다.

<img src="/files/HPN1eX9eyzJxeNHgW5ra" alt="" width="563">

### **단계 이동**

각 단계를 클릭하여 해당하는 단계로 이동할 수 있습니다. 각 단계의 필수 값이 입력되어야만 이동 가능합니다.

### **캠페인 기본 정보**

![](/files/4O9ZsxvfnyIFYL9MYC36)

* 캠페인명 : 해당 캠페인의 이름을 설정합니다. 한글 기준 공백 포함 최대 40자까지 설정 가능합니다.
* 상세설명 : 해당 캠페인에 대한 간략한 설명이 필요할 시 설정합니다. 한글 기준 공백 포함 최대 400자까지 설정 가능합니다.
* 태그 : 태그 추가 버튼 클릭 시 캠페인에 태그를 추가할 수 있습니다. 캠페인 리스트에서 태그 필터를 통해 특정 캠페인을 필터링할 때 활용할 수 있습니다.

<table data-header-hidden><thead><tr><th width="335.6875"></th><th></th></tr></thead><tbody><tr><td><p><img src="/files/CuILwop7VOVCDowOVSCX" alt="" width="188"></p></td><td><ul><li>태그는 Enter로 구분하여 복수 개 추가 가능합니다.</li><li>동일한 태그는 한 번만 추가됩니다.</li><li>이전에 저장했던 태그를 클릭하여 추가할 수 있습니다.</li></ul></td></tr></tbody></table>

### **타겟 설정**

<img src="/files/wRPdsnTQ3JfLneSvB9MS" alt="" width="563">

* 타겟팅 유형 : 세그먼트 / 수신 동의자 전체
  * 세그먼트 : 만들어진 세그먼트를 불러와서 타겟팅 합니다.
  * 수신 동의자 전체 : 그루비에 발송 정보가 있는 모든 회원을 타겟팅 합니다.

{% hint style="warning" %}
카카오 모먼트 수신 동의자 전체는 그루비에 발송 가능한 회원 정보(회원 ID, 전화번호)가 있는 전체 대상에게 발송 요청을 하며, 2단계 메시지 설정에서 상품 설정을 하면 선택한 상품의 모든 학습 데이터가 있는 대상에게 발송 요청합니다.
{% endhint %}

* 세그먼트 설정 : 타겟팅 유형이 세그먼트일 때 표시되며, 저장된 세그먼트를 불러올 수 있습니다.
  * 세그먼트 불러오기 : ‘세그먼트 불러오기' 버튼을 클릭하여 원하는 세그먼트를 최대 3개까지 불러올 수 있습니다. 상세보기를 클릭하여 각 세그먼트의 상세 정보를 확인할 수 있습니다.<br>

    <figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6wykrmlml5/1758681214429/2.png" alt=""><figcaption></figcaption></figure>

    * AI 세그먼트 : 저장된 AI 세그먼트를 선택할 수 있습니다.
    * 세그먼트 : 활용 범위가 '오프사이트'인 세그먼트만 선택 가능합니다.
  * 조건 설정 (AND, OR, NOT) : 각 세그먼트 사이에 적용할 조건을 선택합니다.
    * AND : 앞선 조건과 현재 세그먼트의 교집합에 해당하는 타겟에게 발송합니다. (예: VIP 고객 이면서 최근 30일 내 구매 고객)
    * OR : 앞선 조건과 현재 세그먼트의 합집합에 해당하는 타겟에게 발송합니다. (예: VIP 고객 이거나 최근 30일 내 구매 고객)
    * NOT : 앞선 조건에서 현재 세그먼트에 해당하는 타겟을 제외합니다. (예: VIP 고객 중 최근 30일 내 구매 고객은 제외)
  * 순서 조정 : 세그먼트는 위에서 아래 순서대로 조건이 조합됩니다. 세그먼트 좌측의 화살표 버튼을 통해 자유롭게 순서를 변경하고, 타겟 조합의 우선순위를 조정할 수 있습니다.<br>

    <figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6wykrmlml5/1758681223504/2.png" alt=""><figcaption></figcaption></figure>
  * 세그먼트 조합 결과 요약 : 위에서 조합한 세그먼트의 타겟팅 정보를 알기 쉽게 제공합니다.
    * 세그먼트 조합이 어떻게 이루어지는지 궁금하신가요? ‘조합 결과 보기' 팝업을 통해 현재 설정된 세그먼트와 조건이 어떤 논리로 결합되어 타겟이 추출되는지 직관적으로 확인할 수 있습니다.

{% hint style="warning" %}
발송 타겟으로 발송 요청을 하더라도 해당 회원이 카카오 채널 친구 추가를 하지 않았다면 발송 실패됩니다. (과금은 되지 않습니다.)
{% endhint %}

***

## **2단계 : 메시지 설정**

메시지 설정에서는 메시지 유형 선택하고, 개인화 변수에 치환하여 보낼 그루비 추천 개인화 상품 설정과 그에 따른 예상 타겟 수를 확인할 수 있습니다.

또한, 실제 발송될 메시지 본문을 작성하여 작성된 메시지를 미리보기와 발송 테스트를 통해 확인할 수 있습니다.

<img src="/files/wpw1M9xuuWMzjrQtVSsT" alt="" width="563">

### **메시지 유형**

![](/files/TRdnACp8BkU1dsrf3lH2)

* 메시지 유형과 메시지 유형에 따른 단가를 확인할 수 있습니다.
* 와이드 리스트 / 캐러셀 피드 유형을 사용할 수 있습니다.

### **개인화 상품 설정** <a href="#personal-goods" id="personal-goods"></a>

![](/files/YQfyCJY1UZYKmXEL3nif)

* 상품 설정 : 상품 설정 클릭 시 상품 관련 개인화 변수에 치환하여 보낼 그루비 추천 상품을 설정할 수 있습니다.
* 상품 설정에서 설정한 상품 변수 항목 추가 시 그루비 상품의 선택 항목이 됩니다

<img src="/files/Rzb8W7iUv2wzudiK3ZpX" alt="" width="375">

* 상품 1\~4 총 4개의 그루비 개인화 추천 상품을 선택할 수 있습니다. 모두 미설정 시 상품 관련 개인화 변수는 사용할 수 없습니다.
* 그루비에서는 총 7가지의 추천 상품 종류를 제공합니다.
  * 장바구니 연관 상품 : 최근 장바구니에 담은 상품과 유사한 아이템
  * 최근 상세보기 연관 상품 : 최근 조회한 상품과 유사한 아이템
  * 최다 상세보기 연관 상품 : 기간 내에 가장 많이 조회한 상품과 유사한 아이템
  * 최근 장바구니 상품 : 가장 최근에 담은 장바구니 상품
  * 최다 상세보기 상품 : 개인이 특정 기간동안 상세보기를 가장 많이 한 상품
  * 최근 상세보기 상품 : 가장 최근에 상세보기 된 상품
  * 반복 구매 상품 : 2회 이상 구매한 상품 중 구매주기가 도래한 상품
* 중복되는 추천 상품 종류를 선택할 수 없습니다.

{% hint style="warning" %}
상품 설정 시 선택한 그루비 추천 상품의 종류와 선택 상품의 조합의 학습 데이터 유무에 따라 발송 타겟이 작아질 수 있습니다.
{% endhint %}

### **메시지 작성** <a href="#message" id="message"></a>

* 실제 회원들에게 발송될 메시지 내용을 작성합니다. 메시지에는 이미지, 텍스트, 상품 랜딩 URL 등을 설정하여서 보낼 수 있습니다.
* 메시지 유형별 작성 방식을 확인하여 작성해 주세요.

#### **공통**

* 변수 항목 추가 버튼을 누르면 개인화 변수를 추가할 수 있는 변수 항목 추가 창이 뜹니다.
* 변수 중 상품 관련 변수 선택 시 ➁ 개인화 상품 설정에서 설정한 상품 중 하나를 선택하여 보낼 수 있습니다.

#### **개인화 변수**

* **텍스트 변수 추가**

![](/files/269hIXbZdl2St6WCIT33)

<table><thead><tr><th width="179.3359375">변수명</th><th width="148.8828125">변수 종류</th><th>기타 사항</th></tr></thead><tbody><tr><td>상품명</td><td>상품 변수</td><td>상품 설정에서 설정한 그루비 상품 선택</td></tr><tr><td>가격</td><td>상품 변수</td><td>상품 설정에서 설정한 그루비 상품 선택</td></tr><tr><td>회원 이름</td><td>일반 변수</td><td>대체 값 설정 (* 대체 값 : 데이터가 없을 때 대체해서 보낼 값)</td></tr></tbody></table>

{% hint style="danger" %}
가변하는 변수를 치환한 후 각 영역별 제한된 글자 수 초과 시에는 발송이 되지 않습니다.
{% endhint %}

* **이미지 변수 추가**
  * 회원별 개인화 추천 상품의 이미지 URL을 담아 메시지를 발송합니다. 이미지 URL 변수만 사용 가능합니다.

{% hint style="warning" %}
이미지는 수집된 이미지를 발송하기 때문에 이미지 사이즈와 비율에 제한이 있습니다.\
이미지 URL 변수는 한 메시지 안에서 같은 그루비 상품을 중복해서 사용할 수 없습니다.
{% endhint %}

* **URL 변수 추가**
  * 회원별 개인화 추천 상품 상세의 URL을 담아 메시지를 발송합니다. 모바일 URL, PC URL 변수만 사용 가능합니다.

{% hint style="warning" %}
올바른 형식의 URL을 작성하지 않을 시 발송이 되지 않거나, 잘못된 랜딩이 발생할 수 있습니다.

URL 관련 텍스트 변수는 한 영역에 한 개만 추가 가능합니다.

URL 관련 텍스트 변수는 한 메시지 안에서 같은 그루비 상품을 중복해서 사용할 수 없습니다.

상품 상세 페이지의 기준은 어드민 설정에서 상품 상세 페이지에 설정한 URL 규칙을 기반으로 합니다.

URL 규칙이 통일되지 않으면 이용할 수 없습니다. (상품 상세 페이지에 패턴이 있는 URL 사용 필요)
{% endhint %}

### **메시지 유형별 작성사항**

<details>

<summary>와이드 리스트</summary>

<img src="/files/S4FMmM4uZiDe5NuIS2gk" alt="" width="563">

#### **ⓐ 타이틀**

* 타이틀 영역에서는 메시지에 담아 보낼 메시지의 제목을 추가합니다.
* 변수 사용 시 치환 후 최대 20자까지 작성하여야 발송 가능합니다.
  * 일반 텍스트 입력 : 회원에게 고정으로 보낼 내용을 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 변수 내용을 담아 메시지를 발송합니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <p><img src="/files/ThFgziXCERJPG1rYnJCI" alt=""></p> | <p><img src="/files/VLRl0XDNuD1CsmLAkFuv" alt=""></p> |
| ----------------------------------------------------- | ----------------------------------------------------- |

#### **ⓑ 이미지 영역**

* 이미지 영역에서는 메시지에 담아 보낼 이미지를 추가합니다.
  * 파일 업로드 : 회원에게 고정 이미지를 업로드하여 메시지를 발송합니다.
  * 이미지 변수 추가 : 회원별 개인화 추천 상품의 이미지 URL을 담아 메시지를 발송합니다.

| <p><img src="/files/8W2rwnBYH39xb9JCMN44" alt=""></p> | <p><img src="/files/4Bae9WaqjzA7gMRSj6xs" alt=""></p> |
| ----------------------------------------------------- | ----------------------------------------------------- |

#### **ⓒ 텍스트**

* 텍스트 영역에서는 메시지에 담아 보낼 메시지 본문 텍스트를 추가합니다.
* 변수 사용 시 치환 후 리스트 1 영역의 텍스트는 최대 25자, 리스트 2\~4 영역의 텍스트는 최대 30자까지 작성하여야 발송 가능합니다.
  * 일반 텍스트 입력 : 회원에게 고정으로 보낼 텍스트를 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 변수 내용을 담아 메시지를 발송합니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <p><img src="/files/xfZmkxlW6OSH5mXB3lCT" alt=""></p> | <p><img src="/files/G1fYNtbrsVsthaT7tFPy" alt=""></p> |
| ----------------------------------------------------- | ----------------------------------------------------- |

#### **ⓓ 랜딩 URL**

* 랜딩 URL 영역에서는 해당 상품을 클릭했을 때 랜딩될 URL을 추가합니다.
  * 일반 랜딩 URL 입력 : 회원에게 고정으로 보낼 랜딩 URL을 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 상품의 상품 상세 페이지의 URL이 발송됩니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <p><img src="/files/cCE9F1tumLTHjr5CHWfc" alt=""></p> | <p><img src="/files/d0i7ADXR1jW5HtVDhvDl" alt=""></p> |
| ----------------------------------------------------- | ----------------------------------------------------- |

#### **ⓔ PC URL 추가**

* PC URL은 선택사항으로, 추가 시 PC 카카오톡에서 버튼 클릭 시 별도의 URL로 랜딩 시키려는 경우 사용할 수 있습니다.
  * 일반 PC URL 입력 : 회원에게 고정으로 보낼 PC URL을 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 상품의 상품 상세 페이지의 URL이 발송됩니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <p><img src="/files/D4ow2u0x5Lo59iMn57lD" alt=""></p> | <p><img src="/files/21nFX9CTYrGZgDgAHfyT" alt=""></p> |
| ----------------------------------------------------- | ----------------------------------------------------- |

#### **ⓕ 리스트 4**

* 리스트 4는 선택사항으로 추가를 원하면 오른쪽 버튼을 클릭합니다. 입력 방식과 제한 사항은 리스트 2, 3과 같으며, 입력 시 이미지, 텍스트, 랜딩 URL을 필수로 입력해야 합니다.

#### **ⓖ 버튼**

* 버튼은 선택사항으로 최대 2개까지 설정할 수 있습니다.
* 버튼은 URL 유형만 지원되며, 버튼명과 버튼 클릭 시 이동할 URL을 설정합니다.

#### **ⓗ 미리보기**

* 미리보기에서는 작성한 메시지 내용을 미리 확인할 수 있습니다.
* 개인화 변수는 추가 시 변수명으로 보여지며, 실제 발송 시에는 회원별 개인화 정보로 발송됩니다.
* 개인화 이미지 변수는 추가 시 대체 이미지로 보여지며, 실제 발송 시에는 회원별 선택한 상품의 이미지로 발송됩니다.

{% hint style="info" %}
미리보기는 메시지 발송 참고용으로, 실제 발송되는 메시지와 차이가 있을 수 있습니다.
{% endhint %}

</details>

<details>

<summary>캐러셀 피드</summary>

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724657556526/image.png" alt="" width="563"><figcaption></figcaption></figure>

#### **ⓐ 캐러셀 추가**

* 추가 버튼으로 캐러셀을 추가할 수 있습니다.
* 캐러셀은 최소 2개 이상 최대 6개까지 추가 가능합니다.

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659113585/image.png" alt="" width="563"><figcaption></figcaption></figure>

#### **ⓑ 추가된 캐러셀**

* 추가된 캐러셀 수를 확인할 수 있습니다.

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659122550/image.png" alt="" width="563"><figcaption></figcaption></figure>

#### **ⓒ 이미지 영역**

* 이미지 영역에서는 메시지에 담아 보낼 이미지를 추가합니다.
  * 파일 업로드 : 회원에게 고정 이미지를 업로드하여 메시지를 발송합니다.
  * 이미지 변수 추가 : 회원별 개인화 추천 상품의 이미지 URL을 담아 메시지를 발송합니다.

| <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6wykrmlml5/1716766080304/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6wykrmlml5/1716766097185/image.png" alt=""><figcaption></figcaption></figure></div> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **ⓓ 타이틀**

* 타이틀 영역에서는 메시지에 담아 보낼 캐러셀의 제목을 추가합니다.
* 변수 사용 시 치환 후 최대 20자까지 작성하여야 발송 가능합니다.
  * 일반 텍스트 입력 : 회원에게 고정으로 보낼 텍스트를 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 변수 내용을 담아 메시지를 발송합니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659212897/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659219594/image.png" alt=""><figcaption></figcaption></figure></div> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **ⓔ 텍스트**

* 텍스트 영역에서는 메시지에 담아 보낼 메시지 본문을 추가합니다.
* 변수 사용 시 치환 후 최대 180자까지 작성하여야 발송 가능합니다.
  * 일반 텍스트 입력 : 회원에게 고정으로 보낼 텍스트를 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 변수 내용을 담아 메시지를 발송합니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659244134/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659274054/image.png" alt=""><figcaption></figcaption></figure></div> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **ⓕ 버튼 1**

* 버튼은 최대 2개까지 설정할 수 있으며, 버튼 1은 필수로 설정해야합니다.
* 캐러셀 유형에서 이미지 클릭 시 버튼 1의 링크로 랜딩됩니다.
* 버튼 1의 URL 영역에서만 개인화 변수를 사용할 수 있습니다.
  * 일반 랜딩 URL 입력 : 회원에게 고정으로 보낼 랜딩 URL을 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 상품의 상품 상세 페이지의 URL이 발송됩니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659290806/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659299726/image.png" alt=""><figcaption></figcaption></figure></div> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### **ⓖ PC URL 추가**

* PC URL은 선택사항으로, 추가 시 PC 카카오톡에서 버튼 클릭 시 별도의 URL로 랜딩 시키려는 경우 사용할 수 있습니다.
  * 일반 PC URL 입력 : 회원에게 고정으로 보낼 PC URL을 입력하여 메시지를 발송합니다.
  * 텍스트 변수 추가 : 회원별 개인화 추천 상품의 상품 상세 페이지의 URL이 발송됩니다. 추가된 변수는 일반 텍스트와 구분되어 표시됩니다.

| <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724635537347/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724635592475/image.png" alt=""><figcaption></figcaption></figure></div> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

**ⓗ 버튼 2**

* 버튼 2는 선택사항으로 URL 유형만 지원합니다.
* 버튼 2에서는 개인화 변수를 사용할 수 없습니다.

| <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659330235/image.png" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659339350/image.png" alt=""><figcaption></figcaption></figure></div> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659347330/image.png" alt="" width="563"><figcaption></figcaption></figure>

#### **ⓘ 캐러셀 이동**

* 클릭 후 드래그 앤 드롭으로 캐러셀을 이동할 수 있습니다.

**ⓙ 이미지 썸네일**

* 업로드한 이미지가 썸네일로 표시됩니다. 개인화 변수 사용 시 대체 변수 이미지가 표시됩니다.

**ⓚ 타이틀 썸네일**

* 작성한 타이틀이 썸네일로 표시됩니다. 개인화 변수 사용 시 개인화 변수가 표시됩니다.

**ⓛ 삭제**

* 클릭 시 해당 캐러셀이 삭제됩니다.

**ⓜ 더보기**

* 더보기 버튼은 선택사항으로, 추가 시 캐러셀 우측에 더보기 버튼이 추가되어 설정한 URL로 랜딩됩니다.

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659353782/image.png" alt="" width="563"><figcaption></figcaption></figure>

**ⓝ 미리보기**

* 미리보기에서는 작성한 메시지 내용을 미리 확인할 수 있습니다. 캐러셀 옆에 화살표를 눌러 작성된 캐러셀 영역의 내용을 확인할 수 있습니다.
* 개인화 변수는 추가 시 변수명으로 보여지며, 실제 발송 시에는 회원별 개인화 정보로 발송됩니다.
* 개인화 이미지 변수는 추가 시 대체 이미지로 보여지며, 실제 발송 시에는 회원별 선택한 상품의 이미지로 발송됩니다.

<figure><img src="https://files.helpdocs.io/p92xn84cjv/articles/6rh7nv2q70/1724659365200/image.png" alt="" width="188"><figcaption></figcaption></figure>

{% hint style="info" %}
미리보기는 메시지 발송 참고용으로, 실제 발송되는 메시지와 차이가 있을 수 있습니다.
{% endhint %}

</details>

{% hint style="warning" %}
[메시지 설정 가이드](/new-admin/kakao-moment/kakao-moment-create/message-guide) 문서를 함께 확인해 주세요.
{% endhint %}

{% hint style="danger" %}
**작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다. 가이드를 준수하여 작성해 주세요.**
{% endhint %}

### **발송 테스트**

* 메시지 설정을 마친 후, 캠페인 진행 전 테스트 메시지를 발송할 수 있습니다.
* 발송 테스트 대상은 한 번에 5명까지 발송 테스트를 할 수 있습니다.

{% hint style="info" %}
발송 테스트 시 상품 관련 변수 내용은 학습된 상품 데이터 중 랜덤으로 선택되어 발송됩니다.
{% endhint %}

{% hint style="warning" %}
발송 테스트 메시지도 일반 메시지와 같은 금액이 부과됩니다.\
발송 테스트에 등록한 전화번호 대상이 카카오톡 채널 친구가 아니면 메시지가 발송되지 않습니다.
{% endhint %}

{% hint style="danger" %}
**다음과 같은 상황에 테스트 발송이 실패될 수 있습니다.**

* 작성된 글자 수(고정 글자 수)나 (고정 글자 수+치환된 글자 수)가 초과됐을 경우 : 메시지 설정 가이드에서 각 영역별 최대 글자 수를 확인하여 작성 후 다시 시도해 주세요.
* 카카오 채널 친구가 아닌 경우 : 카카오 채널 친구 추가 후 다시 시도해 주세요.
  {% endhint %}

***

## **3단계 : 옵션 설정**

* 옵션 설정에서는 캠페인을 진행할 발송 스케줄, 설정한 캠페인의 예상 발송 비용 등을 확인할 수 있습니다.

### **스케줄**

* 발송 유형 : 캠페인 발송 시 발송 유형을 선택합니다.
  * 단일 발송 : 설정한 발송 일시에 맞춰 한 번만 발송됩니다.
  * 반복 발송 : (오픈 예정) 반복 주기 및 발송 시간을 선택하여 해당 캠페인을 반복하여 실행하는 옵션입니다.
* 발송 일시 : 캠페인이 발송될 일자와 시간을 선택합니다.

### **예상 발송 비용** <a href="#cost" id="cost"></a>

* 메시지 설정에서 선택한 메시지 유형과 확인된 예상 타겟 수로 계산된 예상 발송 비용을 확인할 수 있습니다.
  * 와이드 리스트 / 캐러셀 피드
    * 발송 단가 : 30원
    * 프로모션가 : 25원(카카오 모먼트에서 프로모션 종료 시 원래 단가로 발송됩니다.)

{% hint style="warning" %}
발송 단가는 카카오 모먼트에서 선정된 단가로 계산되며, 개인화 변수를 사용하지 않아도 동일하게 과금됩니다.
{% endhint %}

{% hint style="danger" %}
발송 요청 시 요청한 타겟의 수보다 충전 잔액이 부족하면 해당 캠페인 발송이 되지 않습니다.\
충전 잔액을 확인하여 발송해 주세요.
{% endhint %}

***

## **유의 사항**

* 발송 및 메시지 설정(카카오 모먼트의 소재)의 기본 제한 사항 및 참고 사항은 카카오 모먼트 정책을 준수합니다.
* 카카오톡 캠페인 생성 개수 제한 및 기타 제한 사항은 [카카오 모먼트 정책](https://kakaobusiness.gitbook.io/main/ad/moment/run/account-1#1.)을 따릅니다. 문서를 확인해 주세요.
* 개인화 메시지는 채널의 친구에게만 발송되는 광고성 메시지이며, 요청한 전화번호가 메시지를 발송하는 채널의 친구가 아닌 경우 발송 요청이 취소됩니다.
* 변수값 치환 후 메시지 제작 가이드 준수 여부를 확인하며, 치환 후 글자 수가 메시지 제작 가이드를 준수하지 않는다면 메시지 발송 요청이 취소됩니다.
* 야간 메시지 발송 규정 시간대, 광고 계정 잔액이 부족한 경우 등 다양한 사유에 따라 발송 실패 처리될 수 있습니다.


# 메시지 설정 가이드

## **카카오 메시지 유형별 가이드**

카카오톡(카카오 모먼트)에서 제공하는 메시지 유형별 메시지 내용을 구성하는 가이드 및 유의사항을 확인합니다.

{% hint style="danger" %}
**개인화 변수 사용 시 변** **치환 후에는 메시지 유형에 따른 가이드를 준수하여야 발송되며, 준수하지 않을 시 발송이 실패됩니다.**
{% endhint %}

### **와이드 리스트**

* 와이드 리스트 유형은 다양한 한 메시지 안에 최대 4개의 이미지와, 다양한 상품 정보를 담을 수 있는 메시지 유형입니다.

{% hint style="warning" %}
필수 : 타이틀, 리스트 1 이미지, 리스트 2\~3, 각 리스트의 랜딩 URL / 선택 : 리스트 4, 버튼 1\~2, PC URL
{% endhint %}

<img src="/files/QbcAvGpr5yr6muBxWA32" alt="" width="188">

<table><thead><tr><th width="157.140625">요소</th><th width="431.45703125">가이드</th><th>개인화 변수</th></tr></thead><tbody><tr><td>⓵ 타이틀</td><td><ul><li>치환 후 최대 20자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓶ 리스트 1 이미지</td><td><ul><li>파일 형식 : JPG, JPEG, PNG (동영상 미지원)</li><li><p>사이즈</p><ul><li>800x400 (2:1 비율) 권장</li><li>가로 80px 이상, 가로:세로 비율 1:2.5 이하 지원 안함</li></ul></li><li>용량 : 10MB</li><li>파일 : 고정 이미지 업로드 또는 변수 이미지 URL 등록</li><li>※ 리스트 1의 이미지는 대표 이미지로, 고정 이미지 사용을 권장합니다.</li></ul></td><td><ul><li>이미지 URL</li></ul></td></tr><tr><td>⓷ 리스트 1 텍스트</td><td><ul><li>치환 후 최대 25자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓸ 리스트 2~4 이미지</td><td><ul><li>파일 형식 : JPG, JPEG, PNG (동영상 미지원)</li><li><p>사이즈</p><ul><li>800x800 (1:1 비율) 권장</li><li>가로 80px 이상, 가로:세로 비율 1:2.5 이하 지원 안함</li></ul></li><li>용량 : 10MB</li><li>파일 : 고정 이미지 업로드 또는 변수 이미지 URL 등록</li></ul></td><td><ul><li>이미지 URL</li></ul></td></tr><tr><td>⓹ 리스트 2~4 텍스트</td><td><ul><li>치환 후 최대 30자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓺ 버튼 1~2</td><td><ul><li>버튼명 : 최대 8자</li><li>랜딩 유형 : URL</li></ul></td><td><ul><li>사용 불가</li></ul></td></tr><tr><td>URL</td><td><ul><li>최대 1000자 입력 가능</li><li>http:// 또는 https:// 형식의 랜딩 URL 지원</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.</p></div></td><td><ul><li>모바일 URL</li><li>PC URL</li></ul></td></tr></tbody></table>

### **캐러셀 피드**

* 캐러셀 피드 유형은 최대 6개의 캐러셀 영역에 대표 이미지와 타이틀, 내용 등의 다양한 요소를 담아 보낼 수 있는 유형입니다.

{% hint style="warning" %}
필수 : 캐러셀은 최소 2개 이상 사용, 이미지, 타이틀, 텍스트, 버튼 1 / 선택 : 버튼 2, 캐러셀 3\~6
{% endhint %}

![](/files/E1kuXUMb8Kjr50qKAHAi)

<table><thead><tr><th width="141.6484375">요소</th><th width="451.77734375">가이드</th><th>개인화 변수</th></tr></thead><tbody><tr><td>⓵ 이미지 영역</td><td><ul><li>파일 형식 : JPG, JPEG, PNG (동영상 미지원)</li><li><p>사이즈</p><ul><li>800x400 (2:1 비율) 권장</li><li>800x600 (4:3 비율) 권장</li><li>가로 80px 이상, 가로:세로 비율 1:2.5 이하 지원 안함</li></ul></li><li>용량 : 10MB</li><li>파일 : 고정 이미지 업로드 또는 변수 이미지 URL 등록</li></ul><p>※ 캐러셀 1 ~ 6 영역의 이미지는 동일한 비율의 이미지를 등록해 주세요.</p></td><td><ul><li>이미지 URL</li></ul></td></tr><tr><td>⓶ 타이틀</td><td><ul><li>치환 후 최대 20자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓷ 텍스트</td><td><ul><li>치환 후 최대 180자</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>상품명</li><li>가격</li><li>회원 이름</li></ul></td></tr><tr><td>⓸ 버튼 1</td><td><ul><li>버튼명 : 최대 8자(변수 사용 불가)</li><li>랜딩 유형 : URL</li><li>※ 캐러셀 유형에서는 이미지 영역 클릭 시 버튼 1과 동일한 URL로 랜딩됩니다.</li></ul></td><td><ul><li>버튼 1 URL만 사용</li><li>모바일 URL</li><li>PC URL</li></ul></td></tr><tr><td>⓹ 버튼 2(선택)</td><td><ul><li>버튼명 : 최대 8자</li><li>랜딩 유형 : URL</li></ul></td><td><ul><li>사용 불가</li></ul></td></tr><tr><td>⓺ 더보기 버튼(선택)</td><td><ul><li>랜딩 유형 : URL</li></ul></td><td><ul><li>사용 불가</li></ul></td></tr><tr><td>URL</td><td><ul><li>최대 1000자 입력 가능</li><li>http:// 또는 https:// 형식의 랜딩 URL 지원</li><li>작성된 글자 수(고정 글자 수)나 치환된 글자 수가 초과되면 발송되지 않습니다.<br>가이드를 준수해 주세요.</li></ul></td><td><ul><li>버튼 1 URL만 사용</li><li>모바일 URL</li><li>PC URL</li></ul></td></tr></tbody></table>

***

## **유의 사항**

{% hint style="warning" %}
작성 가이드는 카카오 모먼트 정책을 준수합니다.
{% endhint %}

* 각 영역에서 공백만 입력할 수 없습니다.
* 본문이 들어가는 영역에 링크 형식을 작성할 수 없습니다.
* 줄바꿈의 횟수에 대한 제한이 있습니다.
* 각 어절 간 공백은 한 번만 사용 가능합니다.
* URL을 작성하는 영역에 다양한 쿼리 파라미터(링크 뒤에 ?나 & 기호로 연결하여 추적하는 URL 형식)가 붙은 딥링크 형태는 정상 동작되지 않을 수 있어 참고하여 설정해 주세요.
* 개인화 변수는 변수별 사용 가능한 영역에서 사용하여야 합니다.

{% hint style="danger" %}
**개인화 메시지 내 변수를 이용하여 수신자의 개인정보를 침해하거나 개인적인 특성이나 민감한 정보를 언급 또는 암시하여 타인의 권리를 침해할 수 있는 내용이 포함된 메시지를 발송한 채널은 카카오광고 운영정책에 따라 한시적 또는 영구적으로 메시지 발송이 제한될 수 있습니다.**
{% endhint %}

{% hint style="warning" %}
URL 내 UTF-8 코드로 인코딩되지 않은 특수문자나 한글이 있을 경우, iOS 기기 > 카카오톡 인앱 브라우저에서 정상 랜딩되지 않을 수 있습니다. 랜딩 오류가 발생할 수 있는 특수문자를 미리 참고하여 URL을 셋팅해 주세요.\
• %\
• | (vertical bar)\
• “
{% endhint %}

{% hint style="warning" %}
파라미터/매크로 치환이 필요한 딥링크 형식의 URL은 메시지 광고에서는 지원하고 있지 않아 정상 동작하지 않을 수 있습니다.\
해당 내용 참고하여 **메시지 소재 내 딥링크 형식의 URL 설정은 지양해 주세요.**
{% endhint %}


# 카카오톡 캠페인: 모먼트 분석 리포트

카카오톡 캠페인 분석 리포트의 기본 분석을 통해 선택한 카카오톡 캠페인의 기본적인 성과를 확인할 수 있습니다.

<img src="/files/z1EednTBKfFc8fpIkeq8" alt="" width="563">

## **기본 정보**

### **캠페인 공통 정보**

![](/files/k2etaXUEyt1IKB67U9Q0)

* 캠페인명 : 선택한 캠페인의 기본적인 정보 입니다. 캠페인명 클릭 시 캠페인의 상세 정보가 새 창으로 열립니다.
* 상세 설명 : 캠페인 만들기 진행 시 입력한 상세 설명입니다.
* 전환 기여 기간 : 캠페인의 리포트 기간을 선택할 수 있습니다. 3시간, 6시간, 발송 당일, 3일, 7일의 기간 중 한 기간을 선택하여 볼 수 있습니다.
* 리포트 기간 : 발송 후 선택된 전환 기여 기간 만큼에 해당되는 리포트 시작 일자와 마지막 일자를 보여줍니다.
* 발송 날짜/시간 : 발송이 진행된 일시를 보여줍니다.
* 상세보기 : 클릭 시 해당 캠페인 작성일 수정일 정보를 확인할 수 있습니다.

{% hint style="warning" %}
기간에 대한 자세한 설명은 [캠페인 분석 리포트 전환 기여 기간](http://doc.groobee.io/article/d9646n2jjl-) 정책을 확인하세요.
{% endhint %}

### **발송 결과 및 발송 비용**

![](/files/f0V3RahbGNrm8eLdRVpT)

***

## **기본 분석**

### **요약 지표**

![](/files/N0ZKO4oc6bv29GCr1LpY)

* 조회 기간 내 데이터 요약 지표입니다.
* 클릭, 주문 수는 세션 당 클릭을 기준으로 카운팅되며, 같은 사용자가 다시 클릭하는 경우에도 30분 이내 세션이 유지되면 중복으로 카운팅 하지 않습니다.\
  같은 사용자가 다른 세션에서 클릭, 주문하는 경우에는 카운팅 됩니다.
* 발송 수 : 발송 요청 수 입니다. 피로도가 적용된 캠페인은 피로도 적용이 표시됩니다.
* 상세보기 : 발송 수 상세를 확인합니다. 피로도 적용했을 시 피로도가 적용되기 전의 발송 대상 수, 피로도가 적용된 수, 실제 발송 요청 수를 확인할 수 있습니다.\
  \
  ![](/files/uh5KxOgZogJsFz3Xfz6H)
  * 발송 대상 수 : 피로도 적용 전 선택한 전체 타겟의 수 입니다.
  * 피로도 적용 수 : 피로도가 적용되어 발송 요청 대상에서 제외된 수 입니다.
  * 발송 수 : 실제 해당 캠페인에서 발송 요청된 수 입니다.

{% hint style="warning" %}
자세한 피로도 설정 방법은 [피로도 관리하기](/new-admin/settings/fatigue) 문서에서 확인해 주세요.
{% endhint %}

* 성공 수 : 발송 성공 수 입니다.
* 클릭 수 : 메시지내의 클릭 요소의 클릭 합계입니다.
* 상세보기 : 클릭 요소 상세를 확인할 수 있습니다.\
  \
  ![](/files/qTJJWnBmKeigp7BVyGql)
* 주문 수 : 클릭 요소를 클릭 후 세션 내 주문 수 입니다.
* 전환 금액 : 클릭 요소를 클릭 후 세션 내 주문 금액입니다.
* 발송 성공률 : 성공 수 / 발송 수 \* 100 %
* 클릭 전환율 : (메시지 클릭 수) / (메시지 성공 수) \* 100 %
* 주문 전환율 : (메시지 주문 수) / (메시지 성공 수) \* 100 %

<img src="/files/Eqy0jgpkfME6Ti1tc1Xe" alt="" width="563">

### **퍼널 분석**

![](/files/opVA4SdBRFGtpOLf4XQn)

* 캠페인을 발송, 수신부터 주문 전환에 이르기까지의 흐름을 시각화하고 단계별로 수치와 비중을 표시합니다.

### **데이터 추이**

![](/files/JYpL3AdCnVo2DSAmvXVP)

* 조회 기간 내 데이터 테이블에 해당하는 데이터의 시간별 추이 그래프입니다.
* 클릭/주문 수 데이터 추이를 막대, 꺾은선 그래프 형태로 확인할 수 있습니다

### **데이터 테이블**

![](/files/AKt77Sfy1nnaZ9bxnEDN)

한 시간 단위로 표기되며, 데이터 항목은 다음과 같습니다.

* 클릭 수 : 메시지에 링크 설정이 없거나, URL 설정이 없을 시 0으로 계산됩니다.
* 클릭 전환율 : (메시지 클릭 수 / 메시지 성공 수) \* 100
* 주문 수 : 메시지 주문 수
* 주문 전환율 : (메시지 주문 수 / 메시지 성공 수) \* 100
* 전환 금액 : 메시지 전환 금액

***

## **주문 상품 분석**

### **상세 주문 리스트**

<img src="/files/nEydGiPTH5C0PCabap2q" alt="" width="563">

* 조회 기간 내 해당 캠페인의 클릭 요소가 클릭된 후 같은 세션 내에서 상품이 주문 되었을 때의 주문 이력입니다.
* 주문 일시, 주문 번호, 회원 ID, 주문 금액, 주문 수량, 주문 상품을 확인할 수 있습니다.
* 회원 ID 항목에는 로그인 회원의 주문인 경우 회원ID가 노출되고, 로그인하지 않은 회원의 주문인 경우 '비로그인 회원', 비회원의 주문인 경우 '비회원'이 노출됩니다.
* 주문 상품 마우스 오버 시 전체 주문 상품을 확인 할 수 있습니다.

### **상품 랭킹 TOP 100**

<img src="/files/7N4kGYxvmpk9EPRaZh8L" alt="" width="563">

* 선택한 전환 기여 기간에 따른 조회 기 내 해당 캠페인의 클릭 요소가 클릭된 후 같은 세션 내에서 조회 또는 주문된 상품의 랭킹입니다.
* 상품 랭킹은 1일(발송 당일) 이상의 전환 기여 기간이 선택될 시 표시됩니다. (시간 단위의 전환 기여 기간에서는 제한됩니다.)
* 상품 뷰 수, 주문 수, 전환 금액 순으로 상품 랭킹 확인이 가능합니다.
* 예를 들어 상품 뷰 수 Top 100은 조회 기간 내 캠페인의 클릭 요소를 클릭한 후 많이 본 상품 순으로 기타 데이터 항목들을 표시합니다.
* 해당하는 탭의 데이터가 0인 경우는 제외되어 표시됩니다.

{% hint style="warning" %}
그루비에서는 페이지를 둘러보거나, 검색하는 등의 방문자 행동이 지속되는 접속 상황의 단위를 세션이라고 합니다. 방문자가 아무 행동도 하지 않은 채 30분이 지나면 세션은 종료됩니다. 세션은 그루비가 발행하는 쿠키(cookie)를 기준으로 판단합니다.
{% endhint %}


# 정산하기

## **발송 비용 충전하기**

* 카카오 모먼트를 통한 발송을 하기 위해서 카카오 모먼트 광고 결제 정책에 따라 먼저 광고 계정에 광고 선금액을 충전해야 합니다.
* 비용 충전은 카카오 모먼트 광고 계정에 로그인한 후 직접 진행하셔야 합니다.

**충전 방식은 다음과 같습니다.**

1. 카카오 모먼트 광고 계정에 로그인합니다. <https://moment.kakao.com/>
2. 좌측 메뉴에서 설정 > 비즈월렛 관리 메뉴로 이동하여 금액을 충전합니다.
3. 충전 후 충전 금액과 잔액을 확인합니다.

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

{% hint style="info" %}
광고캐시 충전 및 결제 관련 정책은 카카오 모먼트의 정책을 따라 갑니다. 자세한 정책은 카카오 모먼트 도움말을 확인해 주세요.

카카오 모먼트 [비즈월렛 관리](https://kakaobusiness.gitbook.io/main/ad/moment/intro/run/payment) 문서를 확인해 주세요.
{% endhint %}

## **그루비에서 사용료 확인하기**

* 그루비 어드민에서도 카카오 모먼트 발송 사용료를 확인할 수 있습니다.
* 카카오톡 캠페인 : 모먼트 페이지에서 당월 사용료를 확인할 수 있습니다.
* 당월 사용료에서 상세보기를 클릭하면 카카오톡 캠페인 : 모먼트 사용료 내역을 확인할 수 있는 페이지로 이동합니다.

<img src="/files/LlIRg62MEatPGG51m7lW" alt="" width="563">

### **광고 계정, 충전 잔액**

<img src="/files/PlCxiRV6LkuVNNG8vcBR" alt="" width="364">

광고 계정 및 충전 잔액을 확인할 수 있습니다.

* 광고 계정 : 그루비 영업권이 설정된 카카오 모먼트 광고 계정 ID를 확인합니다.
* 충전 잔액 : 카카오 모먼트 광고 계정에 충전된 잔액을 확인합니다. 충전 잔액은 카카오 모먼트에서 제공해주는 금액이며, VAT 포함 금액이 반영됩니다.

{% hint style="danger" %}
발송 요청 시 요청한 타겟의 수보다 충전 잔액이 부족하면 해당 캠페인 발송이 되지 않습니다.\
충전 잔액을 확인하여 발송해 주세요.
{% endhint %}

### **발송 단가**

<img src="/files/aYGVlUtTxlz0izqHeO3k" alt="" width="563">

* 발송 단가 : 카카오 모먼트 발송 건 당 단가를 확인할 수 있습니다.
* 와이드 리스트 / 캐러셀 피드
  * 발송 단가 : 30원
  * 프로모션가 : 25원(카카오 모먼트에서 프로모션 종료 시 정상 단가로 발송됩니다.)

### **당월 사용료**

<img src="/files/FDrbBSE4Ac8MoMM3xPRN" alt="" width="375">

당월 사용료를 확인할 수 있습니다.

* 사용 기간 : 당월 1일 \~ 조회 당일까지의 일자를 확인합니다.
* 카카오 모먼트 사용료 : 당월의 사용 기간동안의 사용료를 확인합니다.

{% hint style="warning" %}
부가세(VAT)를 제외한 금액이 표시됩니다.
{% endhint %}

### **카카오 모먼트: 사용료 내역**

<img src="/files/7iisP7ZVbfqw5X8Qha5u" alt="" width="563">

* 이번 달 이전의 월별 사용료를 확인합니다.
* 월별 사용료, 사용 기간, 카카오톡 모먼트 사용료를 확인합니다.

{% hint style="warning" %}
부가세(VAT)를 제외한 금액이 표시됩니다.
{% endhint %}


# 카카오톡 캠페인: 알림톡

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

## **카카오 알림톡이란?**

카카오 알림톡은 고객에게 **정보성 메시지**를 발송할 수 있는 서비스입니다.

알림톡의 가장 큰 특징은 **카카오톡 채널 친구 여부와 관계없이 발송**할 수 있다는 점으로, 고객의 사전 동의 없이도 주문, 배송, 예약 등과 같은 정보성 메시지를 안정적으로 전달할 수 있습니다. 주로 다음과 같은 메시지를 발송하는 데 사용됩니다.

* **주문/결제/배송 알림:** 주문 확인, 결제 완료, 배송 시작 등 고객이 주문한 상품에 대한 상태 변경을 알립니다.
* **회원가입/인증 안내:** 회원가입 환영 메시지, 본인 인증 안내 등 고객의 서비스 이용에 필요한 정보를 전달합니다.
* **예약/출고 알림:** 예약 완료, 상품 출고 등 고객이 요청한 서비스에 대한 진행 상황을 알립니다.

{% hint style="info" %}
정보성 메시지란 정보통신망법 안내서 중 ‘영리목적 광고성 정보의 예외’에 해당하는 메시지입니다.

[**정보성 메시지 알아보기**](https://kakaobusiness.gitbook.io/main/ad/infotalk/audit#id-1)
{% endhint %}


# 알림톡 발송을 위한 사전 준비

카카오 알림톡을 발송하기 위해서는 다음의 사전 준비가 필요합니다.

## **1. 카카오톡 비즈니스 채널 개설**

기존에 개설된 채널이 없다면, [**카카오톡 비즈니스 채널 만들기**](https://kakaobusiness.gitbook.io/main/channel/start) 가이드를 참고하여 [**카카오 비즈니스**](https://business.kakao.com/)에서 채널을 새로 개설해 주세요.

{% hint style="info" %}
새롭게 개설한 비즈니스 채널의 심사 및 승인까지는 영업일 기준 3\~5일이 소요됩니다.
{% endhint %}

***

## **2. 카카오톡 채널 연동**

{% hint style="warning" %}
카카오톡 채널은 개설 후 다음의 설정이 완료되어야 연동할 수 있습니다.

(1) \[카카오 비즈니스 파트너센터 > 채널 > 채널 정보 > 고객센터 연락처] 전화번호 입력\
(2) \[카카오 비즈니스 파트너센터 > 채널 > 채널 정보 > 옵션 설정 > 채널 공개] ON 상태로 설정
{% endhint %}

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

(1) [**\[카카오톡 설정 > 채널 연동\]**](/new-admin/settings/kakao/channel)에서 <img src="/files/9VHnsJNqVKQBH8eF8VIJ" alt="" data-size="line"> 버튼을 클릭해 주세요.

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

(2) 카카오톡 채널 아이디와 관리자 전화번호를 입력하고 카테고리를 선택한 뒤, <img src="/files/VAxAJpOAzOBaPsmTu4HM" alt="" data-size="line"> 버튼을 클릭해 주세요.

(3) 카카오톡으로 전송된 **인증번호 6자리**를 입력하고 <img src="/files/8Fasg9oMIdyelaojap6z" alt="" data-size="line"> 버튼을 클릭하면 카카오톡 채널 연동이 완료됩니다.&#x20;

{% hint style="danger" %}
채널 연동 오류 시, [**채널 연동 오류 사유별 해결 방법**](https://groobee.gitbook.io/groobee-docs/new-admin/undefined-8/undefined-2#undefined)을 참고해 주세요.
{% endhint %}

***

## **3. 개인정보 처리방침 내 수탁자 고지 안내**

관련 법령 미준수로 인한 과태료 부과 등의 불이익을 받지 않도록, [**\[개인정보 처리방침\]**](/new-admin/notes/privacy-policy) 문서를 참고하여 귀사의 개인정보 처리방침 내 '개인정보 처리 위탁 현황' 항목에 수탁자를 고지해 주세요.


# 캠페인 관리

생성한 카카오 알림톡 캠페인의 현황을 확인하고, 관리(진행, 수정, 삭제 등)하는 페이지입니다.

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

{% hint style="warning" %}
캠페인을 정상적으로 관리하려면, 다음 조건을 모두 만족해야 합니다.

(1) 카카오톡 채널 연동\
(2) 카카오톡 채널 정상 상태\
(3) 발신 프로필 정상 상태\
(4) 캠페인에서 활용 중인 템플릿 승인 상태
{% endhint %}

## **1. 만들기**

<img src="/files/LijoMXKw60pZ6FnEWKjN" alt="" data-size="line"> 버튼 클릭 시 **새로운** **카카오 알림톡 캠페인 만들기** 페이지로 이동합니다.

***

## **2. 템플릿 관리**

<img src="/files/nct0N6YCMPSMyWfLDGa3" alt="" data-size="line"> 버튼 클릭 시 **템플릿 관리** 페이지로 이동합니다.

{% hint style="warning" %}
템플릿 관리 페이지로 이동하려면, 다음 조건을 모두 만족해야 합니다.

(1) 카카오톡 채널 정상 상태\
(2) 발신 프로필 정상 상태
{% endhint %}

***

## **3. 미니 대시보드**

미니 대시보드에서는 캠페인 현황과 당월 사용료를 한눈에 파악할 수 있습니다.

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

* **API 트리거 발송:** 현재 '진행 중' 상태인 API 트리거 캠페인의 수를 보여줍니다.
* **완료 캠페인:** 오늘 및 최근 7일 동안 완료된 캠페인의 수를 각각 보여줍니다.
* **당월 사용료:** 이번 달에 발생한 총발송 비용과 지난달 대비 비용 증감률을 함께 보여줍니다. '상세보기'를 클릭하면 월별 상세 내역을 확인할 수 있습니다.

***

## **4. 캠페인 리스트**

### **4-1. API 트리거 발송**

생성한 API 트리거 발송 캠페인 목록입니다.

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

<table><thead><tr><th width="159.8359375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>캠페인명</strong></td><td>캠페인 생성 시 설정한 이름이며, 클릭 시 수정 페이지로 이동합니다.</td></tr><tr><td><strong>상태</strong></td><td><p>캠페인의 진행 상태를 나타내며, 클릭하여 '진행' 또는 '중지'로 변경할 수 있습니다.</p><ul><li><strong>진행중</strong><img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">: 설정된 스케줄에 따라 캠페인이 진행 중인 상태입니다.</li><li><strong>중지</strong><img src="/files/TRr31QJE6zxLsx5PmtD2" alt="" data-size="line"><strong>:</strong> 캠페인이 일시적으로 중지된 상태입니다. 설정된 시작 일시가 되어도 자동으로 진행되지 않습니다.</li></ul></td></tr><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>캠페인 시작 후, 현재까지 발송을 성공한 수입니다.</td></tr><tr><td><strong>캠페인 기간</strong></td><td>캠페인이 진행되는 시작 및 종료 일자입니다. 종료 시점이 지난 캠페인은 완료 탭으로 자동 이동합니다.</td></tr><tr><td><strong>최종 수정일</strong></td><td>캠페인을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

### **4-2. 완료 캠페인**

설정된 기간이 종료되었거나 수동으로 완료 처리한 캠페인 목록입니다.

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

<table><thead><tr><th width="160.1015625">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>캠페인명</strong></td><td>캠페인 생성 시 설정한 이름입니다. 클릭 시 설정한 내용을 확인할 수 있습니다.</td></tr><tr><td><strong>발송 방식</strong></td><td>메시지를 발송하는 방식입니다. (예: API 트리거) </td></tr><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>캠페인 진행 기간 동안 발송을 성공한 수입니다.</td></tr><tr><td><strong>캠페인 기간</strong></td><td>캠페인이 진행된 시작 및 종료 일자입니다.</td></tr><tr><td><strong>캠페인 완료 일시</strong></td><td>캠페인이 완료 탭으로 이동한 일시입니다.</td></tr></tbody></table>

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

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

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

<table><thead><tr><th width="160.1015625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/wIrIsQFbNXIu35OPhaS4" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 캠페인을 수정합니다. 단, <strong>이미 발송이 시작된(진행 중, 완료) 캠페인</strong>은 수정할 수 없으며 내용 확인만 가능합니다.</td></tr><tr><td><img src="/files/xHwQYOmNds52LGsy65QX" alt="" data-size="line"> <strong>복사</strong></td><td>선택한 캠페인을 복사하여 동일한 내용의 새로운 캠페인을 생성합니다. 복사된 캠페인은 캠페인명 뒤에 '-COPY'가 추가됩니다.</td></tr><tr><td><img src="/files/96B2sMaulgkXFwUtFWB7" alt="" data-size="line"> <strong>분석 리포트</strong></td><td>해당 캠페인의 성과를 분석 리포트로 확인합니다. <strong>캠페인 발송 이력이 있는 경우(발송 수 1건 이상)에만 활성화</strong>됩니다.</td></tr><tr><td><img src="/files/sdXrs7KYamhq83aIzqbu" alt="" data-size="line"> <strong>미리보기</strong></td><td>메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.</td></tr><tr><td><img src="/files/gu8lFQqjfC5lenYhclvS" alt="" data-size="line"> <strong>코드 샘플 복사</strong></td><td>API 요청에 필요한 코드 샘플을 복사합니다. (API 트리거 캠페인 전용 기능)</td></tr><tr><td><img src="/files/nZKGcuZF4mQ9N3pUQ4TI" alt="" data-size="line"> <strong>완료 탭으로 이동</strong></td><td>캠페인을 '완료' 탭으로 이동시켜 보관합니다. <strong>'중지' 상태인 캠페인만 이동</strong>할 수 있습니다.</td></tr><tr><td><img src="/files/WCemdenye04VXDipLJHP" alt="" data-size="line"> <strong>삭제</strong></td><td>캠페인을 영구적으로 삭제합니다. <strong>'완료' 상태의 캠페인만 삭제</strong>할 수 있으며, 삭제된 캠페인은 복구할 수 없습니다.</td></tr></tbody></table>

***

## **5. 태그 필터**

캠페인 생성 시 추가한 태그를 기준으로, 원하는 캠페인만 목록에서 필터링하여 볼 수 있습니다.

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

(1) 원하는 태그를 모두 선택(체크)한 후 **\[선택] 버튼**을 클릭해 주세요.

(2) 선택한 태그가 포함된 캠페인만 목록에 표시됩니다.

***

## **6. 검색**

검색창에 캠페인명을 직접 입력하여 원하는 캠페인을 찾을 수 있습니다.


# 캠페인 만들기

캠페인 관리 페이지의 <img src="/files/qhaztNoJhinW5vVJcVDd" alt="" data-size="line"> **버튼**을 클릭하여 새로운 카카오 알림톡 캠페인을 생성할 수 있습니다.

{% hint style="info" %}
카카오 알림톡 캠페인은 **API 트리거 발송** 방식만 지원됩니다.
{% endhint %}

{% hint style="success" %}
카카오 알림톡 캠페인은 **승인 상태의 템플릿**이 있어야만 생성할 수 있습니다.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>API 트리거 발송</strong></td><td>외부 API 요청을 통해 원하는 시점에 특정 고객에게 메시지를 보내는 방식입니다.</td><td><a href="/files/ZciidaWnNzYShm77PQ4J">/files/ZciidaWnNzYShm77PQ4J</a></td><td><a href="/pages/mqcBQABrrV1FIO35whjq">/pages/mqcBQABrrV1FIO35whjq</a></td></tr></tbody></table>


# API 트리거 발송

외부 API 요청을 통해 **원하는 시점에 특정 고객에게 메시지를 실시간으로 보내는 방식**입니다.

고객사의 자체 시스템(CRM, 주문/재고 관리 등)의 이벤트와 연동하여 맞춤형 메시지를 발송할 수 있습니다. (예: 품절 상품 재입고 알림, 주문 상태 변경 안내)

{% hint style="warning" %}
&#x20;메시지 구성 요소별 [**발송 가능 최대 글자 수**](https://docs.groobee.ai/~/changes/276/new-admin/kakao-alimtalk/kakao-alimtalk-create/api-trigger#id-2-1)를 고려하여 API를 요청해 주세요.
{% endhint %}

## **1단계: 기본 설정**

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

* **캠페인명:** 캠페인의 이름을 입력해 주세요. (문자 구분 없이 최대 40자 입력 가능)
* **상세 설명:** 필요시 캠페인에 대한 상세 설명을 입력해 주세요. (문자 구분 없이 최대 400자 입력 가능)
* **태그 #:** 캠페인에 태그를 설정해 주세요. 캠페인 리스트에서 태그 필터를 통해 캠페인을 필터링할 때 활용됩니다.

***

## **2단계: 메시지 설정**

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

### **1. 템플릿 선택**

캠페인에 사용할 템플릿을 선택해 주세요. 템플릿은 검수가 완료된 **승인 상태의 템플릿**만 선택할 수 있습니다.

### **2. 템플릿 정보**

선택한 템플릿에 설정된 상세 정보를 확인할 수 있습니다.

* **기본 설정:** 템플릿의 이름, 코드, 카테고리와 같은 기본 정보를 보여줍니다.
* **개인화 설정:** 메시지에 사용된 개인화 변수의 목록을 보여줍니다.
* **템플릿 메시지:** 실제 발송될 메시지의 제목, 본문, 버튼 등의 내용을 보여줍니다.
* **미리보기:** 알림톡 메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.

<details>

<summary>메시지 구성 요소별 발송 가능 최대 글자 수</summary>

| 구성 요소            | 발송 가능 최대 글자 수                                                                                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **강조 표기형 > 제목**  | 50자                                                                                                                                                           |
| **강조 표기형 > 부제목** | 18자                                                                                                                                                           |
| **메시지 본문**       | <ul><li><strong>카카오톡 25.8.0 버전 이상 사용자:</strong> 1,300자</li><li><strong>카카오톡 25.8.0 버전 미만 사용자:</strong> 1,000자</li></ul>                                       |
| **버튼 > 링크**      | <ul><li><strong>모바일:</strong> 920자 </li><li><strong>PC:</strong> 920자</li><li><strong>Android:</strong> 1,000자</li><li><strong>iOS:</strong> 1,000자</li></ul> |

</details>

{% hint style="info" %}
미리보기는 **참고용으로 제공**되며, 실제 메시지는 수신자의 기기나 앱 환경에 따라 다르게 보일 수 있습니다.
{% endhint %}

***

## **3단계: 옵션 설정**

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

### **1. 스케줄 설정**

캠페인이 진행될 기간을 설정해 주세요.

* **수동 종료 전까지:** 직접 종료하기 전까지 캠페인이 계속 진행됩니다.
* **기간 지정:** 시작일과 종료일을 미리 설정하여, 해당 기간 내에만 캠페인이 진행됩니다.

{% hint style="warning" %}
캠페인은 저장 후 **진행중**<img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">으로 상태를 변경해야 설정한 시간에 맞춰 진행됩니다.
{% endhint %}

### **2. 코드 샘플**

API를 통해 알림톡을 발송할 때 사용하는 코드 예시입니다. 아래 설명을 참고하여 개발팀과 소통 후 알림톡 발송을 요청해 주세요.

* **캠페인 키:** 캠페인마다 부여되는 고유 ID입니다. 이 키를 통해 발송할 캠페인이 식별되므로, API 요청 시 필수로 포함해 주세요.
* **메시지 발송 대상:** 메시지를 수신할 대상을 지정하는 값으로, **phoneNumber, appUserId, userKey** 중 하나를 선택하여 요청해 주세요.
* **개인화 데이터:** 템플릿에 개인화 변수(예: #{name})를 사용한 경우, 각 변수에 치환될 실제 값을 담아 요청해 주세요. 치환 값이 없으면 설정된 대체 값으로 발송됩니다.

<details>

<summary>응답 코드</summary>

| type | code | message                                    | httpStatus              | httpStatusCode |
| ---- | ---- | ------------------------------------------ | ----------------------- | -------------- |
| 성공   | 0    | 성공                                         | OK                      | 200            |
| 헤더   | 1101 | x-api-key 헤더가 누락되었습니다.                     | BAD\_REQUEST            | 400            |
| 헤더   | 1102 | Content-Type 헤더가 누락되었습니다.                  | BAD\_REQUEST            | 400            |
| 일반   | 1201 | 요청 본문에 내용이 없습니다.                           | BAD\_REQUEST            | 400            |
| 일반   | 1202 | 요청 데이터 행이 너무 많습니다.                         | BAD\_REQUEST            | 400            |
| 일반   | 1203 | 요청 포맷이 잘못되었습니다.                            | BAD\_REQUEST            | 400            |
| 일반   | 1204 | 올바르지 않은 날짜 형식입니다.                          | BAD\_REQUEST            | 400            |
| 인증   | 1401 | API 키가 유효하지 않습니다.                          | UNAUTHORIZED            | 401            |
| 인증   | 1402 | API 사용권한이 없습니다.                            | UNAUTHORIZED            | 401            |
| 인증   | 1403 | 등록되지 않은 회원사                                | UNAUTHORIZED            | 401            |
| 인증   | 1404 | 미승인 회원사                                    | UNAUTHORIZED            | 401            |
| 인증   | 1405 | 만료된 회원사                                    | UNAUTHORIZED            | 401            |
| 기타   | 2000 | 내부 서버 에러                                   | INTERNAL\_SERVER\_ERROR | 500            |
| 알림톡  | 7001 | 채널 연동 필요                                   | BAD\_REQUEST            | 400            |
| 알림톡  | 7002 | 발신프로필이 차단 되었습니다.                           | BAD\_REQUEST            | 400            |
| 알림톡  | 7003 | 발신프로필이 휴면 상태입니다.                           | BAD\_REQUEST            | 400            |
| 알림톡  | 7004 | 해당 캠페인의 템플릿이 대기 상태입니다.                     | BAD\_REQUEST            | 400            |
| 알림톡  | 7005 | 해당 캠페인의 템플릿이 검수 요청 상태입니다.                  | BAD\_REQUEST            | 400            |
| 알림톡  | 7006 | 해당 캠페인의 템플릿이 휴면 상태입니다.                     | BAD\_REQUEST            | 400            |
| 알림톡  | 7007 | 해당 캠페인의 템플릿이 차단 상태입니다.                     | BAD\_REQUEST            | 400            |
| 알림톡  | 7008 | 해당 캠페인의 템플릿이 중지 상태입니다.                     | BAD\_REQUEST            | 400            |
| 알림톡  | 7009 | 해당 캠페인의 템플릿이 검수 반려 상태입니다.                  | BAD\_REQUEST            | 400            |
| 알림톡  | 7010 | 해당 캠페인의 템플릿이 만료 상태입니다.                     | BAD\_REQUEST            | 400            |
| 알림톡  | 7011 | 발송을 위한 필수 파라미터가 누락 되었습니다.                  | BAD\_REQUEST            | 400            |
| 알림톡  | 7012 | 전달하신 전화번호 길이가 12자가 아닙니다.                   | BAD\_REQUEST            | 400            |
| 알림톡  | 7997 | 카카오 알림톡 발송 단가가 적용되지 않았습니다. - 그루비에 문의해 주세요. | BAD\_REQUEST            | 400            |
| 알림톡  | 7998 | 카카오 발송 API call error - 그루비에 문의해 주세요.      | INTERNAL\_SERVER\_ERROR | 500            |
| 알림톡  | 7999 | 내부 서버 에러                                   | INTERNAL\_SERVER\_ERROR | 500            |

</details>


# 캠페인 분석 리포트

발송 이력이 있는 캠페인의 성과를 확인하는 페이지입니다. **채널 추가, 상담/문의 등 링크 버튼 외 클릭 지표**는 템플릿 분석 리포트에서 확인할 수 있습니다.

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

{% hint style="info" %}

* 캠페인 성과는 **발송일로부터 7일간** 집계합니다.
* **클릭 지표**는 링크 버튼(웹/앱)에 설정된 **모바일 및 PC 링크**의 클릭 수만 집계합니다
  {% endhint %}

## **1. 조회 기간**

조회 기간을 선택해 주세요. 설정한 조회 기간 동안의 캠페인 성과를 확인할 수 있습니다.

***

## **2. 캠페인 정보**

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

* **캠페인명:** 캠페인 생성 시 설정한 이름입니다. 클릭 시 설정한 내용을 확인할 수 있습니다.
* **상세 설명:** 캠페인 생성 시 설정한 상세 설명입니다.
* **최초 발송일:** 캠페인에서 가장 처음 발송한 날짜입니다.
* **최근 발송일:** 캠페인에서 가장 최근에 발송한 날짜입니다.
* **활용 템플릿:** 캠페인에 사용된 알림톡 템플릿의 이름입니다.
* **템플릿 분석 리포트**<img src="/files/ZI01fyOKmb8Uv8Fmqzd3" alt="" data-size="line">**:** 클릭 시 활용 템플릿의 분석 리포트로 이동합니다.

### **2-1. 캠페인 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 캠페인 상세 정보를 확인할 수 있습니다.

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

* **작성일:** 캠페인이 생성된 날짜입니다.
* **캠페인 기간:** 캠페인이 진행되는 시작 및 종료 일자입니다.
* **최종 수정일:** 캠페인을 가장 최근에 수정한 날짜입니다.

***

## **3. 기본 분석**

### **3-1. 요약 지표**

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

<table><thead><tr><th width="159.7109375">지표</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>조회 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>조회 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액</strong></td><td>조회 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>발송 성공률</strong></td><td>발송 수 대비 발송에 성공한 비율입니다. (발송 성공 수/발송 수 * 100%)</td></tr><tr><td><strong>클릭 전환율</strong></td><td>발송 성공 수 대비 웹 링크 또는 앱 링크 버튼을 클릭한 비율입니다. (클릭 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>주문 전환율</strong></td><td>발송 성공 수 대비 주문을 완료한 비율입니다. (주문 수/발송 성공 수 * 100%)</td></tr></tbody></table>

{% hint style="info" %}
**세션(Session)이란?:** 한 명의 방문자가 사이트에 접속해서 활동하는 시간의 단위를 의미합니다.

* **세션 종료:** 마지막 행동 후 30분 동안 아무런 움직임이 없으면 세션은 자동으로 종료됩니다.
* **세션 기준:** 세션은 그루비가 발행하는 쿠키(Cookie)를 기준으로 구분됩니다.
  {% endhint %}

### **3-2. 클릭 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 수**를 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가 웹 링크 또는 앱 링크 버튼입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 수:** 해당 클릭 요소에서 발생한 클릭 수입니다.

### **3-3. 클릭 전환율 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 전환율**을 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가된 웹 링크 또는 앱 링크 버튼입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 전환율:** 해당 클릭 요소에 대한 클릭 전환율입니다.

### **3-4. 데이터 추이**

조회 기간 동안 일별 클릭 수와 주문 수 변화를 그래프로 확인할 수 있습니다.

<figure><img src="/files/6rQL6z2AR15J6yStuCBZ" alt=""><figcaption></figcaption></figure>

### **3-5. 데이터 테이블**

조회 기간 동안 일별 성과 데이터를 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>해당 날짜에 발송을 성공한 비율입니다.</td></tr><tr><td><strong>클릭 수</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>

***

## **4. 주문 상품 분석**

### **4-1. 상세 주문 리스트**

조회 기간 동안 클릭 후 발생한 주문의 상세 이력을 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>회원 ID</strong></td><td>주문한 회원의 ID입니다. 비로그인 또는 비회원 주문 시 '비로그인'으로 표시됩니다.</td></tr><tr><td><strong>주문 금액(원)</strong></td><td>해당 주문에서 발생한 주문 금액입니다.</td></tr><tr><td><strong>주문 수량</strong></td><td>해당 주문에 포함된 상품의 총 수량입니다.</td></tr><tr><td><strong>주문 상품</strong></td><td>해당 주문에 포함된 모든 상품 목록입니다. 행(Row)을 클릭하면 전체 상품명을 확인할 수 있습니다.</td></tr></tbody></table>

### **4-2. 상품 랭킹 TOP 100**

조회 기간 동안 주문된 상품의 랭킹을 상품 뷰 수, 주문 수, 전환 금액 순으로 확인할 수 있습니다.

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

<table><thead><tr><th width="159.64453125">헤더</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>상품의 판매가입니다.</td></tr><tr><td><strong>상품 뷰 수</strong></td><td>메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 해당 상품이 조회된 수</strong>입니다. 같은 세션 내 모든 조회 수를 합산하여 집계합니다.</td></tr><tr><td><strong>주문 수</strong> </td><td>메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 해당 상품이 주문된 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 해당 상품이 주문된 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>


# 템플릿 관리

생성한 카카오 알림톡 템플릿의 현황을 확인하고, 관리(검수 요청, 수정, 삭제 등)하는 페이지입니다.

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

## **1. 만들기**

<img src="/files/XiTtBIlKuzfnmh0jhP4W" alt="" data-size="line"> 버튼 클릭 시 **새로운** **카카오 알림톡 템플릿 만들기 페이지**로 이동합니다.

{% hint style="warning" %}
템플릿을 생성하려면, **카카오톡 채널을 연동**해야합니다.
{% endhint %}

***

## **2. 템플릿 리스트**

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

<table><thead><tr><th width="159.8359375">헤더</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>템플릿의 현재 상태입니다. (예: 승인, 휴면 등)</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><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>템플릿을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

<details>

<summary><strong>템플릿 상태</strong></summary>

<table><thead><tr><th width="159.796875">상태</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/VVZrNXqtH5uemj5k0jJX" alt="" data-size="line"> <strong>검수 대기</strong></td><td>카카오에 검수를 요청하지 않은 상태입니다.</td></tr><tr><td><img src="/files/2sTSBCFAM139pb1bS1i5" alt="" data-size="line"> <strong>검수중</strong></td><td>검수를 요청하여 카카오에서 템플릿을 검수 중인 상태입니다.</td></tr><tr><td><img src="/files/EoxX6bg8IMQv682SHbwg" alt="" data-size="line"> <strong>검수 반려</strong></td><td>검수 결과 템플릿이 반려된 상태이며, 수정 시 검수 대기 상태로 변경됩니다. <br>상태 변경 이력에서 반려 사유를 확인하고 템플릿을 수정해주세요.</td></tr><tr><td><img src="/files/bsqlvvYC9RLLrxdEBt3B" alt="" data-size="line"> <strong>승인</strong></td><td>검수가 완료되어 캠페인에 사용할 수 있는 상태입니다.</td></tr><tr><td><img src="/files/wMVYpVhXzVHYVd0BYtJF" alt="" data-size="line"> <strong>휴면</strong></td><td>1년 이상 발송 이력이 없어 휴면 처리된 상태입니다.<br>'휴면 해제'를 통해 다시 승인 상태로 변경할 수 있습니다.</td></tr><tr><td><img src="/files/q5Klr8ZTVmO8wkCmlJ7T" alt="" data-size="line"> <strong>만료</strong></td><td>휴면 상태가 1년 이상 지속되어 만료된 템플릿입니다.<br>만료 템플릿은 더 이상 사용할 수 없습니다.</td></tr><tr><td><img src="/files/gFs0pzJZd9JoHmUNLlxx" alt="" data-size="line"> <strong>차단</strong></td><td>카카오 운영 정책 위반으로 관리자에 의해 차단된 상태입니다.<br>차단 해제는 groobee_sales@plateer.com로 문의해 주세요.</td></tr></tbody></table>

</details>

***

## **3. 템플릿 상세**

템플릿 리스트의 행(Row) 클릭 시 해당 템플릿에 대한 세부 정보를 확인할 수 있습니다.

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

* **상태 변경 이력:** 템플릿의 상태가 '승인', '반려' 등으로 변경된 모든 이력을 보여줍니다. 또한 검수 과정에서 사용자가 제출한 참고 의견, 첨부 파일과 카카오 담당자가 남긴 반려 사유 등 소통 내역까지 모두 조회할 수 있습니다.
* **카테고리 변경 이력:** 템플릿 검수 과정에서 카테고리가 변경된 경우, 해당 이력을 모두 확인할 수 있습니다.
* **캠페인 활용 목록:** 템플릿을 사용중인 모든 캠페인을 확인할 수 있습니다.

***

## **4. 관리 도구**

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

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

<table><thead><tr><th width="160.03515625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/0XwdQjEr68wmbufloTF3" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 템플릿의 내용을 수정합니다. <strong>'검수 대기' 상태의 템플릿만</strong> 수정할 수 있으며, 다른 상태에서는 내용 확인만 가능합니다.</td></tr><tr><td><img src="/files/lKGhMBRAGoYf4ibAMzxK" alt="" data-size="line"> <strong>복사</strong></td><td>선택한 템플릿과 동일한 내용의 새 템플릿을 생성합니다. 복사본은 '검수 대기' 상태이며, 템플릿명과 코드 뒤에 '-COPY'가 붙습니다.</td></tr><tr><td><img src="/files/TRzD5KfQecFQfReTpyh1" alt="" data-size="line"> <strong>분석 리포트</strong></td><td>해당 템플릿의 성과를 분석 리포트로 확인합니다. <strong>템플릿을 사용한 캠페인의 발송 이력이 있는 경우(누적 발송 수 1건 이상)에만</strong> 활성화됩니다.</td></tr><tr><td><img src="/files/nJZj5U3HnszH6eILSoJx" alt="" data-size="line"> <strong>미리보기</strong></td><td>알림톡 메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.</td></tr><tr><td><img src="/files/Xe0tjCU8zRFvRd0QMlXi" alt="" data-size="line"> <strong>검수 요청</strong></td><td>템플릿을 카카오에 검수 요청합니다. <strong>'검수 대기' 상태의 템플릿 또는 검수 반려 상태에서 1회 이상 수정한 템플릿만</strong> 요청할 수 있습니다.</td></tr><tr><td><img src="/files/4qDsBziAxUsXQYxhhX5o" alt="" data-size="line"> <strong>검수 요청 취소</strong></td><td>템플릿의 검수 요청을 취소합니다. <strong>'검수중' 상태의 템플릿만</strong> 취소할 수 있습니다.</td></tr><tr><td><img src="/files/6l45UfCdnssRs0K7dPdc" alt="" data-size="line"> <strong>휴면 해제</strong></td><td>휴면 상태의 템플릿을 다시 캠페인에 사용할 수 있도록 '승인' 상태로 변경합니다. <strong>'휴면' 상태일 때만</strong> 해제할 수 있습니다.</td></tr><tr><td><img src="/files/BQC9s2SowPLiDzegmI2C" alt="" data-size="line"> <strong>승인 취소</strong></td><td>승인된 템플릿을 수정이 가능한 '검수 대기' 상태로 되돌립니다. <strong>발송 이력이 없는(누적 발송 수 0건) '승인' 상태의 템플릿만</strong> 취소할 수 있습니다.</td></tr><tr><td><img src="/files/IMev3uE8t5yBMwGc1BIj" alt="" data-size="line"> <strong>삭제</strong></td><td>템플릿을 영구적으로 삭제합니다. <strong>'검수 대기', '검수 반려', '만료', '차단' 상태의 템플릿만</strong> 삭제할 수 있으며, 삭제된 템플릿은 복구할 수 없습니다.</td></tr></tbody></table>

### **4-1 검수 요청**

<img src="/files/Xe0tjCU8zRFvRd0QMlXi" alt="" data-size="line"> 검수 요청 버튼 클릭 시 우측에서 패널이 나타납니다. 필요 시, 카카오 검수 담당자에게 전달할 참고 의견이나 파일을 첨부해 주세요.

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

* **검수자 참고 의견:** 검수자에게 전달할 내용을 입력해 주세요. (문자 구분 없이 최대 500자 입력 가능)
* **첨부 파일:** 패널 하단의 '업로드 유의사항'을 준수하여 검수에 필요한 참고 파일을 업로드해 주세요.
* **제출:** 클릭 시, 작성한 참고 의견과 첨부 파일을 포함하여 카카오에 템플릿 검수를 요청합니다.

{% hint style="warning" %}
아래 기준을 충족하지 않을 경우 템플릿이 반려될 수 있습니다.

(1) 작성한 템플릿이 광고성이 아닌 **정보성 메시지**가 맞는지 확인해주세요.\
(2) 카카오의 **알림톡 서비스 운영정책**에 부합하는지 확인해주세요.

[카카오 알림톡 심사 가이드](https://kakaobusiness.gitbook.io/main/ad/infotalk/audit#1.)
{% endhint %}

***

## **5. 태그 필터**

템플릿 생성 시 추가한 태그를 기준으로, 원하는 캠페인만 목록에서 필터링하여 볼 수 있습니다.

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

(1) 원하는 태그를 모두 선택(체크)한 후 **\[선택] 버튼**을 클릭해 주세요.

(2) 선택한 태그가 포함된 템플릿만 목록에 표시됩니다.

***

## **6. 검색**

검색창에 템플릿명을 직접 입력하여 원하는 템플릿을 찾을 수 있습니다.


# 템플릿 만들기

템플릿 관리 페이지의 <img src="/files/5B0jn1jTvVpKXqBmXUxB" alt="" data-size="line"> 버튼을 클릭하여 새로운 카카오 알림톡 템플릿을 생성할 수 있습니다.

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

{% hint style="success" %}
카카오 알림톡 템플릿은 정보성 메시지에 한해 승인받을 수 있습니다.\
[**카카오 알림톡 제작 가이드**](https://kakaobusiness.gitbook.io/main/ad/infotalk/content-guide)를 참고하여 템플릿이 반려되지 않도록 유의해 주세요.&#x20;
{% endhint %}

## **1. 기본 설정**

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

* **템플릿명:** 템플릿의 이름을 입력해 주세요. (문자 구분 없이 최대 200자 입력 가능)
* **템플릿 코드:** 템플릿의 코드를 입력해 주세요. (문자 구분 없이 최대 30자 입력 가능)
* **카테고리:** 템플릿 목적에 맞는 카테고리를 선택해 주세요. 카테고리는 검수 과정에서 더 적절한 카테고리로 변경될 수 있습니다.
* **태그 #:** 템플릿에 태그를 설정해 주세요. 템플릿 리스트에서 태그 필터를 통해 템플릿을 필터링할 때 활용됩니다.

***

## **2. 개인화 설정**

### **2-1. 개인화 변수 설정**

<img src="/files/agoRlsX2T6GHYrekY8AR" alt="" data-size="line"> 버튼을 클릭하여 사용자별 맞춤 데이터(예: 이름, 등급)를 담아 보낼 개인화 변수를 설정할 수 있습니다.

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

* **변수 추가:** 메시지에 사용할 개인화 변수를 최대 40개까지 생성할 수 있습니다.
* **개인화 키:** API 요청 시 개인화 메시지에서 회원 정보로 치환될 변수의 고유한 식별값입니다. (한글, 영문, 숫자만 최대 50자 입력 가능)

{% hint style="success" %}
개인화 키는 사전에 개발 담당자와 협의하여 입력해주세요.
{% endhint %}

{% hint style="warning" %}
개인화 키를 추가, 수정, 삭제할 경우 메시지 작성 시 추가한 모든 변수는 삭제됩니다.
{% endhint %}

### **2-2. 개인화 변수 추가**

<img src="/files/eruMmrftrvYAsSBxEPLE" alt="" data-size="line"> 버튼을 클릭하여 개인화 변수를 메시지 내용에 추가할 수 있습니다.

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

* **변수:** 메시지에 추가할 개인화 변수를 선택해 주세요. 추가된 변수는 개인화된 정보(예: 회원 이름)로 치환하여 메시지를 발송합니다.
* **대체 발송 값:** 회원의 정보가 없을 경우 대체하여 발송할 값을 입력해 주세요. (문자 구분 없이 최대 10자 입력 가능)

***

## **3. 템플릿 메시지 작성**

각 항목의 <img src="/files/O6dnb9RjN86R3m4Xdzqc" alt="" data-size="line"> 버튼을 클릭하여 메시지에 필요한 요소를 활성화한 후, 내용을 작성해 주세요.

{% hint style="warning" %}
아래 유의사항을 참고하여 메시지를 작성해 주세요.

(1) 실제 데이터로 치환될 변수 값(또는 대체 발송 값)을 포함하여 제한 글자 수를 넘을 경우 발송에 실패할 수 있습니다.\
(2) 메시지에는 [**https://www.emojiengine.com/ko**](https://www.emojiengine.com/ko)에서 확인되는 기본 이모지 및 카카오톡 이모티콘만 사용할 수 있습니다.
{% endhint %}

### **3-1. 메시지 강조(강조 표기형)**

메시지의 핵심 내용을 말풍선 상단에 별도로 표시하여 강조할 수 있습니다.

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

* **제목:** 강조할 내용을 입력해 주세요. (문자 구분 없이 최대 23자 입력 가능)
* **부제목:** 제목을 보충 설명하는 내용을 입력해 주세요. (문자 구분 없이 최대 18자 입력 가능)

### **3-2. 메시지 강조(이미지형)**

메시지의 목적을 나타내는 이미지를 추가하여 내용을 강조할 수 있습니다.

<figure><img src="/files/53wySJryOaH9wWQOl63L" alt=""><figcaption></figcaption></figure>

* **파일 업로드:** 카카오 알림톡 [**이미지 제작 가이드**](https://kakaobusiness.gitbook.io/main/ad/infotalk/audit#id-3)를 준수하여 만든 이미지를 업로드해 주세요.

### **3-3. 메시지 본문**

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

* **내용:** 고객에게 반드시 전달해야 하는 내용을 입력해 주세요. (문자 구분 없이 최대 1,000자 입력 가능)
* **부가 정보:** 지속적으로 안내할 부가 정보를 입력해 주세요. (문자 구분 없이 최대 500자 입력 가능)
* **채널 추가 안내:** \[채널 추가] 버튼을 설정한 경우 안내 문구가 자동으로 추가됩니다.

{% hint style="info" %}
본문(내용, 부가 정보, 채널 추가 안내 메시지)은 **치환될 변수 값을 포함하여 최대 1,000자까지 발송**할 수 있습니다.
{% endhint %}

{% hint style="success" %}
**카카오톡 25.8.0 이상 버전**의 사용자에게는 **최대 1,300자까지 발송 가능**합니다.&#x20;
{% endhint %}

### **3-4. 버튼**

<img src="/files/UgNjq0tMlWtmJ1ZPwA8E" alt="" data-size="line"> 버튼을 클릭하여 메시지에 버튼을 추가할 수 있습니다.

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

| 버튼 유형      | 버튼명                               | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **채널 추가**  | '채널 추가' 고정 노출                     | <p>발신자의 채널을 추가할 수 있는 버튼으로, 메시지 본문에 '채널 추가 안내 문구'가 함께 노출됩니다.</p><p>이미 채널을 추가한 수신자에게는 버튼과 안내 문구가 보이지 않습니다.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **웹 링크**   | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li></ul><p></p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.</p></div>                                                                                                                                                                                         |
| **앱 링크**   | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 각 환경별 설정한 링크로 이동합니다.</p><ul><li><strong>Android:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>iOS:</strong> Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)</li><li><strong>모바일:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li><li><strong>PC:</strong> http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 480자 입력 가능, 최대 980자 발송 가능)</li></ul><p></p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.</p></div> |
| **배송 조회**  | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 '배송조회 페이지'로 이동합니다.</p><p>본문에 입력된 '송장번호'를 조회하여 '배송조회 페이지'로 이동할 수 있는 링크가 자동 생성됩니다.</p><ul><li>배송 조회 버튼은 <strong>메시지 내용</strong>에 <strong>카카오가 지원하는 택배사명과 송장번호가 모두 포함</strong>된 경우에만 사용할 수 있습니다.</li><li><strong>지원 가능 택배사:</strong> 우체국택배, 로젠택배, 일양로지스, FedEx ,한진택배, 경동택배, 합동택배, 롯데택배, 농협택배, 호남택배, CU 편의점택배, CVSnet편의점택배, TNT Express, USPS, EMS, 천일택배, DHL, 대신택배, 건영택배, 한덱스, 굿투럭<br>\* <strong>카카오와 해당 택배사와의 계약 관계에 의해 변동될 수 있음을 유의해 주세요.</strong></li></ul>                                                                                                                                                                              |
| **봇 키워드**  | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 '버튼명'을 상담원에게 전달합니다. </p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채팅 > 채팅 설정]에서 '<strong>1:1 채팅 사용' ON</strong>한 채널에서만 정상 동작합니다.</li><li>'1:1 채팅 사용 OFF'한 경우 채팅이 OFF 되었다는 안내 메시지가 전달됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                           |
| **메시지 전달** | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 '버튼명+메시지 본문'을 상담원에게 전달합니다. </p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채팅 > 채팅 설정]에서 '<strong>1:1 채팅 사용' ON</strong>한 채널에서만 정상 동작합니다.</li><li>'1:1 채팅 사용 OFF'한 경우 채팅이 OFF 되었다는 안내 메시지가 전달됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                    |
| **상담톡 전환** | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 상담톡으로 전환됩니다.</p><ul><li>상담톡을 이용하지 않는 채널에서 해당 버튼을 추가할 경우 발송 실패 처리됩니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **봇 전환**   | 문자 구분 없이 최대 14자 입력 가능             | <p>클릭 시 챗봇이 호출됩니다.</p><ul><li>\[<a href="https://business.kakao.com/"><strong>카카오 비즈니스 파트너센터</strong></a> > 채널 > 챗봇 연결]에서 챗봇과 채널을 연결해야 정상 동작합니다.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **전화하기**   | '전화 연결', '고객센터 연결', '상담원 연결' 중 선택 | <p>클릭 시 입력한 전화번호로 통화를 연결합니다.</p><p>전화하기 버튼은 모바일에서만 확인할 수 있으며, PC에서는 '모바일에서 확인해 주세요' 문구가 나타납니다.</p><ul><li><strong>전화번호:</strong> 숫자 및 하이픈(-)만 입력해 주세요. (최대 14자 입력 가능)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

{% hint style="warning" %}
버튼명에는 이모지 또는 이모티콘을 사용할 수 없습니다.
{% endhint %}

{% hint style="info" %}
모바일 환경 전용 링크 버튼(모바일/Android/iOS)은 PC 카카오톡에서 노출되지 않습니다.&#x20;
{% endhint %}

<details>

<summary><strong>수신자의 실행 환경에 따른 링크 동작</strong></summary>

| 실행 환경   | 1순위        | 2순위    | 3순위   |
| ------- | ---------- | ------ | ----- |
| Android | Android 링크 | 모바일 링크 | PC 링크 |
| iOS     | iOS 링크     | 모바일 링크 | PC 링크 |
| PC      | PC 링크      | 모바일 링크 | -     |

{% hint style="info" %}
수신 환경에 맞는 1순위 링크(앱)가 실행되지 않을 경우 자동으로 2순위 링크(웹)로 연결됩니다.
{% endhint %}

</details>

### **3-5. 보안 템플릿**

민감한 개인정보가 포함된 경우, '보안 템플릿'으로 설정하여 메시지 보안을 강화할 수 있습니다.

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

{% hint style="info" %}
보안 템플릿으로 발송된 메시지는 PC 카카오톡에서 내용이 보이지 않고, "모바일에서 확인해주세요"라는 안내 문구로 대체됩니다.
{% endhint %}

{% hint style="success" %}
템플릿에 민감 정보가 포함되지 않았다고 판단될 경우, 검수 과정에서 카카오가 보안 설정을 해제할 수 있습니다.
{% endhint %}

### **3-6. 미리보기 메시지**

알림창과 채팅 목록에 표시될 미리보기용 메시지를 별도로 설정할 수 있습니다.

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

{% hint style="warning" %}
보안 템플릿으로 설정된 경우에는 미리보기 메시지를 사용할 수 없습니다.
{% endhint %}

{% hint style="success" %}
미설정 시 본문 앞부분이 노출되므로, 핵심 내용을 미리보기로 전달하려면 별도로 작성하는 것을 권장합니다.
{% endhint %}

### **3-7. 대표 링크**

알림톡 말풍선 클릭 시 이동할 랜딩 페이지를 설정할 수 있습니다.

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

* **모바일:** http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)
* **PC:** http\:// 또는 <https://를> 포함하여 유효한 링크를 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)
* **Android:** Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)
* **iOS:** Scheme://Path 형태로 입력해 주세요. (최대 500자 입력 가능, 최대 1,000자 발송 가능)

{% hint style="info" %}
웹 링크와 앱 링크를 모두 입력하면, 모바일 기기 사용자에게는 딥링크가 우선적으로 동작합니다.
{% endhint %}

***

## **4. 미리보기**

작성 중인 메시지가 사용자에게 어떻게 보일지 실시간으로 확인할 수 있습니다.&#x20;

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

{% hint style="info" %}
미리보기는 **참고용으로 제공**되며, 실제 메시지는 수신자의 기기나 앱 환경에 따라 다르게 보일 수 있습니다.
{% endhint %}

***

## **5. 부가 옵션**

### **5-1. 즉시 검수 요청**

템플릿 저장과 동시에 카카오에 검수를 요청합니다.\
필요 시, 카카오 검수 담당자에게 전달할 참고 의견이나 파일을 첨부해 주세요.

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

* **검수자 참고 의견:** 검수자에게 전달할 내용을 입력해 주세요. (문자 구분 없이 최대 500자 입력 가능)
* **첨부 파일:** 패널 하단의 '업로드 유의사항'을 준수하여 검수에 필요한 참고 파일을 업로드해 주세요.

{% hint style="warning" %}
아래 기준을 충족하지 않을 경우 템플릿이 반려될 수 있습니다.

(1) 작성한 템플릿이 광고성이 아닌 **정보성 메시지**가 맞는지 확인해주세요.\
(2) 카카오의 **알림톡 서비스 운영정책**에 부합하는지 확인해주세요.

[카카오 알림톡 심사 가이드](https://kakaobusiness.gitbook.io/main/ad/infotalk/audit#1.)
{% endhint %}


# 템플릿 분석 리포트

발송 이력이 있는 템플릿의 성과를 확인하는 페이지입니다.&#x20;

템플릿 분석 리포트는 **해당 템플릿을 활용한 모든 캠페인의 종합 성과**를 보여주며, **채널 추가, 상담/문의 등 링크 버튼 외 클릭 지표**는 **다음 날 오전 7시**에 업데이트됩니다.

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

{% hint style="info" %}

* 템플릿 성과는 **발송일로부터 3일간** 집계 합니다.
* **클릭 지표**는 링크 버튼(웹/앱)에 설정된 **모바일 및 PC 링크**의 클릭 수만 집계합니다
  {% endhint %}

{% hint style="warning" %}
템플릿의 **발송 성공 수가 11건 이상**일 경우에만 **채널 추가 수, 배송 조회 수, 상담·문의 수를 집계**할 수 있습니다.
{% endhint %}

## **1. 조회 기간**

조회 기간을 선택해 주세요. 설정한 조회 기간 동안의 템플릿 성과를 확인할 수 있습니다.

***

## **2. 템플릿 정보**

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

* **템플릿명:** 템플릿 생성 시 설정한 이름이며, 클릭 시 수정 페이지로 이동합니다.
* **템플릿 코드:** 템플릿 생성 시 설정한 코드입니다.
* **카테고리:** 템플릿 생성 시 설정한 카테고리입니다.
* **최초 발송일:** 템플릿을 활용하여 가장 처음 발송한 날짜입니다.
* **최근 발송일:** 템플릿을 활용하여 가장 최근에 발송한 날짜입니다.

### **2-1. 템플릿 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 템플릿 상세 정보를 확인할 수 있습니다.

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

* **템플릿 상태:** 템플릿의 현재 상태입니다. (예: 승인, 휴면 등)
* **작성일**: 템플릿이 생성된 날짜입니다.
* **최종 수정일:** 템플릿을 가장 최근에 수정한 날짜입니다.

***

## **3. 기본 분석**

### **3-1. 요약 지표**

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

<table><thead><tr><th width="159.7109375">지표</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>조회 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>조회 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액</strong></td><td>조회 기간 동안 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>채널 추가 수</strong></td><td>조회 기간 동안 메시지의 <strong>채널 추가 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>배송 조회 수</strong></td><td>조회 기간 동안 메시지의 <strong>배송 조회 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>상담·문의 수</strong></td><td>조회 기간 동안 메시지의 <strong>봇 키워드, 메시지 전달, 봇 전환, 상담톡 전환, 전화하기 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>발송 성공률</strong></td><td>발송 수 대비 발송에 성공한 비율입니다. (발송 성공 수/발송 수 * 100%)</td></tr><tr><td><strong>클릭 전환율</strong></td><td>발송 성공 수 대비 웹 링크 또는 앱 링크 버튼을 클릭한 비율입니다. (클릭 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>채널 추가 전환율</strong></td><td>발송 성공 수 대비 채널을 추가한 비율입니다. (채널 추가 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>주문 전환율</strong></td><td>발송 성공 수 대비 주문을 완료한 비율입니다. (주문 수/발송 성공 수 * 100%)</td></tr></tbody></table>

{% hint style="info" %}
**세션(Session)이란?:** 한 명의 방문자가 사이트에 접속해서 활동하는 시간의 단위를 의미합니다.

* **세션 종료:** 마지막 행동 후 30분 동안 아무런 움직임이 없으면 세션은 자동으로 종료됩니다.
* **세션 기준:** 세션은 그루비가 발행하는 쿠키(Cookie)를 기준으로 구분됩니다.
  {% endhint %}

### **3-2. 클릭 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 수**를 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가된 웹 링크 또는 앱 링크 버튼입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 수:** 해당 클릭 요소에서 발생한 클릭 수입니다.

### **3-3. 상담**·**문의 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **상담·문의 버튼별 클릭 수**를 확인할 수 있습니다.

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

* **클릭 요소:** 템플릿 메시지에 추가된 상담·문의(봇 키워드, 메시지 전달, 봇 전환, 상담톡 전환, 전화하기) 버튼입니다.
* **클릭 수:** 해당 클릭 요소에서 발생한 클릭 수입니다.

### **3-4. 클릭 전환율 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **웹 링크 또는 앱 링크 버튼의 링크 유형별 클릭 전환율**을 확인할 수 있습니다.

<figure><img src="/files/8EWBP4HzcEHRlHjqVItU" alt=""><figcaption></figcaption></figure>

* **클릭 요소:** 템플릿 메시지에 추가된 웹 링크 또는 앱 링크 버튼입니다. 동일한 유형의 버튼이 여러 개일 경우 넘버링하여 보여줍니다.
* **클릭 전환율:** 해당 클릭 요소에 대한 클릭 전환율입니다.

### **3-5. 데이터 추이**

조회 기간 동안 일별 클릭 수와 주문 수 변화를 그래프로 확인할 수 있습니다.

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

### **3-6. 데이터 테이블**

조회 기간 동안 일별 성과 데이터를 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>해당 날짜에 발송 수 대비 발송에 성공한 비율입니다.</td></tr><tr><td><strong>클릭 수</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>해당 날짜에 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>채널 추가 수</strong></td><td>해당 날짜에 <strong>채널 추가 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>배송 조회 수</strong></td><td>해당 날짜에 <strong>배송 조회</strong> <strong>버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr><tr><td><strong>상담·문의 수</strong></td><td>해당 날짜에 <strong>봇 키워드, 메시지 전달, 봇 전환, 상담톡 전환, 전화하기 버튼을 클릭한 수</strong>입니다. 세션과 관계없이 모든 중복 클릭을 합산하여 집계합니다.</td></tr></tbody></table>

***

## **4. 주문 상품 분석**

### **4-1. 상세 주문 리스트**

조회 기간 동안 클릭 후 발생한 주문의 상세 이력을 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>회원 ID</strong></td><td>주문한 회원의 ID입니다. 비로그인 또는 비회원 주문 시 '비로그인'으로 표시됩니다.</td></tr><tr><td><strong>주문 금액(원)</strong></td><td>해당 주문에서 발생한 주문 금액입니다.</td></tr><tr><td><strong>주문 수량</strong></td><td>해당 주문에 포함된 상품의 총 수량입니다.</td></tr><tr><td><strong>주문 상품</strong></td><td>해당 주문에 포함된 모든 상품 목록입니다. 행(Row)을 클릭하면 전체 상품명을 확인할 수 있습니다.</td></tr></tbody></table>

### **4-2. 상품 랭킹 TOP 100**

조회 기간 동안 주문된 상품의 랭킹을 상품 뷰 수, 주문 수, 전환 금액 순으로 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="159.64453125">헤더</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>상품의 판매가입니다.</td></tr><tr><td><strong>상품 뷰 수</strong></td><td>메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 해당 상품이 조회된 수</strong>입니다. 같은 세션 내 모든 조회 수를 합산하여 집계합니다.</td></tr><tr><td><strong>주문 수</strong> </td><td>메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 해당 상품이 주문된 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 해당 상품이 주문된 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>

***

## **5. 활용 캠페인별 분석**

해당 템플릿을 사용 중인 캠페인별로, 조회 기간 동안의 성과를 확인할 수 있습니다.

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

<table><thead><tr><th width="160.1953125">헤더</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>해당 캠페인을 통해 발송한 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>해당 캠페인을 통해 발송한 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>해당 캠페인을 통해 발송한 메시지의 <strong>웹 링크 또는 앱 링크 버튼을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>최초 발송일</strong></td><td>해당 캠페인에서 가장 처음 발송한 날짜입니다.</td></tr><tr><td><strong>최근 발송일</strong></td><td>해당 캠페인에서 가장 최근에 발송한 날짜입니다.</td></tr><tr><td><strong>분석 리포트</strong></td><td>클릭 시 해당 캠페인의 분석 리포트로 이동합니다.</td></tr></tbody></table>


# 사용료

**\[캠페인 관리 > 미니 대시보드 > 당월 사용료]**&#xC758; <img src="/files/JZ9PwPUAZ5er8znIWTa2" alt="" data-size="line"> 버튼을 클릭하여 알림톡 사용료를 확인할 수 있습니다.

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

{% hint style="info" %}

* 알림톡 수신 확인은 **최대 3일**이 소요될 수 있습니다. 정확한 사용료 산정을 위해 **당일 사용료**는 **3일 후 오전 7시**에 업데이트되며, **전월 최종 사용료**는 **매월 4일**에 확정됩니다.
* 모든 사용료는 **부가세(VAT)가 포함되지 않은 금액**이며, **발송 시점별 단가 변동이 모두 반영**되어 계산됩니다.
  {% endhint %}

## **1. 당월 사용료**

이번 달 1일부터 조회 당일까지의 누적 사용료를 확인할 수 있습니다.

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

* **발송 단가:** 메시지 1건을 발송하는 데 드는 비용입니다.
* **과금 성공 수:** 이번 달 발송 성공 건 중 실제로 과금이 발생한 건수입니다. 사용자에게 메시지가 정상적으로 도달하여 카카오 정책에 따라 과금 처리된 건을 의미합니다.
* **예상 사용료:** 현재까지 과금 성공 건수를 기준으로 산정된 예상 금액입니다. 최종 사용료는 다음 달 4일에 확정됩니다.

### **1-1. 발송 단가 변경 이력**

**\[당월 사용료 > 발송 단가]**&#xC758; <img src="/files/a0ElYfc3ZnK05HJ0Z6m0" alt="" data-size="line"> 버튼을 클릭하여 단가 변경 이력을 확인할 수 있습니다.

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

* **현재 발송 단가:** 조회일을 기준으로 적용되고 있는 발송 단가입니다.
* **적용일:** 해당 발송 단가가 적용되기 시작한 날짜입니다.

| 헤더명             | 설명                        |
| --------------- | ------------------------- |
| **이전 발송 단가(원)** | 과거에 적용되었던 발송 단가 목록입니다.    |
| **적용일**         | 이전 발송 단가가 적용되기 시작한 날짜입니다. |

### **1-2. 사용료 상세**

당월 사용료의 <img src="/files/9h9D8CSioaC8XBAOiIfW" alt="" data-size="line"> 버튼 또는 월별 사용료의 행(Row)을 클릭하여 해당 월에 대한 템플릿별 사용료를 확인할 수 있습니다.

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

* **사용료:** 해당 월에 대한 메시지 발송 비용 총합입니다. 최종 사용료는 다음 달 4일에 확정됩니다.

<table><thead><tr><th width="160.41796875">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>템플릿명</strong></td><td>해당 월에 과금 성공 수가 1건 이상인 템플릿의 이름입니다.</td></tr><tr><td><strong>과금 성공 수</strong></td><td>해당 템플릿으로 발송을 성공한 건 중 실제로 과금이 발생한 건수입니다.</td></tr><tr><td><strong>사용료(원)</strong></td><td>과금 성공 건수를 기준으로 산정된 금액입니다.</td></tr></tbody></table>

***

## **2. 월별 사용료**

월별 알림톡 사용 내역을 확인할 수 있으며,  <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

<figure><img src="/files/6LnFNYbC01mFLwXIlNFQ" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160.31640625">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>사용 기간</strong></td><td>월별 사용 기간은 매월 1일부터 말일까지입니다.</td></tr><tr><td><strong>사용료 확정 상태</strong></td><td><p>사용료의 확정 여부를 보여줍니다.</p><ul><li><strong>미확정:</strong> 매월 3일까지 지난달 사용료는 미확정 상태로 보여집니다.</li><li><strong>확정:</strong> 매월 4일에 지난달 사용료가 확정 상태로 변경됩니다.</li></ul></td></tr><tr><td><strong>과금 성공 수</strong></td><td>해당 월에 발송을 성공한 건 중 실제로 과금이 발생한 건수입니다.</td></tr><tr><td><strong>사용료(원)</strong></td><td>과금 성공 건수를 기준으로 산정된 금액입니다. 지난달 사용료는 이번 달 4일에 확정됩니다.</td></tr></tbody></table>


# SMS 캠페인

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

## **SMS 캠페인이란?**

SMS 캠페인은 고객의 휴대전화 번호로 직접 문자 메시지(SMS/LMS/MMS)를 발송하여 마케팅 정보를 전달하는 서비스입니다.

**별도의 앱 설치나 인터넷 연결 상태와 무관**하게 가장 높고 확실한 도달률을 보장하는 것이 SMS 캠페인의 특징입니다. 고객의 즉각적인 반응을 유도해야 하는 상황에서 가장 효과적이며, 주로 다음과 같이 활용됩니다.

* **타임 세일 및 긴급 공지:** 한정 수량 특가, 당일 마감 프로모션 등 고객이 즉시 확인하고 반응해야 하는 긴급한 혜택을 알립니다.
* **리마인드 및 재방문 유도:** 장바구니에 담긴 상품 알림, 포인트 소멸 안내, 휴면 해제 유도 등 잊혀질 수 있는 정보를 상기시켜 재방문을 유도합니다.


# SMS 발송을 위한 사전 준비

SMS를 발송하기 위해서는 다음의 사전 준비가 필요합니다.

## **1. 발신번호 및 무료 수신거부 전화번호 등록**

발신번호 사전등록제의 시행으로 인하여, 2015년 10월 16일부로 **사전에 등록하지 않은 발신번호**는 **SMS 발송이 제한**됩니다. 따라서 SMS 발송을 위해서는 사전에 발신번호를 등록해야 합니다.

<details>

<summary><strong>발신번호 사전등록제란?</strong></summary>

전기통신사업법 제84조 의거 거짓으로 표시된 전화번호로 인한 이용자 피해 예방을 위해 이용 고객이 사전 등록된 발신번호로만 문자발송이 가능하도록 하는 제도

**적용 내용**\
사전에 등록되지 않은 발신번호로 전송되는 문자발송 차단

**적용 대상**\
문자로 발송되는 모든 발송형식

**적용일**\
2015.10.16

**주요 지침**

* 발신번호는 반드시 기업 또는 기관이 소유한 번호로 등록
* 통신사가 부여하지 않은 유선번호는 등록 불가(e.g. 사설교환기에서 자체 부여한 번호)
* 발신번호는 발신번호 세칙을 준수하여 사용(특수번호 제외)
* 특수번호는 증빙서류를 제출하여 등록 후 사용가능
* 사전등록 예외대상 고객도 주요 발신번호는 사전에 등록하여 사용
* KISA가 발신변작의심으로 소명자료를 요청한 경우 3일 이내 제출(미소명시 해당 발신번호로의 문자 발송 차단 및 2회 이상 위반 시 서비스 중지)

</details>

### **1-1. 서류 준비 및 제출**

아래 항목을 준비하여 그루비 담당자에게 제출해 주세요.

* **제출 서류:** 신분증(또는 사업자 등록증), 그루비 서비스 계약서, 통신서비스 이용증명원
* **등록 정보:** 사용할 발신번호(8\~11자리, 최대 5개), 080 무료 수신거부 전화번호(최대 1개)

| 발신번호 유형     | 허용 형식 예시      | 비고         |
| ----------- | ------------- | ---------- |
| 유선 전화번호     | 02-321-4567   | 지역번호 포함 필수 |
| 이동통신 전화번호   | 010-4321-5678 | -          |
| 대표 전화번호     | 1588-1234     | 지역번호 사용 금지 |
| 공통서비스 식별 번호 | 070-4321-5678 | 지역번호 사용 금지 |

{% hint style="warning" %}
다음의 발신번호는 등록이 제한됩니다.

* 존재하지 않는 번호 대역(070-**0**XXX, 070-**1**XXX, 010-**0**XXX, 010-**1**XXX 등)
* 발신번호 도용 차단 서비스 가입자
  {% endhint %}

### **1-2. 그루비 확인 및 등록**

그루비 담당자가 제출된 서류와 등록 요청 번호의 **고객사 소유 여부를 검증**한 후 등록을 완료합니다.

{% hint style="info" %}
발신번호의 **추가 등록**이 필요한 경우, 해당 번호의 '통신서비스 이용증명원'을 구비하여 그루비에 문의해 주세요.
{% endhint %}

***

## **2. 개인정보 처리방침 내 수탁자 고지 안내**

관련 법령 미준수로 인한 과태료 부과 등의 불이익을 받지 않도록, [**\[개인정보 처리방침\]**](/new-admin/notes/privacy-policy) 문서를 참고하여 귀사의 개인정보 처리방침 내 '개인정보 처리 위탁 현황' 항목에 수탁자를 고지해 주세요.


# 캠페인 관리

생성한 SMS 캠페인의 현황을 확인하고, 관리(진행, 수정, 삭제)하는 페이지입니다.

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

## **1. 만들기**

<img src="/files/IjgYkvXHKvQx87hawvIp" alt="" data-size="line"> 버튼 클릭 시 **새로운 SMS 만들기** 페이지로 이동합니다.

{% hint style="warning" %}
캠페인을 생성하려면, [**\[설정 > SMS 설정\]**](/new-admin/settings/sms)에서 발신번호 및 무료 수신거부 전화번호를 등록해 주세요.
{% endhint %}

***

## **2. 미니 대시보드**

미니 대시보드에서는 캠페인 현황과 당월 사용료를 한눈에 파악할 수 있습니다.

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

* **발송 예정:** 오늘 및 7일 이내 발송 예정된 캠페인의 수를 각각 보여줍니다.
* **발송 완료:** 오늘 및 최근 7일 동안 발송 완료된 캠페인의 수를 각각 보여줍니다.
* **당월 사용료:** 이번 달에 발생한 총발송 비용과 지난달 대비 비용 증감률을 함께 보여줍니다. '상세보기'를 클릭하면 월별 상세 내역을 확인할 수 있습니다.

***

## **3. 캠페인 리스트**

### **3-1. 단일 발송**

생성한 단일 발송 캠페인 목록입니다.

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

<table><thead><tr><th width="159.8359375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>캠페인명</strong></td><td>캠페인 생성 시 설정한 이름이며, 클릭 시 수정 페이지로 이동합니다.</td></tr><tr><td><strong>상태</strong></td><td><p>캠페인의 진행 상태를 나타내며, 클릭하여 '진행' 또는 '중지'로 변경할 수 있습니다.</p><ul><li><strong>진행중</strong><img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">: 설정된 스케줄에 따라 캠페인이 진행 중인 상태입니다. 예정된 발송이 완료된 캠페인은 완료 탭으로 자동 이동합니다.</li><li><strong>중지</strong><img src="/files/TRr31QJE6zxLsx5PmtD2" alt="" data-size="line"><strong>:</strong> 캠페인이 일시적으로 중지된 상태입니다. 발송 예정 일시가 되어도 자동으로 진행되지 않습니다.</li></ul></td></tr><tr><td><strong>메시지 유형</strong></td><td>캠페인 생성 시 작성한 메시지 본문의 길이(Byte)와 이미지 첨부 여부에 따라 자동으로 분류된 발송 규격입니다. (예: SMS, LMS, MMS)</td></tr><tr><td><strong>예상 타겟 수</strong></td><td>캠페인 생성 시 집계된 발송 예상 수입니다. 실제 발송 수는 발송 시점에 따라 달라질 수 있습니다.</td></tr><tr><td><strong>발송 예정 일시</strong></td><td>메시지가 발송될 예정 일시 입니다.</td></tr><tr><td><strong>최종 수정일</strong></td><td>캠페인을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

### **3-2. 반복 발송**

생성한 반복 발송 캠페인 목록입니다.

<figure><img src="/files/4xejSIQNGx3JUurvXsRa" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="159.8359375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>캠페인명</strong></td><td>캠페인 생성 시 설정한 이름이며, 클릭 시 수정 페이지로 이동합니다.</td></tr><tr><td><strong>상태</strong></td><td><p>캠페인의 진행 상태를 나타내며, 클릭하여 '진행' 또는 '중지'로 변경할 수 있습니다.</p><ul><li><strong>진행중</strong><img src="/files/YzqC75eI0qntSoUip8GU" alt="" data-size="line">: 설정된 스케줄에 따라 캠페인이 진행 중인 상태입니다.</li><li><strong>중지</strong><img src="/files/TRr31QJE6zxLsx5PmtD2" alt="" data-size="line"><strong>:</strong> 캠페인이 일시적으로 중지된 상태입니다. 발송 예정 일시가 되어도 자동으로 진행되지 않습니다.</li></ul></td></tr><tr><td><strong>메시지 유형</strong></td><td>캠페인 생성 시 작성한 메시지 본문의 길이(Byte)와 이미지 첨부 여부에 따라 자동으로 분류된 발송 규격입니다. (예: SMS, LMS, MMS)</td></tr><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>캠페인이 진행되는 시작 및 종료 일자입니다. 종료 시점이 지난 캠페인은 완료 탭으로 자동 이동합니다.</td></tr><tr><td><strong>최종 수정일</strong></td><td>캠페인을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

### **3-3. 발송 완료**

설정된 기간이 종료되었거나 수동으로 완료 처리한 캠페인 목록입니다.

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

<table><thead><tr><th width="159.8359375">헤더</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>캠페인 생성 시 작성한 메시지 본문의 길이(Byte)와 이미지 첨부 여부에 따라 자동으로 분류된 발송 규격입니다. (예: SMS, LMS, MMS)</td></tr><tr><td><strong>발송 수</strong></td><td>캠페인 진행 기간 동안 발송을 요청한 수입니다.</td></tr><tr><td><strong>발송 성공 수</strong></td><td>캠페인 진행 기간 동안 발송을 성공한 수입니다.</td></tr><tr><td><strong>발송 스케줄</strong></td><td><ul><li><strong>단일 발송:</strong> 메시지 발송 일시입니다.</li><li><strong>반복 발송:</strong> 캠페인 기간 및 반복 발송 규칙(빈도, 요일, 시간)입니다.</li></ul></td></tr><tr><td><strong>완료 일시</strong></td><td>캠페인이 완료 탭으로 이동한 일시입니다.</td></tr></tbody></table>

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

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

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

<table><thead><tr><th width="160.1015625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/wIrIsQFbNXIu35OPhaS4" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 캠페인을 수정합니다. 단, <strong>이미 발송이 시작된(진행 중, 완료) 캠페인</strong>은 수정할 수 없으며 내용 확인만 가능합니다.</td></tr><tr><td><img src="/files/xHwQYOmNds52LGsy65QX" alt="" data-size="line"> <strong>복사</strong></td><td>선택한 캠페인을 복사하여 동일한 내용의 새로운 캠페인을 생성합니다. 복사된 캠페인은 캠페인명 뒤에 '-COPY'가 추가됩니다.</td></tr><tr><td><img src="/files/96B2sMaulgkXFwUtFWB7" alt="" data-size="line"> <strong>분석 리포트</strong></td><td>해당 캠페인의 성과를 분석 리포트로 확인합니다. <strong>캠페인 발송 이력이 있는 경우(발송 수 1건 이상)에만 활성화</strong>됩니다.</td></tr><tr><td><img src="/files/sdXrs7KYamhq83aIzqbu" alt="" data-size="line"> <strong>미리보기</strong></td><td>메시지가 사용자에게 어떻게 보일지 미리 확인할 수 있습니다.</td></tr><tr><td><img src="/files/nZKGcuZF4mQ9N3pUQ4TI" alt="" data-size="line"> <strong>완료 탭으로 이동</strong></td><td>캠페인을 '완료' 탭으로 이동시켜 보관합니다. <strong>'중지' 상태인 캠페인만 이동</strong>할 수 있습니다.</td></tr><tr><td><img src="/files/WCemdenye04VXDipLJHP" alt="" data-size="line"> <strong>삭제</strong></td><td>캠페인을 영구적으로 삭제합니다. <strong>'완료' 상태의 캠페인만 삭제</strong>할 수 있으며, 삭제된 캠페인은 복구할 수 없습니다.</td></tr></tbody></table>

***

## **4. 태그 필터**

캠페인 생성 시 추가한 태그를 기준으로, 원하는 캠페인만 목록에서 필터링하여 볼 수 있습니다.

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

(1) 원하는 태그를 모두 선택(체크)한 후 **\[선택] 버튼**을 클릭해 주세요.

(2) 선택한 태그가 포함된 캠페인만 목록에 표시됩니다.

***

## **5. 검색**

검색창에 캠페인명을 직접 입력하여 원하는 캠페인을 찾을 수 있습니다.


# 캠페인 만들기

캠페인 관리 페이지의 <img src="/files/qhaztNoJhinW5vVJcVDd" alt="" data-size="line"> **버튼**을 클릭하여 새로운 SMS 캠페인을 생성할 수 있습니다.

{% hint style="info" %}
SMS 캠페인은 '스케줄' 발송 방식만 지원됩니다.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>스케줄 발송</strong></td><td>지정한 발송 일시에 1회 발송하거나, 설정한 반복 주기에 따라 타겟 고객에게 메시지를 정기적으로 발송하는 방식입니다.</td><td><a href="/files/TOBDIImM4HGcI9qaCJdo">/files/TOBDIImM4HGcI9qaCJdo</a></td><td><a href="/pages/FTbgvb3ortgX9R5FvEXy">/pages/FTbgvb3ortgX9R5FvEXy</a></td></tr></tbody></table>


# 스케줄 발송

지정한 발송 일시에 **1회 발송**하거나, 설정한 반복 주기에 따라 타겟 고객에게 메시지를 **정기적으로 발송**하는 방식입니다.

## **1단계: 기본 설정**

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

### **1. 기본 설정**

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

* **캠페인명:** 캠페인의 이름을 입력해 주세요. (문자 구분 없이 최대 40자 입력 가능)
* **상세 설명:** 필요시 캠페인에 대한 상세 설명을 입력해 주세요. (문자 구분 없이 최대 400자 입력 가능)
* **태그 #:** 캠페인에 태그를 설정해 주세요. 캠페인 리스트에서 태그 필터를 통해 캠페인을 필터링할 때 활용됩니다.

### **2. 발신번호**

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

고객에게 표시될 발신번호를 선택해 주세요. 신규 등록은 [**도움말**](/new-admin/settings/sms)을 참고하여 그루비 담당자에게 신청해 주세요.

### **3. 타겟 설정**

<figure><img src="/files/5b9jY9NZSpGJfymXdQiU" alt=""><figcaption></figcaption></figure>

#### **3-1. 타겟팅 유형**

메시지를 발송할 타겟을 설정해 주세요.

* **세그먼트:** 미리 생성해 둔 세그먼트를 불러와 해당 조건에 부합하는 고객을 타겟으로 설정합니다.
* **직접 업로드:** 발송할 고객의 전화번호 목록(CSV 파일)을 직접 업로드하여 타겟을 설정합니다.

{% hint style="warning" %}
**세그먼트**를 대상으로 발송하려면, 회원 데이터 연동이 필요합니다. [**\[설정 > 회원 정보 연동\]**](/new-admin/settings/member_sync)을 확인해 주세요.
{% endhint %}

{% hint style="info" %}

* 직접 업로드 시 템플릿 파일을 다운로드한 후, [**도움말**](https://app.gitbook.com/o/zQ4q0lH0q4jLTdQFhkl1/s/Jv1HnfRtpjN2iazNfYpo/new-admin/notes/offsite/member-upload)을 참고하여 작성해 주세요.
* 업로드된 파일은 캠페인이 **\[발송 완료]** 탭으로 이동한 날로부터 31일간 보관되며, 이후에는 보안을 위해 자동 삭제되어 재사용이 불가능합니다.
  {% endhint %}

{% hint style="danger" %}
직접 업로드(전화번호, 개인화)사용 시 컬럼 부분에 특수문자 및 이모지 사용 시 정상적으로 발송되지 않을 수 있습니다. 컬럼 작성 시 유의해 주세요.
{% endhint %}

#### **3-2. 예상 타겟 수** <a href="#target-audience-size" id="target-audience-size"></a>

설정한 타겟에 따라 메시지를 받게 될 예상 인원을 확인해 주세요.

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

{% hint style="info" %}

* **메시지 발송 시점**의 **대상자 변동 또는 수신 동의 여부**에 따라, 실제 발송 건수는 예상과 다를 수 있습니다.
* **수신 동의 여부**는 **매일 오전 3시**에 갱신됩니다.
  {% endhint %}

***

## **2단계: 메시지 설정**

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

### **1. 메시지 본문**

#### **1-1. 내용**

고객에게 전달할 내용을 입력해 주세요. (최대 1,970바이트 입력 가능)

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

{% hint style="warning" %}
아래 유의사항을 참고하여 메시지를 작성해 주세요.

(1) 정보통신망법에 따라 메시지 상단의 **(광고)** 및 **전송자 명칭**, 하단의 **무료 수신거부 번호**는 필수 기재 사항입니다.\
(2) **(광고)**&#xC640; **무료 수신거부 번호**는 메시지 내에 자동으로 추가됩니다. (30바이트 차지)\
(3) 이모지 사용 시 발송에 실패할 수 있습니다.
{% endhint %}

{% hint style="info" %}
**60바이트**를 초과하거나 **개인화 변수**를 사용할 경우 **LMS**로 자동 전환됩니다.
{% endhint %}

#### **1-2. 개인화 변수 추가**

<img src="/files/eruMmrftrvYAsSBxEPLE" alt="" data-size="line"> 버튼을 클릭하여 개인화 변수를 메시지 내용에 추가할 수 있습니다. 추가된 변수는 발송 시 개인화된 정보(예: 회원 이름)로 치환됩니다.

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

* **업로드 기반 개인화 변수:** **\[타겟팅 유형 > 직접 업로드 > 개인화 정보]**&#xC120;택 시, 업로드한 CSV 파일의 데이터를 변수로 활용합니다.
* **API 기반 개인화 변수:** **\[타겟팅 유형 > 직접 업로드 > 개인화 정보]**&#xB97C; 선택하지 않은 경우 [**\[설정 > 개인화 변수 설정\]**](/new-admin/settings/user-property)에서 추가한 변수를 활용합니다.
* **대체 발송 값:** 회원의 정보가 없을 경우 대체하여 발송할 값을 입력해 주세요. (문자 구분 없이 **최대 10자** 입력 가능)

#### **1-3. 단축 URL**

<img src="/files/toftfwaVhlfSIQD48IuY" alt="" data-size="line"> 버튼을 클릭하여 단축 URL을 생성할 수 있습니다.&#x20;

**캠페인 성과(클릭, 주문) 집계**를 위해, 추가한 URL을 복사하여 메시지 본문에 삽입해 주세요.

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

{% hint style="info" %}
SMS 캠페인의 성과(클릭, 주문)는 단축 URL을 통해서만 집계됩니다.
{% endhint %}

{% hint style="warning" %}
외부 단축 URL 서비스(bitly등)를 사용하여 캠페인 링크를 등록할 경우, 그루비의 클릭 및 전환 추적 파라미터가 유실될 수 있습니다.
{% endhint %}

#### **1-4. 이미지**

패널 하단의 '업로드 유의사항'을 준수하여 메시지에 첨부할 이미지를 업로드해 주세요.

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

{% hint style="info" %}
메시지에 **이미지**를 첨부할 경우 **MMS**로 자동 전환됩니다.
{% endhint %}

### **2. 미리보기**

작성 중인 메시지가 사용자에게 어떻게 보일지 실시간으로 확인할 수 있습니다.

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

{% hint style="info" %}
미리보기는 **참고용으로 제공**되며, 실제 메시지는 수신자의 기기나 앱 환경에 따라 다르게 보일 수 있습니다.
{% endhint %}

### **3. 발송 테스트**

발송하기 전, 메시지가 사용자에게 어떻게 보이는지 미리 확인해볼 수 있습니다.

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

* **전화번호:** 테스트 메시지를 수신할 전화번호를 **최대 5개**까지 등록할 수 있습니다.
* **발송:** 클릭 시 등록한 전화번호로 테스트 메시지가 발송됩니다.

{% hint style="warning" %}
테스트 발송은 **1회 5명**에게만 가능하며, **일반 발송과 동일한 비용**이 발생합니다.
{% endhint %}

***

## **3단계: 옵션 설정**

<figure><img src="/files/6zl7DQ782k9MxKgjW9xD" alt=""><figcaption></figcaption></figure>

### **1. 스케줄 설정**

#### **1-1. 단일 발송**

지정한 날짜와 시간에 메시지를 한 번만 발송합니다.

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

* **발송 일시:** 메시지를 발송할 날짜와 시간을 지정해 주세요.

#### **1-2. 반복 발송**

캠페인 성격에 따라 설정한 주기(매일, 매주, 매월)에 맞춰 지정된 시간에 메시지를 자동으로 발송합니다.

<figure><img src="/files/7gUQlsMdpELQjq9ohZge" alt=""><figcaption></figcaption></figure>

* **수동 종료 전까지:** 직접 종료하기 전까지 캠페인이 계속 진행됩니다.
* **기간 지정:** 시작일과 종료일을 미리 설정하여, 해당 기간 내에만 캠페인이 진행됩니다.
* **반복 주기:** 캠페인 기간 내 메시지가 발송될 반복 규칙(빈도, 요일)을 설정해 주세요.
* **발송 시간:** 메시지가 발송될 시간을 지정해 주세요.

{% hint style="info" %}
정보통신망법에 따라, 광고성 메시지는 **08:00부터 20:50까지 발송**할 수 있습니다.
{% endhint %}

### **2. 발송 간격 제한**

발송 간격 제한은 같은 대상에게 설정한 기간 동안 메시지가 다시 발송되지 않도록 제한하는 기능입니다. 이 캠페인의 발송 이력, 또는 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 중복·반복 발송을 막을 수 있습니다.

발송 유형(단일 발송 / 반복 발송)에 따라 **적용 범위** 영역이 다르게 표시됩니다.

{% tabs %}
{% tab title="단일 발송" %}

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

적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다.
{% endtab %}

{% tab title="반복 발송" %}

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

적용 범위를 '이 캠페인만 적용' 또는 '같은 그룹 캠페인 포함' 중 선택할 수 있습니다.
{% endtab %}
{% endtabs %}

#### **2-1. 사용 여부 선택**

* **사용 안 함:** 발송 간격 제한을 적용하지 않습니다.
* **사용:** 아래에서 설정한 기준에 따라 같은 대상에게 일정 기간 동안 다시 발송되지 않도록 제한합니다.

#### **2-2. 적용 범위**

발송 간격 제한의 기준이 될 발송 이력의 범위를 선택합니다.

* **이 캠페인만 적용:** 이 캠페인의 발송 이력만 기준으로 제한합니다. (반복 발송에서만 선택할 수 있습니다.)
* **같은 그룹 캠페인 포함:** 같은 발송 제한 그룹에 속한 캠페인의 발송 이력을 함께 확인하여, 같은 대상에게 설정한 제한 기간 동안 다시 발송되지 않도록 제한합니다.

{% hint style="info" %}
단일 발송은 이 캠페인 자체가 반복 발송되지 않으므로, 적용 범위가 '같은 그룹 캠페인 포함'으로 고정됩니다. 같은 발송 제한 그룹에 속한 다른 캠페인의 발송 이력을 기준으로 제한이 적용됩니다.

e.g. 푸시와 SMS 캠페인을 같은 그룹으로 묶으면, 푸시 발송 대상을 SMS 발송에서 제외할 수 있습니다.
{% endhint %}

#### **2-3. 발송 제한 그룹**

적용 범위가 '같은 그룹 캠페인 포함'일 때 사용할 발송 제한 그룹을 선택합니다.

* **+ 새 그룹 등록:** 새로운 발송 제한 그룹을 즉시 등록할 수 있습니다.
* **그룹 캠페인 보기:** 선택한 그룹을 사용 중인 캠페인 목록을 확인할 수 있습니다.

{% hint style="info" %}
발송 제한 그룹은 설정 > 발송 제한 그룹 관리에서 미리 만들어 둘 수 있습니다. 같은 그룹에 속한 캠페인은 발송 이력을 함께 공유합니다.
{% endhint %}

#### **2-4. 대상 기준**

같은 대상으로 판단할 기준을 선택합니다.

* **전화번호 또는 회원 기준:** 같은 전화번호 또는 같은 회원으로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다. 한 회원이 여러 전화번호를 사용하는 경우에도 중복 발송을 제한할 수 있습니다.
* **전화번호 기준:** 같은 전화번호로 판단되는 대상에게는 설정한 제한 기간 동안 다시 발송되지 않습니다.

#### **2-5. 제한 기간**

1\~31일 사이로 설정할 수 있습니다.

{% hint style="info" %}
위 기준과 일치하는 대상에게는 마지막 발송일을 기준으로 설정한 제한 기간 동안 다시 발송되지 않습니다. (1\~31일)

e.g. 5월 1일 발송 / 제한 기간 2일 → 5월 1일·2일은 발송되지 않으며, 5월 3일부터 다시 발송할 수 있습니다.
{% endhint %}

### **3. 예상 발송 비용**

예상 타겟 수와 메시지 유형별 단가를 기준으로 산출된 **1회 발송 예상 비용**을 확인할 수 있습니다.

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

{% hint style="info" %}
예상 비용은 타겟 수를 기준으로 산출된 **부가세(VAT) 별도 금액**이며, 실제 발송 비용과 다를 수 있습니다.
{% endhint %}


# 캠페인 분석 리포트

발송 이력이 있는 캠페인의 성과를 확인하는 페이지입니다.

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

{% hint style="info" %}
캠페인 성과는 **발송일로부터 7일간** 집계합니다.
{% endhint %}

## **1. 조회 기간**

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

* **리포트 기간:** 캠페인 발송일을 시작으로, 설정한 전환 기여 기간까지의 범위입니다.
* **일자별:** 특정 날짜 하루에 대한 발송 성과를 확인합니다.
* **기간별:** 설정한 기간 동안의 발송 성과를 합산하여 확인합니다.
* **전환 기여 기간:** 발송일을 기준으로 설정한 기간 동안 발생한 캠페인 성과를 확인합니다.

{% hint style="info" %}
전환 기여 기간은 메시지 발송 후, 언제까지 발생한 데이터(클릭, 주문 등)를 이 캠페인의 성과로 인정할지 설정하는 기준입니다. 자세한 내용은 [**\[분석 리포트 전환 기여 기간\]**](/new-admin/notes/report-time) 문서를 참고해 주세요.
{% endhint %}

***

## 2. 캠페인 정보

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

* **캠페인명:** 캠페인 생성 시 설정한 이름입니다. 클릭 시 설정한 내용을 확인할 수 있습니다.
* **상세 설명:** 캠페인 생성 시 설정한 상세 설명입니다.
* **발송 일시:** 단일 발송 캠페인을 발송한 날짜와 시간입니다.
* **최초 발송 일시:** 반복 발송 캠페인에서 가장 처음 발송한 날짜와 시간입니다.
* **최근 발송 일시:** 반복 발송 캠페인에서 가장 최근에 발송한 날짜와 시간입니다.

### **2.1 캠페인 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 캠페인 상세 정보를 확인할 수 있습니다.

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

* **작성일:** 캠페인이 생성된 날짜입니다.
* **반복 주기:** 캠페인 기간 내 메시지가 발송되는 반복 규칙(빈도, 요일, 시간)입니다.
* **캠페인 기간:** 캠페인이 진행되는 시작 및 종료 일자입니다.
* **최종 수정일:** 캠페인을 가장 최근에 수정한 날짜입니다.

***

## **3. 발송 결과/비용**

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

* **발송 결과/발송 성공:** 발송을 성공한 수입니다.
* **발송 요청:** 발송을 요청한 수입니다.
* **발송 비용:** 발송 성공 수를 기준으로 산정된 예상 금액입니다.

## **4. 기본 분석**

### **4-1. 요약 지표**

<figure><img src="/files/5yC7eUThdcoW293OPKZN" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="159.7109375">지표</th><th>설명</th></tr></thead><tbody><tr><td><strong>발송 수</strong></td><td><ul><li><strong>단일 발송:</strong> 발송을 요청한 수입니다.</li><li><strong>반복 발송:</strong> 설정한 조회 기간 동안 발송을 요청한 수입니다.</li></ul></td></tr><tr><td><strong>발송 성공 수</strong></td><td><ul><li><strong>단일 발송:</strong> 발송을 성공한 수입니다.</li><li><strong>반복 발송:</strong> 설정한 조회 기간 동안 발송을 성공한 수입니다.</li></ul></td></tr><tr><td><strong>클릭 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>단축 URL을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>전환 기여 기간 동안 메시지의 <strong>단축 URL을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액</strong></td><td>전환 기여 기간 동안 메시지의 <strong>단축 URL을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr><tr><td><strong>발송 성공률</strong></td><td>발송 수 대비 발송에 성공한 비율입니다. (발송 성공 수/발송 수 * 100%)</td></tr><tr><td><strong>클릭 전환율</strong></td><td>발송 성공 수 대비 단축 URL을 클릭한 비율입니다. (클릭 수/발송 성공 수 * 100%)</td></tr><tr><td><strong>주문 전환율</strong></td><td>발송 성공 수 대비 주문을 완료한 비율입니다. (주문 수/발송 성공 수 * 100%)</td></tr></tbody></table>

{% hint style="info" %}
**세션(Session)이란?:** 한 명의 방문자가 사이트에 접속해서 활동하는 시간의 단위를 의미합니다.

* **세션 종료:** 마지막 행동 후 30분 동안 아무런 움직임이 없으면 세션은 자동으로 종료됩니다.
* **세션 기준:** 세션은 그루비가 발행하는 쿠키(Cookie)를 기준으로 구분됩니다.
  {% endhint %}

### **4-2. 발송 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 전체 타겟 수와 피로도 관리로 인해 제외된 상세 수치를 확인할 수 있습니다.

<figure><img src="/files/5rnxJ3rcAtB032x9MGtM" alt=""><figcaption></figcaption></figure>

* **발송 대상 수:** 피로도를 적용하기 전 최초 타겟 수입니다.
* **피로도 적용 수:** 설정된 피로도로 인해 발송 대상에서 제외된 수입니다.
* **발송 수:** 발송 대상에서 피로도 적용 수를 제외한, 실제로 발송을 요청한 수입니다.

### **4-3. 클릭 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **단축 URL별 클릭 수**를 확인할 수 있습니다.

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

* **클릭 요소:** 메시지에 삽입된 **단축 URL**입니다.
* **클릭 수:** 해당 클릭 요소에서 발생한 클릭 수입니다.

### **4-4. 클릭 전환율 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 **단축 URL별 클릭 전환율**을 확인할 수 있습니다.

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

* **클릭 요소:** 메시지에 **단축 URL**입니다.
* **클릭 전환율:** 해당 클릭 요소에 대한 클릭 전환율입니다.

### **4-5. 퍼널 분석**

조회한 모든 발송일 기준, 전환 기여 기간 동안 클릭부터 최종 주문까지 이어지는 단계별 전환 성과를 퍼널 그래프로 확인할 수 있습니다.

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

### **4-6. 데이터 추이**

조회한 모든 발송일 기준, 전환 기여 기간 동안의 클릭 및 주문 수 변화 추이를 시간별 그래프로 확인할 수 있습니다.

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

### **4-7. 데이터 테이블**

조회한 모든 발송일 기준, 전환 기여 기간 동안의 시간별 성과 데이터를 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>해당 시간에 발송 수 대비 발송에 성공한 비율입니다.</td></tr><tr><td><strong>클릭 수</strong></td><td>해당 시간에 <strong>단축 URL을 클릭한 수</strong>입니다. 같은 세션 내 중복 클릭은 1회로 집계합니다.</td></tr><tr><td><strong>주문 수</strong></td><td>해당 시간에 <strong>단축 URL을 클릭 후 발생한 주문 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td>해당 시간에 <strong>단축 URL을 클릭 후 발생한 주문 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>

***

## **5. 주문 상품 분석**

### **5-1. 상세 주문 리스트**

조회한 모든 발송일 기준, 전환 기여 기간 동안 클릭 후 발생한 주문의 상세 이력을 확인할 수 있으며, <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.33984375">헤더</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>회원 ID</strong></td><td>주문한 회원의 ID입니다. 비로그인 또는 비회원 주문 시 '비로그인'으로 표시됩니다.</td></tr><tr><td><strong>주문 금액(원)</strong></td><td>해당 주문에서 발생한 주문 금액입니다.</td></tr><tr><td><strong>주문 수량</strong></td><td>해당 주문에 포함된 상품의 총 수량입니다.</td></tr><tr><td><strong>주문 상품</strong></td><td>해당 주문에 포함된 모든 상품 목록입니다. 행(Row)을 클릭하면 전체 상품명을 확인할 수 있습니다.</td></tr></tbody></table>

### **5-2. 상품 랭킹 TOP 100**

조회한 모든 발송일 기준, 전환 기여 기간 동안 주문된 상품의 랭킹을 상품 뷰 수, 주문 수, 전환 금액 순으로 확인할 수 있습니다.

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

<table><thead><tr><th width="159.64453125">헤더</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>상품의 판매가입니다.</td></tr><tr><td><strong>상품 뷰 수</strong></td><td><strong>클릭 후 해당 상품이 조회된 수</strong>입니다. 같은 세션 내 모든 조회 수를 합산하여 집계합니다.</td></tr><tr><td><strong>주문 수</strong> </td><td><strong>클릭 후 해당 상품이 주문된 수</strong>입니다. 같은 세션 내 모든 주문을 합산하여 집계합니다.</td></tr><tr><td><strong>전환 금액(원)</strong></td><td><strong>클릭 후 해당 상품이 주문된 금액</strong>입니다. 같은 세션 내 모든 주문 금액을 합산하여 집계합니다.</td></tr></tbody></table>


# 사용료

[**\[캠페인 관리 > 미니 대시보드 > 당월 사용료\]**](/new-admin/sms/manage#id-2)의 <img src="/files/JZ9PwPUAZ5er8znIWTa2" alt="" data-size="line"> 버튼을 클릭하여 메시지 사용료를 확인할 수 있습니다.

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

{% hint style="info" %}
모든 사용료는 **부가세(VAT)가 포함되지 않은 금액**이며, **발송 시점별 단가 변동이 모두 반영**되어 계산됩니다.
{% endhint %}

## **1. 당월 사용료**

이번 달 1일부터 조회 당일까지의 누적 사용료를 확인할 수 있습니다.

<figure><img src="/files/3h9zR5lxJ0aMqlOUA0Fl" alt=""><figcaption></figcaption></figure>

* **발송 단가:** 메시지 유형별 1건을 발송하는 데 드는 비용입니다.
* **발송 성공 수:** 이번 달 발송을 성공한 메시지 건수입니다.
* **예상 사용료:** 현재까지 발송 성공 건수를 기준으로 산정된 예상 금액입니다.

### **1-1. 발송 성공 수 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 메시지 유형별 발송 성공 수를 확인할 수 있습니다.

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

### **1-2. 예상 사용료 상세**

<img src="/files/XmGo1bENy5dXSuth2l5z" alt="" data-size="line"> 클릭 시 메시지 유형별 예상 사용료를 확인할 수 있습니다.

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

### **1-3. 발송 단가 변경 이력**

**\[당월 사용료 > 발송 단가]**&#xC758; <img src="/files/a0ElYfc3ZnK05HJ0Z6m0" alt="" data-size="line"> 버튼을 클릭하여 메시지 유형별 발송 단가 변경 이력을 확인할 수 있습니다.

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

* **현재 발송 단가:** 조회일을 기준으로 적용되고 있는 발송 단가입니다.
* **적용일:** 해당 발송 단가가 적용되기 시작한 날짜입니다.

| 헤더명             | 설명                        |
| --------------- | ------------------------- |
| **이전 발송 단가(원)** | 과거에 적용되었던 발송 단가 목록입니다.    |
| **적용일**         | 이전 발송 단가가 적용되기 시작한 날짜입니다. |

### **1-4. 사용료 상세**

당월 사용료의 <img src="/files/9h9D8CSioaC8XBAOiIfW" alt="" data-size="line"> 버튼 또는 월별 사용료의 행(Row)을 클릭하여 해당 월에 대한 캠페인별 발송 비용을 확인할 수 있습니다.

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

* **사용료:** 해당 월에 대한 메시지 발송 비용 총합입니다.

<table><thead><tr><th width="160.41796875">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>캠페인명</strong></td><td>해당 월에 1건 이상 발송 성공한 캠페인의 이름입니다.</td></tr><tr><td><strong>메시지 유형</strong></td><td>해당 캠페인의 메시지 유형입니다.</td></tr><tr><td><strong>발송 성공 수</strong></td><td>이번 달 발송을 성공한 메시지 건수입니다.</td></tr><tr><td><strong>사용료(원)</strong></td><td>발송 성공 건수를 기준으로 산정된 금액입니다.</td></tr></tbody></table>

***

## **2. 월별 사용료**

월별 SMS 캠페인 사용 내역을 확인할 수 있으며,  <img src="/files/gJLroSIUlJAEolYNVWqf" alt="" data-size="line"> 버튼을 클릭하여 데이터를 엑셀 파일로 내려받을 수 있습니다.

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

<table><thead><tr><th width="160.31640625">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>사용 기간</strong></td><td>월별 사용 기간은 매월 1일부터 말일까지입니다.</td></tr><tr><td><strong>발송 성공 수</strong></td><td>해당 월에 발송을 성공한 메시지 건수입니다.</td></tr><tr><td><strong>사용료(원)</strong></td><td>발송 성공 건수를 기준으로 산정된 금액입니다.</td></tr></tbody></table>


# 설정

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


# 관리자

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

관리자 설정은 그루비 운영을 담당하는 사용자 계정과 권한을 통합 관리하는 기능입니다.\
주관리자 계정으로 로그인하여 계정 정보와 기본 정보, 부관리자, 권한을 각각 구분하여 관리할 수 있으며, 보안을 강화하기 위한 2단계 인증(2FA) 설정도 지원합니다.

<table data-column-title-hidden data-view="cards"><thead><tr><th>탭 구분</th><th>주요 기능</th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>주관리자</strong></td><td>주관리자 계정과 세금 계산서 담당자 정보 관리 및 보안 설정 방법에 대해 알 수 있습니다.</td><td><a href="/files/muLc4xhrukJVCevCM2Nx">/files/muLc4xhrukJVCevCM2Nx</a></td><td><a href="/pages/5L1GMrgPeIdiGO4eGHL8">/pages/5L1GMrgPeIdiGO4eGHL8</a></td></tr><tr><td><strong>부관리자</strong></td><td>부관리자 계정을 생성하여 권한을 부여하고 관리하는 방법에 대해 알 수 있습니다.</td><td><a href="/files/koNC8fq05I6PRQDckHXB">/files/koNC8fq05I6PRQDckHXB</a></td><td><a href="/pages/mSL0K45FIPsIXsu0THna">/pages/mSL0K45FIPsIXsu0THna</a></td></tr><tr><td><strong>권한</strong></td><td>부관리자에게 부여할 권한을 생성하고 관리하는 방법에 대해 알 수 있습니다.</td><td><a href="/files/gzQ073cirybR5rkKoUzz">/files/gzQ073cirybR5rkKoUzz</a></td><td><a href="/pages/TgXmGHV8TfVvOw9drKu3">/pages/TgXmGHV8TfVvOw9drKu3</a></td></tr></tbody></table>


# 주관리자

주관리자 탭에서는 서비스 운영을 위한 주관리자 계정 및 기본 정보와 세금 계산서 담당자 정보를 입력 및 관리할 수 있습니다. 또한 보안 강화를 위해 2단계 인증(2FA)을 설정 할 수 있습니다.

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

{% hint style="warning" %}
해당 도움말은 **주관리자 계정으로 로그인 시** 이용 가능한 관리자 설정 화면에 대한 안내입니다.\
**부관리자 계정으로 로그인한 경우**에는 화면 구성 및 기능이 다르므로 [**\[부관리자 계정으로 로그인 시\]**](/new-admin/settings/administrator/sub#login) 도움말을 참고해 주세요.
{% endhint %}

## **1. 계정 정보**

* **ID:** 현재 로그인된 주관리자의 계정 ID가 표시됩니다.

{% hint style="warning" %}
해당 ID는 그루비 회원가입 시 입력된 값으로, 이후 수정은 불가합니다.
{% endhint %}

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

* **비밀번호:** 주관리자의 계정 비밀번호를 변경할 수 있습니다.
  * 최근 변경 일자가 함께 표시되어 보안 관리에 참고할 수 있습니다.
  * 비밀번호 분실 시 발급받은 임시 비밀번호 변경 또는 필요에 따라 비밀번호를 변경하고 관리 할 수 있습니다.

{% hint style="success" %}
새 비밀번호는 영문, 숫자, 특수 문자를 포함하여 8\~16자 이내로 설정해야 합니다.
{% endhint %}

***

## **2. 기본 정보**

그루비 회원가입 시 입력된 주관리자의 기본 정보를 필요에 따라 수정하실 수 있습니다.

* **이름** : 주관리자의 성명을 입력해 주세요.
* **회사명** : 소속된 회사명을 입력해 주세요.
* **부서/직책** : 담당 부서명 또는 직책을 입력해 주세요.
* **개인 전화번호** : 주관리자의 개인 연락처를 입력해 주세요.
* **회사 전화번호** : 소속된 회사의 대표 연락처를 입력해 주세요.
* **이메일** : 주관리자가 사용할 이메일 주소를 입력해 주세요.

***

## **3. 세금 계산서 담당자 정보**

세금 계산서 발행 및 수신을 위한 담당자 정보를 별도로 입력할 수 있습니다.

* **이름** : 세금 계산서 담당자의 성명을 입력해 주세요.
* **개인 전화번호** : 담당자의 개인 연락처를 입력해 주세요.
* **이메일** : 세금 계산서 발행 시 수신할 담당자의 이메일 주소를 입력해 주세요.

{% hint style="warning" %}
담당자가 변경될 경우, 반드시 최신 정보로 수정해 주세요.
{% endhint %}

***

## **4. 보안 설정**

### 2단계 인증

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

주관리자는 계정 보안 강화를 위한 **2단계 인증(2FA)**&#xC744; 설정할 수 있습니다.\
사용 설정 시 **모든 주/부관리자 계정**에 **Google Authenticator 앱 인증을 일괄 요청**합니다.\
자세한 사용 설정 및 인증 완료 방법 등은 하단의 [**\[2단계 인증 설정 가이드\]**](#id-2-1)를 참고해 주세요.

{% hint style="info" %}

* 보안 강화를 위해 **2단계 인증 사용을 권장**합니다.
* 사용 설정 시 **최근 설정 일시**가 표시됩니다.
* 계정 당 모바일 기기 1대만 인증에 사용할 수 있습니다. 2단계 인증 사용 시 관리자 1인당 한 개의 계정만 이용해 주세요.
  {% endhint %}

<details>

<summary><strong>[2단계 인증 설정 가이드]</strong></summary>

### 사용 설정하기

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

* 주관리자 계정으로 로그인해 주세요.
* 2단계 인증을 활성화 후 \[저장] 버튼을 클릭합니다.
* 이후 노출된 창에서 \[확인] 버튼을 클릭하여 **2단계 인증 사용 설정을 완료**합니다.

{% hint style="info" %}
2단계 인증을 완료한 계정은 그루비 어드민 로그인 시 인증 코드를 입력해야만 로그인이 가능합니다.
{% endhint %}

### 인증 설정 완료하기

재로그인하여 아래 절차에 따라 **2단계 인증 설정을 완료**해 주세요.

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

* 모바일 기기에 **Google Play Store** 또는 **App Store**에서 **Google Authenticator 앱을 다운로드**해 주세요.
* 앱을 실행한 뒤 \[+] 버튼 또는 \[시작하기] 버튼을 눌러 **\[QR 코드 스캔]을 선택**해 주세요.
* 모바일 기기로 어드민 화면에 표시된 **QR 코드를 스캔**해 주세요.
* 어드민 화면에서 \[다음] 버튼을 클릭한 후, **앱에 생성된 인증 코드를 6자리를 입력**하여 **2단계 인증 설정을 완료**합니다.

{% hint style="success" %}
인증 설정 완료 후 로그인 시, ID와 비밀번호 외에 **Google Authenticator 앱의 일회용 인증 코드(OTP)**&#xAC00; 필요합니다. 비밀번호가 유출되더라도 OTP 없이는 접속할 수 없어 보안이 강화됩니다.
{% endhint %}

</details>


# 부관리자

부관리자 탭에서는 효율적인 서비스 운영을 위해 여러 계정을 생성하고 관리할 수 있습니다.\
부관리자는 서비스 운영을 보조하는 계정으로, 주관리자가 지정한 권한 범위 내에서만 기능을 사용할 수 있습니다.

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

{% hint style="warning" %}
해당 도움말은 **주관리자 계정으로 로그인 시** 이용 가능한 관리자 설정 화면에 대한 안내입니다.\
**부관리자 계정으로 로그인한 경우**에는 화면 구성 및 기능이 다르므로 [**\[부관리자 계정으로 로그인 시\]**](/new-admin/settings/administrator/sub#login) 도움말을 참고해 주세요.
{% endhint %}

## **1. 만들기**

<img src="/files/1W0plym8198H2UK1kBoh" alt="" data-size="line"> 버튼을 클릭하여 새로운 부관리자 계정을 생성할 수 있습니다.

### 새로운 부관리자 계정 만들기

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

* **ID:** 부관리자의 로그인 계정으로 사용할 이메일 주소를 입력해 주세요. 해당 이메일로 계정의 임시 비밀번호가 발송됩니다.
* **이름:** 부관리자의 성명을 입력해 주세요.
* **권한 설정:** 권한 탭에서 미리 설정해둔 권한 중 하나를 선택해 주세요. 선택한 권한의 상세 내용은 하단에 노출되며 권한에 포함된 메뉴 및 기능 목록을 확인할 수 있습니다.

{% hint style="danger" %}
부관리자 계정 ID는 생성 후 수정이 불가하며, 생성 시 사용 중인 이메일은 ID로 중복 사용할 수 없습니다.
{% endhint %}

{% hint style="info" %}
부관리자 계정은 최대 30개까지 생성할 수 있습니다.
{% endhint %}

***

## **2. 부관리자 리스트**

생성한 부관리자의 목록을 확인하고 권한 변경, 상태 관리, 2단계 인증 및 비밀번호 초기화 등 계정 운영에 필요한 모든 기능을 설정 및 관리할 수 있습니다.

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

<table><thead><tr><th width="159.8359375">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>ID</strong></td><td>부관리자 계정 생성 시 설정한 ID(이메일)입니다.</td></tr><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>2단계 인증 상태</strong></td><td>부관리자 계정의 현재 2단계 인증 상태입니다.(2단계 인증 사용 설정 시 표시됩니다.)</td></tr><tr><td><strong>생성일</strong></td><td>부관리자 계정이 생성된 날짜입니다.</td></tr><tr><td><strong>최종 수정일</strong></td><td>부관리자 계정을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

{% hint style="info" %}
행(Row) 좌측의 <img src="/files/lAYdIuUUb1tnDfe1bhfp" alt="" data-size="line"> 아이콘 또는 리스트 상단의 <img src="/files/AS3ioiKrD1mCZNhqqZep" alt="" data-size="line"> 버튼을 클릭하여 해당 부관리자의 권한 상세 내용을 확인할 수 있습니다.&#x20;
{% endhint %}

<details>

<summary><strong>계정 상태</strong></summary>

<table><thead><tr><th width="159.8359375">상태</th><th>설명</th></tr></thead><tbody><tr><td><strong>정상</strong></td><td>부관리자 계정 생성 시 기본 상태입니다.</td></tr><tr><td><strong>휴면</strong></td><td>부관리자 계정이 마지막 로그인 이후 90일 이상 경과하여 휴면된 상태입니다.<br>휴면 상태의 계정은 로그인 시 자동으로 정상 상태로 변경되며, 이후부터 서비스에 정상적으로 접근할 수 있습니다.</td></tr><tr><td><strong>차단</strong></td><td>부관리자 계정을 차단하여 서비스 접근을 제한한 상태입니다.</td></tr></tbody></table>

</details>

***

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

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

<figure><img src="/files/8mRJXD0aDuY3BknD8rhN" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="219.8253173828125">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/0XwdQjEr68wmbufloTF3" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 <strong>부관리자 계정의 이름 또는 권한을 수정</strong>합니다.</td></tr><tr><td><img src="/files/cROKGLKSnqazqPHZbrfZ" alt="" data-size="line"> <strong>차단</strong></td><td>선택한 <strong>부관리자 계정을 차단</strong>하여 <strong>로그인을 제한</strong>합니다.</td></tr><tr><td><img src="/files/gyZVCQbZMpOOw0X36fjP" alt="" data-size="line"> <strong>차단 해제</strong></td><td><strong>차단된 부관리자 계정 상태를 해제</strong>합니다. 차단 해제된 부관리자 계정은 정상적으로 로그인할 수 있습니다.</td></tr><tr><td><img src="/files/Yhz5sOzzoOkKVF5PfmOY" alt="" data-size="line"> <strong>2단계 인증 초기화</strong></td><td><strong>2단계 인증이</strong> <strong>완료된 부관리자 계정의 인증 상태를 초기화</strong>합니다.<br>이 기능은 계정의 인증 문제를 해결하거나 새로운 기기에서 인증을 재설정해야 할 때 유용합니다.</td></tr><tr><td><img src="/files/5WvwaLKe1Xn0ldaqt4wq" alt="" data-size="line"> <strong>비밀번호 초기화</strong></td><td>선택한 <strong>부관리자의 계정 비밀번호를 초기화</strong>합니다. 초기화 시 해당 계정의 <strong>이메일(ID)로 임시 비밀번호가 발급</strong>됩니다.<br>이 기능은 계정 비밀번호를 분실하거나 보안상 재설정이 필요한 경우 유용합니다.</td></tr><tr><td><img src="/files/IMev3uE8t5yBMwGc1BIj" alt="" data-size="line"> <strong>삭제</strong></td><td>부관리자 계정을 영구적으로 삭제합니다. <strong>삭제 시 해당 계정의 작업 내용은 유지</strong>되지만 삭제된 계정은 복구할 수 없습니다.</td></tr></tbody></table>

***

## **부관리자 계정으로 로그인 시** <a href="#login" id="login"></a>

부관리자 계정으로 로그인한 사용자는 계정 정보와 기본 정보(이름)를 확인하고, 비밀번호 변경을 통해 보안을 관리할 수 있습니다.

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

### 계정 정보

* **ID:** 현재 로그인된 부관리자 계정 ID가 표시됩니다.

{% hint style="warning" %}
해당 ID는 부관리자 계정 생성 시 입력된 값으로, 이후 수정은 불가합니다.
{% endhint %}

* **비밀번호:** 계정의 비밀번호를 변경할 수 있습니다.
  * 최근 변경 일자가 함께 표시되어 보안 관리에 참고할 수 있습니다.
  * 비밀번호 분실 시 주관리자에게 비밀번호 초기화를 요청해 주세요. 초기화 시 계정의 이메일(ID)로 임시 비밀번호가 발급됩니다.&#x20;

{% hint style="success" %}
새 비밀번호는 영문, 숫자, 특수 문자를 포함하여 8\~16자 이내로 설정해야 합니다.
{% endhint %}

### 기본 정보

* **이름:** 현재 로그인된 부관리자의의 성명이 표시됩니다. 해당 정보는 자유롭게 수정할 수 있습니다.

***

### 부관리자 2단계 인증 설정 가이드

주관리자가 **2단계 인증 사용을 설정한 경우 이후 로그인 시 인증 설정을 완료해야만 로그인이 가능**합니다.\
아래 절차에 따라 인증 설정을 완료해 주세요.

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

* 모바일 기기에 **Google Play Store** 또는 **App Store**에서 **Google Authenticator 앱을 다운로드**해 주세요.
* 앱을 실행한 뒤 \[+] 버튼 또는 \[시작하기] 버튼을 눌러 **\[QR 코드 스캔]을 선택**해 주세요.
* 모바일 기기로 어드민 화면에 표시된 **QR 코드를 스캔**해 주세요.
* 어드민 화면에서 \[다음] 버튼을 클릭한 후, **앱에 생성된 인증 코드를 6자리를 입력**하여 **2단계 인증 설정을 완료**합니다.

{% hint style="success" %}
인증 설정 완료 후 로그인 시, ID와 비밀번호 외에 **Google Authenticator 앱의 일회용 인증 코드(OTP)**&#xAC00; 필요합니다. 비밀번호가 유출되더라도 OTP 없이는 접속할 수 없어 보안이 강화됩니다.
{% endhint %}


# 권한

권한 탭에서는 서비스 내 메뉴별 사용 권한을 생성하고 관리할 수 있습니다. 생성한 권한은 부관리자 계정에 할당하여, 부관리자가 접근할 수 있는 기능을 제어할 수 있습니다.

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

{% hint style="warning" %}
해당 도움말은 **주관리자 계정으로 로그인 시** 이용 가능한 관리자 설정 화면에 대한 안내입니다.\
**부관리자 계정으로 로그인한 경우**에는 화면 구성 및 기능이 다르므로 [**\[부관리자 계정으로 로그인 시\]**](/new-admin/settings/administrator/sub#login) 도움말을 참고해 주세요.
{% endhint %}

## **1. 만들기**

<img src="/files/1W0plym8198H2UK1kBoh" alt="" data-size="line"> 버튼을 클릭하여 새로운 권한을 생성할 수 있습니다.

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

* **권한명:** 권한의 이름을 입력해 주세요. (문자 구분 없이 최대 40자 입력 가능)
* **상세 설명:** 필요시 권한에 대한 상세 설명을 입력해 주세요. (문자 구분 없이 최대 45자 입력 가능)
* **권한 선택:** 권한 목적에 맞는 메뉴 및 기능을 선택해 주세요. 메뉴 단위의 모든 기능을 전체 선택 또는 기능별로 선택할 수 있습니다.

***

## **2. 권한 리스트**

생성한 권한 목록을 확인하고 관리할 수 있습니다.

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

<table><thead><tr><th width="159.8359375">헤더</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>권한을 가장 최근에 수정한 날짜입니다.</td></tr></tbody></table>

{% hint style="info" %}
행(Row) 좌측의 <img src="/files/lAYdIuUUb1tnDfe1bhfp" alt="" data-size="line"> 아이콘 또는 리스트 상단의 <img src="/files/AS3ioiKrD1mCZNhqqZep" alt="" data-size="line"> 버튼을 클릭하여 해당 부관리자의 권한 상세 내용을 확인할 수 있습니다.&#x20;
{% endhint %}

***

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

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

<table><thead><tr><th width="160.03515625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/0XwdQjEr68wmbufloTF3" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 권한의 내용을 수정합니다. <strong>수정 시 해당 권한을 설정한 모든 부관리자 계정에 일괄 적용</strong>됩니다. </td></tr><tr><td><img src="/files/lKGhMBRAGoYf4ibAMzxK" alt="" data-size="line"> <strong>복사</strong></td><td>선택한 권한과 동일한 내용의 새 권한을 생성합니다. 복사본은 권한명 뒤에 '-COPY'가 붙습니다.</td></tr><tr><td><img src="/files/IMev3uE8t5yBMwGc1BIj" alt="" data-size="line"> <strong>삭제</strong></td><td>권한을 영구적으로 삭제합니다. <strong>부관리자 계정에 설정되지 않은 권한만</strong> 삭제할 수 있으며, 삭제된 권한은 복구할 수 없습니다.</td></tr></tbody></table>


# 사이트

## **기본 정보**

데이터 수집의 기준이 되는 사이트의 기본 정보와 인증 키를 관리하는 페이지입니다.&#x20;

{% hint style="info" %}
그루비 세팅 시 초기 설정값이 기본적으로 입력되어 있습니다.
{% endhint %}

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

### **1. 사이트 관리**

<figure><img src="/files/0OHwpqKu5W2Le6oEPVLS" alt=""><figcaption></figcaption></figure>

* **사이트명:** 운영 중인 사이트명을 입력해 주세요. (문자 구분 없이 최대 100자 입력 가능)
* **사이트 유형:** 운영 중인 사이트의 구축 플랫폼 정보입니다.
* **사이트 URL:** 운영 중인 사이트 URL을 입력해 주세요. 여러 개의 URL은 엔터(Enter)로 구분할 수 있습니다.

{% hint style="warning" %}
**사이트 리뉴얼** 또는 **사이트 유형(플랫폼)**&#xC774; 변경될 경우 기존 스크립트를 사용할 수 없습니다.\
스크립트 재설정은 그루비 담당자에게 문의해 주세요.
{% endhint %}

### **2. 키 관리**

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

* **서비스 키:** 사이트 식별을 위해 자동으로 발급된 고유 키입니다.
* **API 키:** API 호출에 필요한 인증 키입니다. <img src="/files/xWIlPFyEXyHY8yu3Zv2r" alt="" data-size="line"> 버튼을 클릭하여 발급 받을 수 있습니다.

{% hint style="warning" %}
보안을 위해 외부 노출에 주의해 주세요.
{% endhint %}

***

## **URL 설정**

데이터를 수집할 페이지별 URL을 등록하고 관리하는 페이지입니다.

{% hint style="info" %}
그루비 세팅 시 초기 설정값이 기본적으로 입력되어 있습니다.
{% endhint %}

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

### **1. 페이지 URL 리스트**

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

<table><thead><tr><th width="160.2265625">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>페이지</strong></td><td>데이터를 수집할 대상 페이지의 유형입니다. (예: 메인, 상품 상세 등)</td></tr><tr><td><strong>PC</strong></td><td>해당 페이지의 PC URL 입니다. </td></tr><tr><td><strong>모바일</strong></td><td>해당 페이지의 모바일 URL 입니다. </td></tr></tbody></table>

### **2. 설정**

<img src="/files/9fUU23iJXV4AMBS6p6Nn" alt="" data-size="line"> 버튼을 클릭하여 우측 패널에서 페이지 URL을 설정할 수 있습니다.

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

* **PC:** 해당 페이지의 PC URL을 입력해 주세요.
* **모바일:** 해당 페이지의 모바일 URL을 입력해 주세요.

{% hint style="warning" %}
실제 사이트와 일치하지 않을 경우 데이터가 수집되지 않습니다.
{% endhint %}

{% hint style="info" %}
여러 개의 URL은 엔터(Enter)로 구분할 수 있습니다.
{% endhint %}


# 모바일 앱

서비스 중인 모바일 앱의 식별 정보를 등록하는 페이지입니다. 등록된 정보를 바탕으로 방문자의 접속 환경(웹/앱)을 구분하여, **인앱 메시지 캠페인 및 푸시 알림 캠페인**을 진행할 수 있습니다.

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

{% hint style="info" %}
푸시 알림 발송을 위해 **\[푸시 알림 설정 > Firebase 비공개 키]**&#xB97C; 함께 등록해 주세요.
{% endhint %}

## **1. 앱 식별 정보**

Google Play 스토어 및 App Store에 등록된 앱의 고유 식별 정보입니다. 푸시 알림 발송 및 딥링크(앱 실행) 등 앱 연동 기능에 사용됩니다.

<figure><img src="/files/108XaoGdLJMnHmGvECr4" alt=""><figcaption></figcaption></figure>

* **Android 패키지명:** Google Play 스토어에 등록된 앱 패키지명을 입력해 주세요.
* **iOS 번들 ID:** App Store에 등록된 앱 번들 ID를 입력해 주세요.

***

## **2. 사용 플랫폼**

방문자의 접속 환경이 '모바일 웹'인지 '앱(하이브리드 앱)'인지 구분하기 위한 설정입니다.

{% hint style="info" %}
**활용 예시:** 모바일 웹으로 접속한 고객에게만 '앱 다운로드 쿠폰' 캠페인을 노출하고 싶은 경우 활용할 수 있습니다.
{% endhint %}

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

* **앱 구축 솔루션:** 바이앱스(Byapps), 메이크샵 앱(makeshopapp), 스마트스킨(SmartApp), 카페 24앱(Cafe24plus) 등의 솔루션을 이용 중이라면 목록에서 선택해 주세요.
* **기타(직접 입력):** 자체 개발 앱인 경우, 앱 개발 시 설정한 **User Agent 식별 키워드**를 입력해 주세요. (예: AppName, GroobeeApp 등)

{% hint style="warning" %}
**기타(직접 입력)** 선택 시 아래 내용을 참고하여 입력해 주세요.

* 전체 User Agent 문장이 아닌 앱을 식별할 수 있는 고유 키워드(단어)만 입력해 주세요.
* Android와 iOS에 **공통된 식별 키워드**가 있다면 **해당 단어 하나만 입력**해 주세요. OS별로 값이 다르다면 **콤마(,)로 구분**하여 입력합니다. (예: 공통 시 AppName, 분리 시 AppName\_And, AppName\_iOS)
  {% endhint %}


# 회원 정보

\[세그먼트 > 방문자 유형] 중 **회원 등급, 회원 유형, 회원 성별, 회원 연령대**를 변수로 활용하기 위해 각 항목의 코드와 상세 설명(표시 명칭)을 설정하는 페이지입니다.

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

{% hint style="warning" %}
카페24, 고도몰, 아임웹 등 임대형 쇼핑몰에서는 데이터 연동 구조상 본 설정 기능을 지원하지 않습니다.
{% endhint %}

## **1. 코드 등록**

<img src="/files/wybkeukclADt2tzyyYId" alt="" data-size="line"> 버튼을 클릭하여 각 유형별 항목을 추가해 주세요.

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

* **코드:** 해당 변수를 식별하는 고유 코드를 입력해 주세요. (문자 구분 없이 최대 20자 입력 가능)
* **상세 설명:** 세그먼트 설정 시 보여질 변수의 이름을 입력해 주세요. (문자 구분 없이 최대 50자 입력 가능)

{% hint style="info" %}
회원 등급과 회원 유형처럼 서로 다른 세그먼트 변수 유형간에는 같은 코드를 사용할 수 있으나, 동일 변수 내에서는 중복될 수 없습니다.
{% endhint %}

***

## **2. 코드 리스트**

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

<table><thead><tr><th width="160.3828125">헤더</th><th>설명</th></tr></thead><tbody><tr><td><strong>코드</strong></td><td>세그먼트 변수를 식별하는 고유 코드 입니다.</td></tr><tr><td><strong>상세 설명</strong></td><td>세그먼트 설정 시 보여질 변수의 이름입니다.</td></tr></tbody></table>

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

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

<figure><img src="/files/2JJ1A8x1vR6OXJaoXa8K" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="159.7890625">관리 도구</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/0XwdQjEr68wmbufloTF3" alt="" data-size="line"> <strong>수정</strong></td><td>선택한 항목의 코드 및 상세 설명을 수정합니다.</td></tr><tr><td><img src="/files/IMev3uE8t5yBMwGc1BIj" alt="" data-size="line"> <strong>삭제</strong></td><td>해당 코드를 영구적으로 삭제합니다. </td></tr></tbody></table>

***

## **3. 초기화**

<img src="/files/MfdUIBALgcOkmz5Hms0K" alt="" data-size="line"> 버튼을 클릭하여 입력된 모든 항목을 한 번에 삭제할 수 있습니다.




---

[Next Page](/llms-full.txt/1)