컨텍스트 및 이벤트 속성정보
이 참조 문서에서는
context와event_properties에 대한 정보를 다루며, 각 속성정보를 사용해야 하는 시점과 동작의 차이점을 설명합니다.
커스텀 이벤트 속성정보에 대한 일반적인 정보는 커스텀 이벤트 속성정보를 확인하세요.
Canvas 진입 등록정보는 Canvas 컨텍스트 변수의 일부입니다. 이는 canvas_entry_properties가 context로 참조됨을 의미합니다. 각 context 변수에는 이름, 데이터 유형, Liquid를 포함할 수 있는 값이 포함됩니다. 현재 canvas_entry_properties는 이전 버전과 호환됩니다. 자세한 내용은 컨텍스트 및 Canvas 컨텍스트 오브젝트를 참조하세요.
컨텍스트 속성정보와 이벤트 속성정보는 캔버스 워크플로 내에서 서로 다르게 작동합니다. 사용자의 캔버스 진입을 트리거하는 이벤트 또는 API 호출의 속성정보를 context라고 합니다. 사용자가 캔버스 여정 내에서 이동할 때 발생하는 이벤트의 속성정보를 event_properties라고 합니다. 핵심 차이점은 context가 단순히 이벤트뿐만 아니라 API 트리거 캔버스의 진입 페이로드 속성정보에도 접근할 수 있다는 것입니다.
컨텍스트와 이벤트 속성정보의 차이점 요약은 다음 표를 참조하세요.
| 컨텍스트 속성정보 | 이벤트 속성정보 | |
|---|---|---|
| Liquid | context |
event_properties |
| 지속성 | 캔버스 기간 동안 모든 메시지 단계에서 참조할 수 있습니다. | - 한 번만 참조할 수 있습니다. - 이후 메시지 단계에서는 참조할 수 없습니다. |
| 캔버스 동작 | 캔버스의 모든 단계에서 context를 참조할 수 있습니다. 시작 후 동작에 대해서는 시작 후 캔버스 편집을 참조하세요. |
- 행동 경로 단계 이후 첫 번째 메시지 단계에서 event_properties를 참조할 수 있으며, 수행된 동작이 커스텀 이벤트 또는 구매 이벤트인 경우에 해당합니다. - 행동 경로 단계의 다른 모든 사용자 경로 이후에는 사용할 수 없습니다. - 행동 경로와 메시지 단계 사이에 다른 비메시지 구성요소가 있을 수 있습니다. 이러한 비메시지 구성요소 중 하나가 행동 경로 단계인 경우, 사용자는 해당 행동 경로의 다른 모든 사용자 경로를 통과할 수 있습니다. |
기존 캔버스 편집기 세부 정보
더 이상 기존 편집기를 사용하여 캔버스를 생성하거나 복제할 수 없습니다. 캔버스 컨텍스트는 기존 캔버스 편집기에서 지원되지 않으므로, 이 섹션은 이전 캔버스 워크플로에서 캔버스 진입 속성정보와 이벤트 속성정보를 사용할 때 참조용으로 제공됩니다.
캔버스 진입 속성정보:
- 영구 진입 속성정보가 활성화되어 있어야 합니다.
- 캔버스의 첫 번째 전체 단계에서만
canvas_entry_properties를 참조할 수 있습니다. 캔버스는 실행 기반 또는 API 트리거 방식이어야 합니다.
진입 속성정보:
- 캔버스에서 실행 기반 전달을 사용하는 모든 전체 단계에서
event_properties를 참조할 수 있습니다. - 실행 기반 캔버스의 첫 번째 전체 단계를 제외한 스케줄된 전체 단계에서는 사용할 수 없습니다. 그러나 사용자가 캔버스 구성요소를 사용하는 경우, 동작은
event_properties에 대한 현재 캔버스 워크플로 규칙을 따릅니다.
이벤트 속성정보:
- 첫 번째 메시지 단계에서는
event_properties를 사용할 수 없습니다. 대신canvas_entry_properties를 사용하거나event_properties를 포함하는 메시지 단계 이전에 해당 이벤트가 포함된 행동 경로 단계를 추가해야 합니다.
알아두어야 할 사항
- 컨텍스트는 Liquid에서 참조할 때만 사용할 수 있습니다. 캔버스 내에서 속성정보를 기준으로 필터링하려면 이벤트 속성정보 세분화를 대신 사용하세요.
- 인앱 메시지 채널의 경우, 캔버스에서
context와event_properties를 참조할 수 있습니다.event_properties는 트리거 기반이므로 첫 번째 캔버스 단계에 포함된 경우 접근할 수 있습니다. - 첫 번째 메시지 단계에서는
event_properties를 사용할 수 없습니다. 대신context를 사용하거나event_properties를 포함하는 메시지 단계 이전에 해당 이벤트가 포함된 행동 경로 단계를 추가할 수 있습니다. - 행동 경로 단계에 “SMS 인바운드 메시지 전송” 또는 “WhatsApp 인바운드 메시지 전송” 트리거가 포함된 경우, 후속 캔버스 단계에 SMS 또는 WhatsApp Liquid 속성정보를 포함할 수 있습니다. 이는 캔버스에서 이벤트 속성정보가 작동하는 방식과 동일합니다. 이를 통해 메시지를 활용하여 고객 프로필에 퍼스트파티 데이터를 저장하고 참조하며 대화형 메시징을 구현할 수 있습니다.
오디언스 자격은 캔버스 진입 시 한 번 평가됩니다. 진입 중에 사용자가 병합되면, 식별된 사용자는 캔버스를 계속 진행하며 캔버스 세그먼트 기준에 대해 재평가되지 않습니다.
트리거 이벤트의 속성을 Audience Paths 또는 Decision Split 단계에서 참조하기 위해 Context 단계를 필요로 하지 않습니다. 필터 그룹에서 Context Variable 필터를 사용하여 속성을 직접 참조할 수 있습니다. 올바른 데이터 유형을 선택해야 합니다.
트리거의 타임스탬프
실행 기반 캔버스를 트리거하는 이벤트에서 datetime 유형의 타임스탬프를 사용하고 컨텍스트를 통해 참조하는 경우, 타임스탬프는 UTC로 정규화됩니다.
이러한 동작을 고려하여, Braze는 메시지가 선호하는 시간대로 전송되도록 다음 예시와 같은 Liquid 시간대 필터를 사용할 것을 강력히 권장합니다.
1
{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}
예외 사항
- 해당 단계가 메시지 단계인 경우, 캔버스의 첫 번째 단계에서는 타임스탬프가 UTC로 정규화되지 않습니다.
- 캔버스에서의 순서와 관계없이, 인앱 메시지 채널을 사용하는 모든 메시지 단계에서는 타임스탬프가 UTC로 정규화되지 않습니다.
사용 사례
context와 event_properties의 차이점을 더 잘 이해하기 위해, 사용자가 “위시리스트에 아이템 추가” 커스텀 이벤트를 수행할 때 실행 기반 캔버스에 진입하는 시나리오를 살펴보겠습니다.
컨텍스트는 캔버스 생성의 진입 스케줄 단계에서 구성되며, 사용자가 캔버스에 진입하는 시점에 해당합니다. 컨텍스트는 모든 메시지 단계에서도 참조할 수 있습니다.
이 캔버스에는 사용자가 위시리스트에 아이템을 추가했는지 여부를 판단하는 행동 경로 단계로 시작하는 사용자 여정이 있습니다. 여기서 사용자가 아이템을 추가한 경우, 지연을 거친 후 메시지 단계에서 “위시리스트에 새 아이템이 추가되었습니다!”라는 메시지를 받게 됩니다.
사용자 여정의 첫 번째 메시지 단계는 행동 경로 단계의 커스텀 event_properties에 접근할 수 있습니다. 이 경우, 메시지 콘텐츠의 일부로 이 메시지 단계에 {{event_properties.${property_name}}}를 포함할 수 있습니다. 사용자가 위시리스트에 아이템을 추가하지 않은 경우, 다른 모든 사용자 경로를 통과하게 되며, 이는 event_properties를 참조할 수 없고 잘못된 설정 오류가 표시됨을 의미합니다.
메시지 단계가 행동 경로 단계의 다른 모든 사용자가 아닌 경로로 추적될 수 있는 경우에만 event_properties에 접근할 수 있습니다. 메시지 단계가 다른 모든 사용자 경로에 연결되어 있지만 사용자 여정에서 행동 경로 단계로 추적될 수 있는 경우에도 여전히 event_properties에 접근할 수 있습니다. 이러한 동작에 대한 자세한 내용은 메시지 단계를 참조하세요.