Debes tener acceso a objetos personalizados para usar esta funcionalidad.

Qué aprenderás

Descubre cómo usar objetos personalizados en las plantillas para poder usar datos de objetos en los envíos de flujos y campañas.

Para poder usar datos de objetos personalizados en las plantillas, primero debes crear un objeto. 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 a través del 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 recuento de registros de un objeto.

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

Si empiezas con una plantilla HTML, puedes crear primero una copia de arrastrar y soltar:

  1. Ve a Contenido > Plantillas y, a continuación, abre Email: guardado. Abre el menú de 3 puntos de la plantilla HTML y selecciona Clonar al editor de arrastrar y soltar.
  2. Abre Plantillas convertidas para comprobar el progreso. Cuando el estado sea Listo 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 añadir datos de objetos a tus plantillas:

  1. Añade un nuevo bloque de texto o selecciona un bloque de texto existente.
  2. Haz doble clic en el bloque de texto y, a continuación, 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 la ventana modal de personalización, selecciona Objetos en el menú desplegable Todos los tipos .
  1. Dentro de Objetos, verás todos los objetos de tu cuenta que puedes usar para extraer datos en 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 recuento. A continuación, selecciona un filtro de objetos. También puedes crear aquí un filtro de objetos nuevo.
  3. Haz clic en Insertar después de seleccionar un filtro existente. Si creas un filtro nuevo, se inserta su etiqueta cuando termines de crearlo.
  4. Aplica los estilos de texto que necesites. Para un valor de propiedad, añade texto predeterminado editando su etiqueta para incluir |default:'value'. Sustituye value por el texto que quieras mostrar cuando la propiedad esté vacía.

Para especificar las reglas de uso de mayúsculas y minúsculas para los datos de objetos, tendrás que 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 modificar valores con filtros de Django.

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

Puedes usar etiquetas de personalización en emails (incluida la línea de asunto del email), mensajes SMS/MMS, notificaciones push y Klaviyo Customer Hub para mostrar datos de objetos.

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

Uso del 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 eventos.

Estos ejemplos usan lo siguiente:

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

Estructura

Ejemplo

{{ object.object_property }}

{{ object.Name }}

{{ object | lookup:'object_property' }}

{{ object | lookup:'Name' }}

Obtener un objeto por 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 %}

{% evento de objeto personalizado.object_id  object_type_title=«Título» como 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 objetos 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 los registros coincidentes para mostrar la propiedad Name de cada mascota:

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

Recuperar registros de objetos

Usa customobjects para recuperar hasta 5 registros vinculados al destinatario, ordenados desde el más reciente añadido hasta el más antiguo. Recorre en bucle esos registros devueltos para mostrar sus propiedades. Este ejemplo utiliza 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 del objeto en el asunto

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 de Email:

Datos de objetos en la lógica de mostrar/ocultar

También puedes configurar si quieres mostrar u ocultar un bloque en una plantilla en función de los datos del objeto. Usa una propiedad o un recuento de un filtro de objetos, o el objeto que activó un flujo activado por fecha. Puedes usar datos de objeto en una única condición de mostrar/ocultar o en la condición de cada variante de lógica de mostrar/ocultar. Para los datos recuperados 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 que activa el flujo sea Labrador. Usa el valor exacto de raza de los datos.

  1. Selecciona el bloque y abre la pestaña Visualización. En Mostrar/ocultar lógica, selecciona Mostrar solo a una audiencia específica o selecciona Personalizar para varias audiencias para crear variantes de lógica. A continuación, selecciona Usar código.
  2. Introduce una condición como object_filter.countOfDogs > 0 sin {{ }} ni {% %} alrededor. Los filtros de objeto se pueden usar en campañas y flujos. Usa object solo en un flujo activado por fecha en función de los 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 la lógica no están disponibles para ellos. Más información sobre las variantes de lógica de mostrar/ocultar.

Para tener más flexibilidad (p. ej., para que cierta información sea condicional en función de la información que devuelve {% customobject %} o {% customobjects %}), plantéate usar 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 seleccionan registros vinculados a cada destinatario mediante los criterios que se establezcan. Se puede mostrar una propiedad de 1 registro coincidente, propiedades de hasta 10 registros coincidentes o un recuento de registros coincidentes.

Crear un filtro de objetos nuevo

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 Personalization .
  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 quieres establecer un filtro.
  3. Selecciona la propiedad que quieres mostrar. Para crear un filtro de recuento en su lugar, selecciona Número de objetos.
  4. Haz clic en Crear si todavía no hay filtros. Si hay filtros en la lista, déjalos sin seleccionar y haz clic en Crear filtro de objeto.

En el modal Crear filtro de objetos, configura la siguiente información:

  • Nombre
    Introduce 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 debe cumplir un objeto 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 recuento no muestran esta configuración.
  • Selecciona la propiedad y el orden de clasificación
    Para un filtro de propiedad-valor, elige la propiedad que se usa para seleccionar u ordenar registros y, después, elige su 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 en los filtros de recuento.

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

Una vez que hayas creado tu filtro de objetos, puedes usarlo en la lógica de mostrar/ocultar y en las etiquetas de personalización para mostrar registros de objetos específicos en función de los criterios que establezcas.

Recursos adicionales

  • Introducción a los objetos personalizados

    Obtén 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 de perfil. Luego, puedes usar objetos personalizados en tus mensajes, segmentos y más.

¿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 sobre Klaviyo

Klaviyo Community
Conecta con compañeros, socios y expertos de Klaviyo para encontrar ideas, compartir información 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 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