학습 내용
필터의 작동 방식과 필터를 사용하여 변수를 사용자 지정하는 방법을 알아보세요. 필터를 사용하면 보내는 메시지의 변수(즉, 개인화 태그)의 형식과 내용을 사용자 지정할 수 있습니다. 템플릿 편집기에서 사용할 수 있는 필터 목록은 클라비요의 가변 필터 용어집을 참조하세요.
시작하기 전 안내 사항시작하기 전 안내 사항
시작하기 전에 클라비요에서 메시지 개인화가 어떻게 작동하는지 숙지하세요. 필터를 사용하려면 올바른 기본 변수를 식별하여 템플릿에 추가할 수 있어야 합니다.
필터 작동 방식필터 작동 방식
개인화 태그에 필터를 적용하여 표시되는 출력을 조정합니다. 몇 가지 가능한 사용 사례는 다음과 같습니다:
- 텍스트에 일관된 대문자를 적용합니다(예: 위쪽 필터를 사용하여 변수를 가져와 모두 대문자로 만들 수 있습니다).
- 곱하기 필터를 사용하여 프로모션이 적용된 후 품목의 가격을 표시합니다.
- 플로플랫 필터를 사용하여 숫자 변수에 표시할 소수점 이하 자릿수를 설정합니다.
지원되는 필터 목록은 가변 필터 용어집을 참조하세요.
변수에 필터 적용변수에 필터 적용
변수에 필터를 적용하려면
- 개인화 태그를 식별합니다(예:
{{ item.price }}). - 변수 이름 뒤에 파이프 기호( | )를 추가합니다.
- floatformat과 같은 필터 이름을 추가하여 표시할 소수점 수를 지정합니다.
- 필터에 인수가 있는 경우(예: 추가 매개변수 또는 입력) 콜론을 추가하고 그 뒤에 인수를 입력합니다.
공백을 추가하지 마세요. 다음은 필터가 적용된 변수의 예입니다:
{{ item.price|floatformat:2 }}
이 예제에서 item.price는 변수 이름, floatformat은 필터, 2는 필터에 필요한 인수입니다.
인수가 텍스트인 경우 인수를 곧은 작은따옴표(예: ', ' 아닌 ')로 묶어야 합니다. 인수가 숫자인 경우에는 따옴표가 필요하지 않습니다. 예시는 클라비요의 변수 필터 용어집을 참조하세요.
필터 사용 팁필터 사용 팁
필터를 복사하여 템플릿에 붙여넣는 경우 필터 자체와 함께 서식을 지정하여 붙여넣지 않도록 일반 텍스트로 붙여넣어야 합니다. 붙여넣기를 일반 텍스트 키보드 단축키(Ctrl+Shift+V 또는 Cmd+Shift+V)로 사용합니다.
변수에 참조된 데이터가 사용 중인 필터에 적합한지 확인하는 것이 중요합니다. 일부 필터는 텍스트 데이터 유형에만 적용할 수 있고, 다른 필터는 목록이나 숫자에만 작동합니다. 필터가 예상대로 작동하지 않는 경우 사용 중인 이벤트 또는 프로필 데이터를 검토하여 올바른 유형인지 확인하세요.
여러 필터 적용하기여러 필터 적용하기
필요한 경우 단일 변수에 여러 필터를 적용할 수 있습니다. 이렇게 하려면 파이프 기호( | )를 사용하여 각 필터를 연결하고, 일반적으로 필터가 첫 번째부터 마지막까지 순서대로 적용된다는 점을 고려하세요. 다음은 여러 필터가 적용된 변수의 몇 가지 예입니다:
{{ first_name|title|default:'there' }}
첫 번째 필터는 받는 사람의 이름에 제목 대소문자를 적용하고, 두 번째 필터는 이름이 제공되지 않은 경우 사용할 기본 단어를 제공합니다.
{{ item.price|multiply:.8|floatformat:2 }}
첫 번째 필터는 기본 품목 가격에 0.8을 곱합니다. (20% 할인 쿠폰이 적용된 경우 가격을 표시하기 위해), 두 번째 필터 는 소수점 이하 두 자리까지 표시하도록 지정합니다.
추가 리소스