Skip to content

Canvas 임계값 알림

Canvas 임계값 알림은 Canvas에서 계획대로 진행되지 않는 상황을 알려주어, 고객에게 영향을 미치기 전에 중단된 여정이나 예상치 못한 이탈을 포착할 수 있도록 합니다.

사용자 항목 또는 발송된 메시지에 대한 볼륨 또는 비율 임계값을 설정하면, 해당 임계값이 초과될 경우 Braze가 이메일 또는 웹훅으로 알림을 보냅니다. 동일한 Canvas에 대해 여러 알림을 생성할 수도 있습니다. 예를 들어, 사용자 항목에 대한 알림 하나와 발송된 메시지에 대한 알림 하나를 설정할 수 있습니다.

어디서부터 시작해야 할지 모르겠다면, Operator가 Canvas 임계값 알림 설정 방법을 안내해 드릴 수 있습니다.

1단계: 알림 만들기

알림은 Canvas 수준에서 설정되며, 활성 Canvas와 초안 Canvas 모두에 대해 구성할 수 있습니다. Canvas의 알림 관리 페이지를 열려면 다음 중 하나를 수행하세요:

  • 메시징 > Canvas로 이동한 후, 개별 Canvas의 컨텍스트 메뉴에서 알림 관리를 선택합니다.
  • 활성 Canvases의 경우, Canvas Analytics를 열고 알림 관리를 선택합니다.

알림 관리 페이지에서 알림 구성을 선택하여 새 알림을 만듭니다.

2단계: 알림 이름 지정 및 Canvas 선택

알림에 이름을 지정하고 적용할 Canvas를 확인합니다.

알림 이름과 Canvas 이름 필드, 빈 규칙 그룹, 그리고 알림 규칙, 스케줄, 알림에 대한 요약 사이드바가 표시된 알림 구성 패널.

3단계: 알림 규칙 설정

알림 규칙은 알림을 트리거하는 임계값을 정의합니다. 두 가지 측정기준을 사용하여 규칙을 만들 수 있습니다.

  • 사용자 항목: Canvas에 진입한 사용자 수
  • 메시지 발송: Canvas에서 발송된 메시지 수

각 규칙에 대해 비교 연산(미만, 초과, 이하, 이상 또는 같음), 단위 및 임계값을 선택합니다.

  • 볼륨: 현재 확인 기간의 절대 수를 비교합니다. 예를 들어, “사용자 항목이 3,000 미만”이라는 규칙은 평소에는 수천 명의 사용자에게 도달하던 Canvas가 갑자기 멈춘 경우를 감지합니다. 이는 업스트림 오디언스 또는 진입 관련 문제가 있다는 신호이므로 조사할 가치가 있습니다.
  • 백분율: 현재 수를 해당 Canvas의 기준선과 비교합니다. 기준선은 지난 7일간 동일한 시간대의 평균입니다. 예를 들어, 알림이 3시간마다 확인하는 경우, 오후 2시~5시 확인은 이전 7일간의 오후 2시~5시 구간 평균과 비교합니다. “메시지 발송이 50% 미만”이라는 규칙은 평소 볼륨의 절반 이하로 떨어진 경우를 감지합니다.

임계값은 정수입니다. 미만 또는 이하 백분율 규칙의 경우 1에서 100 사이의 값을 입력합니다. 초과, 이상 또는 같음의 경우 백분율은 0 이상이며, 100을 초과하는 값도 가능합니다. 이를 통해 기준선 대비 급증에 대해서도 알림을 설정할 수 있습니다.

여러 규칙을 하나로 묶을 수 있으며, 볼륨 규칙과 백분율 규칙을 혼합하는 것도 가능합니다. 규칙 그룹을 AND 또는 OR 로직으로 결합하여 더 구체적인 알림 조건을 구성할 수 있습니다.

4단계: 알림 스케줄 설정

알림 규칙이 확인되는 빈도를 정의합니다. 확인 빈도는 3시간에서 12시간까지(1시간 단위) 또는 24시간마다로 설정할 수 있습니다. 활성화되면 알림과 연결된 Canvas가 활성 상태인 한 이 스케줄에 따라 계속 확인합니다.

5단계: 알림 설정

알림 규칙이 충족될 때 누구에게 어떤 방식으로 알릴지 선택합니다:

  • 이메일: 수신자 이메일 주소를 하나 이상 추가합니다
  • 웹훅: 알림을 보낼 웹훅 URL을 입력하고, 필요에 따라 웹훅 대상에서 요구하는 커스텀 요청 헤더를 추가합니다

하나의 알림에 대해 두 가지 알림 방식 중 하나 또는 둘 다 활성화할 수 있습니다.

웹훅 알림은 Slack 채널 등 외부 플랫폼으로 알림을 라우팅할 때 유용합니다. 자세한 내용은 Slack의 수신 웹훅을 사용한 메시지 전송 설명서를 참고하세요. 각 웹훅 알림은 알림 이름, 평가 기간, 알림을 트리거한 조건이 포함된 JSON 페이로드를 전송합니다. 각 조건에는 volume 또는 percentage의 threshold_unit이 포함됩니다. 백분율 조건에는 percentage_metric_value(관측 횟수를 기준값의 정수 백분율로 나타낸 값)도 포함됩니다. metric_value는 항상 절대 횟수입니다.

웹훅 페이로드 예시

다음은 알림이 트리거될 때 웹훅 엔드포인트로 전송되는 POST 요청의 JSON 페이로드 예시입니다. 첫 번째 조건은 볼륨 규칙이고, 두 번째는 백분율 규칙으로, 51,235건의 메시지가 전송되었으며 이는 7일 동일 기간 기준값의 57%에 해당하고, 임계값 55% 초과 조건에 대해 평가됩니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

{
  "alert": {
    "name": "Canvas Alert - August 6, 2026",
    "target_type": "CANVAS"
  },
  "evaluation_window_start": "2026-08-06T10:28:01Z",
  "evaluation_window_end": "2026-08-06T13:28:01Z",
  "conditions": [
    {
      "subject": "user_entries",
      "operator": "lt",
      "threshold_value": 500,
      "metric_value": 0.0,
      "group_index": 0,
      "threshold_unit": "volume"
    },
    {
      "subject": "messages_sent",
      "operator": "gt",
      "threshold_value": 55,
      "metric_value": 51235.0,
      "group_index": 0,
      "threshold_unit": "percentage",
      "percentage_metric_value": 57
    }
  ]
}

6단계: 알림 저장하기

요약 패널에서 알림 규칙, 스케줄, 알림 설정을 검토한 후 Save alert를 선택합니다.

7단계: 알림 활성화하기

알림을 저장하는 것만으로는 활성화되지 않습니다. 알림을 켜려면 알림 관리 페이지로 이동하여 해당 알림의 상태 토글을 사용하세요. 알림은 비활성화하거나 연결된 Canvas가 더 이상 활성 상태가 아닐 때까지 활성 상태로 유지됩니다. Canvas 페이지의 구성된 알림 열에는 저장된 알림이 하나 이상 있는 Canvas에 벨 아이콘이 표시됩니다.

고려 사항

  • 초안 상태의 Canvases: 아직 초안 상태인 Canvas에 대해 임계값 알림을 설정할 수 있지만, Canvas가 실행될 때까지 알림이 규칙에 대한 확인을 시작하지 않습니다.
  • 비율 기준선: 비율 규칙은 Canvas가 실행된 후 동일한 기간의 완전한 이전 7일이 필요합니다. 해당 기간이 아직 존재하지 않거나 기준선 평균이 0인 경우(이전 기간에 활동이 없는 경우), 비율 규칙은 알림을 트리거하지 않습니다.
New Stuff!