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