# 카카오톡 캠페인: 모먼트

{% 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.md) / [메시지 설정 가이드](/new-admin/kakao-moment/kakao-moment-create/message-guide.md) 문서를 참고해 주세요.
{% 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 %}


---

# Agent Instructions: Querying This Documentation

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

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

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

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

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