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.
Antes de poder usar datos de objetos personalizados en las plantillas, primero debes crear un objeto.
Acceder a los datos de objetos a través del menú de personalización
Puedes personalizar los bloques de texto en el editor de plantillas usando propiedades de un objeto personalizado o el recuento de registros de un objeto.
Descubre cómo usar el editor de plantillas de Klaviyo.
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 tu propiedad dinámica.
- Selecciona el botón Personalización en la parte superior derecha.
- 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 la propiedad del objeto específica o el filtro de objeto que quieres incluir en la plantilla. También puedes crear aquí un nuevo filtro de objeto.
- Configura el texto predeterminado y cualquier estilo para tu texto.
Para especificar las reglas de uso de mayúsculas y minúsculas para los datos de objetos, tendrás que configurar la regla manualmente en la etiqueta de personalización. Por ejemplo:
- {{ 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 oldest_dog
- Propiedad de objeto llamada Nombre
Estructura | Ejemplo |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldest_dog.Name }} |
{{ object_filter.object_filter_name | lookup: 'object_property' }} | {{ object_filter.oldest_dog | lookup: 'Nombre' }} |
Devuelve un número entero de un filtro de objetos
Estos ejemplos usan lo siguiente:
- Un filtro de objetos adicional llamado count_of_dogs
Estructura | Ejemplo |
{{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
Recuperar registros de objetos
Para recuperar los registros de objetos más recientes de un objeto, tendrás que recorrer en bucle todos los registros de objetos. Este ejemplo usa lo siguiente:
- Objeto llamado Mascotas
Estructura | Ejemplo |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet Profile" as pets %} |
Datos del objeto en el asunto
Puedes personalizar el asunto con cualquiera de las etiquetas de objetos personalizados:
- {% object_filter %}
- {% object %}
- {% customobject %}
Por ejemplo, puedes usar la etiqueta {% object %} en el asunto de tu mensaje para mostrar el nombre de la mascota de un cliente directamente.
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 de objetos. Mostrar u ocultar dinámicamente un bloque en función de los datos de objetos utiliza las mismas etiquetas que el editor de plantillas. Puedes hacer referencia a objetos por ID, a propiedades de los filtros de objetos o a agregados de los filtros de objetos.
Debes crear filtros de objetos antes de poder hacer referencia a ellos en la lógica de mostrar/ocultar.
Por ejemplo, si tienes un objeto Mascota con una propiedad llamada Raza, puedes elegir mostrar un bloque solo a los dueños de mascotas con una determinada raza de perro mediante la condición object.Breed .
Para configurar la lógica de mostrar/ocultar, haz clic en el bloque para el que quieras establecer las reglas y selecciona Usar código en la pestaña Mostrar.
Introduce la condición directamente en el editor de código. Puedes usar filtros de objetos y la etiqueta de plantilla de objetos si se trata de un mensaje de un flujo activado por fecha basado en datos de objetos.
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 objeto te permiten limitar los registros de objeto devueltos según criterios específicos que establezcas, para que puedas mostrar registros de un tipo determinado.
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 modelo de personalización, selecciona Objects en el menú desplegable All types .
- Selecciona el objeto que contiene los datos para los que quieres establecer un filtro.
- Selecciona la propiedad del objeto para la que te gustaría establecer un filtro.
- Selecciona Crear filtro.
En el modal Crear filtro de objetos, configura la siguiente información:
- Nombre
Crea un nombre para el filtro de objetos. - Condiciones del filtro
Define las reglas que debe cumplir un objeto para incluirse en el bloque de texto. - Comportamiento cuando varios registros cumplen las condiciones
Define el comportamiento para los casos en los que varios registros cumplen las condiciones.
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.