Propiedades de contexto y de evento

Este artículo de referencia cubre información sobre context y event_properties, incluyendo cuándo usar cada propiedad y las diferencias en su comportamiento.

Para información sobre las propiedades de eventos personalizados en general, consulta Propiedades de eventos personalizados.

Importante

La terminología y el espacio de nombres de Liquid que ves dependen de las características disponibles en tu espacio de trabajo:

• Si el panel muestra Variables de contexto, haz referencia a las propiedades de entrada con context, como {{context.${property_name}}}. También puedes crear o actualizar variables con un paso de contexto.
• Si el panel muestra Propiedades de entrada de Canvas, haz referencia a ellas con canvas_entry_properties, como {{canvas_entry_properties.${property_name}}}. El paso de contexto y el filtro Variable de contexto no están disponibles.
  
  Para más información, consulta Contexto y Propiedades de contexto y de evento. Si necesitas acceso al contexto de Canvas, ponte en contacto con tu administrador de éxito de cliente.

Las propiedades de contexto y las propiedades de evento funcionan de manera diferente dentro de tus flujos de trabajo de Canvas. En los espacios de trabajo con contexto de Canvas, las propiedades de eventos o llamadas a la API que desencadenan la entrada de un usuario en un Canvas están disponibles como context. Si tu espacio de trabajo en cambio muestra Canvas Entry Properties, los mismos datos de entrada utilizan el espacio de nombres heredado canvas_entry_properties. Las propiedades de eventos que ocurren mientras un usuario avanza dentro de un recorrido en Canvas se conocen como event_properties.

Consulta la siguiente tabla para un resumen de las diferencias entre las propiedades de contexto y las propiedades de evento.

Cosas que debes saber

• Puedes hacer referencia a Context en Liquid. Si Context Variable está disponible como filtro en tu espacio de trabajo, también puedes usar Context en los filtros de Canvas compatibles. De lo contrario, usa la segmentación por propiedades del evento.
• Para los canales de mensajes dentro de la aplicación, puedes hacer referencia a context y event_properties en un Canvas. Se puede acceder a event_properties cuando se incluye en el primer paso del Canvas porque se basa en desencadenadores.
• No puedes usar event_properties en el paso de mensaje principal. En su lugar, puedes usar context o añadir un paso de Rutas de Acción con el evento correspondiente antes del paso de mensaje que incluya event_properties.
• Cuando un paso de Rutas de Acción contiene un desencadenador “Sent an SMS Inbound Message” o “Sent a WhatsApp Inbound Message”, los pasos posteriores del Canvas pueden incluir una propiedad Liquid de SMS o WhatsApp. Esto refleja cómo funcionan las propiedades del evento en los Canvas. De esta forma, puedes aprovechar tus mensajes para guardar y hacer referencia a datos propios en los perfiles de usuario y la mensajería conversacional.

Nota

La elegibilidad de la audiencia se evalúa una sola vez en la entrada al Canvas. Si un usuario se fusiona durante la entrada, el usuario identificado continúa a través del Canvas y no se vuelve a evaluar con los criterios de Segment del Canvas.

Consejo

Si Context Variable está disponible como filtro en tu espacio de trabajo, no necesitas un paso de contexto para hacer referencia a las propiedades del evento desencadenante en los pasos de ruta de audiencia o división de decisiones. Puedes hacer referencia a las propiedades directamente en los grupos de filtros. Asegúrate de seleccionar el tipo de datos correcto.

Marcas de tiempo

Todas las marcas de tiempo en Canvas se normalizan a UTC. Dado este comportamiento, Braze recomienda encarecidamente que uses un filtro de zona horaria de Liquid, como el siguiente ejemplo, para que tus mensajes se envíen en tu zona horaria preferida.

1

{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}

Caso de uso

Para comprender mejor las diferencias entre context y event_properties, consideremos este escenario en el que los usuarios entran en un Canvas basado en acciones si realizan el evento personalizado “añadir artículo a la lista de deseos”.

Los datos de entrada se configuran en el paso Programación de entrada y corresponden al momento en que un usuario entra en un Canvas. En los espacios de trabajo con Canvas Context, estos datos están disponibles como context y se pueden referenciar en cualquier paso de Mensaje. En otros espacios de trabajo, el panel etiqueta estos datos como Propiedades de entrada de Canvas y utiliza canvas_entry_properties.

En este Canvas, tenemos un recorrido de usuario que comienza con un paso de Rutas de Acción para determinar si un usuario ha añadido un artículo a su lista de deseos. A partir de aquí, si el usuario ha añadido un artículo, experimenta un retraso antes de recibir el mensaje “¡Nuevo artículo en tu lista de deseos!” del paso de Mensaje.

El primer paso de Mensaje en un recorrido de usuario tiene acceso a las event_properties personalizadas de tu paso de Rutas de Acción. En este caso, podemos incluir {{event_properties.${property_name}}} en este paso de Mensaje como parte del contenido de nuestro mensaje. Si un usuario no añade un artículo a su lista de deseos, pasa por la ruta de Todos los demás, lo que significa que no se puede hacer referencia a event_properties y se muestra un error de configuración no válida.

Ten en cuenta que solo tendrás acceso a event_properties si tu paso de Mensaje se puede rastrear hasta una ruta que no sea la de Todos los demás en un paso de Rutas de Acción. Si el paso de Mensaje está conectado a una ruta de Todos los demás pero se puede rastrear hasta un paso de Rutas de Acción en el recorrido del usuario, entonces también tienes acceso a event_properties. Para más información sobre estos comportamientos, consulta Paso de Mensaje.