Debes tener acceso a objetos personalizados para usar esta funcionalidad.

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.

Debes crear un objeto antes de poder usar datos de objetos personalizados en las plantillas. Para el menú de personalización, los filtros de objetos y las listas de registros de destinatarios, usa un objeto con una relación de perfil. Sus registros deben estar vinculados al destinatario para que aparezcan en su mensaje.

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

Puedes personalizar bloques de texto en el editor de plantillas de arrastrar y soltar usando propiedades de un objeto personalizado o el conteo de registros de un objeto.

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

Si estás empezando con una plantilla HTML, primero puedes crear una copia de arrastrar y soltar:

  1. Ve a Contenido > Plantillas, luego abre Email: guardado. Abre el menú de 3 puntos de la plantilla HTML y selecciona Clonar a arrastrar y soltar.
  2. Abre Plantillas convertidas para revisar el progreso. Cuando el estado sea Lista para usar, haz clic en el nombre de la plantilla convertida para abrirla.
  3. Revisa el diseño del texto y el contenido personalizado antes de usarlo. La plantilla HTML original no cambia.

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 Personalization en la barra de herramientas de texto.
  1. En el modal de personalización, selecciona Objetos en el menú desplegable Todos los tipos .
  1. 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.
  2. Selecciona una propiedad para mostrar, o Número de objetos para mostrar un conteo. Después, selecciona un filtro de objetos. También puedes crear un nuevo filtro de objetos aquí.
  3. Haz clic en Insertar después de seleccionar un filtro existente. Si creas un nuevo filtro, se inserta su etiqueta cuando terminas de crearlo.
  4. Aplica los estilos de texto que necesites. Para un valor de propiedad, agrega texto predeterminado editando su etiqueta para incluir |default:'value'. Reemplaza value con el texto que quieres mostrar cuando la propiedad esté vacía.

Para especificar las reglas de uso de mayúsculas para los datos de objetos, deberás configurar manualmente la regla en la etiqueta de personalización. Por ejemplo, estas etiquetas usan el objeto que activó un flujo activado por fecha:

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

{{ object }} solo está disponible cuando un objeto ha activado un flujo. La etiqueta de plantilla {{ object }} solo está disponible en flujos activados por fecha basados en un objeto. Esto es similar a la etiqueta de plantilla {{ event }} para flujos activados por evento.

Estos ejemplos usan lo siguiente:

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

Estructura

Ejemplo

{{ object.object_property }}

{{ object.Name }}

{{ object | lookup:'object_property' }}

{{ object | lookup:'Name' }}

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.

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 usan lo siguiente:

  • Un filtro de objeto adicional llamado oldestDog
  • Propiedad de objeto llamada Nombre

Estructura

Ejemplo

{{ object_filter.object_filter_name.object_property}}

{{ object_filter.oldestDog.Name }}

{{ object_filter.object_filter_name | lookup:'object_property' }}

{{ object_filter.oldestDog | lookup:'Name' }}

Devuelve un número entero de un filtro de objetos

Estos ejemplos usan lo siguiente:

  • Un filtro de objeto adicional llamado countOfDogs

Estructura

Ejemplo

{{ object_filter.object_filter_name }}

{{ object_filter.countOfDogs }}

Devuelve varios objetos de un filtro de objetos

Para un filtro llamado dogs configurado con Múltiple, recorre en bucle los registros coincidentes para mostrar la propiedad Nombre de cada mascota:

{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}

Recupera registros de objetos

Usa customobjects para recuperar hasta 5 registros vinculados al destinatario, ordenados del más reciente al más antiguo. Recorre esos registros devueltos para mostrar sus propiedades. Este ejemplo usa lo siguiente:

  • Objeto llamado perfil de mascota
  • Propiedad de objeto llamada name

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 %}
{% for pet in pets %}
{{ pet.name }}
{% endfor %}
{% endcustomobjects %}

Datos de objeto en asuntos

Usa la misma sintaxis de objeto personalizado en los asuntos que en el cuerpo del mensaje. Estos ejemplos muestran la sintaxis para cada fuente de datos:

  • {{ object_filter.oldestDog.Name }} muestra la propiedad Name del filtro de objeto único oldestDog.
  • {{ object.Name }} muestra la propiedad Name del objeto que activó un flujo activado por fecha.
  • {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %} busca un registro de Pet por ID. Úsalo en un flujo activado por un evento que contenga pet_id.

Por ejemplo, usa {{ object.Name }} en un flujo activado por fecha basado en el objeto Pet para mostrar el nombre de la mascota de un cliente en el asunto.

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. Usa una propiedad o un recuento de un filtro de objetos, o del objeto que activó un flujo activado por fecha. Puedes usar los datos del objeto en una sola condición de mostrar/ocultar o en la condición de cada variante de lógica de mostrar/ocultar. Para los datos obtenidos por ID, usa la lógica condicional avanzada que se describe a continuación.

Debes crear filtros de objetos antes de poder hacer referencia a ellos en la lógica de mostrar/ocultar.

Por ejemplo, en un flujo activado por fecha basado en un objeto Mascota, usa object.Breed == 'Labrador' para mostrar un bloque solo cuando la Raza de la mascota activadora sea Labrador. Usa el valor exacto de la raza en tus datos.

  1. Selecciona el bloque y abre la pestaña Visualización. En Lógica de mostrar/ocultar, selecciona Mostrar solo a una audiencia específica o selecciona Personalizar para varias audiencias para crear variantes de lógica. Luego, selecciona Usar código.
  2. Ingresa una condición como object_filter.countOfDogs > 0 sin {{ }} ni {% %} alrededor. Los filtros de objetos se pueden usar en campañas y flujos. Usa object solo en un flujo activado por fecha basado en datos del objeto.
  3. Haz clic en Guardar para aplicar la condición.
A custom-coded show/hide condition using an object filter.
A custom-coded show/hide condition using an object filter.

Las secciones de objetos personalizados admiten la lógica de mostrar/ocultar para una sola audiencia. Las variantes de lógica no están disponibles para ellas. Obtén más información sobre las variantes de lógica de mostrar/ocultar.

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 objeto seleccionan registros vinculados a cada destinatario con los criterios que estableces. Puedes mostrar una propiedad de 1 registro coincidente, propiedades de hasta 10 registros coincidentes o un recuento de registros coincidentes.

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 .
  1. En el modal de personalización, selecciona Objetos en el menú desplegable Todos los tipos .
  2. Selecciona el objeto que contiene los datos para los que te gustaría establecer un filtro.
  3. Selecciona la propiedad que quieres mostrar. Para crear un filtro de recuento, selecciona Número de objetos.
  4. Haz clic en Crear si aún no hay filtros. Si hay filtros en la lista, déjalos sin seleccionar y haz clic en Crear filtro de objetos.

En el modal Crear filtro de objeto, establece la siguiente información:

  • Nombre
    Ingresa un nombre único que contenga solo letras y números, como oldestDog. No uses espacios ni caracteres especiales.
  • Establecer condiciones del filtro
    Define las reglas que un objeto debe cumplir para incluirse en el bloque de texto.
  • ¿Cuántos objetos deben mostrarse?
    Para un valor de propiedad, selecciona Único para 1 registro o Múltiple para hasta 10 registros. Los filtros de conteo no muestran esta configuración.
  • Selecciona la propiedad y Orden de clasificación
    Para un filtro de propiedad-valor, elige la propiedad que se usa para seleccionar u ordenar registros y, luego, elige el orden de clasificación. Por ejemplo, ordena por una propiedad de cumpleaños con Más antiguo para seleccionar primero a la mascota de mayor edad. Estos campos no aparecen para filtros de conteo.

Haz clic en Crear filtro de objeto para guardar el filtro e insertar su etiqueta en el bloque de texto.

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

  • Primeros pasos con objetos personalizados

    Obtén más información sobre los objetos personalizados, que te permiten almacenar y asociar varias propiedades a un solo "objeto". Los objetos personalizados te permiten asignar conceptos de datos diversos y multirelacionales a Klaviyo que no pueden almacenarse utilizando propiedades del perfil. Luego, puedes usar objetos personalizados en tus mensajes, segmentos y mucho más.

¿Te resultó útil este artículo?
Usa este formulario solo para enviar comentarios sobre el artículo. Más información sobre cómo contactar al equipo de asistencia.

Descubre más sobre Klaviyo

Comunidad
Conecta con colegas, socios y expertos de Klaviyo para inspirarte, compartir ideas y resolver todas tus dudas.
Socios
Contrata a un experto certificado por Klaviyo para ayudarte con una tarea específica o para la gestión continua de marketing.
Asistencia

Accede a la asistencia a través de tu cuenta.

Asistencia por correo electrónico (prueba gratuita y cuentas de pago) Disponible 24/7

Asistencia virtual/por chat
La disponibilidad varía según la ubicación y el tipo de plan