Skip to content

Canvas 만들기

이 참조 문서에서는 Canvas를 만들고, 관리하고, 테스트하는 데 필요한 단계를 다룹니다. 이 가이드를 따르거나 Canvas Braze 학습 과정을 확인하세요. Braze Canvas 템플릿에서 시작하여 설정 시간을 단축할 수도 있습니다. 자세한 내용은 Canvas 템플릿을 참조하세요.

기존 Canvas 편집기 세부 정보 펼치기

더 이상 기존 Canvas 환경을 사용하여 Canvas를 만들거나 복제할 수 없습니다. Braze는 최신 편집기로 Canvas를 복제할 것을 권장합니다.

1단계: 새 Canvas 설정

먼저 Messaging > Canvas로 이동한 다음 Create Canvas를 선택합니다.

Canvas 빌더가 Canvas 설정을 단계별로 안내합니다. 이름 지정부터 전환 이벤트 설정, 적절한 사용자를 고객 여정에 유입시키는 것까지 모든 과정을 포함합니다. 아래 각 탭을 선택하여 각 빌더 단계에서 조정할 수 있는 설정을 확인하세요.

여기에서 Canvas의 기본 사항을 설정합니다:

  • Canvas 이름 지정
  • 팀 추가
  • 태그 추가
  • 전환 이벤트 할당 및 이벤트 유형과 기한 선택

기본 사항 단계에서 자세히 알아보세요.

여기에서 사용자가 Canvas에 진입하는 방법과 시기를 결정합니다:

  • 스케줄: 시간 기반 Canvas 진입입니다
  • 실행 기반: 사용자가 정의된 행동을 수행한 후 Canvas에 진입합니다
  • API 트리거: API 요청을 사용하여 사용자를 Canvas에 진입시킵니다

진입 스케줄 단계에서 자세히 알아보세요.

여기에서 타겟 오디언스를 선택합니다:

  • Segments와 필터를 추가하여 오디언스 생성
  • Canvas 재진입 및 진입 제한 세부 조정
  • 타겟 오디언스 요약 확인

타겟 오디언스 단계에서 자세히 알아보세요.

여기에서 Canvas 발송 설정을 선택합니다:

  • 구독 설정 선택
  • Canvas 메시지에 대한 사용량 제한 설정
  • 방해금지 시간 활성화 및 설정

발송 설정 단계에서 자세히 알아보세요.

여기에서 Canvas를 구축합니다.

Canvas 빌더를 사용하여 Canvas를 구축하는 방법을 알아보세요.

여기에서 Canvas 세부 정보의 요약을 확인할 수 있습니다. Canvas 승인 워크플로우가 활성화되어 있으면 시작 전에 나열된 Canvas 세부 정보를 승인할 수 있습니다.

1.1단계: Canvas 기본 사항부터 시작하기

여기에서 Canvas 이름을 지정하고, 을 할당하고, 태그를 만들거나 추가합니다. Canvas에 전환 이벤트를 할당할 수도 있습니다.

**Canvas** 이름, 설명, 위치, 태그 필드가 있는 **Canvas** 세부 정보 페이지.

전환 이벤트 선택

전환 이벤트 유형을 선택한 다음 기록할 전환을 선택합니다. 이러한 전환 이벤트Canvas의 효율성을 측정합니다.

3일 전환 기한 내에 구매를 완료한 사용자의 전환을 기록하기 위한 구매 완료 전환 이벤트 유형이 있는 주요 전환 이벤트 A.

Canvas에 여러 배리언트 또는 대조군이 있는 경우, Braze는 이 전환 이벤트를 사용하여 이 전환 목표를 달성하기 위한 최적의 변형을 결정합니다. 동일한 로직을 사용하여 여러 전환 이벤트를 만들 수 있습니다.

1.2단계: Canvas 진입 스케줄 결정

사용자가 Canvas에 진입할 수 있는 세 가지 방법 중 하나를 선택할 수 있습니다.

진입 스케줄 유형

스케줄 전달을 사용하면 Campaign을 스케줄하는 것과 유사하게 사용자가 시간 스케줄에 따라 진입합니다. Canvas가 시작되자마자 사용자를 등록하거나, 미래의 특정 시점에 여정에 진입시키거나, 반복적으로(매일, 매주 또는 매월) 진입시킬 수 있습니다.

월별 반복 스케줄을 선택하는 경우, 일부 달에는 선택한 날짜가 없을 수 있습니다. 예를 들어 Canvas를 매월 31일에 발송하도록 설정했다고 가정해 보겠습니다. 이 시나리오에서 Braze는 4월 31일이 존재하지 않으므로 4월 30일과 같이 해당 월의 마지막 날에 발송합니다.

이 예시에서는 시간 기반 옵션에 따라 사용자가 2025년 11월 14일부터 2025년 12월 31일까지 매주 화요일 현지 시간대 오후 12시에 이 Canvas에 진입합니다.

유형이 "스케줄"로 설정된 "진입 스케줄" 페이지. 선택에 따라 빈도, 시작 시간, 반복, 요일 등을 포함한 시간 기반 옵션이 표시됩니다.

현지 시간대 전달을 사용할 때 Braze는 진입 자격을 두 번 평가합니다. 먼저 스케줄된 날의 사모아 시간(UTC+13)에 평가하고, 다시 사용자의 현지 시간에 평가합니다. 사용자가 Canvas에 진입하려면 두 번의 확인을 모두 통과해야 합니다. 진입 필터가 상대적 시간 범위를 사용하는 경우(예: “2일 이상 전”), 첫 번째 확인 시점에 24시간이 경과하지 않아 사용자가 하루 늦게 진입할 수 있습니다. 이를 방지하려면 최소 2일 이상의 더 넓은 시간 범위를 사용하세요. 자세한 내용은 Braze는 현지 시간대 전달을 위해 언제 사용자를 평가하나요?를 참조하세요.

1
2
3
4
5
실행 기반 전달을 사용하면 사용자가 앱 열기, 구매, 커스텀 이벤트 트리거 등 특정 행동을 수행할 때 **Canvas**에 진입하고 메시지를 받기 시작합니다.

**진입 오디언스** 창에서 재자격 규칙 및 최대 게재빈도 설정을 포함하여 **Canvas** 동작의 다른 측면을 제어할 수 있습니다. 실행 기반 전달은 In-App Messages가 포함된 **Canvas** 구성요소에는 사용할 수 없습니다.

![실행 기반 전달의 예시. 사용자가 구매를 완료하면 **Canvas**에 진입하며, 진입 기간은 2025년 6월 10일 오후 1:30에 시작됩니다.](/docs/ko/assets/img_archive/Canvas_Action_Based_Delivery.png?cd3f800b27ec326fc0e11bee12630e2e)

API 트리거 전달을 사용하면 API를 통해 /canvas/trigger/send 엔드포인트를 사용하여 사용자가 추가된 후 Canvas에 진입하고 메시지를 받기 시작합니다. 대시보드에서 이를 수행하는 예시 cURL 요청을 찾을 수 있으며, 컨텍스트 오브젝트를 사용하여 선택적 context를 할당할 수도 있습니다.

**Canvas** ID와 cURL 요청 예시가 있는 API 트리거 전달의 예시.

API 트리거 전달에 다음 엔드포인트를 사용할 수 있습니다:

전달 방법을 선택한 후 사용 사례에 맞게 설정을 조정한 다음 타겟 오디언스 설정을 계속 진행합니다.

기존 편집기를 사용하는 Canvases의 중복 제거 동작

재자격 기간이 Canvas의 최대 기간보다 짧은 경우, 사용자가 재진입하여 둘 이상의 구성요소 메시지를 받을 수 있습니다. 사용자의 재진입이 이전 진입과 동일한 구성요소에 도달하는 엣지 케이스에서 Braze는 해당 구성요소의 메시지를 중복 제거합니다.

사용자가 Canvas에 재진입하여 이전 진입과 동일한 구성요소에 도달하고 각 진입에 대해 In-App Messages 자격이 있는 경우, 세션을 두 번 다시 열면 사용자는 메시지를 두 번 받게 됩니다(In-App Messages 우선순위에 따라).

1.3단계: 타겟 진입 오디언스 설정

타겟 오디언스 단계에서 정의한 기준에 맞는 사용자만 여정에 진입할 수 있습니다. 즉, Braze는 사용자가 Canvas 여정에 진입하기 전에 먼저 타겟 오디언스의 자격을 평가합니다. 예를 들어 신규 사용자를 타겟팅하려면 1주일 이내에 앱을 처음 사용한 사용자 Segment를 선택할 수 있습니다.

진입 제어에서 Canvas가 실행되도록 스케줄될 때마다 사용자 수를 제한할 수 있습니다. API 트리거 기반 및 실행 기반 Canvases의 경우 이 제한은 매 UTC 시간마다 적용됩니다.

오디언스 테스트

타겟 오디언스에 Segments와 필터를 추가한 후 사용자 조회를 통해 오디언스 기준에 맞는지 확인하여 오디언스가 예상대로 설정되었는지 테스트할 수 있습니다.

외부 사용자 ID 또는 Braze ID로 검색할 수 있는 "사용자 조회" 필드.

진입 제어 선택

진입 제어는 사용자가 Canvas에 재진입할 수 있는지 여부를 결정합니다. 진입 스케줄 유형에 따라 선택한 주기로 이 Canvas에 잠재적으로 진입할 수 있는 사용자 수를 제한할 수도 있습니다:

  • 스케줄: Canvas의 수명 동안 또는 Canvas가 스케줄될 때마다
  • 실행 기반: 시간별, 일별 또는 Canvas의 수명 동안
  • API 트리거: 시간별, 일별 또는 Canvas의 수명 동안

예를 들어 실행 기반 Canvas가 있고 진입량 제한을 선택하고 최대 진입 필드를 5,000명으로 설정하고 제한 주기를 일별로 설정하면 Canvas는 하루에 5,000명의 사용자에게만 발송합니다.

"**Canvas**에 사용자 재진입 허용" 및 "진입량 제한" 체크박스가 표시된 "진입 제어" 페이지. 후자를 사용하면 최대 진입 수를 설정하고 진입 스케줄 유형에 따라 달라지는 주기를 선택할 수 있습니다(예: 스케줄 진입의 경우 **Canvas**의 수명 동안 또는 **Canvas**가 스케줄될 때마다, 실행 기반 및 API 트리거 진입의 경우 시간별, 일별 또는 **Canvas**의 수명 동안).

종료 기준 설정

종료 기준을 설정하면 Canvas에서 종료시킬 사용자를 결정합니다. 사용자가 예외 이벤트를 수행하거나 Segments 및 필터에 일치하면 더 이상 메시지를 받지 않습니다.

대상 집단 계산

대상 집단 섹션에서 선택한 Segments 및 추가 필터와 같은 오디언스 요약과 메시징 채널별 도달 가능 사용자 수 분석을 확인할 수 있습니다. 기본 추정치 대신 타겟 오디언스의 정확한 도달 가능 사용자 수를 계산하려면 정확한 통계 계산을 선택하세요.

참고 사항:

  • 정확한 통계를 계산하는 데 몇 분이 걸릴 수 있습니다. 이 기능은 필터 또는 필터 그룹 수준이 아닌 Segment 수준에서만 정확한 통계를 계산합니다.
  • 정확한 통계가 로딩되는 동안 반올림된 추정치가 표시될 수 있습니다. 정확한 수치는 로딩이 완료되면 도달 가능 사용자 섹션에 표시됩니다. 자세한 분석을 보려면 추가 통계 표시를 선택할 수 있습니다.
  • 대규모 Segments의 경우 정확한 통계를 계산할 때에도 약간의 변동이 있는 것은 정상입니다. 이 기능의 정확도는 99.999% 이상으로 예상됩니다.

타겟 사용자의 평균 생애 매출 등 추가 통계를 보려면 추가 통계 표시를 선택하세요.

정확한 통계 계산 옵션이 있는 대상 집단 분석.

타겟 오디언스 수가 도달 가능 사용자 수와 다를 수 있는 이유

캠페인이나 Canvas에 표시되는 대상 집단 규모는 추가 필터 없이 해당 세그먼트를 캠페인이나 Canvas에 직접 추가하는 경우에도 해당 세그먼트의 도달 가능한 오디언스 규모와 다를 수 있습니다. 이는 여러 가지 이유로 발생할 수 있습니다:

  • 글로벌 컨트롤 그룹이 Campaign 또는 Canvas에 적용되면 해당 글로벌 컨트롤 그룹에 속한 사용자는 도달 가능 사용자 수에서 제외됩니다.
  • Campaign 또는 Canvas의 대상 집단 규모는 다양한 메시지 채널을 통해 연락할 수 없는 사용자를 제외하며, 동작은 채널마다 다릅니다. 예를 들어, Campaign 또는 Canvas의 도달 가능한 오디언스에는 탈퇴했거나 스팸으로 표시된 사용자(이메일의 경우) 또는 하드바운스된 사용자(이메일의 경우)가 제외됩니다. 그러나 세그먼트 자체는 예상 이메일 도달 가능 사용자 수를 표시할 때만 옵트아웃을 제외합니다.
  • Braze는 선택한 구독 그룹에 속한 사용자에게만 SMS 메시지를 보내므로 Campaign 또는 Canvas의 SMS 대상 집단에서도 선택한 구독 그룹에 속하지 않은 사용자는 제외됩니다.

1.4단계: 발송 설정 선택

발송 설정을 선택하여 구독 설정을 편집하고, 사용량 제한을 활성화하고, 방해금지 시간을 활성화합니다. 사용량 제한 또는 최대 게재빈도 설정을 활성화하면 사용자에게 가해지는 마케팅 압력을 완화하고 과도한 메시지 발송을 방지할 수 있습니다.

이메일 및 푸시 채널을 타겟팅하는 Canvases의 경우, 명시적으로 옵트인한 사용자만 메시지를 받도록 Canvas를 제한할 수 있습니다(가입됨 또는 가입 취소된 사용자 제외). 예를 들어 옵트인 상태가 다른 세 명의 사용자가 있다고 가정해 보겠습니다:

  • 사용자 A는 이메일에 가입되어 있고 푸시가 활성화되어 있습니다. 이 사용자는 이메일을 받지 않지만 푸시를 받습니다.
  • 사용자 B는 이메일에 옵트인했지만 푸시가 활성화되어 있지 않습니다. 이 사용자는 이메일을 받지만 푸시를 받지 않습니다.
  • 사용자 C는 이메일에 옵트인했고 푸시가 활성화되어 있습니다. 이 사용자는 이메일과 푸시를 모두 받습니다.

이렇게 하려면 구독 설정을 “옵트인한 사용자에게만” 이 Canvas를 보내도록 설정합니다. 이 옵션은 옵트인한 사용자만 이메일을 받도록 하며, Braze는 기본적으로 푸시가 활성화된 사용자에게만 푸시를 보냅니다.

이러한 구독 설정은 단계별로 적용되므로 진입 오디언스에는 영향을 미치지 않습니다. 따라서 이 설정은 각 Canvas 단계를 받을 사용자의 자격을 평가하는 데 사용됩니다.

원하는 경우 Canvas에 대한 방해금지 시간(메시지가 발송되지 않는 시간)을 지정합니다. 발송 설정에서 방해금지 시간 활성화를 체크합니다. 그런 다음 사용자의 현지 시간으로 방해금지 시간을 선택하고 해당 방해금지 시간 내에 메시지가 트리거되면 어떤 동작을 수행할지 선택합니다.

방해금지 시간 활성화 체크박스가 표시된 "방해금지 시간" 페이지. 활성화하면 시작 시간, 종료 시간 및 대체 동작을 설정할 수 있습니다.

2단계: Canvas 구축

2.1단계: 배리언트 추가

"배리언트 추가" 옵션이 있는 컨텍스트 메뉴를 표시하기 위해 선택된 "배리언트 추가" 버튼.

배리언트 추가를 선택한 다음 Canvas에 새 배리언트를 추가합니다. 배리언트는 사용자가 이동할 여정을 나타내며 여러 단계와 분기를 포함할 수 있습니다.

플러스 버튼을 선택하여 추가 배리언트를 추가할 수 있습니다. 새 배리언트를 추가하면 사용자가 배리언트 간에 어떻게 분배될지 조정할 수 있으므로 다양한 참여 전략의 효과를 비교 분석할 수 있습니다.

Braze **Canvas**의 두 가지 배리언트 예시.

2.2단계: Canvas 단계 추가

구성요소 사이드바에서 구성요소를 드래그 앤 드롭하여 Canvas 워크플로우에 더 많은 단계를 추가할 수 있습니다. 또는 플러스 버튼을 선택하여 팝오버 메뉴로 구성요소를 추가합니다.

Braze **Canvas**에 지연 단계를 추가하는 구성요소 검색 창.

최대 기간

Canvas 여정의 단계가 증가함에 따라 최대 기간은 사용자가 이 Canvas를 완료하는 데 걸릴 수 있는 가장 긴 시간입니다. 이는 가장 긴 경로에 대해 각 배리언트의 각 단계의 지연 및 트리거 기간을 합산하여 계산됩니다. 예를 들어 Canvas에 3일 지연이 있는 지연 단계와 메시지 단계가 있는 경우 Canvas의 최대 기간은 3일입니다.

단계 편집

사용자 여정의 단계를 편집하고 싶으신가요? Canvas 워크플로우에 따라 이를 수행하는 방법을 확인하세요!

Canvas 워크플로우에서 구성요소를 선택하여 모든 단계를 편집할 수 있습니다. 예를 들어 워크플로우의 첫 번째 단계인 지연 구성요소를 특정 날짜로 편집하고 싶다고 가정해 보겠습니다. 단계를 선택하여 설정을 확인하고 지연을 3월 1일로 조정합니다. 이는 3월 1일에 사용자가 Canvas의 다음 단계로 이동한다는 것을 의미합니다.

지연이 "특정 날짜까지"로 설정된 "지연" 단계 예시.

또는 행동 경로 단계의 행동 설정을 빠르게 편집하고 조정하여 일정 기간 동안 사용자를 유지할 수 있습니다. 이는 이 평가 기간 동안의 행동에 따라 다음 경로의 우선순위를 지정합니다.

평가 기간이 1일로 설정된 **Canvas**의 두 번째 단계 "행동 설정".

Canvas의 경량 구성요소는 간단한 편집 경험을 제공하므로 Canvas의 세부 사항을 더 쉽게 조정할 수 있습니다.

Canvas의 메시지

Canvas 구성요소의 메시지를 편집하여 특정 단계에서 보낼 메시지를 제어합니다. Canvas는 이메일, 모바일 및 웹 푸시 메시지, 그리고 다른 시스템과 통합하기 위한 웹훅을 보낼 수 있습니다. Campaigns와 마찬가지로 특정 Liquid 템플릿을 사용하여 메시지를 개인화할 수 있습니다.

메시지 구성요소는 사용자에게 보내는 메시지를 관리합니다. 메시징 채널을 선택하고 전달 설정을 조정하여 Canvas 메시징을 최적화할 수 있습니다. 이 구성요소에 대한 자세한 내용은 메시지를 확인하세요.

Android 푸시, Content Cards, 이메일 등 사용 가능한 메시징 채널 목록을 표시하는 "메시징 채널"이 선택된 "메시지 설정" 단계.

Canvas 구성요소 구성을 완료한 후 Done을 선택합니다.

context 오브젝트Canvas 생성의 진입 스케줄 단계에서 구성되며 사용자를 Canvas에 진입시키는 트리거를 나타냅니다. 이러한 등록정보는 API 트리거 Canvases의 진입 페이로드 등록정보에도 접근할 수 있습니다. context 오브젝트는 최대 50KB까지 가능합니다.

Canvas 진입 시 생성된 이러한 등록정보를 참조할 때 다음 Liquid를 사용하세요: context.${property_name} . 이벤트는 이 방식으로 사용하려면 커스텀 이벤트 또는 구매 이벤트여야 합니다.

예를 들어 다음 요청을 고려해 보세요: "context" : {"product_name" : "shoes", "product_price" : 79.99}. 이 Liquid {{context.${product_name}}}를 사용하여 메시지에 “shoes”라는 단어를 추가할 수 있습니다.

이벤트 등록정보는 커스텀 이벤트 및 구매에 대해 설정한 등록정보입니다. 이러한 event_properties는 실행 기반 전달이 있는 CampaignsCanvases에서 사용할 수 있습니다.

Canvas에서 커스텀 이벤트 및 구매 이벤트 등록정보는 행동 경로 단계 다음에 오는 모든 메시지 단계의 Liquid에서 사용할 수 있습니다. 이러한 event_properties를 참조할 때 이 Liquid {{event_properties.${property_name}}} 를 사용하세요. 이러한 이벤트는 메시지 구성요소에서 이 방식으로 사용하려면 커스텀 이벤트 또는 구매 이벤트여야 합니다.

행동 경로 다음의 첫 번째 메시지 단계에서 해당 행동 경로에서 참조된 이벤트와 관련된 event_properties를 사용할 수 있습니다. 이 행동 경로 단계와 메시지 단계 사이에 다른 단계(다른 행동 경로 또는 메시지 단계가 아닌)가 있을 수 있습니다. 메시지 단계가 행동 경로 단계의 다른 모든 사용자가 아닌 경로로 추적될 수 있는 경우에만 event_properties에 접근할 수 있습니다.

2.3단계: 연결 편집

단계 간 연결을 이동하려면 두 구성요소를 연결하는 화살표를 선택한 다음 다른 구성요소를 선택합니다. 연결을 제거하려면 화살표를 선택한 다음 Canvas 작성기 하단의 Cancel Connection을 선택합니다.

3단계: 대조군 추가

플러스 버튼을 선택하여 새 배리언트를 추가함으로써 Canvas에 대조군을 추가할 수 있습니다.

Braze는 대조군에 배치된 사용자의 전환을 추적하지만 메시지는 받지 않습니다. 정확한 테스트를 유지하기 위해 전환 이벤트 선택 화면에 표시된 것과 동일한 기간 동안 배리언트와 대조군의 전환 수를 추적합니다.

Variant Name 헤더를 더블 클릭하여 메시지 간 분배를 조정할 수 있습니다.

이 예시에서는 Canvas가 두 개의 배리언트로 나뉘어 있습니다. 배리언트 1에는 사용자의 70%가 포함됩니다. 두 번째 배리언트는 나머지 30%의 사용자가 포함된 대조군입니다.

Braze **Canvas**의 배리언트 예시. 70%는 첫 번째 단계에서 1일 지연 후 두 번째 단계에서 메시지를 보내는 "배리언트 1"로 이동합니다. 나머지 30%는 후속 단계가 없는 "대조군"으로 이동합니다.

Canvas를 위한 지능형 선택

지능형 선택 기능은 이제 다변량 Canvases 내에서 사용할 수 있습니다. 다변량 Campaigns지능형 선택 기능과 유사하게, Canvas의 지능형 선택은 각 Canvas 배리언트의 성과를 분석하고 각 배리언트를 통해 유입되는 사용자의 비율을 조정합니다. 이 분배는 각 배리언트의 성과 측정기준을 기반으로 총 예상 전환 수를 최대화합니다.

다변량 Canvases를 사용하면 문구뿐만 아니라 타이밍과 채널도 테스트할 수 있다는 점을 기억하세요. 지능형 선택을 통해 Canvases를 더 효율적으로 테스트하고 사용자가 최적의 Canvas 여정으로 보내질 것이라는 확신을 가질 수 있습니다.

"배리언트 분배 편집" 페이지에서 "지능형 선택" 옵션이 활성화되어 있습니다. **Canvas**를 분석하고 최적화하면서 페이지 전체에 걸쳐 여러 섹션으로 나뉜 수평 막대가 표시되며, 각 섹션은 색상과 크기가 다릅니다. 이는 시각적 표현일 뿐이며 특정 분석과 상관관계가 없습니다.

Canvas의 지능형 선택은 각 배리언트에 분류된 사용자의 분배를 점진적으로 실시간 조정하여 Canvas 결과를 최적화합니다. 통계 알고리즘이 배리언트 중 결정적인 승자를 결정하면 성과가 낮은 배리언트를 제외하고 Canvas의 향후 모든 적격 수신자를 승리 배리언트에 배치합니다.

이러한 이유로 지능형 선택은 새로운 사용자가 자주 진입하는 Canvases에서 가장 잘 작동합니다.

4단계: 저장 및 시작

Canvas 만들기를 완료한 후 Launch Canvas를 선택하여 Canvas를 저장하고 시작합니다. Canvas를 시작한 후에는 Canvas Details 페이지에서 여정에 대한 분석이 들어오는 대로 확인할 수 있습니다.

나중에 다시 돌아와야 하는 경우 Canvas를 초안으로 저장할 수도 있습니다.

Braze의 **Canvas** 예시.

New Stuff!