자주 묻는 질문

이 문서에서는 Canvas에 대해 자주 묻는 질문에 대한 답변을 제공합니다.

Canvas 빌드 및 편집

Canvas에 포함할 수 있는 단계는 몇 개인가요?

Canvas에는 최대 200개의 단계를 추가할 수 있습니다.

Canvas 단계 이름의 최대 글자 수는 얼마인가요?

Canvas 단계 이름은 최대 256자까지 입력할 수 있습니다.

Canvas 항목 속성에 크기 제한이 있나요?

네. Canvas 컨텍스트 오브젝트(Canvas 항목 속성)의 최대 크기는 50 KB입니다. 이 제한 내에서 페이로드를 가능한 한 작게 유지하세요. Canvas에서 항목 속성과 이벤트 속성이 작동하는 방식은 컨텍스트 및 이벤트 속성을 참조하세요.

“Too many Canvas branches” 오류가 표시되는 이유는 무엇인가요?

이 오류는 단계 분기와 항목 오디언스 규모의 조합으로 인해 클러스터 성능 문제가 발생하여 메시지가 전송되지 않을 수 있을 때 표시됩니다. 오디언스 경로 사용, 분기 또는 오디언스 규모 축소, Canvas Flow에서 다시 빌드하기 등 해결 방법은 “Too many Canvas branches” 오류를 참조하세요.

Canvas에서 재자격과 함께 Optimize with BrazeAI^TM를 사용할 수 있나요?

네. 재자격이 활성화된 경우에도 Canvases에서 Optimize with BrazeAI^TM를 사용할 수 있습니다. 시간이 지남에 따라 할당이 변경되므로 Braze는 재진입 시 동일한 배리언트를 보장할 수 없습니다. Campaigns에서 Optimize with BrazeAI^TM를 켜면 24시간 이상의 재자격 기간이 필요합니다.

구성 요소와 단계의 차이점은 무엇인가요?

구성 요소는 Canvas의 효과를 판단하는 데 사용할 수 있는 Canvas의 개별 부분입니다. 구성 요소에는 사용자 여정 분할, 지연 추가, 여러 Canvas 경로 테스트 등의 동작이 포함될 수 있습니다. Canvas의 단계는 Canvas 브랜치 내의 개인화된 사용자 여정을 의미합니다. 즉, Canvas는 사용자 여정의 단계를 만드는 개별 구성 요소로 이루어져 있습니다.

연결되지 않은 단계가 있는 상태로 Canvas를 실행할 수 있나요?

네. 실행 후에도 연결되지 않은 단계가 있는 상태로 Canvases를 저장할 수 있습니다.

사용자가 연결되지 않은 단계에 도달하면 어디로 이동하나요?

사용자가 Canvas 워크플로의 연결되지 않은 단계에 있는 경우, 다음 단계가 있으면 해당 단계로 진행하며, 사용자가 진행하는 방식은 해당 단계의 설정에 따라 결정됩니다. 이는 단계를 Canvas의 나머지 부분에 직접 연결하지 않고도 단계를 변경할 수 있도록 하기 위한 것입니다. 또한 바로 실시간으로 전환하기 전에 테스트할 여유를 주므로, 사실상 초안을 저장하는 것과 같은 효과가 있습니다.

단계의 연결을 해제하기 전에 분석 보기에서 해당 Canvas 단계에 대기 중인 사용자가 있는지 확인하는 것이 좋습니다.

배리언트는 하나지만 브랜치가 여러 개인 Canvas에서 오디언스와 전송 시간이 동일하면 어떻게 되나요?

각 단계마다 작업이 대기줄에 추가되며, 거의 동시에 실행되어 그중 하나가 “선택”됩니다. 실제로는 어느 정도 고르게 분배될 수 있지만, 먼저 생성된 단계에 약간의 편향이 생길 가능성이 높습니다.

또한 분배가 정확히 어떻게 이루어질지는 보장할 수 없습니다. 균등하게 분할하려면 무작위 버킷 번호 필터를 추가하세요.

Canvas 오디언스는 어떻게 평가되나요?

기본적으로 Canvas의 전체 단계에 대한 필터와 Segments는 전송 시점에 확인됩니다. 결정 분할 단계는 이전 단계를 받은 직후(또는 지연 전에) 평가를 수행합니다.

예외 이벤트는 언제 트리거되나요?

예외 이벤트는 사용자가 연결된 Canvas 구성 요소를 받기 위해 대기하는 동안에만 트리거됩니다. 사용자가 미리 동작을 수행한 경우에는 예외 이벤트가 트리거되지 않습니다. 특정 이벤트를 미리 수행한 사용자를 제외하려면 대신 필터를 사용하세요.

Canvas를 편집하면 이미 Canvas에 있는 사용자에게 어떤 영향이 있나요?

여러 단계로 구성된 Canvas의 일부 단계를 편집하면, 이미 오디언스에 포함되어 있지만 해당 단계를 아직 받지 않은 사용자는 업데이트된 버전의 메시지를 받게 됩니다. 단, 이는 해당 단계에 대해 아직 평가되지 않은 사용자에게만 적용됩니다.

실행 후 편집할 수 있는 항목에 대한 자세한 내용은 실행 후 Canvas 변경하기를 참조하세요.

Canvas를 중지하면 어떻게 되나요?

Canvas를 중지하면 다음이 적용됩니다.

• 사용자가 Canvas에 진입할 수 없게 됩니다.
• 사용자가 흐름의 어느 위치에 있든 더 이상 메시지가 전송되지 않습니다.
• 예외: 이메일이 포함된 Canvases는 즉시 중지되지 않습니다. 전송 요청이 SendGrid로 넘어간 후에는 사용자에게 전달되는 것을 막을 수 없습니다.

사용자 생애주기별로 하나의 Canvas를 만들어야 하나요, 아니면 별도의 Canvases를 만들어야 하나요?

Canvas로 달성하려는 목표에 따라 사용자 여정을 구성하는 방식이 달라질 수 있습니다. Canvas는 유연하므로 사용자 생애주기의 모든 단계에 대한 사용자 여정을 설계할 수 있습니다. 효과적인 사용자 여정을 간편하게 만드는 여러 예시는 Braze 캔버스 템플릿을 확인하세요.

메시지 및 전달

Canvas의 인앱 메시지는 언제 전송되나요?

인앱 메시지는 다음 세션이 시작될 때 전송됩니다. 따라서 Canvas가 중지되기 전에 사용자가 Canvas 단계에 진입했다면, 인앱 메시지가 아직 만료되지 않은 한 다음 세션이 시작될 때 해당 인앱 메시지를 수신합니다.

Canvas가 중지되기 전에 사용자가 세션을 시작했더라도 인앱 메시지가 즉시 표시되지 않을 수 있습니다. 인앱 메시지가 커스텀 이벤트로 트리거되거나 지연되는 경우에 이런 상황이 발생할 수 있습니다. 즉, Canvas가 중지된 후에 사용자가 인앱 메시지 노출 횟수를 기록하고 인앱 메시지를 “수신”할 수도 있습니다. 다만 이 경우 사용자는 Canvas가 중지되기 전, 그리고 Canvas 단계를 수신한 후에 세션을 시작했어야 합니다.

노출 횟수가 기록되었는데도 Canvas의 전송 수가 0으로 표시되는 이유는 무엇인가요?

인앱 메시지 단계가 포함된 Canvas에서 전송된 메시지가 항상 0으로 표시된다면, 이는 인앱 메시지 전달 방식이 다른 메시징 채널과 다르기 때문입니다.

인앱 메시지는 Braze가 “푸시”하는 방식이 아니라 SDK가 “가져오는(pull)” 방식으로 전달됩니다. 적격 사용자를 위한 인앱 메시지는 세션 시작 시 자동으로 전달되며, 표시되기 전까지 트리거 이벤트를 “대기”합니다. 적격 사용자는 세션을 시작할 때 메시지를 수신하므로 Braze는 이를 전송 이벤트로 보고하지 않습니다. 사용자가 트리거 이벤트를 수행하면 메시지가 표시되고, Braze는 노출 횟수를 기록한 후 고객 프로필에 Canvas 단계(또는 Campaign)를 수신한 것으로 표시합니다. 따라서 인앱 메시지의 전송 합계는 0이 됩니다.

긴 지연이나 브랜치 이후 사용자가 인앱 메시지를 수신하지 못한 이유는 무엇인가요?

업스트림 지연 단계와 오디언스 확인이 완료된 후, 사용자는 메시지 단계에 도달해야만 인앱 메시지를 받을 수 있습니다. 메시지가 특정 캘린더 날짜에 만료되거나 단계가 사용 가능해진 후 기간 창이 짧게 설정되어 있으면, 느린 브랜치에 있는 사용자는 만료 후에 도착하여 메시지를 보지 못할 수 있습니다. 가장 긴 현실적인 경로 지연에 맞춰 만료 시점을 조정하세요. 자세한 내용과 예시는 인앱 메시지 만료를 참조하세요.

“Canvas Entry Properties may not be used in In-App Messages.” 메시지가 표시되는 이유는 무엇인가요?

이 메시지는 개인화에서 Canvas의 인앱 메시지가 확인할 수 없는 필드를 참조할 때 표시됩니다. 컨텍스트 및 이벤트 속성정보 및 메시지 단계에 설명된 대로 context 오브젝트를 사용하세요. 레거시 Liquid 네임스페이스인 canvas_entry_properties는 context와 제약 조건이 다릅니다. 여러 단계에 걸쳐 값을 유지해야 하는 경우, Braze 팀과 함께 기존 Canvas 편집기의 영구 속성을 검토하세요. 기기가 인앱 페이로드를 다운로드하기 전에 사용자가 Canvas를 종료하면 저장된 값은 삭제됩니다.

Canvas에서 드래그 앤 드롭 인앱 메시지의 버튼 클릭은 어디에서 확인할 수 있나요?

드래그 앤 드롭 인앱 메시지의 버튼 수준 측정기준은 상위 수준의 Canvas 요약뿐 아니라 Canvas 세부정보의 메시지 단계 분석 카드에 표시됩니다. Canvas를 열고 메시지 단계를 선택한 후 해당 위치에서 인앱 인게이지먼트를 검토하세요. 보고 개념에 대해서는 Canvas 분석을 참조하세요.

동일한 Canvas 메시지 단계나 다변량 전송에서 배리언트별로 다른 전송 시간을 예약할 수 있나요?

아니요. 동일한 다변량 구성 또는 메시지 단계에 속한 배리언트는 하나의 전달 스케줄을 공유합니다. 같은 예약 전송에서 한 배리언트는 오후 6시에, 다른 배리언트는 오후 7시에 전송되도록 지정할 수 없습니다.

전송 시간을 분산하거나 경로별로 다른 시간을 사용하려면 다음 방법을 시도해 보세요.

• 메시지 단계를 분리하고 그 사이에 지연 단계를 두어 각 메시지가 자체 스케줄을 갖도록 합니다.
• 브랜치 또는 실험 경로 단계를 사용하여 사용자가 서로 다른 타이밍의 경로를 따르도록 합니다.
• 사용 사례가 하나의 Canvas 안에 있을 필요가 없다면 Campaigns를 분리합니다.

Campaign의 다변량 및 A/B 개념에 대해서는 다변량 및 A/B 테스트를 참조하세요.

Canvas 메시지 단계에서 사용자에게 전역 최대 게재빈도 설정이 적용되면 어떻게 되나요?

해당 사용자는 상한이 적용된 채널의 전송을 수신하지 않지만, 전역 최대 게재빈도 설정으로 인해 메시지가 전송되지 않은 경우에도 메시지 단계는 사용자를 다음 단계로 진행시킵니다. 단계별 진행 사례는 사용자 진행 방식을 참조하세요. 전역 최대 게재빈도 설정만으로는 사용자가 Canvas에서 이탈하지 않으며, 이 동작은 메시지 단계의 전달 유효성 검사와는 별개입니다. 자세한 내용은 사용량 제한 및 최대 게재빈도 설정을 참조하세요.

전송 수가 예상 오디언스 규모보다 적은 이유는 무엇인가요?

전송 수가 예상 오디언스보다 적은 이유는 Campaigns의 경우와 대부분 동일하며, 여기에는 최대 게재빈도, 엄격한 기기 또는 브라우저 필터, 재적격성 기간, 사용량 제한, 채널 수준 제외(예: 푸시 도달 가능성, 이메일 가입 및 전달 가능성 확인) 등이 포함됩니다.

Canvas에만 해당하는 요인도 있습니다.

• 실행 기반 또는 API 트리거 진입: 사용자는 진입 행동을 수행한 후에만 진입하고 단계를 수신하므로, 해당 행동이 발생하기 전까지는 실제 전송 수가 사전 예상치보다 적습니다.
• 오디언스 경로: 사용자는 자격을 충족하는 가장 높은 우선순위의 브랜치로 라우팅되므로, 하위 브랜치는 단순 Segment 수보다 적은 사용자를 받을 수 있습니다.
• 오디언스 및 전송 시점 확인: 별도로 구성하지 않는 한 전체 단계는 전송 시점에 필터를 재평가합니다. Canvas를 생성할 때 자격을 충족했던 사용자도 메시지가 전송되기 전에 제외될 수 있습니다.
• 대조군: 글로벌 또는 Canvas 대조군은 진입자의 일부를 메시징에서 제외합니다.
• 방해금지 시간 및 지연: 메시지가 보류되거나 재예약되어 현재 보고 있는 보고 기간 밖으로 전송이 이동할 수 있습니다.
• 최대 진입 또는 오디언스 상한: 기본 Segment가 더 크더라도 진입 또는 전송 상한에 도달하면 추가 사용자가 차단됩니다.
• 보고 기간: 분석 범위에 예상치와 비교하려는 모든 전송이 포함되지 않을 수 있습니다.

예상 오디언스와 Canvas 사용자 수가 일치하지 않는 이유는 무엇인가요?

예상 오디언스는 예상치를 계산하는 시점에 Segment 및 진입 필터와 일치하는 사용자를 반영합니다. 그 이후에는 지연 또는 실행 기반 진입, 재적격성, API 트리거, 브랜치 라우팅 등으로 인해 스냅샷보다 더 많은 프로필이 여정에 참여할 수 있습니다. 또한 전송 시점 필터를 충족하지 못한 사용자는 제외될 수 있으며, 이 경우 실제 진입 수 또는 전송 수가 줄어듭니다. 전송 수가 예상 오디언스 규모보다 적은 이유는 무엇인가요?와 함께 타이밍, 상한, 평가 설정을 비교해 보세요.

고유 수신자 수가 타겟팅한 사용자 수보다 많은 이유는 무엇인가요?

Braze는 Canvas 및 Campaign 보고에서 일일 고유 수신자를 추적하기 때문에 고유 수신자 수가 예상한 오디언스보다 많을 수 있습니다. 이를 통해 사용자가 여정에서 메시지를 수신할 때마다 정확한 전환 기여도를 산정할 수 있습니다.

예를 들어 사용자가 월요일과 금요일에 각각 Canvas 단계를 수신하고 각 전송 후에 전환했다면, Braze는 수신자 행 2개와 해당 범위 내 전환 2건을 집계할 수 있습니다. 반복 진입이나 재적격성이 설정된 경우, 동일한 소수의 프로필이 며칠에 걸쳐 여러 고유 수신자를 생성할 수 있습니다.

Canvas의 전송률이 낮아지는 이유는 무엇인가요?

매일 예약된 Canvas가 시간이 지날수록 더 적은 사용자에게 전송된다면 다음 사항을 확인하세요.

• 재적격성이 켜져 있는지 확인하세요: 재적격성이 없으면 Braze는 각 사용자를 Canvas에 한 번만 진입시킵니다. 매일 예약된 Canvases에서는 오디언스와 일치하면서 아직 Canvas에 진입하지 않은 사용자만 각 진입에 적격합니다. 진입하는 사용자가 늘어날수록 이후 진입에서 적격 사용자가 줄어들어 진입량이 감소합니다.
• 오디언스의 멤버십이 고정되어 있는지 확인하세요: 고정된 사용자 목록으로 구성된 오디언스(예: Segment 필터로 사용되는 CSV 가져오기)는 새 멤버가 자동으로 추가되지 않습니다. 새로운 진입자가 없으면 사용자가 Canvas에 진입함에 따라 진입량이 다시 증가할 수 없습니다.

전달 속도 사용량 제한 및 단일 발생 건의 전송 수를 낮추는 기타 요인에 대해서는 전송 수가 예상 오디언스 규모보다 적은 이유는 무엇인가요?를 참조하세요.

작은 대조군 Segment의 과거 멤버십에 변동이 표시되는 이유는 무엇인가요?

과거 멤버십 차트는 추정 샘플을 사용하므로, 글로벌 컨트롤 그룹 Segment를 포함한 작은 Segments는 기본 오디언스가 안정적이더라도 일별 변동이 표시될 수 있습니다. 추정치의 작동 방식과 차트가 변동하는 이유는 과거 Segment 멤버십 규모 보기를 참조하세요.

분석 및 전환

전환 대시보드는 Canvas 전환을 어떻게 기여도로 할당하나요?

전환 대시보드는 선택한 기여도 방식(예: Upon Receipt, Upon Send, Upon Open, Upon Click)에 따라 Canvas 전환을 할당합니다. 사용자가 보고서에 표시되려면 리포트 설정 범위 안에서 Canvas 또는 Campaign에 진입하고, 선택한 기여도 방식에 해당하는 이벤트를 기록하고, 전환 이벤트를 수행해야 합니다.

Canvas 분석의 단계 수준 및 배리언트 수준 전환 규칙은 Canvas에서 사용자 전환은 어떻게 추적되나요?를 참조하세요.

Canvas에서 사용자 전환은 어떻게 추적되나요?

사용자는 Canvas 진입 한 번당 한 번만 전환할 수 있습니다. 전환은 해당 진입에서 사용자가 가장 최근에 수신한 메시지에 할당됩니다. Canvas 시작 부분의 요약 블록은 메시지 수신 여부와 관계없이 해당 경로 내 사용자가 수행한 모든 전환을 반영합니다. 이후의 각 단계에는 해당 단계가 사용자가 가장 최근에 수신한 단계였던 동안 발생한 전환만 표시됩니다.

예시를 보려면 펼치세요

예시 1

푸시 알림 10개로 구성된 Canvas 경로가 있고, 전환 이벤트는 “세션 시작”(“앱 열기”)입니다.

• 사용자 A는 진입 후 첫 번째 메시지를 받기 전에 앱을 엽니다.
• 사용자 B는 각 푸시 알림을 받은 후 앱을 엽니다.

결과: 요약에는 전환이 2회로 표시되지만, 개별 단계에서는 첫 번째 단계에 전환 1회, 이후 모든 단계에 0회가 표시됩니다.

참고

전환 이벤트가 발생할 때 방해금지 시간이 활성화되어 있어도 동일한 규칙이 적용됩니다.

예시 2

방해금지 시간이 활성화된 단일 단계 Canvas가 있습니다.

1. 사용자가 Canvas에 진입합니다.
2. 첫 번째 단계에는 지연이 없지만 설정된 방해금지 시간에 해당하므로 메시지가 억제됩니다.
3. 사용자가 전환 이벤트를 수행합니다.

결과: 사용자는 전체 Canvas 배리언트에서는 전환한 것으로 집계되지만, 해당 단계를 수신하지 않았으므로 단계에서는 전환으로 집계되지 않습니다.

전환율 유형별 차이는 무엇인가요?

• 총 Canvas 전환 수는 각 사용자가 전환을 몇 번 완료했는지가 아니라, 전환 이벤트를 완료한 고유 사용자 수를 반영합니다.
• 배리언트 전환율 또는 Canvas 시작 부분의 요약 블록은 메시지 수신 여부와 관계없이 해당 경로 내 사용자가 수행한 모든 전환을 합계로 반영합니다.
• 단계 전환율은 해당 메시지 단계를 수신하고 설정된 전환 이벤트 중 하나를 완료한 사용자 수를 반영합니다.

Canvas 단계 전환율이 Canvas 배리언트 총 전환율과 일치하지 않는 이유는 무엇인가요?

Canvas 배리언트의 전환 합계가 단계 합계보다 큰 경우는 흔합니다. 이는 사용자가 배리언트에 진입하는 즉시 해당 배리언트에 대한 전환 이벤트를 수행할 수 있기 때문입니다. 하지만 이 전환 이벤트는 Canvas 단계에는 집계되지 않습니다. 따라서 Canvas에 진입한 후 첫 번째 Canvas 단계를 받기 전에 전환 이벤트를 수행한 사용자는 배리언트 전환 합계에는 집계되지만 단계 합계에는 집계되지 않습니다. Canvas에 진입했지만 어떤 단계도 받기 전에 Canvas를 종료한 사용자도 마찬가지입니다.

또한 사용자가 배리언트에 진입한 후 단계에서 어떤 메시지도 받지 않고 전환할 수도 있습니다. 이 경우 단계 수준에서는 전환이 기록되지 않습니다. 하지만 사용자가 실제로 전환했으므로 Canvas 수준에서는 전환이 기록됩니다.

사용자가 API 트리거 Canvas를 수신했는지 어떻게 확인할 수 있나요?

Canvas 필터를 사용해 Segment를 생성하면 사용자가 Canvas에 진입했는지 또는 특정 Canvas 단계를 수신했는지 확인할 수 있습니다. 예를 들어, 사용자가 API 트리거 Canvas에 진입했는지 확인하려면 Canvas 진입 필터를, Canvas에서 메시지를 수신했는지 확인하려면 수신 단계 필터를 사용하세요. 그런 다음 /users/export/segment 엔드포인트를 사용하여 해당 Segment의 사용자를 내보내세요.

Canvas를 삭제할 수 있나요?

아니요. 하지만 Canvas를 보관할 수 있습니다.

보관된 Canvas 또는 Campaign을 재개하려면 어떻게 하나요?

보관된 메시지는 편집 가능한 상태로 되돌리기 전까지 전송되지 않습니다. Campaign 또는 Canvas를 보관 취소하고, 진입 일정이나 전송 시간을 향후 기간으로 설정한 다음(깨끗한 사본이 필요하면 여정을 복제), 필요에 따라 Resume을 선택하거나 실행하세요. 자세한 내용은 Campaigns 및 Canvases 보관을 참조하세요.

오류가 표시되지 않는데 Canvas가 저장되지 않는 이유는 무엇인가요?

오디언스 또는 단계 수준 필터에 비어 있는 Custom attribute 필터가 있으면 자세한 유효성 검사 메시지 없이 저장이 차단될 수 있습니다. 각 필터 카드를 열어 불완전한 커스텀 속성 규칙을 제거하거나 속성 이름과 값을 모두 입력한 다음, Save를 다시 선택하세요.

Canvas 또는 Campaign에서 태그가 사라진 이유는 무엇인가요?

워크스페이스에서 태그가 삭제되면 Braze는 해당 태그를 참조하던 모든 Campaign과 Canvas에서 태그를 제거합니다. 이 정리 작업이 Canvas 변경 로그에 별도의 항목으로 항상 기록되지는 않습니다.

각 Canvas 구성 요소의 분석은 어떻게 확인할 수 있나요?

Canvas 구성 요소의 분석을 확인하려면 Canvas로 이동하여 Canvas Details 페이지를 아래로 스크롤하세요. 여기에서 각 구성 요소의 분석을 확인할 수 있습니다. 자세한 내용은 Canvas 분석을 참조하세요.

Canvas 단계의 인게이지먼트는 언제 고객 프로필에 표시되나요?

Received Message from Canvas Step과 같은 필터는 Braze가 해당 단계에 대한 전송, 수신 또는 인게이지먼트 이벤트를 기록한 후에 업데이트됩니다. 인앱 메시지는 전송 유형 측정기준과 별도로 노출 횟수를 기록할 수 있습니다. 노출 횟수가 기록되었는데도 Canvas에 전송이 0으로 표시되는 이유는 무엇인가요?를 참조하세요. 동일한 이벤트가 Canvas Details의 단계 측정기준에도 표시됩니다.

고유 사용자 수를 볼 때 Canvas 분석과 세그멘터 중 어느 쪽이 더 정확한가요?

고유 사용자 데이터의 경우 Canvas 또는 Campaign 통계보다 세그멘터가 더 정확합니다. Canvas 및 Campaign 통계는 어떤 일이 발생할 때마다 Braze가 증가시키는 숫자이므로, 세그멘터의 수치와 달라질 수 있는 변수가 존재하기 때문입니다. 예를 들어, 사용자는 하나의 Canvas 또는 Campaign에서 두 번 이상 전환할 수 있습니다.

Canvas에 진입한 사용자 수가 예상과 일치하지 않는 이유는 무엇인가요?

Canvas에 진입하는 사용자 수는 오디언스와 트리거가 평가되는 방식 때문에 예상과 다를 수 있습니다. Braze에서는 오디언스가 트리거보다 먼저 평가됩니다(속성 변경 트리거를 사용하는 경우 제외). 따라서 트리거 동작이 평가되기 전에 선택한 오디언스에 속하지 않은 사용자는 Canvas에서 이탈하게 됩니다.

Canvas 여정 중 익명 사용자는 어떻게 되나요?

익명 사용자도 Canvases에 진입하고 종료할 수 있지만, 식별되기 전까지는 이들의 행동이 특정 고객 프로필과 연결되지 않으므로 상호작용이 분석에서 완전히 추적되지 않을 수 있습니다. 쿼리 빌더를 사용하여 이러한 측정기준에 대한 보고서를 생성할 수 있습니다.

현재 Canvas 여정에 있는 사용자를 Campaign 또는 Segment에서 제외할 수 있나요?

Entered Canvas Variation, In Canvas Control Group, Received Message from Canvas Step과 같은 세분화 필터를 사용하여 Canvas 진입, 배리언트 할당 또는 단계 인게이지먼트를 기준으로 사용자를 타겟팅할 수 있습니다. 이러한 필터는 진입 기록과 상호작용을 평가할 뿐, 사용자가 활성 여정을 아직 진행 중인지는 나타내지 않습니다.

활성 Canvas 참여 여부에 따라 사용자를 포함하거나 제외하려면, Canvas 진입 및 종료 시점에 사용자 업데이트 단계를 추가하여 커스텀 속성을 설정 및 해제한 다음, Campaign 또는 Segment에서 해당 속성으로 필터링하세요.

세분화

“Has not entered Canvas variation”과 “Is not in Canvas control group”의 차이점은 무엇인가요?

전체 필터 정의는 세분화 필터를 참조하세요.

“Has not entered Canvas variation” 필터

사용자가 특정 Canvas의 배리언트 경로에 진입한 적이 없는 경우입니다. Canvas 진입 여부와 관계없이 대조군에 속하지 않은 모든 사용자가 포함됩니다. 여기에는 다른 배리언트에 진입한 사용자와 어떤 배리언트에도 진입하지 않은 사용자가 모두 포함됩니다.

“Is not in Canvas control group” 필터

사용자가 Canvas에 진입했지만 대조군에 속하지 않아 배리언트를 받은 경우입니다. 이 필터에는 Canvas에 진입한 사용자만 포함됩니다.

배리언트 할당은 Canvas 진입 시점에 이루어집니다. 사용자가 Canvas에 진입하지 않았다면 어떤 배리언트에도 할당되지 않습니다. 즉, 대조군에도, 배리언트에도 속하지 않습니다.

원본 Canvas 편집기

원본 Canvas 편집기 FAQ를 보려면 펼치기

원본 편집기에서 만든 기존 Canvas를 현재 편집기로 전환하려면 어떻게 하나요?

Canvas를 복제하면 됩니다. 복제하면 원본 Canvas의 사본이 최신 Canvas 워크플로에 생성됩니다.

현재 Canvas 편집기와 원본 Canvas 편집기의 주요 차이점은 무엇인가요?

Canvas 구성 요소 툴바

이전의 원본 Canvas 편집기에서는 사용자 여정에서 단계를 만들 때마다 기본적으로 전체 단계가 추가되었습니다. 현재 편집기에서는 이러한 전체 단계가 여러 Canvas 구성 요소로 대체되어, 편집 시 가시성이 높아지고 더 세밀하게 커스터마이징할 수 있습니다. Canvas 단계 툴바에서 모든 Canvas 구성 요소를 바로 확인할 수 있습니다.

단계 동작

이전에는 각 전체 단계에 지연 및 스케줄 설정, 예외 이벤트, 오디언스 필터, 메시지 구성, 메시지 진행 옵션 등의 정보가 하나의 구성 요소에 모두 포함되어 있었습니다. 현재 편집기에서는 이러한 항목이 별도의 설정으로 분리되어 Canvas 구축 경험을 더 유연하게 커스터마이징할 수 있으며, 이에 따라 일부 기능상의 차이가 있습니다.

메시지 구성 요소 진행

메시지 구성 요소는 해당 단계에 진입한 모든 사용자를 진행시킵니다. 메시지 진행 동작을 따로 지정할 필요가 없으므로 전체 단계를 더 간단하게 구성할 수 있습니다. 메시지 전송 시 진행 옵션을 구현하려면 별도의 오디언스 경로를 추가하여 이전 단계를 수신하지 않은 사용자를 필터링하세요.

지연 “이내” 동작

지연 구성 요소는 전체 지연 시간을 모두 기다린 후 다음 단계로 진행합니다.

예를 들어 4월 12일에 사용자를 1일 후 오후 2시에 다음 단계로 보내도록 설정한 지연 구성 요소가 있다고 가정해 보겠습니다. 한 사용자가 4월 13일 오후 2시 1분에 이 구성 요소에 진입합니다.

• 원본 워크플로에서는 사용자가 4월 14일 오후 2시에 다음 단계로 진행하며, 이는 진입 시점으로부터 1일이 채 되지 않은 시점입니다.
• 현재 편집기에서는 사용자가 4월 15일 오후 2시에 다음 단계로 진행합니다. 같은 시각이지만 진입 시점으로부터 1일 이상 지난 시점이라는 점에 유의하세요.

Intelligent Timing 동작

Intelligent Timing은 메시지 구성 요소에 저장되므로, 지연은 Intelligent Timing 계산 전에 적용됩니다. 즉, 사용자가 구성 요소에 진입하는 시점에 따라 원본 Canvas 워크플로로 만든 Canvas보다 메시지를 늦게 받을 수 있습니다.

예를 들어 지연이 2일로 설정되어 있고 Intelligent Timing이 켜져 있으며, 메시지를 보내기에 가장 좋은 시간이 오후 2시로 결정되었다고 가정해 보겠습니다. 한 사용자가 오후 2시 1분에 지연 단계에 진입합니다.

• 현재 워크플로: 지연이 지나기까지 48시간이 걸리므로 사용자는 셋째 날 오후 2시에 메시지를 받습니다.
• 원본 워크플로: 사용자는 둘째 날 오후 2시에 메시지를 받습니다.

Intelligent Timing이 켜져 있으면 (지연 구성 요소가 없더라도) 사용자가 메시지 구성 요소에 진입한 후 24시간 이내에 식별된 최적 시간에 메시지가 전송된다는 점에 유의하세요.

예외 이벤트

방해금지 시간

예외 이벤트는 메시지 단계와 분리된 작업 경로를 통해 적용됩니다. 방해금지 시간은 메시지 구성 요소에서 적용됩니다. 따라서 사용자가 이미 작업 경로 단계를 통과했고(예외 이벤트로 제외되지 않음), 메시지 구성 요소에 도달했을 때 방해금지 시간에 해당하며, 방해금지 시간이 끝난 후 메시지가 다시 전송되도록 Canvas가 구성되어 있다면 예외 이벤트는 더 이상 적용되지 않습니다. 이러한 사용 사례는 흔하지 않다는 점에 유의하세요.

Segment와 필터의 경우, 메시지 단계에는 전송 시점에 검증되는 추가 Segment와 필터를 구성할 수 있는 전달 검증 기능이 있습니다. 이를 통해 앞서 설명한 방해금지 시간 예외 상황을 방지할 수 있습니다.

“이내” 또는 “다음” 스케줄 설정

예외 이벤트는 작업 경로를 사용하여 생성됩니다. 작업 경로는 “X 시간 기간 이후”만 지원하며, “X 시간 이내” 또는 “다음 X 시간”은 지원하지 않습니다.

“Request Timed Out” 오류에 대한 지원 티켓을 제출할 때 무엇을 포함해야 하나요?

Canvas를 편집하는 동안 “Request Timed Out” 오류가 발생하여 Braze 지원팀에 문의해야 하는 경우, 빠른 해결을 위해 다음 정보를 포함하세요.

• 화면 녹화: 오류가 발생하기 전에 수행한 단계를 녹화한 것으로, 페이지 전환도 포함합니다.
• 타임스탬프 및 시간대: 오류가 발생한 정확한 시간과 사용자의 시간대입니다.
• 브라우저 및 버전: 사용 중인 브라우저(예: Chrome 120, Safari 17)와 다른 브라우저에서 오류를 재현해 보았는지 여부입니다.
• 재현 단계: 오류를 트리거하는 작업에 대한 명확한 설명으로, 관련된 특정 캔버스 단계 또는 구성을 포함합니다.
• 네트워크 로그(선택 사항): 브라우저 개발자 도구(네트워크 탭)를 열고 오류를 재현한 다음, 네트워크 로그를 HTTP Archive(HAR) 로그 파일로 내보냅니다. 이를 통해 지원 팀이 어떤 API 호출에서 시간 초과가 발생하는지 파악하는 데 도움이 됩니다.

Canvas 전달 및 문제 해결

고아 사용자도 Canvas 메시지를 받을 수 있나요?

아니요. 고아 사용자는 메시지를 받을 수 없습니다. 사용자가 Canvas 여정에 있는 동안 프로필이 고아 상태가 되면, 해당 사용자는 별도 알림 없이 흐름에서 종료됩니다. 이 경우 분석에 Exited 이벤트가 항상 표시되지는 않습니다. 워크플로 요약에는 exited_date나 exit_reason 없이 partial_update_token만 포함될 수도 있습니다.

병합과 고아 프로필에 대한 자세한 내용은 중복 사용자 병합을 참조하세요.

활성 Canvas나 Campaign을 중지하면 이미 ESP로 전송된 메시지도 전달되나요?

네. Braze가 이메일 서비스 공급자(ESP)에 요청을 보낸 후에는 해당 전송을 취소할 수 없습니다. Canvas나 Campaign을 중지하면 새로운 전송 요청은 차단됩니다. 하지만 이미 ESP로 넘어간 메시지는 계속 전달될 수 있으며, ESP가 이를 처리하면서 전송 수도 계속 증가할 수 있습니다.

이는 Canvas 중지에서 설명한 동작과 같습니다. 진행 중인 이메일 전송은 즉시 중단되지 않습니다.

사용자에게 보이는 콘텐츠 없이 Canvas 웹훅 단계가 실행되었는지 어떻게 확인하나요?

Braze는 Campaign과 Canvases의 웹훅 단계에 대해 웹훅 Sends 및 관련 전달 결과를 추적합니다. 단계 분석, 웹훅 보고 또는 Currents 웹훅 이벤트로 단계가 실행되었는지 확인하세요. 서버 측에서 수신 사실을 증명해야 한다면 엔드포인트의 요청 로그로 한 번 더 확인할 수 있습니다.

Braze는 웹훅 단계용 보이지 않는 추적 픽셀 기능을 기본으로 제공하지 않습니다. 커스텀 1픽셀 이미지 요청 대신 Braze 웹훅 측정기준과 엔드포인트 로깅을 활용하세요.

웹훅 단계에 본문 필드가 없는 이유는 무엇인가요?

웹훅 단계는 POST, PUT, PATCH, DELETE에서 요청 본문을 사용합니다. 메서드를 GET으로 바꾸면 Braze가 본문 필드를 제거합니다. GET 요청은 요청 본문을 지원하지 않기 때문입니다. JSON이나 양식 데이터를 보내야 한다면 본문을 지원하는 메서드로 다시 바꾸세요. 메서드에 대한 자세한 내용은 웹훅 만들기를 참조하세요.

웹훅 단계에서 spacer.gif는 어떻게 사용하나요?

Braze는 cdn.braze.com 및 braze-images.com에서 spacer.gif 입력 안내 이미지를 호스팅합니다. 외부 엔드포인트를 호출하지 않고 단계만 실행해야 할 때 웹훅 URL이 이 이미지를 가리키도록 설정하는 팀도 있습니다. 하지만 일반적인 웹훅 단계는 실제 엔드포인트를 호출해야 합니다. 전달 여부는 사용자에게 보이는 콘텐츠 없이 Canvas 웹훅 단계가 실행되었는지 어떻게 확인하나요?에서 설명한 대로 웹훅 보고와 엔드포인트 로그로 확인하세요.

“invalid next-step-id” 오류로 Canvas가 로드되지 않는 이유는 무엇인가요?

이 콘솔 오류는 하나 이상의 단계가 존재하지 않거나 유효하지 않은 다음 단계를 가리킨다는 뜻입니다. 예를 들어 일부만 삭제하거나, 복제하거나, 가져온 후에 이 오류가 발생할 수 있습니다. 편집기에서 Canvas를 열고 연결이 끊긴 단계를 다시 연결하세요. 유효한 다음 경로가 없는 단계는 제거하세요. 그래도 Canvas가 로드되지 않으면 Canvas ID와 콘솔 오류 스크린샷을 첨부하여 Braze 지원팀에 문의하세요.

Currents의 Canvas 전환 타임스탬프가 Canvas 분석과 다른 이유는 무엇인가요?

Currents는 Canvas 전환을 users.canvas.Conversion 이벤트로 기록합니다. 이벤트의 time은 전환 이벤트가 발생한 시점입니다. 해당 이벤트의 conversion_behavior 필드에는 전환 정의(유형 및 기간)가 담겨 있습니다. 반면 Canvas 분석은 전환 기간 내에서 Canvas 진입 시점을 기준으로 전환을 집계할 수도 있습니다. 내보낸 데이터를 대조할 때는 Currents의 time을 전환 이벤트 타임스탬프 및 Canvas 전환 기간 설정과 비교하세요.

Currents에서 canvas_step_name이 null인 이유는 무엇인가요?

Braze가 단계 메타데이터 전파를 마치기 전에 Currents 이벤트가 전송되면, canvas_step_name 같은 Campaign 및 Canvas 이름 필드가 null일 수 있습니다. 예를 들어 단계를 생성하거나 이름을 변경한 직후에 이런 일이 발생할 수 있습니다. 자세한 내용은 Currents 데이터에서 Campaign 이름 또는 Canvas 단계 이름이 NULL인 이유는 무엇인가요?를 참조하세요.

사용자 업데이트 단계에서 배열이 업데이트되지 않는 이유는 무엇인가요?

사용자 업데이트 단계의 JSON을 확인하세요. 배열 및 중첩 속성을 업데이트하려면 변경하려는 속성에 맞는 유효한 경로와 값이 필요합니다. 외부 사용자 ID처럼 단계에서 자동으로 제공하는 필드는 포함하지 마세요. 실행 전에 단계의 Preview and test 탭에서 페이로드를 확인하세요.

external_id가 없는 사용자에게도 Canvas 메시지를 보낼 수 있나요?

네, Braze 사용자 프로필이 이미 있다면 가능합니다. external_id가 없는 사용자는 익명 사용자이며, braze_id 또는 사용자 별칭으로 참조할 수 있습니다. Canvas 진입 전에 /users/track 엔드포인트나 SDK로 프로필을 생성하거나 업데이트하세요. 그런 다음 실행 기반 또는 API 트리거 진입을 사용하세요. 일반적인 Canvas 타겟팅에는 여전히 Braze 사용자 프로필이 필요합니다. 프로필 없이 이메일 주소만으로는 Canvas 메시지를 보낼 수 없습니다.

사용자가 트리거 이벤트를 수행한 횟수보다 Canvas에 적게 진입한 이유는 무엇인가요?

실행 기반 및 API 트리거 Canvases에서는 Braze가 트리거 이벤트를 중복 제거합니다. 따라서 사용자는 같은 Canvas에 대략 1초에 한 번까지만 진입할 수 있습니다. 사용자가 1초 안에 같은 트리거를 여러 번 수행하면 진입은 한 번만 처리됩니다.

같은 1초 안에 여러 번 진입하게 하려면 트리거 이벤트 사이에 최소 1.1초 간격을 두세요. 서버에서 이벤트 타이밍을 제어하는 경우가 이에 해당합니다. 같은 1초 안에 여러 번 트리거되는 Campaign 방식의 동작이 필요하다면, 적절한 스케줄 및 재자격 설정을 적용한 Campaigns가 사용 사례에 맞는지 비교해 보세요.

API 트리거 Canvases에서 사용자는 언제 중복 제거되나요?

사용자가 API 트리거 Canvas에 다시 진입하여 지연 단계에 도달했을 때, 이전 진입으로 동일한 메시지가 이미 대기줄에 있다면 Braze는 중복 전송을 막기 위해 해당 사용자를 중복 제거합니다. 이때 두 번째 Canvas 인스턴스는 종료되므로 진입 수가 전송 수보다 많을 수 있습니다.

테스트 푸시는 다른 앱으로 가는데 실제 전송은 정상으로 보이는 이유는 무엇인가요?

고객 프로필의 Test push는 해당 프로필에 연결된 푸시 활성화 기기 모두에 전달됩니다. 한 기기에 여러 앱이 설치되어 있으면, OS는 보통 사용 가능한 첫 번째 앱으로 테스트 알림을 전달합니다. 이 앱이 검증하려던 앱이 아닐 수 있습니다.

앱별 타겟팅을 확인하려면 프로필의 Test push에만 의존하지 마세요. 대신 오디언스를 좁힌 Campaign이나 Canvas로 실제 메시지나 테스트 메시지를 보내세요(예: external_id로 필터링).

여러 앱이 있는 Canvas 메시지 단계에서는 메시지 단계의 Validate audience at message send를 켜세요. 그러면 전송 시점에 Segment 및 필터 검사가 실행됩니다. 자세한 내용은 메시지 단계를 참조하세요.

일반적인 테스트 푸시 동작은 테스트 메시지 보내기 및 푸시 FAQ를 참조하세요.

iOS 및 Android에서 Push Stories는 어떻게 디버깅하나요?

설정 및 크리에이티브 요구 사항은 먼저 Push Stories를 확인하세요. 구현 및 리치 알림 처리에 대해서는 개발자 가이드의 리치 알림 및 Push Stories를 참조하세요.

“Canvas Messages Delayed 24+ Hours” 이메일은 누가 받나요?

Braze는 사용량 제한으로 인해 Canvas 메시지가 24시간 이상 지연되면 이 알림을 보냅니다. 이메일은 Canvas 변경 로그를 기준으로 해당 Canvas를 이전에 변경한 대시보드 사용자에게 전송됩니다. Braze가 이러한 수신자를 확인할 수 없으면 해당 워크스페이스의 회사 관리자에게 이메일을 보냅니다.

예외 이벤트 발생 후 사용자는 언제부터 메시지를 받지 않게 되나요?

Braze는 예외 이벤트가 발생하는 즉시 종료를 기록합니다. 하지만 사용자는 타이머가 끝날 때까지 단계 안에 머무를 수 있으며, 이는 지연 단계에서 가장 두드러집니다. 또한 동작 방식은 예약된 단계와 이벤트 트리거 단계에 따라 다릅니다. 타임라인, 예시, 분석상의 세부 사항은 종료 기준을 참조하세요.

링크 별칭 상호작용을 선택하면 작업 경로 단계에 오류가 표시되는 이유는 무엇인가요?

이메일 상호작용 트리거(예: Click alias in email 또는 Clicked alias in any campaign or Canvas step)를 사용하는 작업 그룹에는 해당 링크가 포함된 메시지를 이미 보낸 메시지 단계가 필요합니다. 작업 경로 단계가 클릭을 평가하기 전에 이메일이 전송되도록 단계를 추가하거나 순서를 바꾸세요. 또는 사용자가 이 Canvas에서 이미 받은 메시지와 일치하는 상호작용을 선택하세요. 전체 상호작용 트리거 목록은 실행 기반 전달을 참조하세요.

과거 커스텀 이벤트 타임스탬프는 실행 기반 Canvases와 Campaigns에 어떤 영향을 주나요?

Braze는 조건을 충족하는 이벤트가 수집되고 사용자가 오디언스 규칙을 충족할 때 실행 기반 여정을 평가합니다. 이벤트 타임스탬프가 Canvas 진입 기간에 포함되면, 과거 날짜로 기록된 커스텀 이벤트도 Canvas 진입을 트리거할 수 있습니다. 반면 타임스탬프가 해당 기간을 벗어나거나, Canvas 또는 Campaign이 활성 상태가 아니었거나, 사용자가 아직 오디언스 조건을 충족하지 않았다면 진입이나 이후 전송이 예상대로 이루어지지 않을 수 있습니다.

고객 프로필 활동 로그와 커스텀 이벤트 문제 해결의 단계를 활용하여 이벤트 타임스탬프를 실행 시점, 진입 기간 설정, Segment 멤버십과 비교하세요. 그래도 동작이 예상과 다르면 Braze 지원팀에 문의하세요.