Variables
Las variables te permiten mostrar contenido dinámico en tus flows — precios de productos, detalles de ofertas y otros datos que se actualizan según el contexto de cada usuario. Úsalas para controlar la visibilidad de elementos y personalizar el contenido de las pantallas.
Para abrir el panel de variables, haz clic en el icono { } en el panel izquierdo. El panel tiene tres pestañas:
- Personalizadas: Variables que creas y gestionas tú mismo.
- Producto: Variables integradas que extraen datos localizados de productos y ofertas del store.
- Elemento: Variables vinculadas a los estados de los elementos en el lienzo.
Variables personalizadas
Crear una variable personalizada
- En el panel de variables, haz clic en +.
- Escribe un nombre para la variable.
- Selecciona un tipo: String, Number o Boolean.
- Establece un valor inicial. Este es el valor que tendrá la variable cuando comience el flow.
- Haz clic en Create variable.
Usa puntos en los nombres para agrupar variables relacionadas — por ejemplo, user.score o user.goal.
Actualizar una variable mediante una interacción
Consulta el artículo de Acciones para más detalles.
Puedes actualizar el valor de una variable en tiempo de ejecución añadiendo una acción Set up variables a cualquier elemento.
- Selecciona un elemento en el lienzo.
- En la pestaña Interactions, haz clic en Add trigger.
- Selecciona On tap y haz clic en Add action. En el desplegable Action type, selecciona Set up variables.
- Haz clic en Add variable. Selecciona la variable y establece el nuevo valor.
Por ejemplo, puedes asignar un valor diferente a user.goal según la respuesta que seleccione el usuario en un cuestionario y, a continuación, usar esa variable para llevarlo a una pantalla diferente.
Variables de producto
Las variables de producto extraen datos localizados directamente de las stores. Úsalas en campos de texto para mostrar precios, títulos y detalles de ofertas precisos según el idioma y la elegibilidad de cada usuario.
| Variable | Descripción | Ejemplo |
|---|---|---|
<PROD_TITLE/> | Título localizado del producto | Premium Subscription |
<PROD_PRICE/> | Precio localizado por un período de facturación | $9.99 |
<PROD_PRICE_PER_DAY/> | Precio de la suscripción dividido entre los días del período de facturación. Vacío para compras que no son suscripciones. | $0.33 |
<PROD_PRICE_PER_WEEK/> | Precio de la suscripción dividido entre las semanas del período de facturación. Vacío para compras que no son suscripciones. | $2.33 |
<PROD_PRICE_PER_MONTH/> | Precio de la suscripción ajustado a un mes. Vacío para compras que no son suscripciones. | $9.99 |
<PROD_PRICE_PER_YEAR/> | Precio de la suscripción ajustado a un año. Vacío para compras que no son suscripciones. | $119.88 |
<OFFER_PRICE/> | Precio localizado de una oferta introductoria o promocional. Vacío si el usuario no es elegible para ninguna oferta. | $0.99 |
<OFFER_BILLING_PERIOD/> | Período de facturación localizado de una oferta. Igual que <OFFER_FULL_DURATION/> para ofertas de prueba y pago por adelantado. Vacío si el usuario no es elegible. | 1 week |
<OFFER_FULL_DURATION/> | Duración total localizada de una oferta. Vacío si el usuario no es elegible. | 1 month |
| Los valores de las variables de oferta dependen del tipo de oferta para la que el usuario es elegible. Para ilustrarlo, tomemos una suscripción semanal llamada “Premium Subscription” a $5, con tres ofertas posibles: |
- Pay As You Go: Las primeras 3 semanas por $3 (facturadas semanalmente), luego $5/semana.
- Pay Up Front: Las primeras 3 semanas por $8 (facturadas de inmediato), luego $5/semana.
- Free Trial: Primera semana gratis, luego $5/semana.
En este ejemplo, <PROD_TITLE/> devuelve “Premium Subscription” y <PROD_PRICE/> devuelve $5. Los valores de las variables de oferta dependen de la oferta para la que el usuario sea elegible:
| Variable | Pay As You Go | Pay Upfront | Free Trial |
|---|---|---|---|
<OFFER_PRICE/> | $3 | $8 | $0 |
<OFFER_BILLING_PERIOD/> | 1 semana | 3 semanas | 1 semana |
<OFFER_FULL_DURATION/> | 3 semanas | 3 semanas | 1 semana |
Para las ofertas Pay Upfront y Free Trial, <OFFER_BILLING_PERIOD/> y <OFFER_FULL_DURATION/> devuelven el mismo valor. Para Pay As You Go, difieren porque el período de facturación es de una semana pero la duración total es de tres semanas.
Para saber más sobre las ofertas y cómo configurarlas, consulta Ofertas.
Variables de elemento
Las variables de elemento capturan las elecciones del usuario: qué seleccionó en los cuestionarios, en qué pestaña está y si el toggle de prueba está activado.
Los tipos de variables de elemento dependen del grupo:
- Opción única: Cuestionarios de opción única y pestañas:
selected_id: ID del elemento para usar en condicionesselected_title: Título del elemento para usar en texto dinámico
- Opción múltiple: Cuestionarios de opción múltiple:
selected_ids: IDs de elementos para usar en condicionesselected_titles: Títulos de elementos para usar en texto dinámico
- Toggle: Toggle de prueba:
is_selected: Valor booleano Los casos de uso más habituales son:
- Mostrar contenido diferente según si el interruptor de prueba está activado.
- Navegar a los usuarios a distintas pantallas según sus respuestas al cuestionario
Usar variables en texto
Para insertar una variable en un elemento de texto:
- Selecciona un elemento de texto en el canvas.
- En la pestaña Design, busca el campo Content y escribe tu texto.
- Haz clic en el icono { } del campo.
- Selecciona una variable de la lista.
También puedes usar variables en otros elementos:
- Usa variables en enlaces y alertas para hacerlos dinámicos
- Crea condiciones dinámicas basadas en variables. Por ejemplo, la condición puede ser
if experience.current > experience.target, navigate to...
