Canvas 만들기
사용자를 여러 단계의 여정으로 안내하려면 Canvas를 사용합니다. Canvas는 지연, 의사결정, 메시지를 연결하여 사용자가 무엇을 언제 수행하는지에 따라 경험을 분기할 수 있습니다. 하나 이상의 채널에서 단일 메시징 단계를 보내려면 Campaigns를 사용하세요.
사전 요구 사항
시작하기 전에
- Canvas 기본 사항을 검토하여 진입, 메시징, 전환 목표가 사용 사례에 맞게 설정되어 있는지 확인하세요.
- 단계별 안내를 원하시면 Canvas Braze 학습 과정을 수강하세요.
- Braze Canvas 템플릿에서 시작하거나, Operator에 브리프를 제공하여 Canvas 초안을 작성해 보세요.
1단계: Canvas 기본 설정하기
- 메시징 > Canvas로 이동합니다.
- Canvas 만들기를 선택합니다.
- Canvas의 이름을 지정하고, Teams를 할당하고, 태그를 만들거나 추가합니다. Canvas에 전환 이벤트를 할당할 수도 있습니다.

전환 이벤트 선택하기
전환 이벤트 유형을 선택한 다음, 기록할 전환을 선택합니다. 이러한 전환 이벤트는 Canvas의 효율성을 측정합니다.
Canvas에 여러 배리언트 또는 대조군이 있는 경우, Braze는 이 전환 이벤트를 사용하여 이 전환 목표를 달성하기 위한 최적의 배리에이션을 결정합니다. 동일한 로직을 사용하여 여러 전환 이벤트를 만들 수 있습니다.
2단계: 진입 스케줄 선택하기
사용자가 Canvas에 진입하는 세 가지 방법 중 하나를 선택할 수 있습니다.
예약 전달을 사용하면 Campaign을 스케줄하는 것과 유사하게 사용자가 정해진 시간에 진입합니다. Canvas가 시작되자마자 사용자를 등록하거나, 미래의 특정 시점에 진입시키거나, 반복적으로(매일, 매주 또는 매월) 진입시킬 수 있습니다.
월간 반복 스케줄을 선택하는 경우, 일부 달에는 선택한 날짜가 없을 수 있습니다. 예를 들어, Canvas를 매월 31일에 발송하도록 설정했다고 가정하겠습니다. 이 경우 Braze는 4월 31일이 존재하지 않으므로 해당 월의 마지막 날인 4월 30일에 발송합니다.
현지 시간대 전달을 사용할 때 Braze는 진입 자격을 두 번 평가합니다: 먼저 예약된 날짜의 사모아 시간(UTC+13)에, 그리고 다시 사용자의 현지 시간에 평가합니다. 사용자는 Canvas에 진입하려면 두 번의 확인을 모두 통과해야 합니다. 진입 필터에 상대적 시간 범위(예: “2일 이상 전”)를 사용하는 경우, 첫 번째 확인 시점에 24시간이 경과하지 않아 사용자가 하루 늦게 진입할 수 있습니다. 이를 방지하려면 최소 2일 이상과 같이 더 넓은 시간 범위를 사용하세요. 자세한 내용은 Braze는 현지 시간대 전달을 위해 언제 사용자를 평가하나요?를 참조하세요.
실행 기반 전달을 사용하면 사용자가 앱 열기, 구매, 커스텀 이벤트 트리거 등 특정 행동을 수행할 때 Canvas에 진입하고 메시지를 수신하기 시작합니다.
진입 오디언스 창에서 재자격 규칙 및 최대 게재빈도 설정을 포함한 Canvas 동작의 다른 측면을 제어할 수 있습니다. 인앱 메시지 단계와 함께 실행 기반 Canvas 진입을 사용할 수 있습니다. 인앱 메시지는 기존 실행 기반 단계(트리거 및 지연)에서는 사용할 수 없습니다.

Canvas 단계와 상호작용은 Canvases의 실행 기반 진입 트리거로 사용할 수 없습니다. Campaigns의 트리거로만 사용할 수 있습니다. 하나의 Canvas에서 다른 Canvas를 트리거하려면 대상으로 전송 Canvas 구성요소를 사용하거나, /canvas/trigger/send 엔드포인트를 호출하는 Braze 간 웹훅을 생성하세요.

실행 기반 Canvas가 예상보다 일찍 메시지를 발송하는 경우, 커스텀 이벤트 타임스탬프가 소급된 시간이 아닌 현재 시간으로 전송되는지 확인하세요. 예를 들어, 실행 기반 Canvas에 사용자가 커스텀 이벤트를 수행한 후 3시간 지연이 설정되어 있다면, Braze는 커스텀 이벤트와 함께 전송된 타임스탬프를 사용하여 해당 지연을 평가합니다. 타임스탬프가 3시간 이상 소급된 경우, Braze는 지연이 이미 경과한 것으로 처리하고 메시지를 즉시 발송합니다.
API 트리거 전달을 사용하면 /canvas/trigger/send 엔드포인트를 통해 사용자를 추가한 후 Canvas에 진입하고 메시지를 수신하기 시작합니다. 대시보드에 예시 cURL 요청이 포함되어 있습니다.
해당 요청의 진입 속성정보 키는 워크스페이스에서 사용 가능한 기능에 따라 달라집니다:
- 대시보드에 컨텍스트 변수가 표시되면,
context오브젝트에 선택적 진입 데이터를 전달하세요. - 대시보드에 Canvas 진입 속성정보가 표시되면, 대시보드 샘플에 표시된 레거시
canvas_entry_properties오브젝트를 사용하세요.
예를 들어, 수신자 오브젝트는 다음 진입 데이터 키 중 하나를 사용합니다:
컨텍스트 변수:
{"external_user_id": "user_123", "context": {"product_name": "shoes"}}
Canvas 진입 속성정보:
{"external_user_id": "user_123", "canvas_entry_properties": {"product_name": "shoes"}}
API 트리거 전달에는 다음 엔드포인트를 사용할 수 있습니다:
전달 방법을 선택한 후 사용 사례에 맞게 설정을 조정한 다음, 타겟 오디언스 설정을 계속 진행하세요.
기존 편집기를 사용하는 Canvases의 중복 제거 동작
재자격 기간이 Canvas의 최대 기간보다 짧으면 사용자가 다시 진입하여 둘 이상의 구성요소 메시지를 수신할 수 있습니다. 사용자의 재진입이 이전 진입과 동일한 구성요소에 도달하는 극단적인 경우, Braze는 해당 구성요소의 메시지를 중복 제거합니다.
사용자가 Canvas에 재진입하여 이전 진입과 동일한 구성요소에 도달하고 각 진입에 대해 인앱 메시지를 받을 자격이 있는 경우, 세션을 두 번 다시 열면 (인앱 메시지 우선순위에 따라) 메시지를 두 번 받게 됩니다.
3단계: 타겟 오디언스 설정하기
타겟 오디언스 단계에서 정의한 기준과 일치하는 사용자만 여정에 진입할 수 있습니다. 즉, Braze는 사용자가 Canvas 여정에 진입하기 전에 먼저 타겟 오디언스의 자격 여부를 평가합니다. 예를 들어, 신규 사용자를 타겟팅하려면 앱을 처음 사용한 지 일주일이 되지 않은 사용자 Segment를 선택할 수 있습니다.

여러 앱이 있는 워크스페이스에서는 Canvas 진입 오디언스 자격이 사용자가 Canvas에 진입할 때만 평가되며, 개별 메시지 단계에서는 평가되지 않습니다. 메시지 단계를 특정 앱의 사용자로 제한하려면 메시지 전송 시 오디언스 유효성 검사를 켜고 메시지 단계의 전달 유효성 검사에서 앱 타겟 Segment를 추가하거나, 전송 시 Liquid를 사용하세요. 앱 보유 등의 필터는 어떤 앱이 메시지를 수신하는지를 제한하지 않습니다.
진입 제어에서는 Canvas가 스케줄에 따라 실행될 때마다 진입하는 사용자 수를 제한할 수 있습니다. API 트리거 기반 및 실행 기반 Canvases의 경우, 이 제한은 매 UTC 시간마다 적용됩니다.

오디언스 필터와 동일한 트리거(예: 속성 변경 또는 커스텀 이벤트 수행)로 액션 기반 Campaign 또는 Canvas를 구성하지 마세요. 사용자가 트리거 이벤트를 수행하는 시점에 오디언스에 포함되지 않아 경합 조건이 발생할 수 있으며, 이 경우 Campaign을 받지 못하거나 Canvas에 진입하지 못하게 됩니다.
오디언스 테스트하기
타겟 오디언스에 Segments와 필터를 추가한 후, 사용자 조회를 통해 오디언스 기준에 부합하는지 확인하여 오디언스가 예상대로 설정되었는지 테스트할 수 있습니다.
진입 제어 선택하기
진입 제어는 사용자가 Canvas에 다시 진입할 수 있는지를 결정합니다. 진입 스케줄 유형에 따라 선택한 주기별로 이 Canvas에 진입할 수 있는 인원 수를 제한할 수도 있습니다:
- 스케줄: Canvas의 전체 수명 기간 또는 Canvas가 스케줄에 따라 실행될 때마다
- 실행 기반: 시간별, 일별 또는 Canvas의 전체 수명 기간
- API 트리거: 시간별, 일별 또는 Canvas의 전체 수명 기간
예를 들어, 스케줄 Canvas에서 진입량 제한을 선택하고 최대 진입 수 필드를 500,000명으로 설정하며 제한 주기를 Canvas가 스케줄에 따라 실행될 때마다로 지정하면, Canvas는 스케줄된 전송당 500,000명의 사용자에게만 발송합니다.


IP 워밍에는 Canvas가 스케줄에 따라 실행될 때마다를 선택하지 않는 것을 권장합니다. 이 옵션은 전송량이 증가할 수 있기 때문입니다.
종료 기준 설정하기
종료 기준을 설정하면 Canvas에서 이탈할 사용자를 결정합니다. 사용자가 예외 이벤트를 수행하거나 Segments 및 필터와 일치하면 더 이상 메시지를 수신하지 않습니다.
대상 집단 계산하기
대상 집단 섹션에서는 선택한 Segments와 추가 필터 등 오디언스 요약과 메시징 채널별 도달 가능한 사용자 수 분석을 확인할 수 있습니다. 기본 추정값 대신 타겟 오디언스의 정확한 도달 가능 사용자 수를 계산하려면 정확한 통계 계산을 선택하세요.
참고 사항:
- 정확한 통계를 계산하는 데 몇 분이 걸릴 수 있습니다. 이 기능은 Segment 수준에서만 정확한 통계를 계산하며, 필터 또는 필터 그룹 수준에서는 계산하지 않습니다.
- 정확한 통계가 로딩되는 동안 반올림된 추정값이 표시될 수 있습니다. 로딩이 완료되면 도달 가능 사용자 섹션에 정확한 수치가 표시됩니다. 자세한 분석을 보려면 추가 통계 표시를 선택할 수 있습니다.
- 대규모 Segments의 경우 정확한 통계를 계산하더라도 약간의 변동이 발생하는 것은 정상입니다. 이 기능의 정확도는 99.999% 이상으로 예상됩니다.
타겟 사용자의 평균 생애 매출 등 추가 통계를 확인하려면 추가 통계 표시를 선택하세요.
타겟 오디언스 수와 도달 가능 사용자 수가 다를 수 있는 이유
Campaign이나 Canvas에 표시되는 대상 집단 규모는 추가 필터 없이 해당 Segment를 Campaign이나 Canvas에 직접 추가하는 경우에도 해당 Segment의 도달 가능한 오디언스 규모와 다를 수 있습니다. 이는 여러 가지 이유로 발생할 수 있습니다:
- 글로벌 컨트롤 그룹이 Campaign 또는 Canvas에 적용되면 해당 글로벌 컨트롤 그룹에 속한 사용자는 도달 가능 사용자 수에서 제외됩니다.
- Campaign 또는 Canvas의 대상 집단 규모는 다양한 메시지 채널을 통해 연락할 수 없는 사용자를 제외하며, 동작은 채널마다 다릅니다. 예를 들어, Campaign 또는 Canvas의 도달 가능한 오디언스에는 탈퇴했거나 스팸으로 표시된 사용자(이메일의 경우) 또는 하드바운스된 사용자(이메일의 경우)가 제외됩니다. 그러나 Segment 자체는 예상 이메일 도달 가능 사용자 수를 표시할 때만 옵트아웃을 제외합니다.
- Braze는 선택한 구독 그룹에 속한 사용자에게만 SMS 메시지를 보내므로 Campaign 또는 Canvas의 SMS 대상 집단에서도 선택한 구독 그룹에 속하지 않은 사용자는 제외됩니다.
4단계: 전송 설정 선택하기
전송 설정을 선택하여 구독 설정을 편집하고, 사용량 제한을 활성화하고, 방해금지 시간을 활성화합니다. 사용량 제한조치 또는 최대 게재빈도 설정을 활성화하면 사용자에게 가해지는 마케팅 부담을 줄이고 과도한 메시지 전송을 방지할 수 있습니다.
이메일 및 푸시 채널을 타겟팅하는 Canvases의 경우, 명시적으로 옵트인한 사용자만 메시지를 수신하도록 Canvas를 제한할 수 있습니다(구독 중이거나 구독 취소한 사용자는 제외). 예를 들어, 옵트인 상태가 서로 다른 세 명의 사용자가 있다고 가정해 보겠습니다:
- 사용자 A는 이메일에 구독되어 있고 푸시가 활성화되어 있습니다. 이 사용자는 이메일을 수신하지 않지만 푸시는 수신합니다.
- 사용자 B는 이메일에 옵트인되어 있지만 푸시가 활성화되어 있지 않습니다. 이 사용자는 이메일을 수신하지만 푸시는 수신하지 않습니다.
- 사용자 C는 이메일에 옵트인되어 있고 푸시가 활성화되어 있습니다. 이 사용자는 이메일과 푸시를 모두 수신합니다.
이렇게 하려면 구독 설정을 “옵트인한 사용자에게만” 이 Canvas를 전송하도록 설정합니다. 이 옵션을 사용하면 옵트인한 사용자만 이메일을 수신하고, Braze는 기본적으로 푸시가 활성화된 사용자에게만 푸시를 전송합니다.
이러한 구독 설정은 단계별로 적용되므로, 진입 오디언스에는 영향을 미치지 않습니다. 따라서 이 설정은 각 캔버스 단계를 수신할 사용자의 자격을 평가하는 데 사용됩니다.

이 구성에서는 타겟 오디언스 단계에서 오디언스를 단일 채널로 제한하는 필터(예: Foreground Push Enabled = True 또는 Email Subscription = Opted-In)를 포함하지 마세요.
Canvas에 대한 방해금지 시간(메시지가 전송되지 않는 시간)을 지정할 수 있습니다. 전송 설정에서 방해금지 시간 활성화를 켭니다. 그런 다음 사용자의 현지 시간대에 맞는 방해금지 시간을 선택하고, 메시지를 중단할지 또는 다음 가능한 시간에 전송할지 선택합니다.
다음 가능한 시간에 전송을 선택하면, 방해금지 시간이 메시지를 보류하고 방해금지 시간 이후 다음 가능한 시간에 전송합니다. 예를 들어, 방해금지 시간이 사용자의 현지 시간 기준 오전 11시 30분에서 오후 2시 30분 사이에 메시지를 전송하지 않도록 설정되어 있고, 사용자가 오전 11시 35분에 메시지 단계에 진입한다고 가정해 보겠습니다. 이 시간은 방해금지 시간 내이므로 메시지가 아직 전송되지 않으며, 방해금지 시간이 끝난 오후 2시 30분에 메시지 단계를 수신하게 됩니다.
5단계: 여정 구축하기

Braze Canvas 템플릿을 사용하여 시간을 절약하세요. 라이브러리에서 사용 사례에 맞는 템플릿을 찾아 커스터마이징할 수 있습니다. 자세한 내용은 Canvas 템플릿을 참조하세요.
5.1단계: 배리언트 추가하기
배리언트 추가를 선택한 다음 Canvas에 새 배리언트를 추가합니다. 배리언트는 사용자가 이동하게 될 여정을 나타내며 여러 단계와 브랜치를 포함할 수 있습니다.
플러스 버튼을 선택하여 추가 배리언트를 추가할 수 있습니다. 새 배리언트를 추가하면 사용자가 각 배리언트에 어떻게 분배될지 조정할 수 있으므로, 다양한 인게이지먼트 전략의 효과를 비교 분석할 수 있습니다.

기본적으로 Canvas 배리언트 할당은 사용자 ID와 Canvas ID의 결정론적 해시를 사용합니다(사용자의 무작위 버킷 번호가 아님). 분배 비율이 변경되지 않는 한 재진입 시 사용자는 동일한 배리언트에 유지됩니다. 출시 후 비율이 변경되면 재진입하는 사용자가 다른 배리언트에 할당될 수 있습니다.
비율이 변경되더라도 할당이 고정되도록 하려면 하나의 배리언트를 사용하고 사용자 업데이트 단계로 랜덤 숫자를 저장한 다음, 오디언스 경로로 라우팅합니다. 전체 패턴을 보려면 다음 단계를 펼쳐 보세요.
단계별 자세히 보기
- 랜덤 숫자를 저장할 Number 커스텀 속성을 생성합니다.
lottery_number또는random_assignment와 같이 찾기 쉬운 이름을 지정합니다. 대시보드에서 데이터 설정 > 커스텀 속성으로 이동합니다. - 단일 Canvas 배리언트를 사용합니다(또는 각 배리언트에 동일한 사용자 업데이트 단계를 추가합니다). 여정 시작 부분에 사용자 업데이트 단계를 추가합니다. 이 단계는 사용자가 오디언스 경로 단계에 도달하기 전에 랜덤 숫자를 생성하고 저장합니다.
- 사용자 업데이트 단계에서 고급 JSON 편집기를 선택합니다. {% random %} 태그를 사용하여 숫자를 생성합니다. 자세한 내용은 랜덤 숫자가 포함된 메시지 보내기를 참조하세요. 예를 들어
{% random 10 %}은 0부터 9까지의 정수를 반환합니다. 1단계에서 만든 커스텀 속성을 다음과 같은 JSON으로 설정합니다:
{% if {{custom_attribute.${lottery_number}}} == blank %} {% capture lottery_number_str %}{% random 10 %}{% endcapture %} { "attributes": [ { "lottery_number": {{ lottery_number_str | plus: 0 }} } ] } {% endif %}
{% if %} 블록은 속성이 비어 있을 때만 숫자를 설정하므로, 사용자가 Canvas에 재진입할 때 동일한 할당을 유지합니다.
- 사용자 업데이트 단계 뒤에 오디언스 경로 단계를 추가합니다. 각 오디언스 그룹에서 배리언트 분배 비율 대신 커스텀 속성을 기반으로 필터를 추가합니다.
예를 들어{% random 10 %}을 사용한 경우, 한 그룹은lottery_number4 미만, 다른 그룹은 3 초과 7 미만, 세 번째 그룹은 6 초과 10 미만으로 설정할 수 있습니다.
5.2단계: 단계 추가하기
컴포넌트 사이드바에서 컴포넌트를 드래그 앤 드롭하여 Canvas 워크플로에 더 많은 단계를 추가할 수 있습니다. 또는 플러스 버튼을 선택하여 팝오버 메뉴로 컴포넌트를 추가합니다. 전체 컴포넌트 목록은 Canvas 컴포넌트를 참조하세요.

Canvas에 최대 200개의 단계를 추가할 수 있습니다. Canvas가 200개 단계를 초과하면 로딩 문제가 발생할 수 있습니다.
단계를 추가하면서 확대/축소 수준을 변경하여 세부 사항에 집중하거나 전체 사용자 여정을 한눈에 볼 수 있습니다. Shift + +로 확대하거나 Shift + -로 축소합니다.
최대 기간
최대 기간은 사용자가 Canvas를 완료하는 데 걸릴 수 있는 가장 긴 시간입니다. Braze는 가장 긴 경로를 따라 지연과 트리거 창을 합산하여 계산합니다. 예를 들어, 3일 지연이 있는 지연 단계와 메시지 단계가 있는 경우 최대 기간은 3일입니다.
단계 편집하기
아무 컴포넌트나 선택하여 편집할 수 있습니다. 예를 들어, 지연 단계를 선택하여 지연을 3월 1일과 같은 특정 날짜로 변경할 수 있습니다. 해당 날짜에 사용자가 다음 단계로 이동합니다.
작업 경로 단계의 행동 설정을 편집하여 일정 기간 동안 사용자를 보류하고, 해당 기간 동안의 행동을 기반으로 다음 경로의 우선순위를 설정할 수도 있습니다.
Canvas의 메시지
메시지 단계를 사용하여 이메일, 모바일 푸시, 웹 푸시 또는 웹훅 메시지를 전송합니다. 메시징 채널을 선택하고 전달 설정을 조정한 다음, Liquid를 사용하여 메시지를 개인화합니다.
Liquid에서 진입 데이터와 이벤트 속성정보를 사용하려면 컨텍스트 및 이벤트 속성정보를 참조하세요. 단계 구성을 마친 후 완료를 선택합니다.
5.3단계: 연결 편집하기
단계 간의 연결을 이동하려면 두 컴포넌트를 연결하는 화살표를 선택한 다음 다른 컴포넌트를 선택합니다. 연결을 제거하려면 화살표를 선택한 후 Canvas 작성기 하단의 연결 취소를 선택합니다.
단일 배리언트에 동일한 오디언스와 전송 시간을 가진 여러 브랜치가 있는 경우, Braze는 해당 브랜치 간에 균등한 분배를 보장하지 않습니다. 분배는 먼저 생성된 브랜치에 치우칠 수 있습니다. 균등한 분배를 위해서는 각 브랜치에 무작위 버킷 번호 필터를 사용하세요. 자세한 내용은 하나의 배리언트에 여러 브랜치가 있는 Canvas에서 오디언스와 전송 시간이 동일하면 어떻게 되나요?를 참조하세요.
6단계: 대조군 추가하기
플러스 버튼을 선택하여 새 배리언트를 추가하면 Canvas에 대조군을 추가할 수 있습니다.
Braze는 대조군에 배치된 사용자의 전환을 추적하지만, 해당 사용자에게는 메시지가 전송되지 않습니다. 정확한 테스트를 유지하기 위해 Braze는 전환 이벤트 선택 화면에 표시된 것과 동일한 기간 동안 배리언트와 대조군의 전환 수를 추적합니다.
배리언트 이름 헤더를 선택하여 메시지 간 배분을 조정할 수 있습니다.
BrazeAI로 Canvas 배리언트 최적화하기
여러 최상위 배리언트가 있는 Canvas의 경우, BrazeAI로 최적화(일부 워크스페이스에서는 지능형 선택으로 표시됨)를 켜면 각 배리언트에 진입하는 사용자 비율이 자동으로 조정됩니다. BrazeAI는 배리언트 성능을 활용하여 예상 전환 수를 극대화합니다.
최소 두 개의 배리언트와 하나의 전환 이벤트를 추가합니다. 그런 다음, 배리언트 비율을 선택하여 배리언트 배분 편집을 열고 BrazeAI로 최적화를 켭니다.
초기 전환 마감 이후 BrazeAI는 12시간마다 성능을 검토하고 가장 많은 전환을 유도하는 배리언트로 더 많은 사용자를 이동시킵니다. 최적화가 확실한 우승 배리언트를 식별하면, 이후 모든 적격 사용자가 해당 배리언트로 진입합니다.
이 최적화는 새로운 사용자가 자주 진입하는 Canvases에서 가장 효과적입니다.
7단계: 저장 및 시작
Canvas 요약을 검토한 다음 Launch Canvas를 선택하여 저장하고 시작합니다. Canvas 승인 워크플로가 켜져 있는 경우, 시작하기 전에 나열된 Canvas 세부 정보를 승인합니다. 시작 후 Canvas Details 페이지에서 분석을 확인할 수 있습니다.
