Preguntas frecuentes sobre objetos personalizados

Qué aprenderás

Descubre las preguntas frecuentes relacionadas con los objetos personalizados en Klaviyo. Si no encuentras tu pregunta en el recurso que aparece a continuación, ponte en contacto en nuestro foro de la Community.

Preguntas generales sobre los objetos

¿Necesito un desarrollador para crear un objeto?

Sí, esta función depende del uso de API para enviar fuentes de datos y, en última instancia, crear objetos.

¿Puedo crear objetos personalizados usando formularios de Klaviyo o cargas de CSV?

Actualmente, Klaviyo requiere que las cuentas creen nuevos objetos personalizados enviándonos datos a través de la API.

¿Cuándo debo usar un objeto personalizado en lugar de propiedades de perfil o un evento?

Deberías usar objetos personalizados cuando tengas una relación de muchos a uno entre la categoría que representa tu objeto personalizado y tus perfiles. Por ejemplo, si quieres guardar información sobre las mascotas de tu cliente y tu cliente puede tener más de una mascota, representarlas como un objeto personalizado funciona mucho mejor que las propiedades de perfil o los eventos.

Cuando se realiza el seguimiento de elementos como un estado de membresía, en los que un perfil solo puede tener un estado a la vez, las propiedades de perfil son más adecuadas. Sin embargo, si quieres almacenar también otros detalles de la membresía de un perfil, un objeto puede funcionar mejor.

Cuando se hace el seguimiento de algo general, como cuántas veces un destinatario ha abierto un email, recomendamos usar eventos.

¿Puedo actualizar mi objeto personalizado después de crearlo?

Sí, siempre puedes añadir propiedades adicionales no obligatorias a tu objeto personalizado. Para obtener más información, lee sobre cómo actualizar un objeto personalizado.

¿Cuándo debería emitir un evento en lugar de actualizar las propiedades del objeto personalizado?

Los eventos están diseñados para activar flujos rápidamente, lo que permite enviar mensajes oportunos y relevantes. Cuando el estado de un objeto cambia y se quiere activar un mensaje como resultado, se debe actualizar el objeto con la nueva información y enviarnos un evento para activar el flujo.

Puedes personalizar plantillas con la información del objeto en el flujo activado por eventos. Hay dos maneras de conseguirlo:

1. Usa la etiqueta {{ event }} para añadir propiedades relevantes en los metadatos de tu evento para usarlas en tu plantilla. Esto funciona bien cuando la puntualidad es importante.
2. Incluye el ID del objeto en los metadatos del evento, lo que te permite obtener el objeto en la plantilla con {% customobject id={{ event.pet_id }} as pet %}. Sin embargo, puede tardar un tiempo en actualizarse el objeto con las últimas propiedades, por lo que es posible que el flujo activara el envío de un mensaje antes de que se actualizara el objeto.

Preguntas sobre el envío de datos de objetos

¿Cómo empiezo a enviar mis datos para objetos personalizados?

1. Crea un nuevo origen de datos usando nuestra API.
2. Define tu estructura de datos (consulta el JSON de ejemplo).
3. Envía los registros de tu fuente de datos a Klaviyo a través de la API.
4. Crea tu objeto personalizado.
5. Crea la relación entre tu objeto personalizado y tus perfiles.

¿Cómo se crean y se usan las fuentes de datos?

Después de crear una nueva fuente de datos, Klaviyo devolverá un identificador único como parte de la respuesta a tu solicitud de API. Esto permite que Klaviyo identifique las fuentes de datos, especialmente en los casos en los que una cuenta tiene varias fuentes de datos (p. ej., 1 para cada integración personalizada, almacén de datos o integración personalizada de terceros en la que la marca confía para su negocio).

Con este identificador único, tu desarrollador puede crear registros de fuentes de datos mediante la API de Klaviyo.

¿Cómo debo dar formato a mis datos?

Tu desarrollador tendrá que enviar datos con formato JSON a Klaviyo. Recomendamos enviar tus datos como texto con una lista separada por comas. Podrás usar el operador «contiene» de la segmentación y el filtro de flujo para filtrar los valores en esta cadena separada por comas. Consulta la referencia de condiciones de segmento para obtener más información sobre el filtrado. 

Tipos de datos compatibles de objetos personalizados:

• Mensaje de texto
• Número entero
• Decimal
• Fecha: todas las fechas y horas se convierten a UTC en nuestro sistema. Por ejemplo, si subes «2025-04-03», se convierte en «2025-04-03 00:00:00». Para clientes con zonas horarias tres horas por delante, la fecha y hora se leería como «2025-04-02 21:00:00».
• Booleano

El tipo de datos de lista no se admite actualmente. Para ver un ejemplo de carga útil para la API de registro de fuente de datos, consulta Crear registros de fuente de datos en masa.

¿Cuáles son los límites de datos de los objetos personalizados?

Puedes cargar un máximo de 2 KB por propiedad y 8 KB por registro total.

¿Puedo mapear con datos anidados?

Recomendamos definir tu objeto JSON sin anidar las propiedades que quieras usar para tu objeto personalizado. Si tus datos de origen están profundamente anidados o usan una lista, tendrás que introducir manualmente la ruta JSON en el administrador de objetos. En el caso de las listas, solo puedes asignar una propiedad a una posición dentro de esa lista (por ejemplo, el primer o el segundo valor).

¿Puedo asociar varios identificadores a un perfil?

Sí, si quieres usar 2 o más identificadores de perfil (p. ej., email y número de teléfono) para asociar tus registros de objeto personalizado a un perfil, asegúrate de incluir ambas propiedades en cada sincronización, incluso si el valor de una de ellas es nulo. 

Preguntas sobre el uso de objetos con flujos

Si mi objeto no activó un flujo y no tengo un id de objeto de un evento, ¿aun así puedo personalizar mis mensajes?

Sí, puedes usar filtros de objetos para encontrar el objeto adecuado al personalizar tus mensajes.

¿Puedo previsualizar los mensajes de flujo cuando un objeto activa un flujo?

En este momento, no es posible usar la función de vista previa en la aplicación para ver un mensaje cuando utilizas la etiqueta {{ object }}.

Para probar un mensaje de flujo:

1. Crea un flujo activado por fecha y configúralo como activo.
2. Crea un perfil con un objeto que tenga una fecha que se activará en al menos 24 horas.

¿Puedo actualizar mis objetos con acciones de flujo, como webhooks y código de Klaviyo?

En este momento, te recomendamos actualizar primero tu fuente de datos original y, a continuación, enviar el objeto revisado de vuelta a Klaviyo en el formato permitido. Si estos dos sistemas se desincronizan, corres el riesgo de enviar de vuelta a Klaviyo un registro desactualizado desde tu sistema y revertirlo al valor original.