메시지 중단
선택적으로 조건문 내에서
abort_message("optional reason for aborting")Liquid 메시지 태그를 사용하여 사용자에게 메시지가 발송되는 것을 방지할 수 있습니다. 이 참조 문서에서는 마케팅 Campaign에서 이 기능을 활용하는 몇 가지 예시를 소개합니다.

Canvas에서 메시지 단계가 중단되면 사용자는 Canvas를 종료하지 않으며 다음 단계로 계속 진행합니다.
abort_message()를 사용한 테스트 발송
abort_message()는 조건을 충족하지 않는 사용자에 대한 발송을 중단합니다. 해당 메시지는 사용자 프로필에 표시되지 않으며 전달 수 또는 최대 게재빈도 설정에 집계되지 않습니다.
테스트 발송이 도착하지 않는 경우, 중단 조건을 충족하는 사용자로 미리보기한 다음 Test Send에서 Override recipients’ attributes with current preview user’s attributes를 활성화하세요(또는 자격을 충족하는 콘텐츠 테스트 그룹 멤버를 추가하세요).
“참석한 게임 수”가 0인 경우 메시지 중단
예를 들어, 게임에 참석하지 않은 고객에게는 메시지를 보내지 않으려는 경우를 생각해 보겠습니다:
{% if custom_attribute.${Number_Game_Attended} == 1 %}
Loved the game? Get 10% off your second one with code SAVE10.
{% elsif custom_attribute.${Number_Game Attended} > 1 %}
Love the games? Get 10% off your next one with code SAVE10.
{% else %}
{% abort_message() %}
{% endif %}
이 메시지는 게임에 참석한 것으로 확인된 고객에게만 전송됩니다.
영어 사용 고객에게만 메시지 보내기
고객의 언어가 영어일 때 일치하는 “if” 문과 영어를 사용하지 않거나 프로필에 언어가 설정되어 있지 않은 사용자에게 메시지를 중단하는 “else” 문을 작성하여 영어 사용 고객에게만 메시지를 보낼 수 있습니다.
{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}
기본적으로 중단된 발송은 메시징 옵저버빌리티에서 Liquid abort 성과로 표시됩니다.
괄호 안에 사유 문자열을 포함할 수 있습니다:
{% abort_message('language was nil') %}
중단 메시지 쿼리
쿼리 빌더 또는 Braze에 연결된 자체 데이터 웨어하우스를 사용하여 Liquid 로직으로 인해 메시지가 중단될 때 트리거되는 특정 중단 메시지를 쿼리할 수 있습니다.
중단 로직이 평가되는 시점
중단 로직 평가 시점은 메시지 채널에 따라 다릅니다.
푸시, 이메일, SMS, 웹훅 및 Content Cards
중단 로직은 Braze가 메시지 전달을 처리하는 발송 시점에 평가됩니다.
In-App Messages
중단 로직은 템플릿 인앱 메시지에 대해서만 인앱 메시지가 트리거되는 시점(예: 사용자가 트리거 이벤트를 수행하거나 세션을 시작하는 시점)에 평가되며, 메시지가 처음 기기로 전송되는 시점에 평가되지 않습니다. 인앱 메시지는 세션 시작 시 SDK로 전달되어 로컬에 캐시되며, abort_message() 호출을 포함한 Liquid는 트리거 조건이 충족될 때 실행됩니다.
높은 중단율 문제 해결
Campaign 또는 캔버스 단계에서 많은 사용자가 진입했지만 발송 수가 적거나, 전달 수가 예상보다 낮게 나타나는 경우 중단 로직이 일반적인 원인입니다. 특히 Liquid에서 평가 시점에 누락된 속성, 카탈로그 데이터 또는 목록 값을 필요로 할 때 자주 발생합니다.
메시징 옵저버빌리티 확인
- 메시징 옵저버빌리티를 엽니다.
- Campaign 또는 Canvas를 선택한 다음 Run Dashboard를 선택합니다.
- 세부 로그에서 Liquid abort 결과로 필터링합니다.
- 중단이 하나의 채널(예: 이메일만)에 집중되는지, 아니면 같은 Canvas 내 여러 채널에 걸쳐 발생하는지 확인합니다.
발송 시점의 속성과 Liquid 확인
푸시, 이메일, SMS, 웹훅, Content Cards의 경우, 중단 로직은 Braze가 전달을 위해 메시지를 처리할 때 실행됩니다. 사용자가 Canvas에 진입하거나 트리거 이벤트가 이전에 발생한 시점이 아닙니다.
- 메시지 단계가 실행되기 전에 필수 커스텀 속성, 이벤트 속성정보 또는 카탈로그 필드가 사용자에게 설정되어 있는지 확인합니다.
abort_message()를 호출하기 전에 명시적인 nil 또는 빈 값 검사를 추가합니다. 값이 없을 때 중단하는else분기는 해당 데이터가 없는 모든 사용자의 발송을 중지합니다.- 개인화가 목록, Segment 또는 연결된 콘텐츠 응답에 의존하는 경우, 메시지 단계가 실행될 때 해당 데이터가 사용 가능한지 확인합니다. 목록 멤버십이나 다운스트림 데이터가 준비되기 전에 사용자가 Canvas에 진입할 수 있습니다.
Canvas 관련 동작
Canvas에서 메시지 단계가 중단되면 사용자는 Canvas를 나가지 않습니다. 대신 다음 단계로 진행합니다. 중단은 해당 메시지 단계의 발송 수에만 영향을 미칩니다.
Canvas 중단을 진단할 때:
- 메시지 단계의 진입 사용자 수와 같은 단계의 발송 사용자 수를 비교합니다.
- 하나의 채널에서만 중단이 발생하는 경우, 해당 단계의 채널별 Liquid 또는 가입 상태를 검토합니다.
- 목록이나 카탈로그 업데이트 이후 중단이 급증하는 경우, 업데이트가 완료되기 전에 메시지 단계가 실행되었는지 확인합니다.
미리보기 및 테스트 발송으로 검증
메시지 작성기에서 영향을 받는 수신자의 프로필과 일치하는 사용자로 미리보기합니다. 테스트 발송 시 중단 로직이 프로필 데이터에 의존하는 경우 Override recipients’ attributes with current preview user’s attributes를 활성화합니다.
더 많은 중단 예시는 중단 메시지 쿼리를 참조하세요.
고려 사항
abort_message() Liquid 메시지 태그는 사용자에게 메시지가 전송되지 않도록 방지합니다. 즉, 메시지가 고객 프로필에 표시되지 않으며, 전달 수 또는 최대 게재빈도 설정에 포함되지 않습니다.