Cómo utilizar objetos personalizados en plantilla

Hola: 5 minutos de lectura
|
Actualizado 7 abr 2025, 18:55 EST
Qué aprenderás

Qué aprenderás

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 

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. 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 en la parte superior derecha. 

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

  1. 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. 
  2. 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.
  3. Establece el texto por defecto y cualquier estilo para tu texto.

Para especificar las reglas de mayúsculas y minú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 Django filtro. 

Acceder a datos de objetos con etiqueta de plantilla

Acceder a datos de objetos con etiqueta de plantilla

Puedes utilizar la etiqueta de plantilla en correo electrónico (incluido el asunto de 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 objeto de la plantilla.  
  • Propiedad del objeto llamada Nombre
EstructuraEjemplo
{{ 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

{% get_object id={{ event.object_id }} as alias %}
{{ alias.object_property }}
{% endget_object %}

{% get_object id={{ event.pet_id }} as pet %}
{{ pet.Name }}
{% endget_object %}

{% get_object id={{ event.object_id }} as alias %}
{{ alias | lookup:'object_property' }}
{% endget_object %}

{% get_object id={{ event.pet_id }} as pet %}
{{ pet | lookup:'Name' }}
{% endget_object %}

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
EstructuraEjemplo

{{ 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 recuento

Estos ejemplos utilizan lo siguiente:

  • Objeto llamado Mascota
  • Un filtro de objetos llamado cuenta_de_mascotas
EstructuraEjemplo
{{ object.object_filter }}{{ Pet.count_of_pets }}
{{ object | lookup:'object_filter' }}{{ Pet | lookup:'count_of_pets' }}

Devuelve un recuento de un filtro de objetos 

Estos ejemplos utilizan lo siguiente:

  • Un filtro de objetos adicional llamado cuenta_de_perros
EstructuraEjemplo
{{ object_filter.object_filter_name }}{{ object_filter.count_of_dogs }}

 

Datos de objeto en la lógica mostrar/ocultar

Datos de 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 del filtro de objetos o agregados del filtro 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. 

Objeto filtro

Objeto filtro

¿Qué es un filtro de objetos?

¿Qué es un filtro de objetos?

El filtro de objetos te habilita para limitar los registros de objetos devueltos en función de criterios específicos que tú establezcas, de modo que puedas mostrar registros de un tipo determinado. 

Crear un nuevo filtro de objetos

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

  1. Dentro del modelo de personalización, selecciona Objetos en el desplegable Todos los tipos
  2. Selecciona el objeto que contiene los datos para los que quieres establecer un filtro. 
  3. Selecciona la propiedad del objeto para la que quieras establecer un filtro. 
  4. 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 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 adicionales 

Recursos adicionales 

Primeros pasos con objetos

Referencia de personalización de mensajes

Cómo usar el panel de vista previa para la personalización de mensajes

¿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.
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.
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