캔버스 노드 설정 | Appbox 콘솔 사용 가이드
캔버스 노드 설정
노드를 조합하여 메시지 발송, 대기, 분기 등의 여정 흐름을 자유롭게 구성할 수 있습니다.
| 구분 | 노드 | 설명 |
|---|---|---|
| 흐름 제어 | 대기 | 다음 노드로 진행하기 전 설정한 시간만큼 대기합니다. |
| 이벤트 분기 | 특정 이벤트 발생 여부에 따라 경로를 Yes/No로 분기합니다. | |
| 사용자 분기 | 세그먼트 조건 충족 여부에 따라 경로를 Yes/No로 분기합니다. | |
| A/B 테스트 | 사용자를 최대 5그룹으로 나눠 각기 다른 경로로 분기합니다. | |
| 액션 | 푸시 메시지 | 사용자에게 푸시 메시지를 발송합니다. |
| 인앱 메시지 | 앱 내에서 인앱 메시지를 노출합니다. |
여정 1개당 사용할 수 있는 최대 노드 수는 50개이며, 노드 간 연결은 순방향만 허용합니다.
대기 노드
- 다음 노드로 진행하기 전, 설정한 시간 동안 여정 흐름을 대기 시키는 노드입니다. 메시지 발송 간 간격을 두거나, 사용자의 행동을 기다릴 때 사용합니다.
- 대기 시간 설정 : 최소 1분부터 최대 90일까지 설정할 수 있습니다.
-
대기 중 전환 이벤트가 발생하면 대기를 즉시 중단하고 여정을 종료합니다.
이 때, 전환은 이전 액션 노드(푸시/인앱)에 집계됩니다. - 대기 노드에서는 만료 기간을 무시하고, 대기 시간만큼 흐름을 대기합니다.
- 대기 시간 중 여정 종료일에 도달하면 대기를 중단하고 종료 조건에 따라 여정을 종료합니다.
이벤트 분기
- 사용자의 특정 이벤트 발생 여부 또는 발생 횟수를 기준으로 이후 여정 경로를 Yes/No로 분기합니다.
- 이벤트 발생 수집 기간과 기준 이벤트를 설정하여 원하는 시점의 사용자 행동에 따라 경로를 분기할 수 있습니다.
기준 이벤트 설정
- Yes/No 분기 기준이 되는 이벤트를 설정합니다.
- 기준 이벤트는 AND / OR 조건으로 각각 최대 5개까지 설정할 수 있습니다.
- 이벤트 발생 여부뿐 아니라, 수집 기간 내 이벤트 발생 횟수를 기준으로도 분기할 수 있습니다.
- 기준 이벤트가 전환 이벤트와 동일한 경우에는 Yes로 판단하지만, 통계 수집 후 여정을 종료합니다.
- 이벤트 설정 : 이벤트 페이지에서 설정한 이벤트를 선택하여, 해당 이벤트 발생 여부에 따라 Yes/No로 분기 됩니다.
- 세부 조건 추가 (And 조건) : 이벤트 설정 후, 속성 키를 이용하여 속성값에 따라서 이벤트를 집계할 수 있습니다.
- 1회 발생 / N회 발생 : 이벤트 발생 횟수를 조건으로 이벤트 발생 여부를 설정할 수 있습니다.
기준 이벤트 수집 기간
- 기준 이벤트를 수집할 기간을 설정합니다.
- 수집 기간 동안 이벤트가 중복 발생하면, 첫 번째 발생 이벤트를 기준으로 Yes / No를 판단합니다.
- 이 단계 진입 후 N시간/일 동안 수집 (기본값) : 이벤트 분기 노드에 진입한 시점부터 설정한 기간 내에 발생한 이벤트 발생 여부를 기준으로 분기합니다.
- 여정 시작부터 이 단계 도착 전까지 수집 : 사용자가 여정에 진입한 시점부터 이벤트 분기 노드에 진입 이전까지의 기간 동안 이벤트 발생 여부를 기준으로 분기합니다.
- 기준 이벤트 수집 기간 설정 시, 만료 기간을 무시하고 기준 이벤트 수집 기간 만큼 흐름을 대기합니다.
사용자 분기
- 사용자가 특정 세그먼트/구독 그룹 조건을 만족하는지 여부를 기준으로 이후 여정 경로를 Yes/No로 나누는 흐름 제어 노드입니다.
- 발송 대상을 기준으로 분기 조건을 설정할 수 있으며, 조건 충족 여부는 분기 시점에 판단합니다.
발송 대상
- 분기 기준이 되는 발송 대상(세그먼트/구독 그룹)을 설정합니다.
- 세그먼트 평가는 사용자가 해당 사용자 분기 노드에 진입하는 시점의 상태를 기준으로 1회 판단합니다.
- 노드 진입 이후 세그먼트 상태가 변경되어도 이미 결정된 Yes / No 경로는 유지됩니다.
푸시 메시지
- 푸시 메시지 노드는 사용자 여정 흐름 안에서 특정 시점의 사용자에게 푸시 메시지를 발송하는 액션 노드입니다.
- 발송 플랫폼, 메시지 내용 등 발송 항목은 기존 푸시 메시지와 동일하게 적용합니다.
- 사용자 여정의 푸시 메시지 노드는 발송 시점과 흐름의 연결 관계를 중심으로 동작합니다.
여정 기반 발송 처리
- 푸시 메시지는 독립적으로 발송되는 캠페인이 아니라, 사용자가 해당 노드에 도달한 시점에 실행되는 여정 내 액션입니다.
- 발송 시점이 여정 종료 또는 만료 시점과 일치하는 경우에는, 푸시를 발송하지 않고 여정 종료 또는 만료를 우선 처리합니다.
발송 제외 시간 설정
- 발송 제외 시간 설정을 사용하는 경우, 발송 시점이 제외 시간대에 해당하면 보류 발송하거나 발송을 취소할 수 있습니다.
- 발송 보류 중 여정 종료 또는 만료 시각에 도달하면 해당 푸시는 발송되지 않습니다.
- 발송 제외 시간을 설정하여 사용자가 푸시 메시지를 수신하지 않는 방해 금지 시간대를 설정합니다.
- 발송 제외 시간대 : 시작시간과 종료시간이 같을 경우, 모든 시간에 푸시 메시지를 발송합니다.
- 발송 제외 시간 메시지 처리 : 발송 취소된 푸시 메시지 노드는 Yes 경로로 생략(Skip)되며(마지막 단계인 경우, 여정 종료) 전환이 집계되지 않습니다.
모든 날짜 설정은 한국 표준시 KST(UTC+9)를 기준으로 합니다.
실패 및 다음 노드 진행
- 푸시 메시지 노드는 발송 결과에 따라 성공/실패 경로로 다음 노드를 분기할 수 있습니다.
- FCM 발송 실패 시에는 2회 재시도하며, 재시도 후에도 실패하면 실패로 분기됩니다.
- 토큰 만료 시에는, 재시도하지 않고 해당 토큰을 무효 처리합니다.
- 실패(FAIL) 경로가 정의되지 않은 경우 여정을 종료합니다.
인앱 메시지
- 인앱 메시지 노드는 사용자 여정 흐름 안에서 특정 조건을 만족한 사용자에게 인앱 메시지를 노출하는 액션 노드입니다.
- 템플릿 선택, 프레임 설정, 콘텐츠 편집 등 설정 항목은 기존 인앱 메시지와 동일하게 적용합니다.
- 사용자 여정 내, 인앱 메시지 노드의 캠페인 설정값은 고정 항목입니다.(아래 표 참고)
| 항목 | 비고 |
|---|---|
| 노출 조건 | 즉시 노출합니다. |
| 노출 기간 | 여정 운영 기간과 동일합니다. |
| 반복 노출 여부 | 1회만 노출합니다. |
| 노출 우선 순위 | 최상 고정입니다.
기존 인앱 메시지와 노출 타이밍이 중복되는 경우, 사용자 여정 인앱 메시지를 우선 노출합니다. |
여정 기반 노출 처리
- 인앱 메시지는 사용자가 해당 노드에 도달한 이후, 즉시 노출됩니다.
- 노출 시점이 여정 종료 또는 만료 시점과 완전히 일치하는 경우에는, 인앱 메시지를 노출하지 않고 여정 종료 또는 만료를 우선 처리합니다.
- 기존 인앱 메시지와 노출 조건이 중복되는 경우에는 사용자 여정의 인앱 메시지를 우선 노출합니다.
- 여러 사용자 여정 간 인앱 메시지 노출 조건이 중복되는 경우에는 최신 사용자 여정의 인앱 메시지를 우선 노출합니다.
다음 노드 진행
- 설정한 인앱 메시지가 노출된 이후 다음 노드로 진행합니다.
- 사용자가 해당 노드에 도달했더라도 앱에 접속하지 않아 즉시 노출이 불가능한 경우에는 노출 가능한 시점(앱에 접속)까지 대기합니다.
- 노출 기간이 종료될 때까지 앱 접속이 발생하지 않으면 인앱 메시지는 노출되지 않습니다.
A/B 테스트
- 사용자를 여러 그룹으로 나누어 서로 다른 경로로 분기가 가능합니다.
- 그룹별 성과를 비교/확인할 수 있도록 지원하는 노드입니다.
- 그룹은 최대 5개까지 설정 가능하며, 최소 1% 이상의 가중치가 존재해야 합니다.
테스트 그룹
- 테스트 그룹은 최소 2개부터 최대 5개까지 설정할 수 있습니다.
- 각 그룹의 비율은 정수로만 지정 가능하며, 전체 합계는 반드시 100%여야 합니다.
- 모든 그룹 경로는 연결되어 있어야 합니다.
- 여정 활성화 이후에는 그룹 비율을 수정할 수 없습니다.
- 재진입이 허용된 여정에서는 동일 사용자가 다시 A/B 테스트에 진입 시, 기존 배정된 그룹을 유지합니다.