Preguntas frecuentes sobre objetos personalizados

Qué aprenderás

Conoce las preguntas más frecuentes relacionadas con los objetos personalizados en Klaviyo. Si no encuentras tu pregunta en los recursos que aparecen a continuación, consulta nuestro foro comunitario.

Preguntas generales sobre objetos

¿Necesito un desarrollador para crear un objeto?

Sí, estas funciones dependen del uso de la API para enviar fuentes de datos y, en última instancia, crear objetos.

¿Puedo crear objetos personalizados utilizando formularios Klaviyo o cargas CSV?

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

¿Cuándo debo utilizar un objeto personalizado frente a un Propiedades de perfil o evento?

Debes utilizar objetos personalizados cuando tengas una relación de muchos a uno entre la categoría que representa tu objeto personalizado y tu perfil. Por ejemplo, si quieres guardar información sobre las mascotas de tus clientes, y éstos pueden tener más de una mascota, representarlas como un objeto personalizado funciona mucho mejor que Propiedades de perfil o eventos.

Cuando los elementos de seguimiento son como un estado de afiliación, donde un perfil sólo puede tener un estado a la vez, Propiedades de perfil se ajusta mejor. Sin embargo, si quieres almacenar también otros detalles sobre la pertenencia a un perfil, un objeto puede funcionar mejor. 

Para seguir algo amplio, como cuántas veces ha abierto un destinatario un correo electrónico, recomendamos utilizar eventos.

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

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

¿Cuándo debo emitir un evento frente a actualizar las propiedades del objeto personalizado?

Los eventos están pensados para activar el flujo rápidamente, permitiéndote enviar mensajes oportunos y relevantes. Cuando cambie el estado de un objeto y quieras desencadenar un mensaje como consecuencia de ello, debes actualizar el objeto con la nueva información y enviarnos un evento para desencadenar el flujo.

Puedes personalizar la plantilla con la información del objeto en el flujo desencadenado por el evento. Hay dos formas de conseguirlo: 

1. Utiliza la etiqueta {{ event }} para añadir propiedades relevantes en los metadatos de tu evento para utilizarlas 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 permitirá obtener el objeto en la plantilla con el {% customobject id={{ event.pet_id }} as pet %}. Sin embargo, el objeto puede tardar algún tiempo en actualizarse con las últimas propiedades, por lo que es posible que el flujo haya activado el envío de un mensaje antes de que el objeto se actualizara.

Preguntas sobre el envío de datos de objetos 

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

1. Crea una nueva fuente de datos utilizando nuestra API.
2. Define tu estructura de datos (consulta el ejemplo JSON).
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 tu perfil.

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

Tras crear una nueva fuente de datos, Klaviyo te devolverá un identificador único como parte de la respuesta a tu solicitud de API. Esto permite a Klaviyo identificar las fuentes de datos, especialmente en los casos en que una cuenta tiene múltiples fuentes de datos (por ejemplo, 1 por cada integración personalizada, almacén de datos o integraciones personalizadas de terceros en las que confía la marca para su negocio).

Con este identificador único, tu desarrollador puede crear registros de fuentes de datos a través de la API de Klaviyo.

¿Cómo debo formatear mis datos?

Tu desarrollador tendrá que enviar datos con formato JSON a Klaviyo. Te recomendamos que envíes tus datos como texto con una lista separada por comas. Podrás utilizar el operador "contains" de segmentación y filtro de flujo para filtrar los valores de esta cadena separada por comas. Consulta la referencia de las condiciones del segmento para obtener más información sobre el filtro.  

Tipos de datos admitidos en objetos personalizados:

• Texto
• Entero
• Decimal
• Fecha - Todas las fechas se convierten a UTC en nuestro sistema. Por ejemplo, si subes "2025-04-03" se convierte en "2025-04-03 00:00:00". Para los clientes con zonas horarias adelantadas tres horas, la fecha y hora sería "2025-04-02 21:00:00".
• Booleano

Actualmente no se admite el tipo de datos lista. Para ver un ejemplo de carga útil para el registro de origen de datos API, consulta Crear a granel registros de origen de datos.

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

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

¿Puedo hacer un mapa con datos anidados?

Te recomendamos que definas tu objeto JSON sin anidar las propiedades que quieras utilizar para tu objeto personalizado. Si tus datos de origen están profundamente anidados o utilizan una lista, tendrás que introducir manualmente la ruta JSON en el gestor de objetos. En el caso de las listas, sólo puedes asignar una propiedad a una posición dentro de esa lista (por ejemplo, al primer o segundo valor).

¿Puedo asociar varios identificadores a un perfil?

Sí, si quieres utilizar 2 o más identificadores de perfil (por ejemplo, correo electrónico y número de teléfono) para asociar tus registros de objetos personalizados a un perfil, asegúrate de incluir ambas propiedades en cada sincronización, aunque el valor de una de ellas sea nulo.  

Preguntas sobre el uso de objetos con flujo 

¿Puedo utilizar el disparador división o el disparador filtro para el flujo activado por fecha?

En este momento, no está disponible la creación de división de activación y filtro de activación para flujo activado por fecha.

Si mi objeto no desencadenó un flujo y no tengo un objeto id de un evento, ¿puedo personalizar mi mensajería?

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

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

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

Para probar un mensaje de flujo:

1. Crea un flujo activado por fecha y ponlo en directo.
2. Crea un perfil con un objeto que tenga una fecha que se activará en al menos 24 horas.

¿Puedo actualizar mis objetos utilizando acciones de flujo como webhook y código Klaviyo?

En este momento, te aconsejamos que actualices primero tu fuente de datos original y luego envíes el objeto revisado de nuevo a Klaviyo en el formato permitido. Si estos dos sistemas se desincronizan, corres el riesgo de volver a enviar un registro desactualizado a Klaviyo desde tu sistema, revirtiéndolo al valor original.