개인화 유저 변수
개인화 유저 변수는 유저별 속성 값을 메시지 본문에 자동으로 치환하는 기능이에요.
한 번의 캠페인 작성으로도 받는 사람마다 자기 이야기처럼 보이는 메시지를 보낼 수 있습니다.
1. 메시지에 변수 추가하기
캠페인 메시지 작성 영역의 내용 박스 하단에 유저 정보 / 상품 추천 정보 2개 버튼이 있어요.
유저 정보 버튼을 클릭하면 변수 선택 팝오버가 열려요.
| 항목 | 설명 |
|---|---|
| 유저 정보 | 메시지에 끼워 넣을 유저 속성을 1개 선택합니다. 검색창으로 빠르게 찾을 수 있어요. |
| 기본 값 (선택) | 선택한 변수 값이 그 유저에게 존재하지 않거나 비어 있을 때 대신 표시할 텍스트입니다. (예: 이름이 없을 때 고객) |
기본 값을 비워 두면, 변수 값이 없는 유저에게는 그 자리만 빈 문자열로 발송됩니다. 어색한 문장이 되지 않도록 가능한 한 기본 값을 채워두는 걸 권장해요.
값을 채우고 추가를 클릭하면 본문 커서 위치에 {{ 변수명 }} 형태로 삽입됩니다. 실제 발송 시점에 그 자리가 유저별 실제 값(또는 기본 값)으로 치환되어 나가요.
같은 메시지 안에 변수를 여러 개 넣을 수 있어요. 예: {{ name }}님, {{ membership }} 등급 고객님께 드리는 특별 혜택!
변수를 여러 개 사용할 때는 한 변수씩 유저 정보 버튼으로 추가하면 돼요.
2. 사용 가능한 변수 목록
변수 선택 드롭다운에는 애플리케이션이 보유한 모든 유저 속성이 노출됩니다. 각 변수 옆에는 한글 설명이 함께 표시되고, 기본 속성 → 애플리케이션 커스텀 속성 순으로 일관된 순서로 정렬되어 있어요. 영어 키 이름이 익숙하지 않아도 한글 설명만 보고 빠르게 고를 수 있습니다.
블럭스가 기본으로 제공하는 속성과, 애플리케이션이 데이터 페이지에서 직접 추가한 커스텀 속성을 모두 사용할 수 있어요.
자주 쓰는 기본 속성
| 변수 표기 | 설명 |
|---|---|
{{ name }} | 유저 이름 |
{{ age }} | 유저 나이 |
{{ gender }} | 성별 |
{{ phone_number }} | 전화번호 |
{{ email_address }} | 이메일 |
{{ blux_user_tier }} | 블럭스 유저 등급 |
{{ last_active_at }} | 마지막 활동 시각 |
{{ send_date }} | 발송 시점의 날짜 (예: 2026-05-27) — 인사말 등에서 활용 |
마지막 행동 상품 변수
유저가 가장 최근에 한 행동(장바구니·방문·구매·좋아요)에 연결된 상품 정보를 끼워 넣을 수 있어요.
| 변수 표기 | 설명 |
|---|---|
{{ latest_cartadd_item.name }} | 마지막으로 장바구니에 담은 상품명 |
{{ latest_cartadd_item.item_url }} | 마지막으로 장바구니에 담은 상품 링크 |
{{ latest_cartadd_item.brand_message_image_url }} | 마지막으로 장바구니에 담은 상품 이미지 |
{{ latest_product_detail_view_item.name }} | 마지막으로 본 상품명 |
{{ latest_product_detail_view_item.item_url }} | 마지막으로 본 상품 링크 |
{{ latest_product_detail_view_item.brand_message_image_url }} | 마지막으로 본 상품 이미지 |
{{ latest_purchase_item.name }} | 마지막으로 구매한 상품명 |
{{ latest_purchase_item.item_url }} | 마지막으로 구매한 상품 링크 |
{{ latest_purchase_item.brand_message_image_url }} | 마지막으로 구매한 상품 이미지 |
{{ latest_like_item.name }} | 마지막으로 좋아요한 상품명 |
마케팅 수신 동의 변수
유저의 채널별 수신 동의 상태를 표시할 수 있어요.
| 변수 표기 | 설명 |
|---|---|
{{ marketing_notification_consent }} | 마케팅 수신 동의 여부 (전체) |
{{ marketing_notification_sms_consent }} | 광고 문자 수신 동 의 여부 |
{{ marketing_notification_email_consent }} | 광고 이메일 수신 동의 여부 |
{{ marketing_notification_kakao_consent }} | 광고 카카오톡 수신 동의 여부 |
{{ marketing_notification_push_consent }} | 광고 앱푸시 수신 동의 여부 |
이 외에도 애플리케이션이 직접 추가한 모든 커스텀 유저 속성을 동일한 방식으로 사용할 수 있습니다.
3. 이미지·링크에도 변수 사용하기
개인화 변수는 메시지 본문 텍스트뿐 아니라 메시지의 이미지 URL과 버튼 링크 URL에도 사용할 수 있어요. 예를 들면 다음과 같이 활용할 수 있습니다.
- 이미지 URL — 유저가 마지막으로 본 상품 이미지를 메시지 이미지로 노출
- 예:
{{ latest_product_detail_view_item.brand_message_image_url }}
- 예:
- 버튼 링크 URL — API 트리거 캠페인에서 외부 시스템이 함께 보낸 값을 그대로 URL에 끼워 넣기
- 예:
https://shop.example.com/orders/{{ api_trigger.order_id }}
- 예:
API 트리거 변수 (api_trigger.*)
API 트리거 캠페인을 사용하는 경우, 외부 시스템이 호출 시 함께 보낸 페이로드 값을 api_trigger.<필드명> 형태로 메시지 본문·이미지·링크 어디서나 끼워 넣을 수 있어요. 이미지·링크에 변수를 직접 타이핑하지 않아도 입력란 옆 변수 선택 버튼에서 API 트리거 변수 카테고리를 골라 추가할 수 있습니다.
앱푸시 이미지를 변수로 받아오기
앱푸시는 이미지 슬롯에서 API 트리거 변수로 받아오는 이미지 옵션을 별도로 선택할 수 있어요. 캠페인 작성 시 변수명만 지정해 두면, 발송 시점에 외부 시스템이 보낸 api_trigger.<변수명> 값이 그대로 푸시 이미지 URL로 사용됩니다. 호출마다 다른 상품·배너 이미지를 동적으로 태워 보낼 때 활용할 수 있습니다. 자세한 동작은 [채널 > 앱푸시 > 이미지 첨부하기]를 참고해 주세요.
카카오 브랜드 메시지에서는 이미지·링 크에 api_trigger.* 변수를 사용할 수 없어요.
카카오 정책상 이미지 URL과 링크 URL이 메시지 검수 시점에 확정되어 있어야 하므로, 발송 시점에 값이 결정되는 api_trigger.* 변수는 노출되지 않습니다. 텍스트 본문에는 그대로 사용할 수 있어요.
4. 사용 시 주의사항
마지막 활동 상품 정보는 약 10분 내외로 갱신됩니다. 테스트 발송 시 실데이터가 반영되기까지 약간의 지연이 있을 수 있어요.
개인화 이미지·링크가 발송 실패할 수 있는 경우
- 그 유저가 방문·장바구니·구매·좋아요 행동을 한 적이 없는 경우
- 마지막으로 행동한 상품이 삭제되었거나 품절된 경우
활성화된 캠페인에서도 위 조건에 해당하는 유저는 자동으로 실패 처리됩니다.