Cómo usar objetos personalizados en plantillas

Objetivos del artículo

Aprende a usar objetos personalizados en plantillas, para que puedas usar datos de objetos en envíos de flujos y campañas.

Para poder usar datos de objetos personalizados en las plantillas, primero debes crear un objeto.

Acceder a los datos de objetos desde el menú de personalización

Puedes personalizar bloques de texto en el editor de plantillas usando propiedades de un objeto personalizado o el recuento de registros de un objeto.

Aprende cómo usar el editor de plantillas de Klaviyo.

Para empezar a agregar datos de objetos en las plantillas:

1. Agrega un nuevo bloque de texto o selecciona un bloque de texto existente.
2. Haz doble clic en el bloque de texto y luego coloca el cursor donde quieras 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 menú desplegable Todos los tipos .

5. Dentro de Objetos, verás todos los objetos de la cuenta que puedes usar para extraer datos a la plantilla. Selecciona el objeto que contiene los datos que te gustaría usar en la plantilla.
6. Selecciona la propiedad del objeto específico o el filtro de objeto que quieras incluir en la plantilla. También puedes crear un nuevo filtro de objetos aquí.
7. Configura el texto predeterminado y cualquier estilo para el texto.

Para especificar las reglas de uso de mayú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 cómo modificar valores con filtros de Django.

Acceder a los datos de objetos con etiquetas de personalización

Puedes usar etiquetas de personalización en correos electrónicos (incluido el asunto del correo electrónico), mensajes SMS/MMS, notificaciones push y Klaviyo Customer Hub para mostrar datos de objetos.

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

Usar el objeto que activó un flujo

Estos ejemplos usan lo siguiente:

• Objeto llamado Mascota que se referencia con la etiqueta object en la plantilla. 
• Propiedad de objeto llamada Nombre

Recuperar un objeto por su 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.

Devuelve un único objeto de un filtro de objetos

Estos ejemplos usan lo siguiente:

• Un filtro de objeto adicional llamado oldest_dog
• Propiedad de objeto llamada 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

Recupera registros de objetos

Para recuperar los registros de objetos más recientes de un objeto, tendrás que recorrer todos los registros de objetos. Este ejemplo usa lo siguiente:

• Objeto llamado Pets

Datos de objeto en asuntos

Puedes personalizar los asuntos con cualquiera de las etiquetas de objeto personalizadas:

• {% object_filter %}
• {% object %}
• {% customobject %}

Por ejemplo, puedes usar la etiqueta {% object %} en el asunto del mensaje para mostrar directamente el nombre de la mascota de un cliente.

Vista de borrador:

Vista previa del correo electrónico:

Datos del objeto en la lógica de mostrar/ocultar

También puedes configurar si quieres mostrar u ocultar un bloque en una plantilla según los datos del objeto. Mostrar u ocultar dinámicamente un bloque según los datos del objeto usa 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.

Por ejemplo, si tienes un objeto Pet con una propiedad llamada Breed, puedes optar por mostrar un bloque solo a los dueños de mascotas con una raza de perro determinada usando la condición object.Breed .

Para configurar la lógica de mostrar/ocultar, haz clic en el bloque para el que quieras configurar las reglas y selecciona Usar código en la pestaña Mostrar.

Ingresa la condición directamente en el editor de código. Puedes usar filtros de objeto y la etiqueta de plantilla de objeto si es un mensaje para un flujo activado por fecha basado en datos de objetos.

Para tener más flexibilidad (p. ej., hacer que cierta información sea condicional en función de la información devuelta por {% customobject %} o {% customobjects %}), considera usar 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 que se devuelven en función de criterios específicos que estableces, para que puedas mostrar registros de un tipo determinado.

Crear un nuevo filtro de objetos

Para comenzar a crear un filtro de objetos:

1. Agrega un nuevo bloque de texto o edita el texto en un bloque de texto existente en la plantilla.
2. Selecciona el botón Personalización .

3. Dentro del modelo de personalización, selecciona Objetos en el menú desplegable Todos los tipos .
4. Selecciona el objeto que contiene los datos para los que te gustaría 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 objeto, establece la siguiente información:

• Nombre
  Crea un nombre para tu filtro de objetos.
• Filtrar condiciones
  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 el filtro de objetos, puedes usarlo en la lógica de mostrar/ocultar y en etiquetas de personalización para mostrar registros de objetos específicos según los criterios que configures.

Recursos adicionales