Cómo utilizar objetos personalizados en plantilla
Debe tener acceso a los objetos personalizados para utilizar esta funcionalidad.
Qué aprenderás
Aprende a utilizar objetos personalizados en plantilla, para poder utilizar datos de objetos en envíos de flujo y campaña.
Debe 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.
Aprenda 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.
- Seleccione la propiedad de objeto o el filtro de objeto específicos que desea incluir en la plantilla. También puede crear aquí un nuevo filtro de objetos.
- 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 plantillaAcceder 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.
Aprenda 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 desencadenado un flujo. El {{ object }} etiqueta de plantilla sólo está disponible en fecha desencadenada flujo basado en un objeto. Esto es similar a la {{ event }} etiqueta de plantilla para el flujo desencadenado por eventos.
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 %} |
{% customobject {{ event.pet_id }} object_type_title="Mascota" como mascota %} |
|
{% customobject {{ event.object_id }} object_type_title="Title" as alias %} |
{% customobject {{ event.pet_id }} object_type_title="Mascota" como 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
| 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 a partir 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á 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 %} |
Objeto datos en asunto de correo electrónico
Puede personalizar su asunto de correo electrónico con cualquiera de los objetos personalizados etiqueta:
- {% object_filter %}
- {% object %}
- {% customobject %}
Por ejemplo, puede utilizar la etiqueta {% object %} en el asunto de correo electrónico de su mensaje para mostrar directamente el nombre de una mascota cliente.
Vista preliminar:
Email vista previa:
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.
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.
Introduzca la condición directamente en el editor de código. Puede utilizar el objeto filtro y el objeto etiqueta de plantilla si se trata de un mensaje para un flujo activado por fecha basado en datos de objeto.
Si desea una mayor flexibilidad (por ejemplo, condicionar cierta información a la devuelta por {% customobject %} o {% customobjects %}), considere la posibilidad de utilizar una lógica condicional avanzada con la lógica de {% if … %} directamente en un bloque de texto.
Objeto filtroObjeto 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 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 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 adicionalesRecursos adicionales
Referencia de personalización de mensajes
Cómo usar el panel de vista previa para la personalización de mensajes