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?
Sí, esta función depende del uso de interfaz de programación de aplicaciones (API) para enviar fuentes de datos y, en última instancia, crear objetos.
¿Puedo crear objetos personalizados con formularios de Klaviyo o cargas de CSV?
Actualmente, Klaviyo requiere que las cuentas creen nuevos objetos personalizados enviándonos datos mediante la interfaz de programación de aplicaciones (API).
¿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.
Al hacer seguimiento de elementos como un estado de membresía, en los que un perfil solo puede tener un estado a la vez, las propiedades del perfil son la 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í, siempre puedes agregar propiedades adicionales, no obligatorias, a tu objeto personalizado. Para obtener más información, lee sobre 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:
- Usa la etiqueta
{{ event }}para agregar propiedades relevantes en los metadatos del evento y usarlas en la plantilla. Esto funciona bien cuando la puntualidad es importante. - 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 propiedades más recientes, 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?
- Crea una nueva fuente de datos usando nuestra interfaz de programación de aplicaciones (API).
- Define la estructura de datos (ver ejemplo de JSON).
- 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.
- Crea la relación entre tu objeto personalizado y tus perfiles.
¿Cómo se crean y se usan las fuentes de datos?
Los objetos personalizados se crean a partir de fuentes de datos. Tu desarrollador deberá crear una nueva fuente de datos usando nuestra interfaz de programación de aplicaciones (API) de objetos personalizados.
Después de crear una nueva fuente de datos, Klaviyo devolverá 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 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 se apoya 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?
La persona desarrolladora deberá enviar datos con formato JSON a Klaviyo. Se recomienda enviar los datos como texto con una lista separada por comas. Podrás usar la segmentación y el operador "contiene" del 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 en objetos personalizados:
- Texto
- Entero
- Decimal
- Fecha: todas las fechas y horas se convierten a UTC en nuestro sistema. Por ejemplo, si cargas "2025-04-03", se convierte en "2025-04-03 00:00:00". Para clientes con zonas horarias tres horas adelantadas, la fecha y hora se verían como "2025-04-02 21:00:00".
- Booleano
Actualmente no se admite el tipo de datos de la lista. Para ver un payload de ejemplo para la interfaz de programación de aplicaciones (API) de registros de fuentes de datos, consulta Crear registros de fuentes de datos en bloque.
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?
Puedes cargar un máximo de 2 KB por propiedad y 8 KB por registro total.
¿Puedo mapear con datos anidados?
Recomendamos definir el objeto JSON sin anidar las propiedades que quieres usar para el objeto personalizado. Si los datos de origen están profundamente anidados o usan una lista, tendrás que ingresar manualmente la ruta JSON en el administrador de objetos. Para las listas, solo puedes asignar una propiedad a una posición dentro de esa lista (p. ej., el primer o el segundo valor).
¿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?
En este momento, no es posible usar la función de vista previa en la app para ver un mensaje cuando usas la etiqueta {{ object }}.
Para probar un mensaje de flujo:
- Crea un flujo activado por fecha y configúralo para que se publique.
- 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 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.