개인화 문법
개요
그로스 액션의 강력한 기능 중 하나는 개인화 메시지 기능입니다. 개인화 메시지를 사용하면 각 사용자의 디바이스 정보와 개인 정보를 활용하여 맞춤형 캠페인을 쉽게 만들 수 있습니다. 개인화 메시지는 Liquid라는 오픈소스 템플릿 언어를 사용하여 구현됩니다.
개인화 메시지 작성하기
개인화 메시지 작성 시에는 디파이너리에서 제공하는 태그와 커스텀 태그를 모두 활용할 수 있습니다.
| 구분 | 태그 | 타입 | 설명 |
| User | {{user["abx:user_id"]}} | text | 유저 아이디를 의미하며 연동 시 노출됩니다. |
| {{user["abx:age"]}} | long | 수집유무에 따라 노출이 결정됩니다. | |
| {{user["abx:gender"]}} | enum | 수집유무에 따라 노출이 결정됩니다. | |
| {{user["c:${your_custom_user_property}"]}} | 고객이 직접 수집한 User Properties 값이 추가됩니다. | ||
| Device | {{device.os}} | text | 앱의 OS 버전을 의미합니다. |
| {{device.model}} | text | 디바이스 모델명을 의미합니다. | |
| {{device.platform}} | enum | Android, iOS 플랫폼 정보를 의미합니다. | |
| {{device.carrier}} | text | 디바이스의 통신사 정보를 의미합니다. | |
| {{device.language}} | text | 디바이스에 설정된 언어 정보를 의미합니다. | |
| {{device.country}} | text | 디바이스에 설정된 국가 정보를 의미합니다. |
User(프로필)
유저 정보 설정 시 user id, age, gender는 별도의 API를 활용하여 연동합니다.
연동이 완료되면 {{user["abx:user_id"]}} 태그를 사용할 수 있으며 {{user["abx:age"]}}와 {{user["abx:gender"]}}의 경우
수집된 데이터가 없을 시 사용할 수 없습니다. 이외 직접 연동하여 쌓인 {{user["c:${your_custom_user_property}"]}} 값 또한
개인화 태그로 활용할 수 있습니다. 아래 내용을 참고해 주세요.
- {{user["abx:"]}} 형식 : 별도 API로 연동해야하며 user_id, age, gender만 지원합니다.
- {{user["c:${your_custom_user_property}"]}}형식: 고객이 직접 수집한 User Properties 속성이 추가됩니다.
Device(대상 기기)
SDK 탑재 시 위 6가지의 태그를 모두 사용할 수 있으며, 발송하는 기기의 치환된 결과값이 노출됩니다.
Kakao 및 SMS 개인화 태그 사용 시 안내
1. Device 태그 사용 불가
카카오 및 SMS 채널의 경우 발송 시 기기 정보를 확인할 수 없기 때문에 개인화 언어 사용 시 Device 태그를 사용할 수 없습니다.
2. 개인화변수 사용으로 인한 글자수 제한 초과
카카오와 SMS에 개인화변수를 사용할 경우 실제 발송 시 치환되는 문자로 인해 글자수 제한을 초과할 수 있습니다. 카카오 알림톡과 친구톡은 글자수 제한을 초과하면 발송에 실패합니다. SMS는 바이트 제한을 초과하면 본문의 일부만 발송됩니다. 따라서 개인화변수를 사용할 경우, 제한된 글자수와 바이트를 초과하지 않도록 여유있게 메시지를 작성하세요.
개인화 메시지 : 텍스트
텍스트 개인화 메시지 작성 방법을 안내합니다.
예시) 20세 이상의 유저에게 30% 쿠폰 제공 메시지 노출
방법 1.
텍스트 작성 영역에서 “{{” 또는 작성 시 디파이너리에서 제공하는 기본 태그를 선택할 수 있습니다.
“{%” 작성 시 리퀴드 템플릿 언어를 바로 작성할 수 있습니다.
방법 2.
텍스트 영역 안의 아이콘{}을 클릭하면 디파이너리에서 제공하는 기본 태그를 선택할 수 있습니다.
개인화 메시지 : 이미지
이미지 개인화 메시지 작성 방법을 안내합니다.
예시) 20세 미만에게는 'A'이미지, 20세 이상에게는 'B'이미지 노출
개인화 모드 On 시 텍스트를 입력할 수 있는 영역으로 전환되며, 개인화 텍스트 입력과 동일한 방식으로 개인화 메시지를 작성할 수 있습니다.
(※ 화면 내 개인화 가이드의 내용을 유의하여 작성해 주세요.)
방법 1.
텍스트 작성 영역에서 “{{” 또는 작성 시 디파이너리에서 제공하는 기본 태그를 선택할 수 있습니다.
“{%” 작성 시 리퀴드 템플릿 언어를 바로 작성할 수 있습니다.
방법 2.
텍스트 영역 안의 아이콘{}을 클릭하면 디파이너리에서 제공하는 기본 태그를 선택할 수 있습니다.
개인화 적용 시 미리보기
[[인용:경고:보통]] 개인화 메시지 입력 시 시뮬레이션 옵션을 필수로 설정해야 합니다.
시뮬레이션 옵션 설정 방법
- 직접 입력
개인화 키와 밸류값을 직접 입력하여 작성한 메시지를 미리 확인할 수 있습니다. 예를 들어 20세 이하에게는 'A'이미지, 20세 이상에게는 'B'이미지 노출 하는 메시지를 작성했다면, 개인화 키 값에 age를, 값에 나이를 입력하여 해당 메시지가 조건에 부합하게 잘 나오는지 확인할 수 있습니다. - 테스트 기기 선택
Growth Action > Settings > Test Message Setting에서 미리 등록한 테스트 기기를 선택합니다. 선택한 기기에 로그인된 가장 최근 사용자의 정보에 부합하는 결과를 확인할 수 있습니다.
※ 주의사항 : Push Token으로 등록한 테스트 기기는 시뮬레이션 설정 목록에서 제외됩니다. - 테스트 유저 선택
Growth Action > Settings > Test Message Setting에서 미리 등록한 테스트 유저를 선택합니다. 테스트 유저 등록 시 조회한 유저 ID의 사용자의 정보에 부합하는 결과를 확인할 수 있습니다. - 개인화 프로필 선택
Growth Action > Settings > Test Message Setting에서 미리 저장된 개인화 키와 밸류 값을 불러올 수 있습니다. 특정 유저의 여러 특성을 조합하여 저장 후, 시뮬레이션 설정 시 해당 값을 그대로 불러와 보세요.