개인화 메시지 (Liquid)

태그나 유저프로필 등 고객 데이터 연동 docid\ cjfldmxlu8vgdgu3jzect 이 먼저 되어야 이를 바탕으로 개인화 메시지 사용이 가능합니다 아래 기존 개인화 메시지 문법도 함께 지원 되고 있지만 원활한 사용을 위해 새로운 문법 변경을 권장드립니다 {{ name || 고객 }}님 안녕하세요! liquid 는 shopify에서 개발한 오픈소스 템플릿 언어입니다 플레어레인은 liquid 문법을 활용한 개인화 메시지를 지원합니다 liquid를 사용하면 데이터를 원하는 형태로 조작할 수 있기 때문에 보다 풍부한 개인화 메시지 표현이 가능합니다 메시지에 이름이나 회원등급 등 고객 데이터를 첨부하여 더욱 개인화된 메시지를 발송해보세요 일반 메시지 발송 대비 높은 반응률을 기대할 수 있습니다 개인화 메시지 예시 {{ name | default "고객" }}님 안녕하세요! {{ tags signup date | date "%y %m %d", "asia/seoul" }} 일자로 가입이 완료되었습니다 주문하신 {{ entry event data product name | truncate 20 }} 상품이 배송 시작하였습니다 적립금 {{ tags point | number with delimiter}} 원이 소멸 예정입니다 동작 원리 liquid 문법은 2개의 중괄호로 구성된 문자열 블록입니다 예를 들어, 고객 이름을 활용한 개인화 메시지는 다음과 같이 구성할 수 있습니다 {{ name | default "고객" }}님 안녕하세요! 실제 발송 시점에 유저프로필 & 태그 docid 0bvi3zqh7gd3f mr2nske 내 이름 데이터가 있으면 아래와 같이 메시지가 발송됩니다 김민혁님 안녕하세요! 만약 이름 데이터가 없는 경우 기본값이 설정되어 아래와 같이 메시지가 발송됩니다 고객님 안녕하세요! 사용 가능 함수 필터는 연속 활용이 가능합니다 아래 예시는 signup date 태그가 있으면 date 포맷팅을 하고, 값이 없는 경우 default에 의해 기본값을 리턴합니다 {{ tags signup date | date "%y %m %d", "asia/seoul" | default "오늘" }} 일자로 가입이 완료되었습니다 문자열 필터 default 변수가 없는 경우 기본값으로 치환합니다 truncate 긴 변수를 특정 길이만큼 잘라냅니다 truncatewords 긴 변수를 단어 개수만큼 잘라냅니다 replace 변수 내 특정 문자열을 모두 치환합니다 replace first 변수 내 첫 번째 특정 문자열을 치환합니다 date 기간 문자열을 원하는 포맷으로 변경합니다 ( 포맷 확인 ) upcase 영문 문자열을 모두 대문자로 치환합니다 downcase 영문 문자열을 모두 소문자로 치환합니다 capitalize 영문 첫 단어를 대문자로 치환합니다 url encode url safe 하도록 문자열을 인코딩합니다 url decode url 인코딩된 문자열을 디코딩합니다 strip html html 태그를 모두 제외합니다 숫자 필터 number with delimiter 숫자를 세자리 구분 콤마를 포함한 문자열로 변환합니다 plus 숫자 변수에 특정 값을 더합니다 minus 숫자 변수에 특정 값을 뺍니다 times 숫자 변수에 특정 값을 곱합니다 divided by 숫자 변수에 특정 값을 나눕니다 round 숫자 변수를 반올림합니다 floor 숫자 변수를 내림 처리 합니다 ceil 숫자 변수를 올림 처리 합니다 배열 필터 first 배열의 첫 번째 값을 출력합니다 last 배열의 마지막 값을 출력합니다 size 배열 내 개수를 출력합니다 join 배열의 모든 값을 묶어 하나의 문자열로 출력합니다 조건 분기 {% if %}, {% else %}, {% elsif %} 조건을 활용한 분기 처리가 가능합니다 {% assign %} 임의 변수를 할당해두고 후속 함수에 연계하여 사용할 수 있습니다 활용예시 {% assign user name = tags nickname %} {% assign last purchase = tags last purchase category %} {% if last purchase == "스니커즈" %} 이번 주 한정으로 {{ user name }}님이 좋아하시는 스니커즈 신상품을 10% 할인 중이에요! 놓치지 마세요 👟 {% elsif last purchase == "아우터" %} 추운 날씨에 딱 맞는 아우터 신상이 입고되었어요! {{ user name }}님을 위한 특별 혜택도 준비되어 있답니다 🧥 {% else %} {{ user name }}님만을 위한 신규 상품과 할인 혜택이 준비되어 있어요 지금 바로 확인해보세요! {% endif %} 사용 가능 변수 연동된 다양한 고객 데이터를 변수로 활용하실 수 있습니다 태그 tags 해당 기기에 설정된 유저프로필 & 태그 docid 0bvi3zqh7gd3f mr2nske 에서 일치하는 태그를 자동으로 매칭합니다 {{ tags grade }} 등급 쿠폰이 발급되었습니다 해당 기기의 태그 중 grade를 찾습니다 이벤트 entry event data 고객 여정 자동화에서 시작 조건 이벤트 docid\ bffue91dld0f3kivt4wul 에 함께 첨부된 data를 변수로 활용할 수 있습니다 고객님 장바구니에 담긴 {{ entry event data product name }} 상품이 기다리고 있어요! 발생 이벤트의 서브데이터 중 product name을 찾습니다 userid 발송 대상 기기에 유저id가 있는 경우 유저id 값을 전달합니다 웹훅 등 유저id를 전달해야할 일이 있을 때 주로 활용됩니다 데이터 발송 당시 외부 값을 즉석으로 입력받아 맞춤형 개인 메시지를 발송할 수 있습니다 {{ writername }}님이 회원님의 글을 좋아합니다 발송 api를 통해 data 파라미터를 추가하거나 콘솔 내 데이터 필드를 직접 입력할 수 있습니다 api post https //api flarelane com/v1/projects/\<project id>/notifications { targettype userid, targetids "user id", body "{{ writername }}님이 회원님의 글을 좋아합니다 " data { writername "민혁" } } 문법 (업데이트 전) 메시지 제목 혹은 내용부에 2개의 중괄호( {{ }} )를 넣고 2개의 세로줄 (||) 을 기준으로 변수명과 기본값을 나눕니다 변수명에 값이 없으면 기본값이 활용됩니다 위 예시를 보자면, username 변수에 '김철수' 값이 들어온 경우에는 김철수님 으로, 값이 들어오지 않은 경우에는 고객님 으로 표기됩니다