Objetivos del artículo

Objetivos del artículo

Descubre cómo usar las variables de personalización (o etiquetas) de Klaviyo en tus mensajes de marketing y en Klaviyo Customer Hub para ofrecerles una experiencia única a tus suscriptores.

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

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, {{ first_name }} {{ last_name }}: tu color favorito es el {{ person|lookup:'Favorite Color' }}.

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

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

{{ email }}

Correo electrónico

{{ first_name }}

Nombre

{{ last_name }}

Apellidos

{{ person.organization }}

Organización del destinatario

{{ person|lookup:"$address1" }}

Dirección 1

{{ person.id }}

ID único ($id/external ID)

{{ person|lookup:"$latitude" }}

Latitud

{{ person|lookup:"$longitude" }}

Longitud

{{ person.KlaviyoID }}

ID de Klaviyo

{{ person.full_name }}

Nombre completo

{{ person.title }}

Título

{{ person.phone_number }}

Número de teléfono

{{ person|lookup:'$address2' }}

Dirección 2

{{ person.City }}

Ciudad

{{ person.Region }}

Estado/región

{{ person.Country }}

País

{{ person.Zipcode }}

Código postal

{{ person|lookup:"$source" }}

Fuente

{{ person|lookup:"$consent" }}

Consentimiento

{{ person|lookup:'$consent_form_id' }}

$consent_form_id

{{ person|lookup:'$consent_form_version' }}

$consent_form_version

{{ person|lookup:'$consent_method' }}

$consent_method

{{ person|lookup:"$timezone" }}

Zona horaria del destinatario

{{ person|lookup:'$consent_timestamp' }}

$consent_timestamp

{{ person|lookup:'$phone_number_region' }}

$phone_number_region

{{ person.ViewedItems }}

Artículos vistos recientemente

{{ person|lookup:"Expected Date Of Next Order" }} 

Fecha prevista del próximo pedido

Etiquetas de objetos personalizados

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. 

Etiqueta Resultado
{{ object.object_property }} Devuelve el objeto que activó un flujo 
{{ object | lookup:'object_property' }} 

{{ object_filter.object_filter_name.object_property}}

Devuelve un único objeto de un filtro de objetos 
{{ object_filter.object_filter_name | lookup: 'object_property' }}
{{ object_filter.object_filter_name }}Devuelve un recuento de un filtro de objetos

{% customobject id={{ event.object_id }} as alias %}

Recuperar un objeto por su ID

{% customobjects object_type_title=“Title” as alias %}
{% for object_instance in alias %}
{{ object_instance.record }}
{% endfor %}
{% endcustomobjects %}

Recuperar todos los registros de un objeto de un perfil
Etiquetas de organización

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

{{ organization.name }}

Nombre de la organización

{{ organization.url }}

Sitio web de la organización

{{ organization.full_address }}

Dirección completa de la organización, lo que incluye la ciudad, el estado/región y el código postal

{{ organization.street_address }}

Dirección postal de la organización

{{ organization.street_address2 }}

La segunda parte de la dirección de la organización (p. ej., el número de departamento o unidad)

{{ organization.city }}

Ciudad de la organización

{{ organization.region }}

Estado, provincia o región de la organización

{{ organization.zip_code }}

Código postal de la organización

Etiquetas de enlace y vista previa

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: 

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

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

{% unsubscribe %}

Cancelar la suscripción

Si ya no deseas recibir correos electrónicos, {% unsubscribe 'click here' %}.

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 <a href="{% unsubscribe_link %}" >cancelar la suscripción</a> .

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

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

{% manage_preferences %}

Administrar preferencias

¿Deseas actualizar tus preferencias? {% manage_preferences 'Click here' %}.

¿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 <a href="{% manage_preferences_link %}" >administrar preferencias</a>.

Este es un enlace sofisticado para administrar preferencias.

Vista web

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

{% web_view %}

Ver en el navegador

¿No puedes ver este correo electrónico? {% web_view 'Open in your browser' %}.

¿No puedes ver este correo electrónico? Abrir en el navegador.

Este es un enlace sofisticado de <a href="{% web_view_link %}">vista web</a> .

Este es un enlace sofisticado de vista web
Texto de vista previa

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

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

{{ person.property_name }}

Etiqueta de personalización del perfil sencilla

{{ person.Birthday }}

{{ person|lookup:'property name' }}

Etiqueta de personalización del perfil, si el nombre de la propiedad contiene espacios o caracteres especiales

{{ person|lookup:'Favorite Color' }}

{{ event.property_name }}

Etiqueta de variable de evento sencilla

{{ event.URL }}

{{ event|lookup:'property name' }}

Etiqueta de variable de evento, si el nombre de la variable contiene espacios o caracteres especiales

{{ event|lookup:'$value' }}

{{ event.property.nested_variable }}

Etiqueta de variable de evento, si la variable del evento está anidada en los datos del evento 

{{ event.extra.checkout_url }}

{{ event|lookup:'property name'|lookup:'nested variable name' }}

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

{{ event|lookup:'Coupon Codes'|lookup:'0' }}

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

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, {{ first_name|default:'friend' }}, ¿te gustaría probar {{ person|lookup:'Favorite Food'|default:'tasty treats' }}?

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, {{ first_name|title }}, ¿viste nuestro último lanzamiento?

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 

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 

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

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”

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”

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: 

{% for item in event.shopping_cart_items %}{{ item.name }} × {{ item.quantity }} {% endfor %}

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

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

Recursos adicionales

¿Te resultó útil este artículo?
Usa este formulario solo para enviar comentarios sobre el artículo. Más información sobre cómo contactar al equipo de asistencia.

Descubre más sobre Klaviyo

Comunidad
Conecta con colegas, socios y expertos de Klaviyo para inspirarte, compartir ideas y resolver todas tus dudas.
Capacitación en vivo
Únete a una sesión en tiempo real con expertos de Klaviyo para conocer las mejores prácticas, cómo configurar funciones clave y mucho más.
Asistencia

Accede a la asistencia a través de tu cuenta.

Asistencia por correo electrónico (prueba gratuita y cuentas de pago) Disponible 24/7

Asistencia virtual/por chat
La disponibilidad varía según la ubicación y el tipo de plan