Cómo utilizar objetos personalizados en plantilla
Debes tener acceso a los objetos personalizados para utilizar esta funcionalidad.
Objetivos de aprendizaje
Aprende a utilizar objetos personalizados en plantilla, para poder utilizar datos de objetos en envíos de flujo y campaña.
Debes crear primero un objeto antes de poder utilizar datos de objetos personalizados en plantilla.
Acceder a los datos del objeto a través del menú de personalizaciónAcceder a los datos del objeto a través del menú de personalización
Puedes personalizar el bloque de texto en el editor de plantilla utilizando las propiedades de un objeto personalizado, o el recuento de registros de un objeto.
Aprende a utilizar el editor de plantillas de Klaviyo.
Para empezar a añadir datos de objetos en tu plantilla:
- Añade un nuevo bloque de texto o edita el texto de un bloque de texto existente en tu plantilla.
- Selecciona el botón Personalización en la parte superior derecha.
- En el modal de personalización, selecciona Objetos en el desplegable Todos los tipos .
- Dentro de Objetos, verás todos los objetos de tu cuenta que puedes utilizar para introducir datos en la plantilla. Selecciona el objeto que contiene los datos que quieres utilizar en la plantilla.
- Selecciona la propiedad de objeto o el filtro de objeto concretos que quieras incluir en la plantilla. También puedes crear aquí un nuevo filtro de objetos.
- Establece el texto por defecto y cualquier estilo para tu texto.
Para especificar las reglas de uso de mayúsculas para los datos de los objetos, tendrás que establecer manualmente la regla en la etiqueta de plantilla. Por ejemplo:
-
{{ object.full_name|title|default:'value' }}
Juan Nadie -
{{ object.full_name|upper|default:'value' }}
JOHN DOE -
{{ object.full_name|lower|default:'value' }}
Juan Pérez
Más información sobre la modificación de valores con filtros Django.
Acceder a datos de objetos con etiqueta de plantillaAcceder a datos de objetos con etiqueta de plantilla
Puedes utilizar la etiqueta de plantilla en correo electrónico (incluido el asunto del correo electrónico), SMS/MMS mensajes, notificación push, y Klaviyo Customer Hub para mostrar datos de objetos.
Aprende a utilizar la etiqueta de plantilla en Klaviyo.
Objeto etiqueta de plantilla referenciaObjeto etiqueta de plantilla referencia
Puedes utilizar la siguiente etiqueta de plantilla con objetos.
Utilizar el objeto que desencadenó un flujo
{{ object }} sólo está disponible cuando un objeto ha activado un flujo. El {{ object }} etiqueta de plantilla sólo está disponible en fecha desencadenada flujo basado en un objeto. Es similar a la {{ event }} etiqueta de plantilla para flujo activado por evento.
Estos ejemplos utilizan lo siguiente:
- Objeto llamado Mascota al que se hace referencia con la etiqueta de objeto en la plantilla.
- Propiedad del objeto llamada Nombre
| Estructura | Ejemplo |
| {{ object.object_property }} | {{ object.Name }} |
| {{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Obtener un objeto por ID
Estos ejemplos utilizan lo siguiente:
- Objeto llamado Mascota
- Propiedad del objeto llamada Nombre
- Evento que desencadenó el flujo con una propiedad de objeto llamada pet_id. Este campo es el mismo que el ID del objeto Mascota.
| Estructura | Ejemplo |
|
{% customobject event.object_id object_type_title="Title" as alias %} {{ alias.object_property }} {% endcustomobject %} |
{% customobject event.pet_id object_type_title="Pet" as pet %} {{ pet.Name }} {% endcustomobject %} |
|
{% customobject event.object_id object_type_title="Title" as alias %} {{ alias | lookup:'object_property' }} {% endcustomobject %} |
{% customobject event.pet_id object_type_title="Pet" as pet %} {{ pet | lookup:'Name' }} {% endcustomobject %} |
Devuelve un único objeto de un filtro de objetos
Estos ejemplos utilizan lo siguiente:
- Un filtro de objetos adicional llamado perro_más_viejo
- Propiedad del 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: 'Name' }} |
Devuelve un entero de un filtro de objetos
Estos ejemplos utilizan lo siguiente:
- Un filtro de objetos adicional llamado cuenta_de_perros
| Estructura | Ejemplo |
| {{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
Recuperar registros de objetos
Para recuperar los registros de objeto más recientes de un objeto, tendrás que recorrer en bucle todos los registros de objeto. Este ejemplo utiliza lo siguiente:
- Objeto llamado Mascotas
| Estructura | Ejemplo |
| {% customobjects object_type_title="Title" as alias %}
{% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %} |
{% customobjects object_type_title="Pet Profile" as pets %} |
Datos del objeto en cuestión
Puedes personalizar tu asunto con cualquiera de los objetos personalizados etiqueta:
- {% object_filter %}
- {% object %}
- {% customobject %}
Por ejemplo, puedes utilizar la etiqueta {% object %} en el asunto de tu mensaje para mostrar directamente el nombre de la mascota de un cliente.
Vista preliminar:
Vista previa del correo electrónico:
Datos del objeto en la lógica mostrar/ocultar
También puedes configurar si mostrar u ocultar bloque en una plantilla en función de los datos del objeto. Mostrar u ocultar dinámicamente un bloque en función de los datos del objeto utiliza la misma etiqueta que el editor de plantillas. Puedes hacer referencia a objetos por ID, propiedades de filtros de objetos o agregados de 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 sólo a los dueños de mascotas con una determinada raza de perro utilizando la condición object.Breed .
Para establecer 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 utilizar filtros de objeto y la etiqueta de plantilla de objeto si se trata de un mensaje para un flujo activado por fecha basado en datos de objeto.
Para una mayor flexibilidad (por ejemplo, hacer que alguna información sea condicional a la información devuelta por {% customobject %} o {% customobjects %}), entonces considera utilizar la lógica condicional avanzada con la lógica {% if … %} directamente en un bloque de texto.
Filtros de objetosFiltros de objetos
¿Qué es un filtro de objetos?¿Qué es un filtro de objetos?
Los filtros de objetos te permiten limitar los registros de objetos devueltos en función de los criterios específicos que establezcas, de forma que puedas mostrar registros de un determinado tipo.
Crear un nuevo filtro de objetosCrear un nuevo filtro de objetos
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 Personalización .
- Dentro del modelo de personalización, selecciona Objetos en el desplegable Todos los tipos .
- Selecciona el objeto que contiene los datos para los que quieres establecer un filtro.
- Selecciona la propiedad del objeto para la que quieras establecer un filtro.
- Selecciona Crear nuevo filtro.
En el modal Crear filtro de objetos, establece la siguiente información:
-
Nombre
Crea un nombre para tu filtro de objetos. -
Condiciones de filtrado
Define las reglas que debe cumplir un objeto para ser incluido en el bloque de texto. -
Comportamiento cuando varios registroscumplen las condiciones
Define el comportamiento para los casos en los que varios registros cumplen las condiciones.
Una vez creado tu filtro de objetos, puedes utilizarlo en la lógica de mostrar/ocultar y en la etiqueta de plantilla para mostrar registros de objetos específicos en función de los criterios que establezcas.
Recursos adicionalesRecursos adicionales
Referencia de personalización de mensajes
Cómo usar el panel de vista previa para la personalización de mensajes