Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

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

Las propiedades de entrada de Canvas forman parte de las variables de contexto de Canvas. Esto significa que canvas_entry_properties se referencia como context. Cada variable context incluye un nombre, un tipo de datos y un valor que puede incluir Liquid. Actualmente, canvas_entry_properties es compatible con versiones anteriores. Para más detalles, consulta Contexto y Objeto de contexto de Canvas.

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.

	Propiedades de contexto	Propiedades de evento
Liquid	`context`	`event_properties`
Persistencia	Pueden ser referenciadas por todos los pasos de Mensaje durante toda la duración de un Canvas construido usando Canvas.	- Solo pueden ser referenciadas una vez. - No pueden ser referenciadas por pasos de Mensaje posteriores.
Comportamiento en Canvas	Puedes referenciar `context` en cualquier paso de un Canvas. Para el comportamiento posterior al lanzamiento, consulta Editar Canvas después del lanzamiento.	- Puedes referenciar `event_properties` en el primer paso de Mensaje después de un paso de Rutas de Acción donde la acción realizada es un evento personalizado o un evento de compra. - No puede estar después de la ruta El resto del paso de Rutas de Acción. - Puede haber otros componentes que no sean de Mensaje entre los pasos de Rutas de Acción y Mensaje. Si uno de estos componentes que no son de Mensaje es un paso de Rutas de Acción, el usuario puede pasar por la ruta El resto de esa ruta de acción.

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.

Lo que debes saber

El contexto solo está disponible como referencia en Liquid. Para filtrar según las propiedades dentro del Canvas, utiliza en su lugar 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 está basado 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 incluye 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 de Canvas posteriores pueden incluir una propiedad Liquid de SMS o WhatsApp. Esto refleja cómo funcionan las propiedades del evento en Canvas. De esta forma, puedes aprovechar tus mensajes para guardar y hacer referencia a datos propios en perfiles de usuario y 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 reevalúa con respecto a los criterios de Segment del Canvas.

Consejo

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 con el filtro Context Variable. 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 utilices un filtro de zona horaria de Liquid, como en el siguiente ejemplo, para que tus mensajes se envíen en tu zona horaria preferida.

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

Caso de uso

Un paso de Rutas de Acción seguido de un paso de Retraso y un paso de Mensaje para los usuarios que han añadido un artículo a su lista de deseos, y una ruta para todos los demás.

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”.

El contexto se configura en el paso Programación de entrada de la creación de un Canvas y corresponde al momento en que un usuario entra en un Canvas. El contexto también puede referenciarse 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. A partir de aquí, si el usuario ha añadido un artículo, experimenta un retraso antes de recibir un 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 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 puede rastrearse hasta una ruta que no sea Todos los demás en un paso de Rutas de Acción. Si el paso de Mensaje está conectado a una ruta Todos los demás 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!