Skip to content

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.

Las propiedades de contexto y las propiedades de evento funcionan de manera diferente dentro de tus flujos de trabajo de Canvas. Las propiedades de eventos o llamadas a la API que desencadenan la entrada de un usuario en un Canvas se conocen como context. Las propiedades de eventos que ocurren mientras un usuario avanza dentro de un recorrido en Canvas se conocen como event_properties. La diferencia clave es que context se enfoca en más que solo eventos, ya que también accede a las propiedades de las cargas útiles de entrada en Canvas activados por API.

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

Detalles del editor de Canvas original

Ya no puedes crear ni duplicar Canvas usando el editor original. Ten en cuenta que el contexto de Canvas no es compatible con el editor de Canvas original, por lo que esta sección está disponible como referencia al usar propiedades de entrada de Canvas y propiedades de evento para el flujo de trabajo de Canvas anterior.

Propiedades de entrada de Canvas:

  • Deben tener activadas las propiedades de entrada persistentes.
  • Solo pueden referenciar canvas_entry_properties en el primer paso completo de un Canvas. El Canvas debe ser basado en acciones o activado por API.

Propiedades de entrada:

  • Pueden referenciar event_properties en cualquier paso completo que use entrega basada en acciones en un Canvas.
  • No pueden usarse en pasos completos planificados que no sean el primer paso completo de un Canvas basado en acciones. Sin embargo, si un usuario está usando un componente de Canvas, el comportamiento sigue las reglas actuales del flujo de trabajo de Canvas para event_properties.

Propiedades de evento:

  • No se puede usar event_properties en el paso de Mensaje principal. En su lugar, debes usar canvas_entry_properties o añadir un paso de Rutas de acción con el evento correspondiente antes del paso de Mensaje que incluye event_properties.

Cosas que debes saber

  • El contexto solo está disponible para referencia en Liquid. Para filtrar por las propiedades dentro del Canvas, usa la segmentación por propiedades de evento en su lugar.
  • Para canales de mensajes dentro de la aplicación, puedes referenciar context y event_properties en un Canvas. Se puede acceder a event_properties cuando se incluyen en el primer paso del Canvas porque está basado en desencadenantes.
  • 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 incluye event_properties.
  • Cuando un paso de Rutas de acción contiene un desencadenante “Envió un mensaje SMS de entrada” o “Envió un mensaje WhatsApp de entrada”, los pasos posteriores del Canvas pueden incluir una propiedad Liquid de SMS o WhatsApp. Esto refleja cómo funcionan las propiedades de evento en Canvas. De esta manera puedes aprovechar tus mensajes para guardar y referenciar datos propios en perfiles de usuario y mensajería conversacional.

Marcas de tiempo para desencadenantes

Si estás usando marcas de tiempo con un tipo datetime de eventos que desencadenan Canvas basados en acciones, que se referencian usando contexto, las marcas de tiempo se normalizan a UTC.

Dado este comportamiento, Braze recomienda encarecidamente que uses un filtro de zona horaria de Liquid como el siguiente ejemplo para garantizar que tus mensajes se envíen con tu zona horaria preferida.

1

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

Excepciones

  • Las marcas de tiempo no se normalizan a UTC en el primer paso de un Canvas si ese paso es un paso de Mensaje.
  • Las marcas de tiempo no se normalizan a UTC en ningún paso de Mensaje que use el canal de mensajes dentro de la aplicación, independientemente de su orden en el Canvas.

Caso de uso

Un paso de Rutas de acción seguido de un paso de Retraso y un paso de Mensaje para usuarios que han añadido un artículo a su lista de deseos, y una ruta para el resto.

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

El contexto se configura en el paso de Horario de entrada al crear un Canvas y corresponde al momento en que un usuario entra en un Canvas. El contexto también puede ser referenciado en cualquier paso de Mensaje.

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. Desde 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 El resto, lo que significa que no se pueden referenciar las 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 puede rastrearse hasta una ruta que no sea El resto en un paso de Rutas de acción. Si el paso de Mensaje está conectado a una ruta El resto pero puede rastrearse 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.
New Stuff!