> ## Documentation Index
> Fetch the complete documentation index at: https://guide.blux.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 개인화 유저 변수

> 개인화 기능을 활용한 맞춤형 메시지 발송으로 매출을 늘려보세요

<Info>
  개인화 변수는 **유저의 정보를 바탕으로 개인화된 메시지를 작성하는 기능**입니다.

  개인화 변수를 활용하면 한 번의 캠페인으로도 다양한 유저에게 각기 다른 메시지를 발송할 수 있어요.
</Info>

***

## 개인화 변수 사용하기

<Frame>
  <img src="https://mintcdn.com/blux/y9pZclyJ7aVCZnFu/5.personal/imgs/personal_content.png?fit=max&auto=format&n=y9pZclyJ7aVCZnFu&q=85&s=0ed7ed28a1c773569286f71389331086" className="mx-auto" style={{ width:"72%" }} width="782" height="788" data-path="5.personal/imgs/personal_content.png" />
</Frame>

메시지 작성 시, 박스 하단의 **\[메시지 개인화 > 유저 정보]** 버튼을 통해 개인화 변수를 추가할 수 있습니다.

간단한 개인화 변수만으로도 유저들은 많은 관심을 가집니다.

메시지를 보낼 때 유저의 이름을 부를 수도 있고, 최근에 클릭했던 상품 정보를 넣을 수도 있습니다.

* **유저 정보**: 개인화 변수를 설정할 수 있습니다.
* **기본 값**: 변수로 설정한 필드에 값이 없는 경우, 기본적으로 입력될 값을 설정할 수 있습니다.

메시지 작성시에는 `{{ }}`로 표시되어 있는 변수를 사용해야 합니다. 실제 발송시에는 `{{ }}`로 표시되어 있는 변수들이 실제 값으로 치환되어 발송됩니다.

<Tip>
  개인화 변수를 활용한 CRM 메시지 예시가 궁금하다면?

  사용자 가이드의 [\[Tutorial > 퍼널별 CRM 메시지 추천 > 전환\]](/tutorials/1.funnel/2.conversion) 또는 [\[Tutorial > 퍼널별 CRM 메시지 추천 > 재구매 및 리텐션\]](/tutorials/1.funnel/3.retention)을 참고하세요!
</Tip>

***

## 개인화 변수 목록

Blux Message에서 제공하는 개인화 변수는 다음과 같습니다.

| 개인화 변수명                                                         | 설명                           |
| :-------------------------------------------------------------- | :--------------------------- |
| **name**                                                        | 유저 이름                        |
| **age**                                                         | 유저 나이                        |
| **phone\_number**                                               | 유저 전화번호                      |
| **email\_adress**                                               | 유저의 이메일 주소                   |
| **user\_id**                                                    | 유저 ID                        |
| **birthday**                                                    | 유저 생일                        |
| **signup\_date**                                                | 유저가 회원가입한 날짜                 |
| **last\_active\_at**                                            | 유저의 마지막 활성 시점                |
| **last\_login\_date**                                           | 유저가 마지막으로 로그인한 날짜            |
| **user\_id\_hash\_number**                                      | 유저 ID의 hash값 (숫자형)           |
| **user\_id\_hash\_numeric\_string**                             | 유저 ID의 hash값 (문자형)           |
| **latest\_cartadd\_item\_friendtalk\_image\_url**               | 유저가 마지막으로 장바구니에 담은 상품 이미지 링크 |
| **latest\_cartadd\_item\_name**                                 | 유저가 마지막으로 장바구니에 담은 상품명       |
| **latest\_cartadd\_item\_url**                                  | 유저가 마지막으로 장바구니에 담은 상품 링크     |
| **latest\_product\_detail\_view\_item\_friendtalk\_image\_url** | 유저가 마지막으로 본 상품 이미지 링크        |
| **latest\_product\_detail\_view\_item\_name**                   | 유저가 마지막으로 본 상품명              |
| **latest\_product\_detail\_view\_item\_url**                    | 유저가 마지막으로 본 상품 링크            |
| **marketing\_notification\_consent**                            | 마케팅 수신 동의 여부                 |
| **marketing\_notification\_email\_consent**                     | 이메일 마케팅 수신 동의 여부             |
| **marketing\_notification\_kakao\_consent**                     | 카카오톡 마케팅 수신 동의 여부            |
| **marketing\_notification\_sms\_consent**                       | 문자 마케팅 수신 동의 여부              |

***

## 개인화 변수 사용시 주의사항

* `[업데이트 시점]` **마지막 방문 / 장바구니 / 구매 정보는 약 10분 내외로 업데이트됩니다.**

  테스트 발송 시 실데이터 반영에 약간의 지연이 있을 수 있으니 참고 부탁드립니다.
* `[발송 실패 이유]` **아래 상황에서는 개인화 이미지/링크가 발송 실패할 수 있습니다.**

  (a) 유저가 방문/장바구니/구매 행동을 하지 않은 경우

  (b) 유저가 마지막으로 방문/장바구니/구매한 상품이 삭제되었거나 품절된 경우

  실제 캠페인 활성화 후에도 특정 유저가 (a) 또는 (b)에 해당하면, 해당 유저에 대한 메시지는 자동으로 **실패 처리**됩니다.
* `[권장 사용 채널]` 개인화 이미지와 링크를 사용한 캠페인을 활성화하고자 하시는 경우,**\[브랜드메시지 I형]을 사용하는 것을 권장드립니다.**

  (기술적으로) 브랜드메시지 API는 이미지 규격이 더 **세분화·안정화**되어 있어 개인화 이미지 발송을 더욱 안정적으로 하실 수 있습니다.

  **브랜드메시지 I형은 기존 친구톡과 완전히 동일한 유형이라, 브랜드메시지 등록이 완료되어 있다면 별도로 고려해주실 점은 없습니다!**

***

## Cafe24 자동 수집 변수 목록

<Info>
  다음 개인화 변수들은 Cafe24를 사용하고 계실 때 추가로 수집되는 변수들입니다.

  별도의 데이터 연동 없이 활용하실 수 있습니다.
</Info>

| 개인화 변수명               | 설명             |
| :-------------------- | :------------- |
| **membership**        | 유저의 멤버십 등급     |
| **available\_points** | 사용할 수 있는 포인트 수 |
| **total\_points**     | 유저의 전체 포인트 수   |
| **used\_points**      | 유저가 사용한 포인트 수  |