컨텍스트 및 이벤트 속성
이 참조 문서에서는 각 속성의 사용 시기 및 동작의 차이점을 포함하여
context및event_properties에 대한 정보를 다룹니다.
커스텀 이벤트 속성정보 일반에 대한 자세한 내용은 커스텀 이벤트 속성정보에서 확인하세요.
캔버스 진입 속성은 캔버스 컨텍스트 변수의 일부입니다. 이는 canvas_entry_properties가 context로 참조됨을 의미합니다. 각 context 변수에는 이름, 데이터 유형, Liquid를 포함할 수 있는 값이 포함됩니다. 현재 canvas_entry_properties는 이전 버전과 호환됩니다. 자세한 내용은 컨텍스트 및 캔버스 컨텍스트 객체를 참조하십시오.
컨텍스트 속성과 이벤트 속성은 Canvas 워크플로 내에서 다르게 작동합니다. 사용자의 캔버스 입력을 트리거하는 이벤트 또는 API 호출의 속성을 context라고 합니다. 사용자가 Canvas 여정 내에서 이동할 때 발생하는 이벤트의 속성을 event_properties라고 합니다. 주요 차이점은 context 은 API 트리거 캔버스에서 항목 페이로드의 속성에도 액세스하여 이벤트 그 이상의 것에 초점을 맞춘다는 점입니다.
컨텍스트 속성과 이벤트 속성 간의 차이를 요약한 표를 참조하십시오.
| 컨텍스트 속성 | 이벤트 등록정보 | |
|---|---|---|
| Liquid | context |
event_properties |
| 지속성 | Canvas를 사용하여 구축된 Canvas의 모든 메시지 단계에서 참조할 수 있습니다. | - 한 번만 참조할 수 있습니다. - 후속 메시지 단계에서 참조할 수 없습니다. |
| 캔버스 동작 | 캔버스의 모든 단계에서 context 을 참조할 수 있습니다. 출시 후 동작에 대해서는 출시 후 캔버스 편집을 참조하세요. |
- 커스텀 이벤트 또는 구매 이벤트가 수행되는 작업 경로 단계 뒤의 첫 번째 메시지 단계에서 event_properties를 참조할 수 있습니다. - 작업 경로 단계의 다른 모든 사람 경로 뒤에 있을 수 없습니다. - 액션 경로와 메시지 단계 사이에 메시지 이외의 다른 구성 요소를 포함할 수 있습니다. 이러한 메시지 이외의 구성 요소 중 하나가 작업 경로 단계인 경우 사용자는 해당 작업 경로의 다른 모든 사람 경로를 통해 이동할 수 있습니다. |
Original Canvas editor details
You can no longer create or duplicate Canvases using the original editor. Canvas 컨텍스트는 원래 Canvas 편집기에서 지원되지 않으므로 이 섹션은 이전 Canvas 워크플로에 대한 Canvas 진입 속성과 이벤트 속성을 사용할 때 참조용으로 제공됩니다.
캔버스 항목 속성:
- 영구 항목 속성이 켜져 있어야 합니다.
- 캔버스의 첫 번째 전체 단계에서만
canvas_entry_properties을 참조할 수 있습니다. 캔버스는 액션 기반 또는 API 트리거형이어야 합니다.
항목 속성:
- 캔버스에서 액션 기반 전달을 사용하는 모든 단계에서
event_properties을 참조할 수 있습니다. - 액션 기반 캔버스의 첫 번째 전체 단계 이외의 예약된 전체 단계에서는 사용할 수 없습니다. 그러나 사용자가 Canvas 구성 요소를 사용하는 경우, 동작은
event_properties에 대한 현재 Canvas 워크플로 규칙을 따릅니다.
이벤트 속성:
- 리드 메시지 단계에서
event_properties을 사용할 수 없습니다. 대신canvas_entry_properties를 사용하거나event_properties를 포함하는 메시지 단계 앞에 해당 이벤트가 포함된 작업 경로 단계를 추가해야 합니다.
알아두어야 할 사항
- 컨텍스트는 Liquid에서만 참조할 수 있습니다. To filter on the properties within the Canvas, use event property segmentation instead.
- 인앱 메시지 채널의 경우, Canvas에서
context및event_properties를 참조할 수 있습니다.event_properties는 트리거 기반이기 때문에 첫 번째 Canvas 단계에 포함될 때 접근할 수 있습니다. - You can’t use
event_propertiesin the lead Message step. 대신context를 사용하거나 메시지 단계에event_properties를 포함하는 해당 이벤트 이전의 Action Paths 단계를 추가할 수 있습니다. - 행동 경로 단계에 “SMS 인바운드 메시지 보내기” 또는 “WhatsApp 인바운드 메시지 보내기” 트리거가 포함된 경우 후속 캔버스 단계에 SMS 또는 WhatsApp Liquid 속성정보를 포함할 수 있습니다. 이는 캔버스에서 이벤트 프로퍼티가 작동하는 방식을 반영합니다. 이렇게 하면 메시지를 활용하여 고객 프로필 및 대화 메시지에 대한 퍼스트파티 데이터를 저장하고 참조할 수 있습니다.
오디언스 적격성은 Canvas 진입 시 한 번 평가됩니다. 사용자가 진입 중에 병합되면, 식별된 사용자는 Canvas를 통해 계속 진행하며 Canvas 세그먼트 기준에 대해 다시 평가되지 않습니다.
트리거 이벤트의 속성을 Audience Paths 또는 Decision Split 단계에서 참조하기 위해 Context 단계를 필요로 하지 않습니다. 필터 그룹에서 Context Variable 필터를 사용하여 속성을 직접 참조할 수 있습니다. 올바른 데이터 유형을 선택해야 합니다.
트리거의 타임스탬프
이벤트에서 동작 기반 Canvas를 트리거하는 날짜 시간 유형과 함께 타임스탬프를 사용하는 경우, 타임스탬프는 UTC로 정규화됩니다.
이러한 동작을 고려할 때, Braze는 다음 예시와 같은 Liquid 시간대 필터를 사용하여 원하는 시간대로 메시지가 전송되도록 할 것을 강력히 권장합니다.
1
{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}
예외
- 캔버스의 첫 번째 단계가 메시지 단계인 경우 타임스탬프는 UTC로 정규화되지 않습니다.
- 캔버스에서의 순서와 관계없이 인앱 메시지 채널을 사용하는 메시지 단계에서는 타임스탬프가 UTC로 정규화되지 않습니다.
Use case
context 및 event_properties의 차이를 더 잘 이해하기 위해, 사용자가 “위시리스트에 항목 추가”라는 사용자 정의 이벤트를 수행할 경우 동작 기반 Canvas에 진입하는 시나리오를 고려해 보겠습니다.
컨텍스트는 Canvas를 생성할 때 진입 일정 단계에서 구성되며 사용자가 Canvas에 진입할 때와 관련이 있습니다. 컨텍스트는 모든 메시지 단계에서 참조될 수 있습니다.
이 캔버스에는 사용자가 위시리스트에 항목을 추가했는지 확인하는 작업 경로 단계로 시작되는 사용자 여정이 있습니다. 여기서 사용자가 항목을 추가하면, 메시지 단계에서 “위시리스트에 새 항목이 추가되었습니다!”라는 메시지를 받기 전에 지연을 경험합니다.
사용자 여정의 첫 번째 메시지 단계는 작업 경로 단계에서 사용자 정의 event_properties에 접근할 수 있습니다. 이 경우 이 메시지 단계에 {{event_properties.${property_name}}}를 메시지 콘텐츠의 일부로 포함할 수 있습니다. 사용자가 위시리스트에 항목을 추가하지 않으면, 그들은 모두 다른 경로를 거치게 되며, 이는 event_properties을 참조할 수 없고 잘못된 설정 오류를 반영합니다.
메시지 단계가 행동 경로 단계에서 모든 사람이 아닌 경로로 추적할 수 있는 경우에만 event_properties에 액세스할 수 있습니다. 메시지 단계가 모두 다른 경로에 연결되어 있지만 사용자 여정의 작업 경로 단계로 추적할 수 있다면, 여전히 event_properties에 접근할 수 있습니다. 이러한 행동에 대한 자세한 정보는 메시지 단계를 참조하십시오.
GitHub 에서 이 페이지를 편집합니다.