Skip to content

지연

지연 구성요소를 사용하면 Canvas에 독립적인 지연을 추가할 수 있습니다. 관련 메시지를 추가하지 않고도 Canvas에 지연을 추가할 수 있습니다.

지연을 사용하면 Canvas를 더 깔끔하게 만들 수 있습니다. 또한 이 구성요소를 사용하여 정확한 날짜, 특정 날짜 또는 특정 요일까지 다른 단계를 지연시킬 수 있습니다. 지연 구성요소는 최대 하나의 후속 단계에 연결할 수 있습니다.
Canvas의 첫 번째 단계로 1일 지연이 설정된 지연 단계.

지연 만들기

지연을 만들려면 Canvas에 단계를 추가하세요. 사이드바에서 지연 구성 요소를 드래그 앤 드롭하거나, 단계 하단의 플러스 버튼을 선택한 다음 지연을 선택하세요.

연장된 지연

지연 단계를 최대 2년(730일)까지 연장할 수 있습니다. 예를 들어, 앱에 신규 사용자를 온보딩하는 경우, 세션을 시작하지 않은 사용자에게 메시지 단계를 보내기 전에 2개월의 연장된 지연을 추가할 수 있습니다.

시간 지연 유형

Canvas에서 다음 메시지 전에 지연 유형을 선택할 수 있습니다. 지정된 기간이 지난 후까지 사용자를 지연시키거나, 특정 날짜와 시간까지 사용자를 지연시킬 수 있습니다.

시간 지연이 있는 경우, 일부 사용자는 지연 후에만 Canvas의 다음 단계로 진행하게 됩니다. 지연 중인 사용자는 다음 단계로 진행 측정기준에 추가되지 않습니다. 자세한 내용은 지연 분석을 참조하세요.

기간을 선택하면 사용자를 설정된 초, 분, 시간, 일 또는 주 동안, 그리고 특정 시간에 지연시킬 수 있습니다. 예를 들어, 사용자를 4시간 또는 1일 동안 지연시킬 수 있습니다.

“일”과 “캘린더 일”의 계산 방식 차이에 유의하세요.

  • “일”은 24시간이며, 사용자가 지연 단계에 진입한 시점부터 계산됩니다.
  • “캘린더 일”은 다음 지정된 시간까지 대기할 시간을 정의하며, 24시간 미만일 수 있습니다. 회사 시간 또는 사용자의 현지 시간으로 지연을 선택할 수 있습니다. 시간이 지정되지 않으면, 사용자는 회사 시간 기준으로 다음 날 자정까지 지연됩니다.

지연 동작: 특정 시간의 “캘린더 일” vs “일”

캘린더 일을 단위로 선택하고 특정 시간에를 활성화하면(예: 1 캘린더 일, 오전 9시), Canvas는 먼저 대상 캘린더 날짜를 계산한 다음 예약된 시간을 적용합니다. 예를 들어, 캔버스 단계가 월요일 오후 9시에 전송되고 지연 단계가 1 캘린더 일, 오전 9시로 설정된 경우, 다음 단계는 화요일 오전 9시에 전송됩니다. Canvas는 월요일 + 1 캘린더 일 = 화요일을 계산한 다음 오전 9시를 적용합니다.

반면, 을 단위로 선택하고 특정 시간에를 사용하지 않으면(예: 1일 후), Canvas는 사용자가 지연 단계에 진입한 시점부터 24시간을 대기합니다. 예를 들어, 단계가 10월 13일 오전 9시 35분에 전송되고 지연 단계가 1일 후인 경우, 다음 단계는 10월 14일 오전 9시 35분에 전송됩니다.

특정 시간에를 선택하여 사용자가 Canvas에서 진행하는 시점을 지정할 수도 있습니다. 이 옵션은 사용자가 지연 단계에 진입한 시간을 고려합니다. 이 시간이 설정에서 구성된 시간을 초과하면, Braze는 지연에 추가 시간을 더합니다.

예를 들어, 오늘이 12월 11일이고 지연 단계가 기간 1주, UTC 오전 8시로 설정되어 있다고 가정합니다. 사용자가 12월 4일에 지연 단계에 진입한 경우, 원래 UTC 오전 8시 이전에 지연 단계에 진입했다면 오늘 지연 단계에서 해제되어 여정을 계속합니다. 이 시간 이후에 지연 단계에 진입한 경우, 사용자는 다음 날(이 시간의 다음 발생 시점)까지 지연됩니다.

캘린더 날짜를 선택하면 사용자를 특정 날짜와 시간까지 해당 단계에 유지할 수 있습니다.

고려 사항

사용자는 지난 날짜의 단계나 메시지를 받지 않습니다

선택한 날짜와 시간이 사용자가 지연 단계에 도달하는 시점에 이미 지난 경우, 사용자는 Canvas를 종료합니다. Canvas 시작과 “정확한 날짜까지 대기” 단계에 선택된 날짜 사이에는 최대 31일이 있을 수 있습니다.

예를 들어, 다음 시나리오에서 사용자는 단계나 메시지를 받지 않습니다:

  • 메시지가 5월 3일 오후 9시에 전송되도록 예약되었지만, 지연 단계가 5월 3일 오전 9시에 만료됩니다.
  • 캔버스 단계가 사용자의 현지 시간대의 특정 시간까지 지연되지만, 사용자의 고객 프로필에 시간대가 설정되어 있지 않습니다. 이 경우 지연은 해당 사용자에 대해 회사 시간대를 기본값으로 사용하며, 이미 지정된 시간이 지났습니다.

후속 지연 단계가 이전 지연 단계의 타임라인 내에 있으면 사용자가 종료됩니다

Canvas에 두 개의 지연 단계가 있지만 첫 번째 지연 단계가 두 번째 지연 단계보다 긴 경우, 사용자도 Canvas를 종료합니다.

예를 들어, Canvas에 다음 단계가 있다고 가정합니다:

  • 단계 1: 메시지 단계
  • 단계 2: 12월 13일 오후 10시까지 지연 단계
  • 단계 3: 메시지 단계
  • 단계 4: 12월 13일 오후 7시까지 지연 단계
  • 단계 5: 메시지 단계

단계 4에 진입한 사용자는 단계 4의 지연이 단계 2의 타임프레임에 포함되기 때문에 단계 5를 받기 전에 Canvas를 종료합니다.

요일을 선택하면 사용자를 특정 요일의 특정 시간까지 해당 단계에 유지할 수 있습니다. 예를 들어, 회사 시간대 기준으로 다음 목요일 오후 4시까지 사용자를 지연시킬 수 있습니다.

이를 성공적으로 구성하려면, 사용자가 선택한 요일(예: 목요일)에 지정된 시간 이후에 Canvas에 진입하는 경우 어떻게 할지도 선택해야 합니다. 같은 날에 사용자를 진행시키거나 다음 주까지 유지하도록 선택할 수 있습니다.

지연 중 프로필 업데이트

사용자가 Canvas에 진입하고 지연 단계가 끝나기 전에 유효한 이메일 주소를 추가하면, 다음 단계에서 이메일을 받게 됩니다. 이는 다른 프로필 업데이트에도 적용됩니다. 지연 중 사용자 속성이나 연락처 정보에 대한 변경 사항은 사용자가 후속 단계로 진행할 때 반영됩니다.

지연 단계 사용하기

6월 10일이라고 가정해 보겠습니다. 6월 11일에 사용자가 Canvas에 진입하여 다가오는 프로모션에 대한 메시지를 받도록 하고 싶습니다. 그런 다음 6월 17일 오후 3시(현지 시간)까지 사용자를 Canvas에 유지하려고 합니다. 6월 17일 현지 시간 오후 3시에 사용자에게 프로모션에 대한 리마인더 메시지를 보내려고 합니다.

Canvas 단계의 순서는 다음과 같을 수 있습니다:

  1. 먼저 6월 11일에 사용자가 Canvas에 진입한 직후 전송되는 메시지 단계를 추가합니다.
  2. 6월 17일 현지 시간 오후 1시까지 사용자를 유지하는 지연 단계를 만듭니다.
  3. 지연 단계를 메시지를 즉시 전송하는 또 다른 메시지 단계에 연결합니다.

Canvas 끝에 있는 지연 구성 요소

Canvas에 지연 구성 요소를 추가했는데 이후 단계가 없는 경우, 마지막 단계에 도달한 모든 사용자는 자동으로 Canvas에서 나가게 됩니다. 이는 지연 단계의 시간에 아직 도달하지 않았더라도 마찬가지입니다. 즉, 이미 지연 단계에 도달한 사용자는 이 단계 이후에 추가하는 메시지를 받지 못합니다. 그러나 사용자가 아직 지연 단계에 도달하지 않았고 메시지가 추가된 경우에는 해당 메시지를 받게 됩니다.

개인화된 지연

개인화 지연 토글을 선택하여 사용자에 대한 개인화된 지연을 설정합니다. 컨텍스트 단계와 함께 사용하여 지연에 사용할 컨텍스트 변수를 선택할 수 있습니다. 이렇게 하면 선택한 속성 또는 속성정보에 설정된 시간이 재정의됩니다. 이 기능은 일 또는 주 단위로 오프셋을 적용하면서 사용자가 특정 시간에 다음 단계로 이동하도록 하려는 경우에 유용합니다. 시간대는 속성 또는 속성정보에서 가져오며, 사용할 수 없는 경우 대체 시간대를 사용합니다.

“특정 시간에”의 시간대 동작

특정 시간에 옵션으로 개인화된 지연을 구성할 때, 시간대 동작은 속성 또는 컨텍스트 변수의 데이터 유형에 따라 달라집니다:

  • 시간대가 포함된 문자열 데이터 유형: 속성 또는 컨텍스트 변수가 시간대 정보를 포함하는 문자열 데이터 유형인 경우, 문자열에 지정된 시간대를 따릅니다. 예를 들어, 2025-06-10T10:00:00-08:00은 UTC-8을 사용합니다.
  • 시간대가 없는 문자열 데이터 유형: 속성 또는 컨텍스트 변수가 시간대 정보가 없는 문자열 데이터 유형인 경우, 대체 시간대를 따릅니다. 예를 들어, 2025-06-10은 대체 시간대를 사용합니다.
  • 시간 데이터 유형: 속성 또는 컨텍스트 변수가 시간 데이터 유형인 경우, UTC를 따릅니다. 이는 시간 데이터 유형이 데이터베이스에 저장될 때 항상 UTC로 변환되기 때문이며, 따라서 변수가 시간 데이터 유형으로 설정된 경우 “특정 시간에”는 항상 UTC를 기준으로 합니다. 예를 들어, 2025-06-10T10:00:00-08:00은 UTC+0을 사용합니다.

사용 사례

지금으로부터 30일 후에 고객에게 치약 구매를 리마인드하고 싶다고 가정해 보겠습니다. 컨텍스트 단계와 지연 단계의 조합을 사용하여 지연에 사용할 컨텍스트 변수를 선택할 수 있습니다. 이 경우 컨텍스트 단계에는 다음 필드가 포함됩니다:

  • 컨텍스트 변수 이름: product_reminder_interval
  • 데이터 유형: Time
  • 값: {{custom_attribute.${Order_filled_time}}}

product_reminder_interval 컨텍스트 변수와 해당 값.

다음으로, 지금으로부터 30일 후에 고객에게 리마인드하려면 지연 옵션으로 특정 날짜까지를 선택하고 개인화 지연을 선택하여 컨텍스트 단계의 정보를 사용합니다. 이렇게 하면 사용자는 선택한 컨텍스트 변수까지 지연됩니다.

지연 분석

지연 구성 요소는 활성 또는 이전에 활성이었던 Canvas의 분석 보기에서 다음 측정기준을 사용할 수 있습니다.

측정기준 설명
진입 해당 단계에 진입한 횟수를 나타냅니다. Canvas에 재적격성이 있고 사용자가 지연 단계에 두 번 진입한 경우, 두 건의 진입이 기록됩니다.
다음 단계로 진행 Canvas의 다음 단계로 진행한 진입 수를 나타냅니다.
Canvas 종료 Canvas를 종료하고 다음 단계로 진행하지 않은 진입 수를 나타냅니다.
개인화 실패 다음과 같은 이유로 사용자에게 의도된 개인화된 메시지 또는 콘텐츠를 전달할 수 없었던 횟수를 나타냅니다:
  • 지연 값이 과거 시점임
  • 지연 값이 미래 2년 이상임
  • 기간 이후 값이 숫자가 아님
  • 특정 날짜까지 값이 날짜 또는 날짜 형식의 문자열이 아님

자세한 내용은 개인화 실패 오류를 참조하세요.

이러한 분석의 시계열은 확장된 구성 요소 보기에서 확인할 수 있습니다.

문제 해결

개인화 실패 오류

사용자가 개인화된 지연을 트리거하지 않는 경우, 지연 단계에 대한 자격을 부여하도록 설정한 컨텍스트 단계가 예상대로 작동하지 않기 때문일 수 있습니다. 컨텍스트 변수가 유효하지 않은 경우, 사용자는 컨텍스트 단계에서 컨텍스트가 설정되지 않은 채로 Canvas를 계속 진행합니다. 이로 인해 개인화된 지연과 같은 Canvas의 이후 단계에 대한 자격을 충족하지 못할 수 있습니다.

문제 해결

Canvas가 중지되었을 때 지연 단계에 있는 사용자

Canvas를 중지하면, 이미 지연 단계에서 대기 중인 사용자는 즉시 종료되지 않습니다. Braze는 여전히 지연 완료를 스케줄하지만, Canvas가 중지된 동안에는 추가 메시지가 전송되지 않습니다.

사용자의 지연이 경과하기 전에 Canvas를 다시 활성화하면, 해당 사용자는 스케줄대로 다음 단계로 진행할 수 있습니다. Canvas가 중지된 동안 지연 기간이 이미 경과한 경우, 해당 사용자는 다음 단계를 수신하는 대신 Canvas에서 종료됩니다. 예시는 Canvas를 중지하면 어떻게 되나요?Canvases 중지를 참조하세요.

New Stuff!