Cómo usar objetos personalizados en plantillas
Debes tener acceso a objetos personalizados para usar esta funcionalidad.
Qué aprenderás
Descubre cómo usar objetos personalizados en las plantillas para poder usar datos de objetos en los envíos de flujos y campañas.
Para poder usar datos de objetos personalizados en las plantillas, primero debes crear un objeto. Para el menú de personalización, los filtros de objetos y las listas de registros de destinatarios, usa un objeto con una relación de perfil. Sus registros deben estar vinculados al destinatario para que aparezcan en su mensaje.
Acceder a los datos de objetos a través del menú de personalización
Puedes personalizar bloques de texto en el editor de plantillas de arrastrar y soltar usando propiedades de un objeto personalizado o el recuento de registros de un objeto.
Descubre cómo usar el editor de plantillas de Klaviyo.
Si empiezas con una plantilla HTML, puedes crear primero una copia de arrastrar y soltar:
- Ve a Contenido > Plantillas y, a continuación, abre Email: guardado. Abre el menú de 3 puntos de la plantilla HTML y selecciona Clonar al editor de arrastrar y soltar.
- Abre Plantillas convertidas para comprobar el progreso. Cuando el estado sea Listo para usar, haz clic en el nombre de la plantilla convertida para abrirla.
- Revisa el diseño del texto y el contenido personalizado antes de usarlo. La plantilla HTML original no cambia.
Para empezar a añadir datos de objetos a tus plantillas:
- Añade un nuevo bloque de texto o selecciona un bloque de texto existente.
- Haz doble clic en el bloque de texto y, a continuación, coloca el cursor donde quieras insertar la propiedad dinámica.
- Selecciona el botón Personalization en la barra de herramientas de texto.

- En la ventana modal de personalización, selecciona Objetos en el menú desplegable Todos los tipos .

- Dentro de Objetos, verás todos los objetos de tu cuenta que puedes usar para extraer datos en la plantilla. Selecciona el objeto que contiene los datos que te gustaría usar en la plantilla.
- Selecciona una propiedad para mostrar o Número de objetos para mostrar un recuento. A continuación, selecciona un filtro de objetos. También puedes crear aquí un filtro de objetos nuevo.
- Haz clic en Insertar después de seleccionar un filtro existente. Si creas un filtro nuevo, se inserta su etiqueta cuando termines de crearlo.
- Aplica los estilos de texto que necesites. Para un valor de propiedad, añade texto predeterminado editando su etiqueta para incluir
|default:'value'. Sustituyevaluepor el texto que quieras mostrar cuando la propiedad esté vacía.
Para especificar las reglas de uso de mayúsculas y minúsculas para los datos de objetos, tendrás que configurar manualmente la regla en la etiqueta de personalización. Por ejemplo, estas etiquetas usan el objeto que activó un flujo activado por fecha:
- {{ object.full_name|title|default:'value' }}
John Doe - {{ object.full_name|upper|default:'value' }}
JOHN DOE - {{ object.full_name|lower|default:'value' }}
john doe
Más información sobre modificar valores con filtros de Django.
Acceder a los datos de objetos con etiquetas de personalización
Puedes usar etiquetas de personalización en emails (incluida la línea de asunto del email), mensajes SMS/MMS, notificaciones push y Klaviyo Customer Hub para mostrar datos de objetos.
Descubre cómo usar etiquetas de personalización en Klaviyo.
Referencia de etiquetas de personalización de objetos
Puedes usar las siguientes etiquetas de personalización con objetos.
Uso del objeto que activó un flujo
{{ object }} solo está disponible cuando un objeto ha activado un flujo. La etiqueta de plantilla {{ object }} solo está disponible en flujos activados por fecha basados en un objeto. Esto es similar a la etiqueta de plantilla {{ event }} para flujos activados por eventos.
Estos ejemplos usan lo siguiente:
- Objeto llamado Mascota al que se hace referencia con la etiqueta de objeto en la plantilla.
- Propiedad de objeto llamada Nombre
Estructura | Ejemplo |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Obtener un objeto por ID
Estos ejemplos usan lo siguiente:
- Objeto llamado Mascota
- Propiedad de objeto llamada Nombre
- Evento que activó el flujo con una propiedad de objeto llamada pet_id. Este campo es el mismo que el ID del objeto para el objeto Pet.
Estructura | Ejemplo |
{% customobject event.object_id object_type_title="Title" as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
{% evento de objeto personalizado.object_id object_type_title=«Título» como alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
Devuelve un único objeto de un filtro de objetos
Estos ejemplos usan lo siguiente:
- Un filtro de objetos adicional llamado oldestDog
- Propiedad de objeto llamada Nombre
Estructura | Ejemplo |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldestDog.Name }} |
{{ object_filter.object_filter_name | lookup:'object_property' }} | {{ object_filter.oldestDog | lookup:'Name' }} |
Devuelve un número entero de un filtro de objetos
Estos ejemplos usan lo siguiente:
- Un filtro de objeto adicional llamado countOfDogs
Estructura | Ejemplo |
{{ object_filter.object_filter_name }} | {{ object_filter.countOfDogs }} |
Devuelve varios objetos de un filtro de objetos
Para un filtro llamado dogs configurado con Múltiple, recorre los registros coincidentes para mostrar la propiedad Name de cada mascota:
{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}
Recuperar registros de objetos
Usa customobjects para recuperar hasta 5 registros vinculados al destinatario, ordenados desde el más reciente añadido hasta el más antiguo. Recorre en bucle esos registros devueltos para mostrar sus propiedades. Este ejemplo utiliza lo siguiente:
- Objeto llamado perfil de mascota
- Propiedad de objeto llamada name
Estructura | Ejemplo |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet Profile" as pets %} |
Datos del objeto en el asunto
Usa la misma sintaxis de objeto personalizado en los asuntos que en el cuerpo del mensaje. Estos ejemplos muestran la sintaxis para cada fuente de datos:
{{ object_filter.oldestDog.Name }}muestra la propiedad Name del filtro de objeto único oldestDog.{{ object.Name }}muestra la propiedad Name del objeto que activó un flujo activado por fecha.{% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}Busca un registro de Pet por ID. Úsalo en un flujo activado por un evento que contenga pet_id.
Por ejemplo, usa {{ object.Name }} en un flujo activado por fecha basado en el objeto Pet para mostrar el nombre de la mascota de un cliente en el asunto.
Vista de borrador:

Vista previa de Email:
Datos de objetos en la lógica de mostrar/ocultar
También puedes configurar si quieres mostrar u ocultar un bloque en una plantilla en función de los datos del objeto. Usa una propiedad o un recuento de un filtro de objetos, o el objeto que activó un flujo activado por fecha. Puedes usar datos de objeto en una única condición de mostrar/ocultar o en la condición de cada variante de lógica de mostrar/ocultar. Para los datos recuperados por ID, usa la lógica condicional avanzada que se describe a continuación.
Debes crear filtros de objetos antes de poder hacer referencia a ellos en la lógica de mostrar/ocultar.
Por ejemplo, en un flujo activado por fecha basado en un objeto Mascota, usa object.Breed == 'Labrador' para mostrar un bloque solo cuando la Raza de la mascota que activa el flujo sea Labrador. Usa el valor exacto de raza de los datos.
- Selecciona el bloque y abre la pestaña Visualización. En Mostrar/ocultar lógica, selecciona Mostrar solo a una audiencia específica o selecciona Personalizar para varias audiencias para crear variantes de lógica. A continuación, selecciona Usar código.
- Introduce una condición como
object_filter.countOfDogs > 0sin{{ }}ni{% %}alrededor. Los filtros de objeto se pueden usar en campañas y flujos. Usaobjectsolo en un flujo activado por fecha en función de los datos del objeto. - Haz clic en Guardar para aplicar la condición.

Las secciones de objetos personalizados admiten la lógica de mostrar/ocultar para una sola audiencia. Las variantes de la lógica no están disponibles para ellos. Más información sobre las variantes de lógica de mostrar/ocultar.
Para tener más flexibilidad (p. ej., para que cierta información sea condicional en función de la información que devuelve {% customobject %} o {% customobjects %}), plantéate usar la lógica condicional avanzada con la lógica {% if ... %} directamente en un bloque de texto.
Filtros de objetos
¿Qué es un filtro de objetos?
Los filtros de objetos seleccionan registros vinculados a cada destinatario mediante los criterios que se establezcan. Se puede mostrar una propiedad de 1 registro coincidente, propiedades de hasta 10 registros coincidentes o un recuento de registros coincidentes.
Crear un filtro de objetos nuevo
Para empezar a crear un filtro de objetos:
- Añade un nuevo bloque de texto o edita el texto de un bloque de texto existente en tu plantilla.
- Selecciona el botón Personalization .

- En el modal de personalización, selecciona Objetos en el menú desplegable Todos los tipos .
- Selecciona el objeto que contiene los datos para los que quieres establecer un filtro.
- Selecciona la propiedad que quieres mostrar. Para crear un filtro de recuento en su lugar, selecciona Número de objetos.
- Haz clic en Crear si todavía no hay filtros. Si hay filtros en la lista, déjalos sin seleccionar y haz clic en Crear filtro de objeto.
En el modal Crear filtro de objetos, configura la siguiente información:
- Nombre
Introduce un nombre único que contenga solo letras y números, como oldestDog. No uses espacios ni caracteres especiales. - Establecer condiciones del filtro
Define las reglas que debe cumplir un objeto para incluirse en el bloque de texto. - ¿Cuántos objetos deben mostrarse?
Para un valor de propiedad, selecciona Único para 1 registro o Múltiple para hasta 10 registros. Los filtros de recuento no muestran esta configuración. - Selecciona la propiedad y el orden de clasificación
Para un filtro de propiedad-valor, elige la propiedad que se usa para seleccionar u ordenar registros y, después, elige su orden de clasificación. Por ejemplo, ordena por una propiedad de cumpleaños con Más antiguo para seleccionar primero a la mascota de mayor edad. Estos campos no aparecen en los filtros de recuento.

Haz clic en Crear filtro de objetos para guardar el filtro e insertar su etiqueta en el bloque de texto.
Una vez que hayas creado tu filtro de objetos, puedes usarlo en la lógica de mostrar/ocultar y en las etiquetas de personalización para mostrar registros de objetos específicos en función de los criterios que establezcas.
Recursos adicionales
- Introducción a los objetos personalizados
Obtén información sobre los objetos personalizados, que te permiten almacenar y asociar varias propiedades a un solo «objeto». Los objetos personalizados te permiten asignar conceptos de datos diversos y multirelacionales a Klaviyo que no pueden almacenarse utilizando propiedades de perfil. Luego, puedes usar objetos personalizados en tus mensajes, segmentos y más.
- Referencia de personalización de mensajes
Descubre cómo usar las etiquetas de plantilla de Klaviyo para personalizar la experiencia de los clientes.
- Cómo usar el panel de vista previa para la personalización de mensajes
Descubre cómo 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 información fiable para las opciones de personalización.