컨텍스트

컨텍스트 단계를 사용하면 사용자가 캔버스를 이동할 때 하나 이상의 변수를 생성하고 업데이트할 수 있습니다. 예를 들어, 시즌별 할인을 관리하는 캔버스가 있는 경우 컨텍스트 변수를 사용하여 사용자가 캔버스에 들어갈 때마다 다른 할인 코드를 저장할 수 있습니다.

작동 방식

컨텍스트 단계를 사용하면 사용자가 특정 캔버스를 통과하는 동안 임시 데이터를 생성하고 사용할 수 있습니다. 이 데이터는 해당 캔버스 여정 내에서만 존재하며 다른 캔버스나 세션 외부에 지속되지 않습니다.

컨텍스트 변수는 특정 캔버스 여정에 대해서만 존재합니다. 사용자의 프로필은 영구적으로 변경되지 않으며 다른 캔버스에도 표시되지 않습니다. 따라서 특정 캠페인이나 워크플로에만 관련된 임시 정보에 이상적입니다.

컨텍스트 단계에서는 최대 10개의 컨텍스트 변수를 정의하거나 업데이트할 수 있습니다. 이러한 변수를 사용하여 지연을 개인화하고, 사용자를 동적으로 세분화하고, 캔버스 전체에서 메시징을 강화할 수 있습니다. 예를 들어 사용자의 예정된 비행 시간에 대한 컨텍스트 변수를 만든 다음 이를 사용하여 개인화된 지연을 설정하고 미리 알림을 보낼 수 있습니다.

컨텍스트 변수는 두 가지 방법으로 설정할 수 있습니다:

• 캔버스 항목에서: 이벤트 또는 API 트리거의 데이터가 컨텍스트 변수를 자동으로 채울 수 있습니다.
• 컨텍스트에서 단계: 컨텍스트 단계를 추가하여 컨텍스트 변수를 수동으로 정의하거나 업데이트합니다.

각 컨텍스트 변수에는 이름, 데이터 유형, 값(Liquid 또는 개인화 추가 도구를 사용하여 설정)이 필요합니다. 정의되면 Liquid를 사용하여 캔버스 전체에서 컨텍스트 변수를 참조할 수 있습니다(예: {{context.${flight_time}}}).

각 캔버스 항목은 최신 항목 데이터와 캔버스 설정을 기반으로 컨텍스트 변수를 재정의하여 사용자가 각자의 컨텍스트에 따라 여러 개의 활성 여정을 가질 수 있도록 합니다. 예를 들어, 고객에게 예정된 항공편이 두 개 있는 경우 출발 시간 및 대상과 같은 항공편별 컨텍스트 변수가 있는 두 개의 개별 여정 상태를 동시에 실행할 수 있습니다. 이를 통해 오후 2시 뉴욕행 항공편에 대한 개인화된 알림을 보내는 동시에 내일 오전 8시 로스앤젤레스행 항공편에 대한 다른 업데이트를 전송하여 각 메시지가 특정 예약과 관련성을 유지하도록 할 수 있습니다.

사용자 처리 및 일괄 처리

컨텍스트 단계는 사용자를 일괄 처리하여 성능/성과를 최적화합니다. 사용자가 컨텍스트 단계를 입력하면 기본값으로 1,000명 단위로 일괄 처리합니다. 이러한 배치는 병렬로 처리되지만 각 배치 내에서 사용자는 순차적으로 처리됩니다.

즉,

예시: 3,500명의 사용자가 연결된 콘텐츠로 컨텍스트 단계에 진입하는 경우 사용자당 650ms가 소요됩니다:

• Braze는 4개의 사용자 배치(이 예에서는 1,000명, 1,000명, 1,000명, 500명의 사용자)를 생성합니다.
• 각 배치는 사용자를 순차적으로 처리하므로 1,000명의 사용자를 배치하는 데 약 10.8분(650초, 1,000×650ms)이 걸립니다.
• 배치는 서로 다른 시간에 완료되므로 사용자는 배치가 완료되면 다음 단계로 넘어갑니다.
• 배치 크기와 연결된 콘텐츠 응답 시간에 따라 첫 번째 사용자가 마지막 사용자보다 몇 분 먼저 다음 단계에 도달할 수 있습니다.

연결된 콘텐츠가 없으면 대기할 외부 API 호출이 없기 때문에 컨텍스트 단계가 훨씬 빠르게 처리됩니다.

고려 사항

• 컨텍스트 단계당 최대 10개의 컨텍스트 변수를 정의할 수 있습니다.
• 각 변수에는 고유한 이름(문자, 숫자, 밑줄만 가능, 최대 100자)이 필요합니다.
• 한 단계에 포함된 모든 변수의 총 크기는 50KB를 초과할 수 없습니다.
• API 트리거를 사용하여 전달된 변수는 컨텍스트 단계에서 생성된 변수와 동일한 네임스페이스를 공유하며, 컨텍스트 단계에서 변수를 재정의하면 API 값이 재정의됩니다.

자세한 내용과 진행 방법은 컨텍스트 변수 참조를 참조하세요.

컨텍스트 만들기 단계

1단계: 단계 추가

캔버스에 단계를 추가한 다음 사이드바에서 구성 요소를 끌어다 놓거나 더하기 버튼을 선택하고 컨텍스트를 선택합니다.

2단계: 변수 정의

컨텍스트 변수를 정의합니다:

1. 컨텍스트 변수에 이름을 지정합니다.
2. 데이터 유형을 선택합니다.
3. Liquid 표현식을 수동으로 작성하거나 개인화 추가를 사용하여 기존 속성에서 Liquid 스니펫을 만듭니다.
4. 미리 보기를 선택하여 컨텍스트 변수 값을 확인합니다.
5. (선택 사항) 변수를 추가하려면 컨텍스트 변수 추가를 선택하고 1~4단계를 반복합니다.
6. 완료했으면 완료를 선택합니다.

이제 메시지 및 사용자 업데이트 단계 등 Liquid를 사용하는 모든 곳에서 개인화 추가를 선택하여 컨텍스트 변수를 사용할 수 있습니다. 전체 안내는 컨텍스트 변수 참조를 참조하세요.

컨텍스트 변수 필터

오디언스 경로 및 결정 분할 단계에서 컨텍스트 변수를 사용하여 필터를 만들 수 있습니다. 필터 설정, 비교 로직 및 진행 예제는 컨텍스트 변수 참조를 참조하세요.

사용자 경로 미리보기

사용자 경로를 테스트하고 미리 확인하여 메시지가 올바른 오디언스에게 전송되고 컨텍스트 변수가 예상 결과에 맞게 평가되는지 확인하는 것이 좋습니다.

잘못된 컨텍스트 변수를 생성하는 일반적인 시나리오를 관찰하세요. 사용자 경로를 미리 볼 때 컨텍스트 변수를 사용하여 개인화된 지연 단계의 결과와 사용자를 컨텍스트 변수와 일치시키는 모든 오디언스 또는 의사 결정 단계 비교를 볼 수 있습니다.

컨텍스트 변수가 유효하면 캔버스 전체에서 해당 변수를 참조할 수 있습니다. 그러나 컨텍스트 변수가 올바르게 생성되지 않은 경우 캔버스의 향후 단계도 올바르게 수행되지 않습니다. 예를 들어 사용자에게 약속 시간을 할당하는 컨텍스트 단계를 만들고 약속 시간의 값을 과거 날짜로 설정하면 메시지 단계의 리마인더 이메일이 전송되지 않습니다.

연결된 콘텐츠 문자열을 JSON으로 변환하기

컨텍스트 단계에서 연결된 콘텐츠를 호출할 때 일관성 및 오류 방지를 위해 호출에서 반환되는 JSON은 문자열 데이터 유형으로 평가됩니다. 이 문자열을 JSON으로 변환하려면 as_json_string 을 사용하여 변환합니다. For example:

1
2
{% connected_content http://example.com :save product %}
{{ product | as_json_string }}

문제 해결

잘못된 컨텍스트 변수

컨텍스트 변수는 다음과 같은 경우 유효하지 않은 것으로 간주됩니다:

• 임베디드 커넥티드 콘텐츠에 대한 호출이 실패합니다.
• 런타임에 Liquid 표현식은 데이터 유형과 일치하지 않거나 비어 있는 값(null)을 반환합니다.

예를 들어 컨텍스트 변수 데이터 유형이 숫자이지만 Liquid 표현식이 문자열을 반환하는 경우 유효하지 않습니다.

이런 상황에서는

• 사용자가 다음 단계로 진행합니다.
• 캔버스 단계 분석에서는 이를 업데이트되지 않음으로 계산합니다.

문제를 해결할 때 업데이트되지 않음 메트릭을 모니터링하여 컨텍스트 변수가 올바르게 업데이트되고 있는지 확인하세요. 컨텍스트 변수가 유효하지 않은 경우 사용자는 컨텍스트 단계를 지나 캔버스에서 계속 진행할 수 있지만 이후 단계에서는 자격을 얻지 못할 수 있습니다.

각 데이터 유형에 대한 설정 예는 데이터 유형을 참조하세요.

연결된 콘텐츠로 전송이 지연됨

일괄 처리된 모든 사용자는 사용자가 진행하기 전에 처리됩니다. 일괄 처리가 완료되면 성공한 사용자는 다음 단계로 이동하고 실패한 사용자는 개별적으로 재시도하며, 성공한 사용자는 재시도가 성공할 때까지 기다리지 않고 진행합니다.

동작을 다시 시도합니다: 컨텍스트 단계(및 모든 캔버스 단계)는 표준 연결된 콘텐츠 재시도 동작이 아닌 캔버스별 재시도 메커니즘을 사용합니다. 연결된 콘텐츠 호출이 실패하면 Braze는 지수 백오프를 사용하여 약 13번 단계를 다시 시도합니다. 모든 재시도가 실패하면 사용자는 캔버스를 종료합니다.

처리 시간: 컨텍스트 단계를 통해 모든 사용자를 처리하는 데 걸리는 시간은 상황에 따라 다릅니다:

• 단계에 진입하는 사용자 수
• 연결된 콘텐츠 사용 여부(및 응답 시간)
• 배치 크기(기본값은 배치당 1,000명의 사용자)

연결된 콘텐츠 엔드포인트에 속도 제한이 있는 경우 컨텍스트 단계가 각 배치 내에서 사용자를 순차적으로 처리하므로 속도 제한을 자연스럽게 준수할 수 있습니다. 그러나 여러 배치가 병렬로 처리되므로 엔드포인트가 여러 배치의 동시 요청을 처리할 수 있는지 확인해야 합니다.

시간대 일관성 표준화

타임스탬프 유형을 사용하는 대부분의 이벤트 속성정보는 캔버스에서 이미 UTC로 표시되지만, 몇 가지 예외가 있습니다. 캔버스 컨텍스트가 추가됨에 따라 액션 기반 캔버스의 모든 기본값 타임스탬프 이벤트 속성정보는 UTC로 표시됩니다. 이러한 변화는 캔버스 단계와 메시지를 편집할 때 보다 예측 가능하고 일관된 경험을 보장하기 위한 광범위한 노력의 일환입니다. 이 변경 사항은 특정 캔버스가 컨텍스트 단계를 사용 중인지 여부에 관계없이 모든 액션 기반 캔버스에 영향을 줍니다.

Frequently asked questions

캔버스 컨텍스트가 일반 사용 가능해지면 어떤 변화가 있나요?

캔버스 컨텍스트가 일반적으로 사용 가능해지면 다음과 같은 세부 사항이 적용됩니다:

• 액션 기반 캔버스의 트리거 이벤트 속성정보에서 날짜/시간 유형이 UTC인 모든 타임스탬프는 UTC 기준입니다.
• 이 변경 사항은 특정 캔버스가 컨텍스트 단계를 사용하고 있는지 여부에 관계없이 모든 액션 기반 캔버스에 영향을 줍니다.

이러한 변경의 이유는 무엇인가요?

이러한 변화는 캔버스 단계와 메시지를 편집할 때 보다 예측 가능하고 일관된 경험을 제공하기 위한 광범위한 노력의 일환입니다.

이 변경 사항은 언제부터 적용되나요?

• 캔버스 컨텍스트 얼리 액세스에 참여 중인 경우 이 변경 사항이 이미 적용되었습니다.
• 캔버스 컨텍스트 미리 맛보기에 참여하지 않는 경우, 이 변경 사항은 미리 맛보기에 참여하거나 캔버스 컨텍스트가 정식 버전으로 출시되는 시점에 적용됩니다.

API 트리거 또는 예약된 캔버스가 이 변경의 영향을 받나요?

아니요.

이 변경 사항이 캔버스 항목 속성에 영향을 주나요?

예, canvas_entry_property 이 액션 기반 캔버스에서 사용 중이고 속성 유형이 time 인 경우 canvas_entry_properties 에 영향을 미칩니다. 모든 상황에서 원하는 시간대에 타임스탬프를 표시하려면 Liquid time_zone 필터를 사용하는 것이 좋습니다.

다음은 이를 수행하는 방법의 예입니다:

새로운 타임스탬프 동작이 메시징에 어떤 영향을 미칠 수 있는지에 대한 실제적인 예는 무엇인가요?

메시지 단계에 다음과 같은 콘텐츠가 있는 액션 기반 캔버스가 있다고 가정해 보겠습니다:

1
Your appointment is scheduled for {{canvas_entry_properties.${appointment_time} | date: "%Y-%m-%d %l:%M %p"}}, we'll see you then!

그러면 다음과 같은 메시징이 표시됩니다:

1
Your appointment is scheduled for 2025-08-05 4:15pm, we’ll see you then!

Liquid를 사용하여 시간대를 지정하지 않았으므로 여기서의 타임스탬프는 UTC 기준입니다.

시간대를 명확하게 지정하려면 다음과 같이 Liquid time_zone 필터를 사용할 수 있습니다:

1
Your appointment is scheduled for {{canvas_entry_properties.${appointment_time} | time_zone: "America/Los_Angeles" | date: "%Y-%m-%d %l:%M %p"}}, we'll see you then!

그러면 다음과 같은 메시징이 표시됩니다:

1
Your appointment is scheduled for 2025-08-05 8:15am, we'll see you then!

미국/로스앤젤레스 시간대는 Liquid를 사용하여 지정되므로 여기서의 타임스탬프는 태평양 표준시(PST)입니다.

선호하는 시간대는 이벤트 속성정보 페이로드에 전송되어 Liquid 로직에서 사용될 수도 있습니다:

1
2
3
4
{
  "appointment_time": "2025-08-05T08:15:30:250-0800"
  "user_timezone": "America/Los_Angeles"
}

컨텍스트 변수는 캔버스 항목 속성과 어떻게 다릅니까?

컨텍스트 단계 얼리 액세스에 참여 중인 경우 이제 캔버스 항목 속성이 캔버스 컨텍스트 변수로 포함됩니다. 즉, Liquid 스니펫에서 컨텍스트 변수를 사용하는 것과 유사하게 Braze API를 사용하여 캔버스 항목 속성을 전송하고 다른 단계에서 참조할 수 있습니다.

단일 컨텍스트 단계에서 변수가 서로를 참조할 수 있나요?

예. 컨텍스트 단계의 모든 변수는 순서대로 평가되므로 다음과 같은 컨텍스트 변수를 설정할 수 있습니다:

이는 여러 컨텍스트 단계에도 적용됩니다. 예를 들어 다음 시퀀스를 상상해 보세요:

1. 초기 컨텍스트 단계는 job_title 값으로 JobInfo 라는 변수를 만듭니다.
2. 메시지 단계는 {{context.${JobInfo}}} 을 참조하고 사용자에게 job_title 을 표시합니다.
3. 나중에 컨텍스트 단계에서 컨텍스트 변수를 업데이트하여 JobInfo 의 값을 job_description 으로 변경합니다.
4. JobInfo 을 참조하는 모든 후속 단계는 이제 업데이트된 값 job_description 을 사용합니다.

컨텍스트 변수는 캔버스 전체에서 가장 최근 값을 사용하며, 업데이트할 때마다 해당 변수를 참조하는 모든 다음 단계에 영향을 줍니다.