Cómo utilizar objetos personalizados en plantilla

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ó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:

1. Agrega un nuevo bloque de texto o selecciona uno ya existente.
2. Haz doble clic en el bloque de texto y luego coloca el cursor donde desees insertar la propiedad dinámica.
3. Selecciona el botón Personalización en la parte superior derecha.

4. En el modal de personalización, selecciona Objetos en el desplegable Todos los tipos .

5. 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.
6. 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.
7. 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 Pérez
• {{ 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 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 referencia

Puedes utilizar la siguiente etiqueta de plantilla con objetos.

Utilizar el objeto que desencadenó un flujo

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

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.

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

Devuelve un entero de un filtro de objetos

Estos ejemplos utilizan lo siguiente:

• Un filtro de objetos adicional llamado cuenta_de_perros

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

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.

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 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 objetos

Para empezar a crear un filtro de objetos:

1. Añade un nuevo bloque de texto o edita el texto de un bloque de texto existente en tu plantilla.
2. Selecciona el botón Personalización .

3. Dentro del modelo de personalización, selecciona Objetos en el desplegable Todos los tipos .
4. Selecciona el objeto que contiene los datos para los que quieres establecer un filtro.
5. Selecciona la propiedad del objeto para la que quieras establecer un filtro.
6. 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 filtro
  Define las reglas que debe cumplir un objeto para ser incluido 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 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 adicionales