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 agregar personalización a 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: su 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 la 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 los 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). Las etiquetas de personalización de perfil seleccionadas están disponibles en el menú Personalization del editor de correo electrónico o en la ventana modal de vista previa para mensajes SMS y push.
Si quieres agregar propiedades personalizadas a tus mensajes, ve directamente a la sección sobre personalización personalizada.
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 específicos de cómo usar 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 ha activado 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 ellos, se incluyen los siguientes:
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 página de consentimiento activa o una vista previa.
Cancelar la suscripción
Klaviyo exige que se incluya en todos los correos electrónicos un enlace de cancelación de suscripción. Usa una etiqueta simple de cancelar la suscripción para un enlace que diga “Cancelar la suscripción”, o agrega 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í. |
Como alternativa, puedes usar la etiqueta {% unsubscribe_link %} para generar una 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 con enlace 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. Obtén más información sobre las páginas para administrar preferencias.
Usa una etiqueta simple de administración de preferencias para un enlace que diga “Administrar preferencias”, o agrega tu propio texto entre comillas.
Etiqueta | Salida |
| Administrar preferencias |
¿Deseas actualizar tus preferencias? | ¿Deseas actualizar tus preferencias? Haz clic aquí. |
Como alternativa, puedes usar 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 usar un color diferente para el enlace al color de enlace establecido en los estilos de la plantilla, o si deseas usar un botón o una imagen con enlace en lugar de un enlace de texto.
Etiqueta | Salida |
| Este es un enlace sofisticado para administrar preferencias. |
Vista web
Para darles a los destinatarios la opción de ver un correo electrónico en su navegador web, puedes usar la etiqueta de vista 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 ese evento.
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. Como alternativa, usa los formatos que se describen a continuación para agregar manualmente etiquetas personalizadas a las 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 event|lookup:'Collection Names'|lookup:'0' es correcto, pero event|lookup:'Collection Names'.0 no lo es.
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 predeterminado para que aparezca si un destinatario del mensaje no tiene establecida esa propiedad. En el ejemplo a continuación, “amigo” y “algo delicioso” se establecen como los valores predeterminados en caso de que el nombre o la comida favorita de un destinatario no estén configurados en su perfil de Klaviyo.
Texto con etiquetas de personalización | Salida |
Hola, | Hola, amigo, ¿te gustarían unas golosinas deliciosas? |
El filtro title te permite aplicar el formato de mayúscula inicial a cualquier etiqueta de texto, para asegurarte de que aparezca de forma coherente una vez que se envíe 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” corrige 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 la cuenta y refleja el día o la hora en que se envió 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 mostrará nada; es necesaria la línea completa de código.
Para aprender a usar o personalizar las etiquetas de fecha, consulta 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 Inicio de pago 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 la variable es {{ event.item.price }}, la etiqueta de formato de moneda completa sería {% currency_format event.item.price %}. Si tu etiqueta incluye filtros (por ejemplo, un valor por defecto en caso de que la propiedad esté vacía), inclúyelos también en la etiqueta: {% evento currency_format.item.price|default:"0" %}. suyo
Cómo seleccionar un país
Hay 2 lugares donde puedes configurar el formato de moneda para tus mensajes:
- 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 solo mensaje desde 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 según los datos del perfil o del 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 tienen puntos de fidelidad, verán el tercer mensaje.
{% if person|lookup:'Loyalty Points' > 150 %}
Hey VIP! You’ve always got free shipping & free returns
{% elif person|lookup:'Loyalty Points' > 0 %}
You have {{ person|lookup:'Loyalty Points' }} points, and you just need 150 to become a VIP!
{% else %}
Have you heard about our VIP program? Join today on our website to start earning rewards.
{% endif %}Dentro de una declaración if, se requiere una condición inicial {% 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 un máximo de una etiqueta {% else %}. 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 declaraciones condicionales, usa el generador de etiquetas de Django o mueve el contenido a un bloque de HTML dedicado para editar el código directamente.
Las siguientes etiquetas no aparecen en el editor de texto en línea, pero permanecen en el 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 usar el panel de vista previa para entender los datos de personalización disponibles para tus mensajes y cómo acceder a las etiquetas de plantilla. Usa el modal de vista previa como tu fuente de verdad para las opciones de personalización.
- Cómo crear bloques dinámicos en un correo electrónico de flujo
Aprende cómo usar bloques de tablas dinámicas para agregar información de productos y de otros eventos a tus flujos activados por métricas. En este artículo, aprenderás a crear un bloque dinámico usando el ejemplo de un recordatorio de carrito abandonado que muestra los productos que se dejaron atrás.
- Solución de mensajes de error de plantillas de correo electrónico
Si encuentras errores o advertencias en una plantilla de correo electrónico, es posible que debas resolverlos antes de enviar el mensaje. Busca en este recurso el mensaje de error o la advertencia que estés viendo para encontrar consejos para resolver el problema.
- Cómo crear bloques de contenido para Customer Hub
Aprende a crear bloques de contenido para tu Klaviyo Customer Hub. Los bloques de contenido son bloques altamente personalizables y adaptables que tienen acceso a los datos de perfil de Klaviyo, lo que te permite mostrar integraciones (p. ej., saldo de puntos de lealtad), ofertas personalizadas y más.