Introducción a los objetos personalizados

Obtén información sobre los objetos personalizados, que te permiten almacenar y asociar varias propiedades a un solo «objeto».  Los objetos personalizados te permiten asignar conceptos de datos diversos y multirelacionales a Klaviyo que no pueden almacenarse utilizando propiedades de perfil. Luego, puedes usar objetos personalizados en tus mensajes, segmentos y más.

¿En qué se diferencian los objetos personalizados de las propiedades de perfil?

Las propiedades de perfil son una excelente manera de almacenar información sencilla. Por ejemplo, si tienes una propiedad de color favorita, puedes almacenar el color favorito de cada cliente.

Pero ¿qué pasa si quieres necesitar más datos o múltiples versiones de esa propiedad? Un gran ejemplo es para las mascotas. Puedes usar propiedades de perfil para almacenar datos como el nombre, la edad o la raza, pero solo se pueden usar una vez por perfil.

Si alguien tiene varias mascotas, puedes usar objetos personalizados. De esta manera, Fluffy el Gran Danés tiene su propia tarjeta de identificación digital para su nombre, edad, peso, etc., y Cheeks el hámster tiene la misma información, pero con respuestas (muy) diferentes. 

Ejemplos de casos de uso

A continuación, verás algunos ejemplos que muestran cómo los objetos personalizados son flexibles en los datos que puedes almacenar en Klaviyo.

Cita

Si eres una empresa en la que los clientes pueden programar citas, puedes usar un objeto Cita para almacenar datos de citas de perfiles. 

Dentro de cada registro de objeto para el objeto Appointment, algunos ejemplos de datos que puedes incluir son:

• ID de cita
• Fecha de la cita
• Persona designada (por ejemplo, médico específico, instructor, etc.)
• Lugar de la cita
• Tipo de cita

Los perfiles pueden tener varios registros de objetos si tienen varias citas, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.

Suscripción

Si eres una empresa en la que los clientes pueden suscribirse, puedes usar un objeto Suscripción para almacenar datos de suscripción de perfiles. 

Dentro de cada registro de objeto para el objeto Suscripción, algunos ejemplos de datos que puedes querer incluir son:

• ID de suscripción
• Producto de suscripción
• Precio de suscripción
• Estado de la suscripción
• Próxima fecha de facturación

Los perfiles pueden tener varios registros de objetos si tienen varias suscripciones, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.

Reserva

Si eres una empresa en la que los clientes pueden reservar, puedes utilizar un objeto de reserva para almacenar datos de reservas de perfiles. 

Dentro de cada registro de objeto para el objeto de reserva, algunos ejemplos de datos que puedes querer incluir son:

• ID de reserva
• Fecha de reserva
• Ubicación de la reserva
• Ocasión de reserva
• Recuento de invitados de la reserva

Los perfiles pueden tener varios registros de objetos si tienen varias reservas, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.

Mascota

Si eres una empresa que atiende a dueños de mascotas, puedes usar un objeto Pet para almacenar datos sobre las mascotas de los perfiles. 

Dentro de cada registro de objeto para el objeto Pet, algunos ejemplos de datos que puedes querer incluir son:

• ID de microchip para mascotas
• Nombre de la mascota
• Tipo de mascota (por ejemplo, perro o gato)
• Raza de mascotas
• Cumpleaños de mascotas

Los perfiles pueden tener varios registros de objetos si tienen varias mascotas, y puedes usar estos datos de objetos para crear segmentos y enviar mensajes y flujos personalizados.

Límites de la cuenta

Los objetos personalizados tienen 3 conjuntos de límites de cuenta:

• Límite de objetos
  Número total de objetos que puede tener una cuenta.
• Límites de las propiedades de objeto
  El número de propiedades que puede tener una cuenta por objeto.
• Límites de registros de objetos
  El número de registros de objetos permitidos para una cuenta.

El número de objetos y registros de objetos disponibles se basa en el número total de perfiles activos en todas tus cuentas. Los límites de registros se comparten en todas las cuentas, mientras que los límites de objetos se aplican a cada cuenta por separado.

Por ejemplo, si tienes una cuenta familiar con 5 cuentas secundarias en las que cada cuenta tiene 100 000 perfiles activos, el total de tus perfiles activos será de 500 000. Como se muestra en el siguiente gráfico, las cuentas con más de 400 000 perfiles tienen un multiplicador de registro de objeto de 10. Como resultado, estas cuentas pueden almacenar un máximo combinado de 5 millones de registros (500.000 x 10). Esto significa que podrías tener 1 cuenta con 3 millones de registros, siempre y cuando las 4 cuentas restantes tengan menos de 2 millones de registros de objetos combinados. En cuanto al número de objetos por cuenta, dado que el recuento combinado de perfiles es superior a 400 000, cada cuenta puede tener hasta 5 objetos.

Además, todas las cuentas tienen los siguientes límites:

• Máximo de 500 registros por perfil y objeto.
• Cada objeto personalizado no debe tener más de 8 KB.
• Cada registro de objeto personalizado no debe tener más de 2 KB.

Crear un objeto

Para empezar a crear un objeto en Klaviyo, ve a Contenido > Objetos. y haz clic en Crear objeto.

Desde aquí, puedes crear un objeto desde cero o seleccionar una plantilla de objeto recomendada. Para crear un objeto desde cero, selecciona el botón Crear.

La primera parte del flujo de trabajo de creación de objetos requiere que establezcas la siguiente información para tu objeto:

• Nombre
  Un nombre para identificar tu objeto
• Descripción (opcional)
  Una descripción de los datos que representa tu objeto
• Origen de datos
  La fuente de datos donde residen tus datos de objetos.

Para crear una fuente de datos, haz clic en el desplegable Seleccionar una fuente de datos y, a continuación, selecciona Crear una fuente de datos.

Para crear un origen de datos, debes establecer la siguiente información:

• Nombre
  Un nombre único para identificar la fuente de tus datos de objetos.
• Descripción (opcional)
  Una descripción de tu fuente de datos.

Establece el ID del objeto

Una vez que establezcas un nombre para tu objeto y elijas la fuente de datos, el siguiente paso es configurar un ID de objeto y asignar las propiedades del objeto que quieras. Durante este paso, podrás previsualizar los datos asociados con la fuente de datos que se enviaron a Klaviyo a través de la API de objetos personalizados.

Es necesario establecer el ID de objeto para distinguir los registros de objetos entre sí. Tendrás que especificar una propiedad de origen de datos que se utilizará para el ID de objeto único.

El ID de objeto debe ser una propiedad de origen de datos única que pueda usarse para identificar instancias específicas de un registro de objeto. Por ejemplo, con un objeto de tarjeta regalo, puedes usar algo como el código de descuento único como ID del objeto. Esto es único para cada instancia del origen de datos y existirá para cada registro de objeto.

Cada vez que Klaviyo reciba datos de tu fuente de datos con el mismo ID de objeto, se actualizará el registro de objeto asociado. Por este motivo, es importante que el ID de objeto sea único para que se actualice el registro correspondiente.

Enviar datos de objetos

Cuando actualizas un registro de objeto existente, se sustituye todo el registro. Por lo tanto, es crítico enviar el registro de objeto completo, incluso si solo quieres actualizar 1 propiedad.

Por ejemplo, supongamos que quieres actualizar solo 1 de cada 5 propiedades de un registro. Si envías datos actualizados con el ID y solo la propiedad 1 que quieras actualizar, las otras 4 propiedades se establecerán como nulas. Si uno de los campos recién anulados se ha usado en tu relación de perfil (por ejemplo, un identificador de perfil como una dirección de correo electrónico), el objeto dejará de estar relacionado con ese perfil.

Asignar las propiedades de objeto

Al asignar propiedades de objeto, puedes seleccionar qué información del origen de datos estará disponible dentro de un objeto en Klaviyo.

Sin embargo, por este motivo, recomendamos enviar datos de objetos a través de la API de ingesta de objetos en formatos de fecha y marca de tiempo estandarizados. Si no se conoce el valor de una propiedad específica, puedes establecer un valor nulo para ella.

Para asignar propiedades de objeto:

1. En la columna Propiedades del origen de datos, selecciona la propiedad del origen de datos que quieras incluir en el objeto.
2. En la columna de propiedades asignadas , introduce el nombre que quieras que tenga la propiedad de origen de datos en el objeto.
3. En la columna Tipo de datos, selecciona el tipo de datos adecuado de la propiedad de tu fuente de datos.
4. En la columna Obligatorio, selecciona la casilla de verificación si quieres que esta propiedad sea obligatoria en el objeto.
5. Selecciona el botón Añadir asignación si necesitas asignar propiedades de objeto adicionales.

Datos anidados en la asignación

De forma predeterminada, la interfaz del gestor de objetos admite 1 nivel de anidamiento. Para acceder a datos más detallados, debes introducir manualmente la ruta que prefieras.

Como ejemplo, mira la fuente de datos a continuación.

text Copy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

Para acceder a los datos sobre el nombre de un niño, puedes introducir la siguiente ruta, ya que los datos están anidados demasiado lejos para acceder a la interfaz.

Si tienes una matriz en tus datos de origen, puedes encontrar propiedades para asignar por posición. Por ejemplo, puedes extraer el primer número de teléfono dentro de la matriz phone_numbers incluyendo [0] al final de tu ruta.

Añadir una relación

Después de establecer un ID de objeto y asignar tus propiedades de objeto, el siguiente paso es añadir una relación a tu objeto.

Las relaciones conectan tu objeto con perfiles relevantes. Define la siguiente información para establecer una relación:

• Nombre de la relación
  Establece un nombre para tu relación. Por ejemplo, si tienes un objeto para mascotas, quizás te interese establecer el nombre de la relación como «Propietario de mascotas».
• Datos de origen
  Selecciona las propiedades de origen de datos que quieras asociar a un perfil.
• Identificador de perfil
  Configura el identificador de perfil (es decir, email, número de teléfono, etc.). Esto debe incluirse en la fuente de datos para que un objeto se asocie con un perfil. Usa el botón Vincular otra propiedad para añadir pares adicionales de propiedades e identificadores.

Confirmar las asignaciones y crear un objeto

Una vez que hayas terminado de asignar las propiedades del objeto y establecer la relación, confirma las asignaciones en la ventana modal de confirmación y selecciona el botón Crear objeto. Ten en cuenta que las asignaciones existentes no se pueden editar una vez que se haya creado el objeto, y los datos comenzarán a sincronizarse inmediatamente.

Verás tu objeto en la lista de la página Objetos en Klaviyo, junto con la siguiente información:

• Nombre del objeto
• Fecha de creación
• Fecha de la última actualización
• Estado

Estados del estado del objeto personalizado

Hay tres estados al publicar objetos personalizados:

• Borrador
  El objeto sigue siendo editable y no está publicado ni activo.
• Publicación
  El objeto está creando registros de objetos personalizados a partir de los datos que has enviado a tu fuente de datos.  Si has enviado varios miles de registros desde tu fuente de datos, tu objeto se publicará al instante. Si has enviado unos cuantos millones de registros, puede tomar horas publicarlos. Una vez completado, el estado cambiará a Activo.
• Activo
  El objeto está publicado y activo. Todos los registros de objetos personalizados se han creado de acuerdo con los datos enviados desde tu fuente de datos. Cualquier nuevo dato enviado para este objeto generará registros de objetos personalizados adicionales vinculados a tus perfiles.

Objetos en páginas de perfil

Los objetos relevantes también aparecerán en una página de perfil para que puedas ver los registros de objetos que pertenecen a un perfil. Para ver los registros de objetos, ve a la pestaña Objetos en una página de perfil. Puedes cambiar entre objetos usando el menú desplegable encima de las tarjetas de objetos.

Para ver un registro de objeto completo, selecciona el menú de 3 puntos y haz clic en Ver. Aparecerá un panel lateral que contiene el registro completo del objeto.

Actualizar un objeto

Si quieres empezar a enviar nuevos datos para un objeto, añade las propiedades de objeto adicionales a tu origen de datos y, a continuación, edita la asignación de objetos para incluir esta nueva propiedad. Todos los objetos creados anteriormente devolverán un valor nulo para esta propiedad, ya que esos datos no están disponibles, pero en adelante, los objetos se crearán y actualizarán con esta propiedad.

Si envías nuevas propiedades de objeto que aún no se han asignado a un objeto, puedes actualizar tu objeto personalizado para incluirlo. A continuación, se reprocesan todos los registros de objetos personalizados para incluir estos datos.

Para actualizar un objeto, sigue estos pasos:

1. Haz clic en Contenido > Objetos en la barra lateral de Klaviyo.
2. Selecciona el nombre del objeto que quieras editar.
3. Haz clic en Siguiente en la esquina superior derecha.
4. En la sección Asignar propiedades de objeto , haz clic en Añadir asignación.

1. En la columna Propiedades del origen de datos, selecciona la propiedad del origen de datos que quieras incluir en el objeto.
2. En la columna de propiedades asignadas , introduce el nombre que quieras que tenga la propiedad de origen de datos en el objeto.
3. En la columna Data type, selecciona el tipo de datos adecuado de la propiedad de tu fuente de datos.

1. Haz clic en Siguiente en la esquina superior derecha.
2. Haz clic en Siguiente en la esquina superior derecha. No tendrás que hacer cambios en tus relaciones.
3. Haz clic en Publicar cambios.

Una vez que hayas completado este proceso, todos los registros de tu fuente de datos se reprocesarán y los registros de objetos personalizados existentes se actualizarán en consecuencia.

Eliminar un objeto

Para eliminar un objeto, sigue estos pasos:

1. Haz clic en Contenido > Objetos en la barra lateral de Klaviyo.
2. En el menú situado a la derecha de tu objeto, haz clic en Eliminar.
   

3. Haz clic en Eliminar de nuevo para confirmar la eliminación del objeto.
4. Se eliminarán el objeto y todos los registros de objetos personalizados asociados.

Si creas un nuevo objeto personalizado utilizando el origen de datos de un objeto anterior, se generarán nuevos registros de objetos personalizados utilizando los datos que ya has sincronizado. Aunque utiliza los mismos datos, se considera un nuevo objeto con nuevos registros, por lo que todos los segmentos, flujos, plantillas y campañas deben actualizarse para utilizar este nuevo objeto.

Recursos adicionales