Preguntas frecuentes sobre objetos personalizados
Objetivos del artículo
Obtén información sobre las preguntas frecuentes relacionadas con objetos personalizados en Klaviyo. Si no ves tu pregunta en el recurso de abajo, comunícate en nuestro foro de Community.
Preguntas generales sobre los objetos
¿Necesito un desarrollador para crear un objeto?
Necesitas a un desarrollador para enviar datos personalizados mediante interfaz de programación de aplicaciones (API). Puedes crear la fuente de datos y configurar el objeto en Klaviyo.
¿Puedo crear objetos personalizados con 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 interfaz de programación de aplicaciones (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 del perfil o un evento?
Debes 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 conservar información sobre las mascotas de tus clientes y tus clientes pueden tener más de una mascota, representarlas como un objeto personalizado funciona mucho mejor que las propiedades del perfil o los eventos.
Cuando se hace seguimiento de elementos como el estado de una membresía, en los que un perfil solo puede tener un estado a la vez, las propiedades del perfil son una mejor opción. Sin embargo, si también quieres almacenar otros detalles sobre la membresía de un perfil, un objeto puede funcionar mejor.
Cuando hagas el seguimiento de algo amplio, como cuántas veces un destinatario ha abierto un correo electrónico, recomendamos usar eventos.
¿Puedo actualizar mi objeto personalizado después de crearlo?
Sí, puedes agregar propiedades no obligatorias hasta el límite de propiedades de objeto de la cuenta. Para obtener más información, lee sobre cómo actualizar un objeto personalizado.
¿Cuándo debo 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 te permite enviar mensajes oportunos y relevantes. Cuando cambia el estado de un objeto y quieres activar un mensaje como resultado, debes 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 evento. Hay dos formas de lograrlo:
- Incluye las propiedades que necesitas en los datos del evento y luego consúltalas 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. - 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 %}. Reemplaza estos nombres con los nombres de tu propio objeto, propiedad y campo de evento. Puede tomar tiempo para que las actualizaciones del objeto estén disponibles, así que un mensaje de flujo podría 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?
- Crea una nueva fuente de datos usando nuestra interfaz de programación de aplicaciones (API).
- Define la estructura de datos con el ejemplo de JSON en Crear registros de fuente de datos de forma masiva.
- Envía los registros de tu fuente de datos a Klaviyo a través de la interfaz de programación de aplicaciones (API).
- Crea tu objeto personalizado usando esa fuente de datos. Elige un ID de objeto único y asigna las propiedades que quieres usar.
- Crea la relación entre tu objeto personalizado y tus perfiles asignando los identificadores de perfil en tus datos, como el correo electrónico o el número de teléfono.
- Revisa las asignaciones, haz clic en Crear objeto y luego haz clic en Crear objeto otra vez para confirmar.
¿Cómo se crean y se usan las fuentes de datos?
Los objetos personalizados se crean a partir de fuentes de datos. Puedes crear una fuente de datos en el generador de objetos al seleccionar Crear nueva fuente de datos en el menú desplegable Fuente de datos, o tu desarrollador puede crear una con la interfaz de programación de aplicaciones (API) de objetos personalizados.
Cuando creas una fuente de datos mediante la interfaz de programación de aplicaciones (API), Klaviyo devuelve un identificador único como parte de la respuesta a tu solicitud de interfaz de programación de aplicaciones (API). Esto permite que Klaviyo identifique las fuentes de datos, especialmente en casos en los que una cuenta tiene varias fuentes de datos (p. ej., 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 origen de datos mediante la interfaz de programación de aplicaciones (API) de Klaviyo.
¿Cómo debo dar formato a los datos?
Tu desarrollador tendrá que enviar datos con formato JSON a Klaviyo. Para una propiedad con varios valores de texto, envía un arreglo de cadenas y asígnalo como Lista (Texto). Puedes filtrar estos valores en segmentos y flujos. Consulta la referencia de condiciones de segmento para obtener más información sobre el filtrado.
Tipos de datos compatibles en objetos personalizados:
- 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 desfase, como 2025-04-03T00:00:00+03:00, se convierte a 2025-04-02 21:00:00 UTC.
- Booleano
- Lista (texto)
List (Text) admite arreglos de cadenas, como ["dog", "cat"]. No admite arreglos de números, listas anidadas u objetos. Para ver un ejemplo de carga útil para la interfaz de programación de aplicaciones (API) del registro de la fuente de datos, consulta Creación masiva de registros de fuente de datos.
Al enviar números de teléfono, estos deben estar en el formato E.164. Al enviar fechas, estas deben estar en uno de nuestros formatos de marca de tiempo aceptables.
¿Cuáles son los límites de datos para 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 quieres usar para el objeto personalizado. Para datos anidados, selecciona una propiedad en el menú desplegable Propiedad de origen de datos o ingresa manualmente su ruta JSON. Para una lista de valores de texto, asigna la lista en sí como Lista (Texto). Para asignar un solo elemento de un arreglo, usa su posición, como [0] para el 1.er elemento o [1] para el 2.º.
¿Puedo asociar varios identificadores con un perfil?
Sí, si quieres usar 2 o más identificadores de perfil (p. ej., 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 flujos
Si mi objeto no activó un flujo y no tengo un id de objeto de un evento, ¿aun así puedo personalizar mi mensajería?
Sí, puedes usar filtros de objetos para encontrar el objeto correcto al personalizar tus mensajes.
¿Puedo previsualizar los mensajes de un flujo cuando un objeto activa un flujo?
Sí. Puedes previsualizar mensajes que usan datos de {{ object }} en un flujo activado por fecha basado en un objeto personalizado, antes de activar el flujo.
Para ver la vista previa de un correo electrónico:
- Abre un correo electrónico en un flujo activado por fecha basado en un objeto personalizado y, luego, haz clic en Vista previa en el editor de correo electrónico.
- 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 con el perfil seleccionado. Si no hay ninguno disponible, usa un registro de muestra del mismo tipo de objeto. Revisa los valores que se muestran: la vista previa no confirma qué registro activará el flujo. Si no hay registros disponibles, no hay datos del objeto para previsualizar.
¿Puedo actualizar mis objetos con acciones de flujo como webhooks y código de Klaviyo?
En este momento, te recomendamos que primero actualices la fuente de datos original y luego envíes el objeto revisado a Klaviyo en el formato permitido. Si estos dos sistemas se desincronizan, te arriesgas a enviar a Klaviyo desde tu sistema un registro desactualizado, revirtiéndolo al valor original.