Referencia de personalización de mensajes

Hola: 15 minutos de lectura

Actualizado 22 nov 2024, 13:14 EST

Descubre cómo usar las variables de personalización (o etiquetas) de Klaviyo en tus mensajes de marketing para ofrecer una experiencia personalizada a tus suscriptores.

Las etiquetas de personalización se pueden usar en correos (incluido el asunto), mensajes SMS o MMS, y notificaciones push. En este artículo se describen algunas etiquetas disponibles, sus estructuras y formas, y cómo personalizarlas. Para saber cómo añadir personalización, consulta nuestro artículo sobre cómo añadir personalización a los mensajes.

Anteriormente, las etiquetas de personalización se llamaban «etiquetas de plantilla» y «sintaxis variable».

Información sobre las etiquetas de personalización

Al introducir etiquetas en el campo de texto de un mensaje, estas tienen el aspecto de la frase de la izquierda de la tabla que se muestra a continuación. Una vez enviado el mensaje, las etiquetas se sustituyen por la información del perfil del destinatario o del evento, y pasan a parecerse a la frase de la derecha.

Hola, {{ first_name }} {{ last_name }}, tu color favorito es el {{ person|lookup:'Favorite Color' }}.

Hola, Miguel de Cervantes, tu color favorito es el verde.

La personalización del perfil suele empezar con person, excepto algunas etiquetas especiales como first_name y last_name. Las variables de evento, que pueden utilizarse en flujos activados por métricas, empiezan por event. Las etiquetas de empresa (como el nombre y la dirección de tu empresa) empiezan por 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 aparece 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 quieres añadir propiedades personalizadas a tus mensajes, ve a la sección de personalización.

Etiqueta	Propiedad del perfil
`{{ email }}`	Email
`{{ first_name }}`	First name
`{{ last_name }}`	Last name
`{{ person.organization }}`	Recipient organization
`{{ person\|lookup:"$address1" }}`	Address 1
`{{ person.id }}`	Unique ID ($id/external ID)
`{{ person\|lookup:"$latitude" }}`	Latitude
`{{ person\|lookup:"$longitude" }}`	Longitude
`{{ person.KlaviyoID }}`	Klaviyo ID
`{{ person.full_name }}`	Full name
`{{ person.title }}`	Title
`{{ person.phone_number }}`	Phone Number
`{{ person\|lookup:'$address2' }}`	Address 2
`{{ person.City }}`	City
`{{ person.Region }}`	State / Region
`{{ person.Country }}`	Country
`{{ person.Zipcode }}`	Zip Code
`{{ person\|lookup:"$source" }}`	Source
`{{ person\|lookup:"$consent" }}`	Consent
`{{ 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" }}`	Recipient timezone
`{{ person\|lookup:'$consent_timestamp' }}`	$consent_timestamp
`{{ person\|lookup:'$phone_number_region' }}`	$phone_number_region
`{{ person.ViewedItems }}`	Recently viewed items
`{{ person\|lookup:"Expected Date Of Next Order" }}`	Expected date of next order

Etiquetas de organización

Las etiquetas de organización te permiten incluir información sobre tu empresa u organización en tus mensajes. Puedes gestionar esta información en Cuenta > Información de contacto > Organización. Todas las etiquetas de organización empiezan por organization. Consulta la tabla siguiente para ver la lista de etiquetas de organización.

Etiqueta de organización	Descripción
`{{ organization.name }}`	Nombre de la empresa
`{{ organization.url }}`	Sitio web de la empresa
`{{ organization.full_address }}`	Dirección completa de la empresa, con la ciudad, la provincia o región y el código postal
`{{ organization.street_address }}`	Dirección postal de la empresa
`{{ organization.street_address2 }}`	Segunda parte de la dirección de la empresa (por ejemplo, la escalera o la puerta)
`{{ organization.city }}`	Ciudad donde está ubicada la empresa
`{{ organization.region }}`	Provincia o región donde está ubicada la empresa
`{{ organization.zip_code }}`	Código postal de la empresa

Etiquetas de enlace y vista previa

Las etiquetas de enlace y vista previa permiten a los destinatarios gestionar sus preferencias de suscripción y ver tu mensaje en sus navegadores. Son estas:

Darse de baja
Gestionar preferencias
Vista web
Texto de vista previa

Estas etiquetas solo se admiten para plantillas de correo electrónico, no para SMS ni MMS. Si haces clic en uno de estos enlaces desde un correo electrónico de vista previa, se te dirigirá a una página de marcador de posición en lugar de una vista previa o página de consentimiento activa.

Darse de baja

Klaviyo requiere que se incluya en todos los correos un enlace para darse de baja. Usa una etiqueta de darse de baja sencilla para incluir un enlace con el texto «Darse de baja» o, si quieres, añade tu propio texto entre comillas.

Etiqueta	Resultado
`{% unsubscribe %}`	Darse de baja
Si no quieres seguir recibiendo correos, `{% unsubscribe 'click here' %}`.	Si no quieres seguir recibiendo correos, haz clic aquí.

Si lo prefieres, puedes usar la etiqueta {% unsubscribe_link %} para generar una URL para darse de baja. En lugar de generar una palabra o frase enlazada completa, esta etiqueta solo crea la URL para darse de baja. Utiliza esta etiqueta si quieres emplear un color para el enlace de baja distinto al que está establecido en los estilos de la plantilla o si quieres usar un botón o una imagen enlazados en lugar de un enlace de texto.

Etiqueta	Resultado
`Esto es un enlace para <a href="{% unsubscribe_link %}" >darse de baja</a> elegante.`	Esto es un enlace para darse de baja elegante.

Cuando un destinatario haga clic en el enlace para darse de baja, se le redirigirá a una página de confirmación personalizable.

Gestionar preferencias

Las páginas de preferencias permiten a los destinatarios actualizar sus preferencias. Esto te ayuda a segmentar y dirigir tus mensajes de forma más eficaz. Si quieres incluir un enlace a esta página para cada destinatario, usa la etiqueta de gestionar preferencias.

Puedes crear páginas de gestión de preferencias generales y páginas específicas de listas. Las páginas específicas de listas se usan cuando envías un mensaje solamente a una lista. Las páginas de gestión de preferencias generales se usan cuando 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 gestión de preferencias.

Usa una etiqueta de gestión de preferencias sencilla para incluir un enlace con el texto «Gestionar preferencias», o bien añade tu propio texto entre comillas.

Etiqueta	Resultado
`{% manage_preferences %}`	Gestionar preferencias
¿Quieres modificar tus preferencias? `{% manage_preferences 'Click here' %}`.	¿Quieres modificar tus preferencias? Haz clic aquí.

Si lo prefieres, puedes usar la etiqueta {% manage_preferences_link %} para generar una URL de gestión de preferencias. En lugar de generar una palabra o frase enlazada completa, esta etiqueta solo crea la URL de la página de preferencias del destinatario. Utiliza esta etiqueta si quieres emplear un color para el enlace distinto al que está establecido en los estilos de la plantilla o si quieres usar un botón o una imagen enlazados en lugar de un enlace de texto.

Etiqueta	Resultado
`Esto es un enlace para <a href="{% manage_preferences_link %}" >gestionar preferencias</a> elegante.`	Esto es un enlace para gestionar preferencias elegante.

Vista web

Puedes usar la etiqueta de vista web para ofrecer a los destinatarios la opción de ver un correo en su navegador web.

Etiqueta	Resultado
`{% web_view %}`	Ver en el navegador
¿No puedes ver este correo? `{% web_view 'Open in your browser' %}`.	¿No puedes ver este correo? Ábrelo en tu navegador.
`Esto es un enlace de <a href="{% web_view_link %}">vista web</a> elegante.`	Esto es un enlace de vista web elegante.

Texto de vista previa

En algunos casos, puede que quieras 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 utilizando la etiqueta {% render_variable preview_text %}.

Si modificas el texto de vista previa en la pantalla de vista previa del correo, esta etiqueta mostrará el texto de vista previa modificado.

Etiquetas de personalización y eventos personalizadas

Las etiquetas personalizadas hacen referencia a propiedades de 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 eventos hacen referencia a los datos de un evento específico (por ejemplo, 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 de correo y busca la etiqueta. Para añadir una etiqueta de evento, previsualiza el mensaje y copia la etiqueta de variable de evento de los datos de vista previa. Si lo prefieres, puedes utilizar los formatos que se describen a continuación para añadir manualmente etiquetas personalizadas a tus plantillas.

Formato de 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 de evento está anidada en los datos de 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 (por ejemplo, $), 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' sería correcto, pero event|lookup:'Collection Names'.0 no sería correcto.

Personaliza 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 que se usan de forma más frecuente son default y title.

El filtro default establece un valor predeterminado para que aparezca si los destinatarios de un mensaje no tienen establecida esa propiedad. En el ejemplo que se muestra a continuación, «amigo/a» y «golosinas riquísimas» se establecen como valores predeterminados en caso de que el nombre o la comida favorita de los destinatarios no estén establecidos en su perfil de Klaviyo.

Texto con etiquetas de personalización	Resultado
Hola, `{{ first_name\|default:'friend' }}`, ¿te apetecen unas `{{ person\|lookup:'Favorite Food'\|default:'tasty treats' }}`?	Hola, amigo/a, ¿te apetecen unas golosinas riquísimas?

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 utilicen el formato de 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, si usas el filtro title, corregirá el formato de mayúsculas o minúsculas para que su nombre aparezca correctamente (es decir, la primera letra aparecerá en mayúsculas y el resto en minúsculas, como en el ejemplo siguiente).

Texto con etiquetas de personalización	Resultado
Hola, `{{ first_name\|title }}`, ¿has visto nuestro último lanzamiento?	Hola, Elisa, ¿has visto nuestro último lanzamiento?

Hay decenas de filtros adicionales disponibles para tus mensajes. Consulta más información sobre cómo usar filtros para personalizar las etiquetas.

Etiquetas de fecha

Las etiquetas de fecha te ofrecen una forma rápida de insertar información sobre fechas en un correo. 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; rellena una marca de tiempo cuando se envía el mensaje. Para utilizar la etiqueta today, pega esta 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 hace falta 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 Placed Order y Added to Cart, entre otros, suelen tener un valor financiero asociado (por ejemplo, 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.

En este sentido, fíjate en el campo $value de la métrica Started Checkout que aparece a continuación:

Usando 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 representa con un símbolo de moneda y el número correcto de decimales:

Para usar la etiqueta de formato de moneda, sustituye 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á {% currency_format event.item.price %}. Si tu etiqueta incluye filtros (como un valor predeterminado 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

Hay 2 lugares en los que puedes configurar el formato de moneda para tus mensajes:

Para toda la cuenta
Ve a Configuración > Organización > Idioma de la organización y formato regional y selecciona un idioma para la organización.
Para un mensaje concreto
Selecciona un formato de moneda distinto para un único mensaje en la pestaña Estilos de la plantilla, en la sección Moneda.

Resolución de problemas de la etiqueta currency_format

Esta etiqueta solo es compatible con variables numéricas (por ejemplo, 10 o 24,56). Las propiedades con el símbolo de moneda incluido (como 40 € o 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 ofrecen controles de alto potencial con los que puedes personalizar tus 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. Por último, si no tiene ningún punto 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 solo necesitas 150 para ser VIP! 
{% else %}
¿Conoces el programa VIP? Apúntate hoy en nuestro sitio web y empieza a conseguir recompensas.
{% endif %}

Dentro de una declaración «if», se requiere una condición {% if … %} de apertura, así como la etiqueta {% endif %} de cierre. Todos los demás elementos (es decir, las etiquetas {% elif %} y {% else %}) son opcionales. Puedes usar todas las etiquetas {% elif %} que quieras, seguidas de un máximo de una etiqueta {% else %}. Cada destinatario de correo solo verá el primer mensaje para el que cumpla los requisitos.

Declaraciones «for»

Con los bloques «for», puedes iterar cada elemento de una variable que está almacenando una lista y generarlos por separado. A continuación se muestra un ejemplo de declaración:

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

1 toalla de playa extragrande

4 sillas de playa

2 protectores solares FPS

1 nevera de plástico

Cada declaración for debe contener lo siguiente:

Una etiqueta {% for … %} de apertura que contenga 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 {% endfor %} de cierre

Entre las dos etiquetas obligatorias, puedes incluir el texto que quieras. Para incluir variables anidadas dentro de la colección de filas, sustituye 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 }} pasaría a {{ item.name }}.

Sentencias condicionales y editor de texto integrado

Cuando añadas determinadas sentencias condicionales a un bloque de texto, es posible que desaparezcan del editor de texto integrado. El código seguirá estando ahí, pero oculto. Para ver y editar sentencias condicionales, abre el campo Código fuente del bloque de texto.

Las etiquetas siguientes solo son visibles en el campo Código fuente de un bloque de texto:

{% for ... %}
{% endfor %}
{% if ... %}
{% elif ... %}
{% else %}
{% endif %}
{% with ... %}
{% endwith %}

Recursos adicionales

¿Te ha resultado útil este artículo?

Utiliza este formulario solo para enviar comentarios sobre el artículo. Más información sobre cómo contactar con el servicio de asistencia.

Descubre más de Klaviyo

Comunidad

Conecta con compañeros, socios y expertos de Klaviyo para inspirarte, compartir ideas y resolver todas tus dudas.

Visitar la comunidad

Formación en directo

Únete a una sesión en directo con expertos de Klaviyo para conocer las prácticas recomendadas, cómo configurar funciones clave y mucho más.

Registrarse ahora

Asistencia

Accede al servicio de asistencia a través de tu cuenta.

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

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

Iniciar sesión