Guía de personalización de mensajes
Descubre cómo usar las variables de personalización (o etiquetas) de Klaviyo para ofrecer una experiencia personalizada a tus clientes.
Las etiquetas de personalización se pueden usar en correos electrónicos (incluido el asunto), mensajes SMS o MMS, notificaciones push y Klaviyo Customer Hub. En este artículo, se describen algunas etiquetas disponibles, sus estructuras y formas, además de cómo personalizarlas. Para saber cómo añadir una personalización, consulta nuestro artículo sobre cómo personalizar tus mensajes.
Anteriormente, las etiquetas de personalización se llamaban “etiquetas de plantilla” y “sintaxis de variable”.
Acerca de las etiquetas de personalización
Al introducir etiquetas en un campo de texto, la oración se verá como la que se encuentra a la izquierda de la tabla siguiente. Una vez que se muestra el mensaje, las etiquetas se reemplazan por la información del perfil del destinatario o del evento, y se verá como la oración que se ubica a la derecha.
Hola, | Hola, George Washington: tu color favorito es el verde. |
La personalización del perfil suele empezar con person, a excepción de algunas etiquetas especiales como first_name y last_name. Las variables de evento, que pueden utilizarse en flujos activados por métricas, comienzan con event. Las etiquetas de organización (como el nombre y la dirección de tu empresa) empiezan con organization.
Todas las etiquetas de personalización distinguen entre mayúsculas y minúsculas, y deben coincidir exactamente con los nombres de las propiedades a las que hacen referencia. Asegúrate de que las etiquetas estén escritas correctamente y de que usen las mayúsculas y las minúsculas tal como aparecen en tus perfiles.
Personalización del perfil
La personalización del perfil te permite mostrar propiedades especiales de Klaviyo en tus mensajes. La lista que se muestra a continuación cubre todas las personalizaciones del perfil (es decir, las propiedades integradas de Klaviyo). Algunas etiquetas de personalización del perfil están disponibles en el menú Personalización del editor de correo o en la ventana modal de vista previa para mensajes push y SMS.
Si deseas añadir propiedades personalizadas a tus mensajes, ve directamente a la sección de Etiquetas personalizadas y de eventos.
Etiqueta | Propiedades del perfil |
| Correo electrónico |
| Nombre |
| Apellidos |
| Organización del destinatario |
| Dirección 1 |
| ID único ($id/external ID) |
| Latitud |
| Longitud |
| ID de Klaviyo |
| Nombre completo |
| Título |
| Número de teléfono |
| Dirección 2 |
| Ciudad |
| Estado/región |
| País |
| Código postal |
| Fuente |
| Consentimiento |
| $consent_form_id |
| $consent_form_version |
| $consent_method |
| Zona horaria del destinatario |
| $consent_timestamp |
| $phone_number_region |
| Artículos vistos recientemente |
| Fecha prevista del próximo pedido |
Etiquetas de objetos personalizados
Las etiquetas de objetos personalizados te permiten usar datos de objetos en envíos de flujos y campañas.
Revisa las referencias de etiquetas para ver ejemplos de cómo usar las etiquetas para obtener un ID de objeto o devolver un recuento.
Para poder usar datos de objetos personalizados en las plantillas, primero tienes que crear un objeto. La etiqueta {{ object }} solo está disponible cuando un objeto activó un flujo.
Etiqueta | Resultado |
| Devuelve el objeto que activó un flujo |
| |
| Devuelve un único objeto de un filtro de objetos |
| |
| Devuelve un recuento de un filtro de objetos |
| Recuperar un objeto por su ID |
| Recuperar todos los registros de un objeto de un perfil |
Etiquetas de organización
Las etiquetas de la organización te permiten incluir información sobre tu empresa u organización en tus mensajes. Para administrar esta información, haz clic en el nombre de tu organización en la esquina inferior izquierda y, a continuación, selecciona Configuración > Organización > Información de contacto. Todas las etiquetas de la organización empiezan con organization. Consulta la siguiente tabla para ver la lista de etiquetas de la organización.
Etiqueta de organización | Descripción |
| Nombre de la organización |
| Sitio web de la organización |
| Dirección completa de la organización, lo que incluye la ciudad, el estado/región y el código postal |
| Dirección postal de la organización |
| La segunda parte de la dirección de la organización (p. ej., el número de departamento o unidad) |
| Ciudad de la organización |
| Estado, provincia o región de la organización |
| Código postal de la organización |
Etiquetas de enlace y vista previa
Las etiquetas de enlace y vista previa permiten que los destinatarios administren sus preferencias de suscripción y vean tu mensaje en sus navegadores. Entre ellas, se incluyen:
- Cancelar la suscripción
- Administrar preferencias
- Vista web
- Texto de vista previa
Estas etiquetas solo se admiten para plantillas de correo electrónico. Si haces clic en uno de estos enlaces desde un correo electrónico de vista previa, se te dirigirá a una página temporal en lugar de una vista previa o página de consentimiento activa.
Cancelar la suscripción
Klaviyo exige que se incluya en todos los correos electrónicos un enlace de cancelación de suscripción. Usa la etiqueta de cancelación de suscripción para un enlace que diga simplemente “Cancelar la suscripción”, o añade tu propio texto entre comillas.
Etiqueta | Salida |
| Cancelar la suscripción |
Si ya no deseas recibir correos electrónicos, | Si ya no deseas recibir correos electrónicos, haz clic aquí. |
También puedes utilizar la etiqueta {% unsubscribe_link %} para generar un URL de cancelación de suscripción. En lugar de generar un enlace con una palabra o frase, esta etiqueta solo crea el URL para cancelar la suscripción. Utiliza esta etiqueta si deseas emplear un color para el enlace de cancelación de suscripción distinto al que está establecido en los estilos de la plantilla o si deseas usar un botón o una imagen en lugar de un enlace de texto.
Etiqueta | Salida |
| Este es un enlace sofisticado para cancelar la suscripción. |
Cuando un destinatario hace clic en el enlace de cancelación de suscripción, se le dirige a una página de confirmación personalizable.
Administrar preferencias
Las páginas de preferencias permiten que los destinatarios actualicen sus preferencias. Esto te ayuda a segmentar y dirigir tus mensajes de forma más eficaz. Si deseas incluir un enlace a esta página para cada destinatario, usa la etiqueta para administrar preferencias.
Puedes crear páginas de administración de preferencias generales y específicas para ciertas listas. Las páginas específicas de listas se usan cuando le envías un mensaje solamente a una lista. Las páginas de administración de preferencias generales se usan cuando le envías contenido a un segmento, a una combinación de listas y en flujos que no se activan por listas. Consulta más información sobre las páginas de administración de preferencias.
Usa una etiqueta de administración de preferencias para incluir simplemente un enlace con el texto “Administrar preferencias”, o bien añade tu propio texto entre comillas.
Etiqueta | Salida |
| Administrar preferencias |
¿Deseas actualizar tus preferencias? | ¿Deseas actualizar tus preferencias? Haz clic aquí. |
También puedes utilizar la etiqueta {% manage_preferences_link %} para generar un URL de administración de preferencias. En lugar de generar un enlace con una palabra o frase, esta etiqueta solo crea el URL de la página de preferencias del destinatario. Utiliza esta etiqueta si deseas emplear un color para el enlace distinto al que está establecido en los estilos de la plantilla o si deseas usar un botón o una imagen en lugar de un enlace de texto.
Etiqueta | Salida |
| Este es un enlace sofisticado para administrar preferencias. |
Vista web
Puedes usar la etiqueta de vista web para ofrecerles a los destinatarios la opción de ver un correo electrónico en su navegador web.
Etiqueta | Salida |
| Ver en el navegador |
¿No puedes ver este correo electrónico? | ¿No puedes ver este correo electrónico? Abrir en el navegador. |
| Este es un enlace sofisticado de vista web. |
Texto de vista previa
En algunos casos, puede que desees mostrar el texto de vista previa dentro del cuerpo de la plantilla. Puedes hacer referencia a cualquier texto de vista previa que hayas establecido en la pantalla de previsualización o configuración del correo electrónico utilizando la etiqueta {% render_variable preview_text %}.
Si modificas el texto de vista previa en la pantalla de vista previa del correo electrónico, esta etiqueta mostrará el texto de vista previa actualizado.
Etiquetas personalizadas y de eventos
Las etiquetas personalizadas hacen referencia a propiedades del perfil personalizadas (es decir, cualquier dato que recopiles sobre tus contactos que no sean propiedades y eventos especiales de Klaviyo), como el cumpleaños de alguien o sus preferencias de contacto. Las etiquetas de evento hacen referencia a los datos de un evento específico (p. ej., un evento de pedido realizado) y solo se pueden usar en flujos activados por el evento en cuestión.
Para añadir una etiqueta personalizada, haz clic en Personalización en un campo de texto del correo electrónico y busca la etiqueta. Para añadir una etiqueta de evento, previsualiza tu mensaje y copia la etiqueta de variable de evento de los datos de previsualización. También puedes utilizar los formatos que se describen a continuación para añadir manualmente etiquetas personalizadas a tus plantillas.
Formato de la etiqueta | Descripción | Ejemplo |
| Etiqueta de personalización del perfil sencilla |
|
| Etiqueta de personalización del perfil, si el nombre de la propiedad contiene espacios o caracteres especiales |
|
| Etiqueta de variable de evento sencilla |
|
| Etiqueta de variable de evento, si el nombre de la variable contiene espacios o caracteres especiales |
|
| Etiqueta de variable de evento, si la variable del evento está anidada en los datos del evento |
|
| Etiqueta de variable de evento, si la variable de evento está anidada en otra variable con un nombre que contiene un espacio o un carácter especial |
|
Utiliza la notación de puntos (.) para las etiquetas sin espacios ni caracteres especiales. Si los nombres de propiedades contienen espacios o caracteres especiales (p. ej., “$”), usa la notación de búsqueda.
Recuerda que, con las propiedades anidadas, si el nombre de una propiedad utiliza la notación de búsqueda, todas las propiedades posteriores también deberán utilizarla. Esto significa que, por ejemplo, event|lookup:'Collection Names'|lookup:'0' es correcto, pero event|lookup:'Collection Names'.0 no.
Personalizar etiquetas con filtros
Para personalizar la forma en la que aparecen las etiquetas, aplica filtros de plantilla. Los filtros pueden utilizarse para aplicar mayúsculas en las palabras significativas, establecer las posiciones decimales de un número y mucho más. Dos de los filtros más comunes son default y title.
El filtro default establece un valor por defecto para que aparezca si un destinatario del mensaje no tiene establecida esa propiedad. En el ejemplo que se muestra a continuación, “amigo” y “algo delicioso” se establecen como valores por defecto en caso de que el nombre o la comida favorita del destinatario no estén establecidos en su perfil de Klaviyo.
Texto con etiquetas de personalización | Salida |
Hola, | Hola, amigo, ¿te gustaría probar algo delicioso? |
El filtro title te permite aplicar el formato de mayúscula inicial a cualquier etiqueta de texto para asegurarte de que se muestre con un formato coherente una vez enviado el mensaje. Por ejemplo, es posible que algunos suscriptores escriban todo en mayúsculas o todo en minúsculas al rellenar tu formulario de registro. Si no usas ningún filtro, el nombre de cada suscriptor tendrá el formato (todo en mayúsculas o todo en minúsculas) que haya utilizado al rellenar tu formulario. Sin embargo, el filtro “title” corregirá el formato de mayúsculas o minúsculas para que su nombre aparezca correctamente.
Texto con etiquetas de personalización | Salida |
Hola, | Hola, Elise, ¿viste nuestro último lanzamiento? |
Hay decenas de filtros adicionales disponibles para tus mensajes. Obtén más información sobre el uso de filtros para personalizar etiquetas.
Etiquetas de fecha
Las etiquetas de fecha te ofrecen una forma rápida de insertar información sobre fechas en un correo electrónico. La fecha está en la zona horaria de tu cuenta y refleja el día o la hora en la que se envía un mensaje.
La etiqueta {{ today }} es una de las etiquetas de fecha más comunes. Sirve para rellenar una marca de tiempo cuando se envía el mensaje. Para utilizar la etiqueta “today”, pega la siguiente línea de código en tu plantilla:
{% today "%Y-%m-%d" as today %} {{ today }}
Ten en cuenta que usar la etiqueta {{ today }} sin el código anterior no generará nada, ya que es necesario insertar la línea de código completa.
Para saber cómo usar y personalizar las etiquetas de fecha, lee nuestro artículo sobre etiquetas de fecha en las plantillas.
Etiquetas de moneda
Los datos de eventos como Pedido Realizado y Se Añadió al Carrito, entre otros, suelen tener un valor financiero asociado (p. ej., el precio de un producto o el valor del carrito de un cliente). Usa la etiqueta {% currency_format ... %} para aplicar el formato de moneda de tu país a ese valor.
Por ejemplo, fíjate en el campo $value de la métrica Proceso de Pago Iniciado que aparece a continuación:
Si usas solo la variable {{ event|lookup:"$value" }}, esta propiedad se muestra con un solo decimal y sin símbolo de moneda en el correo electrónico:
Sin embargo, con la etiqueta de formato de moneda, {% currency_format event|lookup:"$value" %}, el número se muestra con un símbolo de moneda y el número correcto de decimales:
Para usar la etiqueta de formato de moneda, reemplaza el texto del marcador de posición en {% currency_format PLACEHOLDER %} por tu variable.
Por ejemplo, si tu variable es {{ event.item.price }}, la etiqueta de formato de moneda completa sería {% currency_format event.item.price %}. Si tu etiqueta incluye filtros (p. ej., un valor por defecto en caso de que la propiedad esté vacía), inclúyelos también en la etiqueta: {% currency_format event.item.price|default:”0” %}.
Cómo seleccionar un país
Puedes configurar el formato de moneda para tus mensajes de dos modos:
- Para toda tu cuenta
Ve a Configuración > Organización > Idioma de la organización y formato regional y selecciona un Idioma de la organización. - Para un mensaje específico
Selecciona un formato de moneda diferente para un único mensaje en la pestaña Estilos de esa plantilla, en la sección Moneda.
Solución de problemas con la etiqueta “currency_format”
Esta etiqueta solo es compatible con variables numéricas (p. ej., 10 o 24.56). Las propiedades con el símbolo de moneda incluido (p. ej., $40, $76.30) son cadenas, y la etiqueta “currency_format” no puede alterarlas.
Declaraciones condicionales
Las etiquetas condicionales te permiten incluir contenido en tus mensajes para los destinatarios que cumplan determinados criterios y no incluirlo para los demás. También te brindan un mayor control sobre la personalización de los mensajes para cada destinatario.
Declaraciones “if”
Las declaraciones “if” te permiten controlar el contenido que alguien recibe en función de los datos de su perfil o de un evento.
En el ejemplo siguiente, el destinatario verá la primera línea de texto si tiene más de 150 puntos de fidelidad. Si tiene menos de 150, pero más de 0, verá la segunda línea. Y si no tiene puntos de fidelidad, verá el tercer mensaje.
{% if person|lookup:'Loyalty Points' > 150 %}
¡Hola, cliente VIP! Recuerda que siempre tienes envíos y devoluciones gratis
{% elif person|lookup:'Loyalty Points' > 0 %}
Tienes {{ person|lookup:'Loyalty Points' }} puntos, ¡y sólo necesitas 150 para convertirte en VIP!
{% else %}
¿Conoces nuestro programa VIP? Únete hoy en nuestro sitio web para empezar a ganar recompensas.
{% endif %}
Dentro de una declaración “if”, se requiere una condición {% if ... %}, así como la etiqueta de cierre {% endif %}. Todos los demás elementos (es decir, las etiquetas {% elif %} y {% else %} ) son opcionales. Puedes utilizar un número ilimitado de etiquetas {% elif %}, seguido de una etiqueta {% else %}, como máximo. Cada destinatario del correo electrónico solo verá el primer mensaje para el que cumpla las condiciones.
Declaraciones “for”
Con los bloques “for”, puedes iterar sobre cada elemento de una variable que contiene una lista y mostrarlos por separado. A continuación, se muestra un ejemplo de declaración:
| Manta de playa extragrande × 1 Sillas de playa × 4 Protector solar SPF × 2 Hielera de plástico × 1 |
Cada declaración For debe contener lo siguiente:
- Una etiqueta de apertura
{% for ... %}que contiene un alias de fila (item en el ejemplo anterior) y una colección de filas (event.shopping_cart_items en el ejemplo anterior) - Una etiqueta de cierre
{% endfor %}
Entre las dos etiquetas obligatorias, puedes incluir el texto que deseas. Para incluir variables anidadas dentro de la colección de filas, reemplaza el principio del nombre de la variable (la colección de filas más el número que sigue) por tu alias de fila. Por ejemplo, la variable {{ event.shopping_cart_items.0.name }} se convertiría en {{ item.name }}.
Declaraciones condicionales y editor de texto integrado
Cuando añadas determinadas declaraciones condicionales a un bloque de texto, es posible que desaparezcan del editor de texto integrado. El código seguirá estando allí, pero oculto. Para ver y editar las declaraciones condicionales, abre el campo Código fuente del bloque de texto.
Las siguientes etiquetas solo son visibles en el campo Código fuente de un bloque de texto:
- {% for ... %}
- {% endfor %}
- {% if ... %}
- {% elif ... %}
- {% else %}
- {% endif %}
- {% with ... %}
- {% endwith %}
Recursos adicionales
- Cómo crear y enviar una campaña de correo electrónico
Aprende los conceptos básicos sobre campañas de correo electrónico, incluyendo qué son y cómo enviarlas en Klaviyo.
- Cómo usar el panel de vista previa para la personalización de mensajes
Aprende a utilizar el panel de vista previa para conocer los datos de personalización disponibles para tus mensajes y cómo acceder a la etiqueta de plantilla. Utiliza el modal de vista previa como fuente de verdad para las opciones de personalización.
- Cómo crear bloques dinámicos en un flujo de correo electrónico
Aprende a utilizar el bloque de tablas dinámicas para añadir información sobre productos y otros eventos a tu flujo desencadenado por métrica. En este artículo, aprenderás a crear un bloque dinámico utilizando el ejemplo de un recordatorio de carrito abandonado que muestra los productos que se han dejado.
- Solución de mensajes de error de plantillas de correo electrónico
Si encuentras errores o advertencias en una plantilla de correo electrónico, puede que tengas que resolverlos antes de enviar tu mensaje. Busca en este recurso el mensaje de error o advertencia que encuentres para encontrar consejos para resolver el problema.
- Cómo crear bloques de contenido para Customer Hub
Aprenda a crear bloques de contenido para su Customer Hub de Klaviyo. Los bloques de contenido son bloques altamente personalizables que tienen acceso a Klaviyo datos del perfil que le permiten mostrar integraciones (p. ej. saldo de puntos de fidelidad), ofertas personalizadas y mucho más.