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.
¿En qué se diferencian los objetos personalizados de las propiedades de perfil?
Las propiedades de perfil son una excelente manera de almacenar información sencilla. Por ejemplo, si tienes una propiedad de color favorita, puedes almacenar el color favorito de cada cliente.
Pero ¿y si necesitas más datos o varias versiones de esa propiedad? Un gran ejemplo son las mascotas. Puedes usar propiedades de perfil para almacenar cosas como el nombre, la edad y la raza, pero solo se pueden usar una vez por perfil.
Si alguien tiene varias mascotas, puedes usar objetos personalizados. De esta manera, Fluffy el Gran Danés tiene su propia tarjeta de identificación digital para su nombre, edad, peso, etc., y Cheeks el hámster tiene la misma información, pero con respuestas (muy) diferentes.
Ejemplos de casos de uso
A continuación, verás algunos ejemplos que muestran cómo los objetos personalizados son flexibles en los datos que puedes almacenar en Klaviyo.
Cita
Si eres una empresa en la que los clientes pueden programar citas, puedes usar un objeto Cita para almacenar datos de citas de perfiles.
Dentro de cada registro de objeto para el objeto Appointment, algunos ejemplos de datos que puedes incluir son:
- ID de cita
- Fecha de la cita
- Persona designada (por ejemplo, médico específico, instructor, etc.)
- Lugar de la cita
- Tipo de cita
Los perfiles pueden tener varios registros de objetos si tienen varias citas, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.
Suscripción
Si eres una empresa en la que los clientes pueden suscribirse, puedes usar un objeto Suscripción para almacenar datos de suscripción de perfiles.
Dentro de cada registro de objeto para el objeto Suscripción, algunos ejemplos de datos que puedes querer incluir son:
- ID de suscripción
- Producto de suscripción
- Precio de suscripción
- Estado de la suscripción
- Próxima fecha de facturación
Los perfiles pueden tener varios registros de objetos si tienen varias suscripciones, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.
Reserva
Si eres una empresa en la que los clientes pueden reservar, puedes utilizar un objeto de reserva para almacenar datos de reservas de perfiles.
Dentro de cada registro de objeto para el objeto de reserva, algunos ejemplos de datos que puedes querer incluir son:
- ID de reserva
- Fecha de reserva
- Ubicación de la reserva
- Ocasión de reserva
- Recuento de invitados de la reserva
Los perfiles pueden tener varios registros de objetos si tienen varias reservas, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.
Mascota
Si eres una empresa que atiende a dueños de mascotas, puedes usar un objeto Pet para almacenar datos sobre las mascotas de los perfiles.
Dentro de cada registro de objeto para el objeto Pet, algunos ejemplos de datos que puedes querer incluir son:
- ID de microchip para mascotas
- Nombre de la mascota
- Tipo de mascota (por ejemplo, perro o gato)
- Raza de mascotas
- Cumpleaños de mascotas
Los perfiles pueden tener varios registros de objetos si tienen varias mascotas, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.
Límites de la cuenta
Los límites de objetos de tu cuenta dependen del límite de perfiles de tu plan y de si tienes un plan de Advanced Klaviyo Data Platform. Los planes gratuitos de email incluyen 1 objeto, 15 propiedades por objeto y 2 500 registros. También puedes solicitar una prueba de Advanced Klaviyo Data Platform a través de tu CSM. Las cuentas de una familia de cuentas usan los límites del plan de la cuenta principal. Para obtener más información sobre la facturación, consulta cómo funciona la facturación compartida en Klaviyo.
Los objetos personalizados tienen 3 conjuntos de límites de cuenta:
- Límite de objetos
Número total de objetos que puede tener una cuenta. - Límites de las propiedades de objeto
El número de propiedades que puede tener una cuenta por objeto. - Límites de registros de objetos
El número de registros de objetos permitidos para una cuenta.
El número de objetos y registros de objetos disponibles se basa en el límite de perfiles del plan. En el caso de una familia de cuentas, el límite de perfiles del plan compartido determina estas asignaciones. Los límites de registros se comparten entre la familia, mientras que los límites de objetos se aplican a cada cuenta por separado.
Un plan de email gratuito con un límite de 250 perfiles incluye 2500 registros de objetos.
Por ejemplo, si tienes una familia de cuentas con 5 cuentas y un plan de email compartido con un límite de 500 000 perfiles activos, el multiplicador de registros de objetos es 10. Estas cuentas pueden almacenar un máximo combinado de 5 millones de registros (500 000 × 10). Esto significa que podrías tener 1 cuenta con 3 millones de registros, siempre que las 4 cuentas restantes no tengan más de 2 millones de registros de objetos en total. Como el límite de perfiles compartidos es superior a 400 000, cada cuenta puede tener hasta 5 objetos.
Para un plan de Advanced Klaviyo Data Platform, la asignación de registros de objeto se basa en el límite total de perfiles del plan. Para un plan de email, se basa en el límite de perfiles activos del plan.
Límite de perfiles | Plan de Advanced KDP | Número de objetos | Número de propiedades de objeto | Multiplicador de registros de objetos |
0 - 400,000 | none | 1 | 15 | 10 |
De pago | 5 | 30 | 10 | |
Más de 400 000 | none | 5 | 30 | 10 |
De pago | 5 | 30 | 10 |
Además, todas las cuentas tienen los siguientes límites:
- Máximo de 500 registros por perfil y objeto.
- Cada registro de objetos personalizados no debe superar los 8 KB.
- Cada valor de propiedad dentro de un registro de objeto personalizado no debe superar los 2 KB.
Crear un objeto
Para empezar a crear un objeto en Klaviyo, ve a Contenido > Objetos y haz clic en Crear objeto.

Desde aquí, puedes crear un objeto desde cero o seleccionar una plantilla de objeto recomendada. Para crear un objeto desde cero, selecciona el botón Crear.

La primera parte del flujo de trabajo de creación de objetos requiere que establezcas la siguiente información para el objeto:
- Nombre
Un nombre para identificar tu objeto - Descripción (opcional)
Una descripción de los datos que representa tu objeto - Origen de datos
La fuente de datos donde residen tus datos de objetos.
Para crear una nueva fuente de datos, abre el menú desplegable Fuente de datos y selecciona Crear nueva fuente de datos.

Para crear una fuente de datos, es necesario establecer la siguiente información:
- Nombre
Un nombre único para identificar la fuente de tus datos de objetos. - Descripción (opcional)
Una descripción de tu fuente de datos.

Haz clic en Siguiente para continuar.
Establece el ID del objeto
A continuación, define un ID de objeto y establece las propiedades del objeto. Si tu fuente de datos ya contiene datos enviados a través de la API de objetos personalizados, puedes previsualizarlos y seleccionar propiedades para mapear. Si tu fuente de datos está vacía, puedes definir primero las propiedades y usar la carga útil de ejemplo que se proporciona tras la creación para empezar a enviar datos.
Configurar el ID de objeto es necesario para distinguir los registros de objetos entre sí. Para una fuente de datos que ya contiene datos, selecciona una propiedad en ID de objeto. Para una fuente de datos vacía, Klaviyo establece el campo de ID de objeto en id; incluye un valor único para él en cada registro que envíes.
El ID de objeto debe ser una propiedad de origen de datos única que pueda usarse para identificar instancias específicas de un registro de objeto. Por ejemplo, con un objeto de tarjeta regalo, puedes usar algo como el código de descuento único como ID del objeto. Esto es único para cada instancia del origen de datos y existirá para cada registro de objeto.
Cada vez que Klaviyo reciba datos de tu fuente de datos con el mismo ID de objeto, se actualizará el registro de objeto asociado. Por este motivo, es importante que el ID de objeto sea único para que se actualice el registro correspondiente.
Enviar datos de objetos
Cuando envías una actualización mediante la API de ingesta de fuentes de datos, se reemplaza el registro del objeto. Envía el registro completo, incluso si solo quieres actualizar 1 propiedad.
Por ejemplo, imagina que quieres actualizar solo 1 de las 5 propiedades opcionales de un registro. Si envías el ID y solo la propiedad que quieres actualizar, las otras 4 propiedades serán null. Si omites una propiedad obligatoria, la actualización se rechaza. Mantén los campos del identificador de perfil en cada actualización para que Klaviyo pueda vincular el registro con el perfil previsto.
Al enviar números de teléfono, deben estar en formato E.164. Al enviar fechas, deben estar en uno de nuestros formatos de marca de tiempo aceptables.
Asignar las propiedades de objeto
Al asignar propiedades de objeto, puedes seleccionar qué información del origen de datos estará disponible dentro de un objeto en Klaviyo.
Para un origen de datos que contiene datos, el menú desplegable incluye propiedades de las muestras de datos cargadas. Haz clic en Nueva muestra de datos para previsualizar otra muestra. Si una propiedad no aparece en la lista, escribe su ruta y elige Crear propiedad de origen para esa ruta.
Recomendamos enviar los datos de objetos a través de la API de ingesta de objetos en formatos de fecha y marca de tiempo estandarizados. Si no se conoce el valor de una propiedad opcional, puedes establecer un valor nulo.

Para asignar propiedades de objeto:
- Si la fuente de datos contiene datos, selecciona la propiedad que quieres incluir en la columna Datos de origen. Si la fuente de datos está vacía, pasa al siguiente paso.
- En la columna Propiedad mapeada, introduce el nombre que quieres que la propiedad de fuente de datos tenga en el objeto. Para una fuente de datos vacía, introduce el nombre en la columna Propiedad del objeto.
- En la columna Tipo de datos, selecciona el tipo de datos adecuado de la propiedad de tu fuente de datos.
- En la columna Obligatorio, selecciona la casilla de verificación si quieres que esta propiedad sea obligatoria en el objeto.
- Selecciona el botón Añadir asignación si necesitas asignar propiedades de objeto adicionales.
Si una propiedad de objeto está establecida como Obligatoria, debe existir en el origen de datos y no puede tener un valor nulo establecido. Si la propiedad requerida no está presente, no se creará el registro del objeto.
Datos anidados en la asignación
El menú desplegable de propiedades incluye campos anidados de las muestras de datos cargadas. Si una ruta no aparece en la lista, puedes introducirla manualmente.
Como ejemplo, mira la fuente de datos a continuación.
{
"type": "data-source-record",
"attributes": {
"record": {
"child": {
"child_id": "d64b8458",
"name": {
"first": "Theodore",
"last": "Customer"
},
"birth_date": "2022-04-12",
"email": "jon.customer@klaviyo.com",
"phone_numbers": [
"+11234567899",
"+13456789123"
]
}
}
}
}Para acceder al nombre del menor, selecciona o introduce child.name.first.

Si tienes una matriz en tus datos de origen, puedes encontrar propiedades para asignar por posición. Por ejemplo, puedes extraer el primer número de teléfono dentro de la matriz phone_numbers incluyendo [0] al final de tu ruta.

Añadir una relación
Después de establecer un ID de objeto y asignar las propiedades del objeto, haz clic en Siguiente para añadir una relación al objeto.
Las relaciones conectan tu objeto con perfiles relevantes. Define la siguiente información para establecer una relación:
- Nombre de la relación
Establece un nombre para tu relación. Por ejemplo, si tienes un objeto para mascotas, quizás te interese establecer el nombre de la relación como «Propietario de mascotas». - Datos de origen
Para una fuente de datos que contiene datos, selecciona las propiedades que identifican el perfil. Este campo no se muestra para una fuente de datos vacía. - Identificador de perfil
Selecciona el identificador de perfil (p. ej., email o número de teléfono) para cada propiedad de origen. Incluye estos identificadores en los datos que envíes para que el objeto se pueda asociar a un perfil. Usa Vincular otro para añadir otro par o Añadir identificador de perfil si la fuente de datos está vacía.

Confirmar las asignaciones y crear un objeto
Cuando hayas terminado de asignar las propiedades del objeto y de configurar la relación, haz clic en Crear objeto en la esquina superior derecha. Revisa la advertencia y luego haz clic en Crear objeto en el cuadro de diálogo de confirmación. Las asignaciones existentes no se pueden editar una vez creado el objeto, y Klaviyo empieza a procesar los datos que ya estén en el origen de datos.

En la página de confirmación, haz clic en Copiar JSON para copiar una carga útil de ejemplo para tu objeto. Úsala como referencia al enviar tus datos a través de la API de objetos personalizados.
Haz clic en Salir para volver a la página Objetos. Verás tu objeto en la lista con la siguiente información:
- Nombre del objeto
- Propietario
- Estado
Estados del estado del objeto personalizado
Hay 3 estados de estado principales al publicar objetos personalizados:
- Borrador
El objeto sigue siendo editable y no está publicado ni activo. - Publicación
El objeto está creando registros de objetos personalizados a partir de los datos que has enviado a tu fuente de datos. Unos miles de registros pueden publicarse rápidamente. Unos cuantos millones de registros pueden tardar horas. Una vez completado, el estado cambia a Publicado. - Publicado
El objeto está publicado y activo. Klaviyo ha terminado de procesar los datos enviados desde tu fuente de datos. Los nuevos datos crean registros o actualizan registros con ID de objeto coincidentes, y los identificadores de perfil determinan a qué perfiles se vinculan.
Objetos en páginas de perfil
Los objetos relevantes también aparecerán en una página de perfil para que puedas ver los registros de objetos que pertenecen a un perfil. Para ver los registros de objetos, ve a la pestaña Objetos en una página de perfil. Puedes cambiar entre objetos usando el menú desplegable encima de las tarjetas de objetos.

Para ver un registro de objeto completo, selecciona el menú de 3 puntos y haz clic en Ver. Aparecerá un panel lateral que contiene el registro completo del objeto.
Explora todos los registros dentro de un objeto
Para explorar todos los registros de un objeto, no solo los registros asociados a un único perfil, usa el explorador de registros. Haz clic en Contenido > Objetos y, a continuación, haz clic en el nombre de un objeto para abrir el explorador de registros y ver sus registros.
Actualizar un objeto
Cuando publicas cambios en un objeto, se aplican al objeto activo.
Si quieres empezar a enviar nuevos datos para un objeto, añade las propiedades adicionales del objeto a la fuente de datos y, a continuación, edita la asignación de objetos para incluirlas. Cuando los registros se reprocesan, una propiedad asignada recientemente se rellena si su valor ya estaba presente en los datos de origen. De lo contrario, es null hasta que envíes una actualización que la incluya.
Si envías nuevas propiedades de objeto que aún no se han asignado a un objeto, puedes actualizar el objeto personalizado para incluirlas. A continuación, se reprocesan todos los registros del objeto personalizado para incluir estos datos.
Para actualizar un objeto, sigue estos pasos:
- Haz clic en Contenido > Objetos en la barra lateral de Klaviyo.
- Abre el menú a la derecha del objeto que quieras editar y haz clic en Editar.
- Haz clic en Siguiente en la esquina superior derecha.
- En Asignar propiedades de objetos, haz clic en Añadir asignación. Si la fuente de datos está vacía, esta sección se etiqueta como Propiedades del objeto.
Puedes añadir asignaciones hasta alcanzar el límite de propiedades del plan. No se pueden editar las asignaciones existentes y las propiedades asignadas recientemente no se pueden configurar como obligatorias.
- En la columna Datos de origen, selecciona la propiedad de la fuente de datos que quieras incluir en el objeto. Si la fuente de datos está vacía, pasa al siguiente paso.
- En la columna Propiedad mapeada, introduce el nombre que quieres que la propiedad de fuente de datos tenga en el objeto. Para una fuente de datos vacía, usa la columna Propiedad del objeto.
- En la columna Data type, selecciona el tipo de datos adecuado de la propiedad de tu fuente de datos.

Las propiedades asignadas recientemente no se pueden marcar como obligatorias.
- Haz clic en Siguiente en la esquina superior derecha.
- Revisa las relaciones y, a continuación, haz clic en Publicar cambios en la parte superior derecha. No necesitas cambiar las relaciones para añadir una propiedad.
- Haz clic en Publicar cambios en el cuadro de diálogo de confirmación.
Haz clic en Salir para volver a Objetos. Después de publicar los cambios de asignación, los registros de la fuente de datos se vuelven a procesar y los registros de objetos personalizados existentes se actualizan en consecuencia.
Eliminar un objeto
Una vez que elimines un objeto, no podrás recuperarlo ni revertirlo. Los segmentos, flujos, plantillas o campañas que hayan usado estos objetos personalizados dejarán de funcionar según lo previsto.
Para eliminar un objeto, sigue estos pasos:
- Haz clic en Contenido > Objetos en la barra lateral de Klaviyo.
- En el menú situado a la derecha de tu objeto, haz clic en Eliminar.

- Para un objeto publicado, escribe DELETE en el cuadro de diálogo de confirmación y, a continuación, haz clic en Eliminar. Para un objeto en borrador, haz clic en Eliminar para confirmar.
Se eliminarán el objeto y todos los registros de objetos personalizados asociados.
Si creas un nuevo objeto personalizado utilizando el origen de datos de un objeto anterior, se generarán nuevos registros de objetos personalizados utilizando los datos que ya has sincronizado. Aunque utiliza los mismos datos, se considera un nuevo objeto con nuevos registros, por lo que todos los segmentos, flujos, plantillas y campañas deben actualizarse para utilizar este nuevo objeto.
Recursos adicionales
- Cómo usar objetos personalizados en plantillas
Descubre cómo usar objetos personalizados en las plantillas para poder usar datos de objetos en los envíos de flujos y campañas.
- Cómo usar objetos personalizados en segmentos
Aprende a usar objetos personalizados en segmentos para poder crear grupos de clientes en función de los datos de los objetos.
- Cómo usar objetos personalizados en flujos
Aprende a usar objetos personalizados en los flujos para que puedas usar los datos de los objetos con el fin de crear flujos activados por fechas y configurar divisiones.