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?

Necesitas a un desarrollador para enviar datos personalizados a través de API. Puedes crear la fuente de datos y configurar el objeto en Klaviyo.

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

Los formularios de Klaviyo y las cargas de CSV no envían registros de objetos personalizados. Usa la API para enviar los datos personalizados y luego asígnalos a un objeto en Klaviyo.

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

Al hacer seguimiento de elementos como el estado de una suscripción, 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 sobre la suscripción 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í, puedes añadir propiedades no obligatorias hasta el límite de propiedades de objetos de tu cuenta. Para obtener más información, lee 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. Incluye las propiedades que necesites en los datos del evento y, después, haz referencia a ellas en la plantilla. Por ejemplo, si el evento incluye una propiedad pet_name, usa {{ event.pet_name }}. Esto funciona bien cuando la rapidez es importante.
2. Incluye el ID del objeto en los datos del evento y luego recupera el objeto en la plantilla. Para un objeto llamado Pet con una propiedad Name y una propiedad de evento llamada pet_id, usa {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}. Sustituye estos nombres por los nombres de los campos de objeto, propiedad y evento. Las actualizaciones de objetos pueden tardar un tiempo en estar disponibles, por lo que un mensaje de flujo puede enviarse antes de que el objeto tenga los valores más recientes.

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 la estructura de los datos mediante el ejemplo de JSON en Crear registros de origen de datos en bloque.
3. Envía los registros de tu fuente de datos a Klaviyo a través de la API.
4. Crea el objeto personalizado con ese origen de datos. Elige un ID de objeto único y asigna las propiedades que quieras usar.
5. Crea la relación entre el objeto personalizado y los perfiles asignando los identificadores de perfil en los datos, como el email o el número de teléfono.
6. Revisa las asignaciones, haz clic en Crear objeto y, a continuación, haz clic en Crear objeto de nuevo para confirmar.

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

Cuando creas una fuente de datos a través de la API, Klaviyo devuelve un identificador único como parte de la respuesta a tu solicitud de API. Esto permite a Klaviyo identificar las fuentes de datos, especialmente en casos en los que una cuenta tiene varias fuentes de datos (por ejemplo, 1 para cada una de las integraciones personalizadas, el almacén de datos o las integraciones personalizadas de terceros de las que la marca depende 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 en formato JSON a Klaviyo. Para una propiedad con varios valores de texto, envía una matriz de cadenas y asígnala como Lista (Texto). Puedes filtrar estos valores en segmentos y flujos. Consulta la referencia de condiciones de segmentos para obtener más información sobre el filtrado.

Tipos de datos compatibles de objetos personalizados:

• Mensaje de texto
• Número (entero)
• Número (decimal)
• Marca de tiempo: las fechas y horas se almacenan en UTC. Un valor sin zona horaria, como 2025-04-03, se trata como 2025-04-03 00:00:00 UTC. Un valor con un desplazamiento, como 2025-04-03T00:00:00+03:00, se convierte en 2025-04-02 21:00:00 UTC.
• Booleano
• Lista (texto)

List (Text) admite matrices de cadenas, como ["dog", "cat"]. No admite matrices de números, listas anidadas u objetos. Para ver un ejemplo de carga útil para la API de registros de fuente de datos, consulta Crear registros de fuente de datos en bloque.

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

Cada propiedad de objeto personalizado asignada puede contener hasta 2 KB, y cada registro de objeto personalizado asignado puede contener hasta 8 KB.

¿Puedo mapear con datos anidados?

Recomendamos definir el objeto JSON sin anidar las propiedades que quieras usar para el objeto personalizado. Para los datos anidados, selecciona una propiedad en el desplegable Propiedad de origen de datos o introduce manualmente su ruta JSON. Para una lista de valores de texto, asigna la propia lista como Lista (texto). Para asignar un único elemento de una matriz, usa su posición, por ejemplo, [0] para el 1.er elemento o [1] para el 2.º.

¿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?

Sí. Puedes previsualizar mensajes que usen datos de {{ object }} en un flujo activado por fecha basado en un objeto personalizado, antes de activar el flujo.

Para previsualizar un email:

1. Abre un email en un flujo activado por fecha basado en un objeto personalizado y, a continuación, haz clic en Vista previa en el editor de email.
2. Selecciona un perfil asociado con un registro de ese objeto y, luego, revisa el mensaje personalizado.

La vista previa usa un objeto de muestra asociado al perfil seleccionado. Si no hay ninguno disponible, usa un registro de muestra del mismo tipo de objeto. Comprueba los valores mostrados: la vista previa no confirma qué registro activará el flujo. Si no hay registros disponibles, no hay datos de objeto para previsualizar.

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