Primeros pasos con objetos personalizados

Qué aprenderás

Aprende sobre los objetos personalizados, incluyendo cómo configurar un objeto y cómo puedes utilizar objetos en todo Klaviyo.

Antes de empezar

Debe tener acceso a los objetos personalizados para utilizar esta funcionalidad. 

¿Qué son los objetos personalizados?

Los objetos personalizados son un tipo de estructura de datos en Klaviyo que te habilitan para mapear diversos conceptos de datos multirrelacionales en Klaviyo que no se pueden almacenar utilizando Propiedades de perfil. Por ejemplo, digamos que quieres almacenar datos sobre las mascotas de tus clientes en Klaviyo. Cada mascota tiene una serie de atributos sobre ella (por ejemplo, nombre, edad, raza. etc.), lo que dificulta la tienda de esta información con Propiedades de perfil cuando un perfil tiene varias mascotas. 

A continuación, puedes utilizar estos datos de objeto en flujo, plantilla y segmento a través de Klaviyo para personalizar mejor tu marketing. 

Ejemplos de casos prácticos

A continuación se muestran algunos ejemplos que demuestran la flexibilidad de los objetos personalizados en los datos que puedes almacenar en Klaviyo. 

Cita previa

Si tienes un negocio en el que los clientes pueden concertar citas, puedes utilizar un objeto Cita para almacenar datos de citas de perfil.  

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

• Identificación de la cita 
• Fecha de nombramiento
• Persona designada (por ejemplo, un médico concreto, un instructor, etc.)
• Lugar de la cita
• Tipo de cita 

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

Suscripción 

Si eres una empresa en la que el cliente puede Registrarse para una suscripción, puedes utilizar un objeto Suscripción para almacenar datos de suscripción de perfil.  

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 utilizar los datos de estos objetos para crear segmentos y enviar mensajes y flujos personalizados. 

Reserva

Si tienes un negocio en el que los clientes pueden hacer reservas, puedes utilizar un objeto Reserva para almacenar datos de reservas de perfil.  

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

• ID de reserva
• Fecha de reserva
• Lugar de la reserva
• Ocasión de la reserva 
• Recuento de invitados a la reserva 

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

Mascota

Si eres una empresa que atiende a dueños de mascotas, puedes utilizar un objeto Mascota para tienda datos sobre mascotas perfil'.  

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

• Identificación del microchip de la mascota
• Nombre de la mascota 
• Tipo de mascota (por ejemplo, perro o gato)
• Raza
• Cumpleaños de mascotas 

perfil puede tener varios registros de objetos si tienen varias mascotas, y puedes utilizar estos datos de objetos para crear segmento y enviar mensajes personalizados y flujo. 

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 losobjetos 
  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 perfil activo de todas sus 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 tiene una familia de cuentas con 5 cuentas hijo en la que cada cuenta tiene 100.000 perfil activo, su perfil activo total será igual a 500.000. Como se muestra en el siguiente gráfico, las cuentas con más de 400.000 perfiles tienen un multiplicador de registros de objetos de 10. Como resultado, estas cuentas pueden tienda un máximo combinado de 5 millones de registros (500.000 x 10). Esto significa que podría tener 1 cuenta con 3 millones de registros siempre que 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 número de perfiles combinados supera los 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 por objeto.
• Cada objeto personalizado no debe tener más de 8 KB.
• Cada registro de objeto personalizado no debe ocupar más de 2 KB.

Crear un objeto 

Para empezar a crear un objeto en Klaviyo, vaya a Contenido > Objetos. 

Siga los pasos para crear y sincronizar una fuente de datos para su objeto personalizado. Una vez completados estos pasos, seleccione el botón Crear objeto personalizado para crear el objeto. 

Desde aquí, puede crear un objeto desde cero o seleccionar una plantilla de objeto recomendada. Para crear un objeto desde cero, seleccione el botón Construya el suyo propio.

La primera parte del flujo de trabajo de creación de objetos requiere establecer la siguiente información para su objeto:

• Nombre
  Un nombre para identificar su objeto
• Descripción (opcional)
  Una descripción de los datos que representa su objeto
• fuente de datos
  La fuente de datos de la que obtener los datos del objeto. Debe enviarse al menos 1 registro a Klaviyo utilizando la API de objetos personalizados para que aparezca como opción en el desplegable. 

Establecer el ID del objeto

Una vez que establezca un nombre para su objeto y elija la fuente de datos, el siguiente paso es establecer un ID de objeto y asignar las propiedades de objeto deseadas. Durante este paso, podrá previsualizar los datos asociados a la fuente de datos que se enviaron a Klaviyo a través de la API de objetos personalizados.

Establecer el ID del objeto es necesario para distinguir los registros de objetos entre sí. Tendrá que especificar una propiedad de la fuente de datos que se utilizará para el identificador único del objeto. 

El ID del objeto debe ser una propiedad única de la fuente de datos que pueda utilizarse para identificar instancias específicas de un registro de objeto. Por ejemplo, con un objeto de tarjeta regalo, puede utilizar algo como el código de descuento único como ID del objeto. Es único para cada instancia de la fuente de datos, y existirá para todos los registros de cada objeto. 

Cada vez que Klaviyo reciba datos de su fuente de datos con el mismo ID de objeto, se actualizará el registro de objeto asociado. Por esta razón, es importante que el ID del objeto sea único para que se actualice el registro apropiado.

Enviar datos del objeto

Cuando actualiza un registro de objeto existente, se sustituye todo el objeto. Por lo tanto, es fundamental enviar el objeto completo cada vez, aunque sólo desee actualizar 1 registro. 

Por ejemplo, supongamos que desea actualizar sólo 1 de los 5 registros de un objeto. Si envía actualizar datos con el ID y sólo el 1 registro que desea actualizar, los otros 4 registros se establecerán como nulos. Si uno de los nuevos campos nulos se utilizaba en su 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.

Propiedades del objeto de mapa 

Al mapear las propiedades de los objetos, puede seleccionar qué información de la fuente de datos estará disponible dentro de un objeto en Klaviyo.

Sin embargo, por esta razón, recomendamos enviar los datos de los objetos a través de la API de ingestión de objetos en formatos estandarizados. Si no se conoce el valor de una propiedad específica, puede establecer un valor nulo para ella.

Para asignar las propiedades de los objetos:

1. En la columna de propiedades de origen de datos seleccione la propiedad de origen de datos que desea incluir en su objeto. 
2. En la columna Propiedad mapeada , introduzca el nombre que desea que tenga la propiedad del origen de datos en el objeto. 
3. En la columna tipo de datos, seleccione el tipo de datos apropiado de su propiedad fuente de datos.
4. En la columna Obligatorio, seleccione la casilla si desea que esta propiedad sea obligatoria en el objeto.
5. Seleccione el botón Añadir asignación si necesita asignar propiedades de objeto adicionales. 

Datos anidados en la cartografía

Por defecto, la interfaz de gestión de objetos asiste a 1 nivel de anidamiento. Para acceder a datos más profundos, debe introducir manualmente la ruta de su elección.

A modo de ejemplo, observe la fuente de datos que figura a continuación. 

{
   "tipo": "datos-fuente-registro",
   "atributos": {
   "registro": {
    "child_id": "d64b8458",
    "child": { 
     "nombre": {
      “first”: “Theodore”,
      “last”: “Customer”
     }
    }
    "fecha_nacimiento": "2022-04-12",
    "correo electrónico": "jon.customer@klaviyo.com",
    "números_de_teléfono": [
     "+11234567899",
     "+13456789123"
    ]
   }
  }
 }
]

Para acceder a los datos sobre el nombre de pila de un niño, puede introducir la siguiente ruta, ya que de lo contrario los datos están demasiado anidados para acceder a ellos con la interfaz.

Si tiene una matriz en sus datos de origen, puede encontrar propiedades para mapear por posición. Por ejemplo, podría extraer el primer número de teléfono dentro de la matriz phone_numbers incluyendo [0] al final de su ruta. 

Añadir relación 

Tras establecer un ID de objeto y asignar sus propiedades de objeto, el siguiente paso es añadir una relación a su objeto. 

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

• Nombre de la relación
  Establezca un nombre para su relación. Por ejemplo, si tiene un objeto mascota, puede establecer que el nombre de la relación sea algo como "Propietario de mascota". 
• Fuente de datos
  Seleccione las propiedades de la fuente de datos que desea asociar a un perfil. 
• identificador de perfil
  Establezca el identificador del perfil (es decir, correo electrónico, número de teléfono, etc.). Es necesario incluirlo en la fuente de datos para que un objeto se asocie a un perfil. Utilice el botón Vincular otra propiedad para añadir pares adicionales de propiedad e identificador.

Confirmar las asignaciones y crear un objeto

Una vez que haya terminado de asignar las propiedades del objeto y de establecer la relación, confirme las asignaciones en el modal de confirmación y seleccione el botón Crear objeto. Tenga en cuenta que las asignaciones existentes no pueden editarse una vez creado el objeto, y los datos comenzarán a sincronizarse inmediatamente. 

Verá su objeto listado en la página Objetos de Klaviyo, junto con la siguiente información: 

• Nombre del objeto
• Fecha de creación
• Última fecha de actualización
• Estado

Estados de estado de los objetos personalizados

 Existen tres estados cuando se publican objetos personalizados: 

• Borrador
  El objeto aún es editable y no está publicado ni activo .
• Publicación
  El objeto está creando registros de objetos personalizados a partir de los datos que ha enviado a su fuente de datos. Si ha enviado unos pocos miles de registros desde su fuente de datos, su objeto se publicará al instante. Si ha enviado unos cuantos millones de registros, la publicación puede tardar horas. 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 su fuente de datos. Cualquier nuevo dato enviado para este objeto generará registros de objetos personalizados adicionales vinculados a su perfil.

Objetos en las páginas de perfil

Los objetos relevantes también aparecerán en la página de un 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 de la página de un perfil. Puedes pasar de un objeto a otro utilizando el menú desplegable situado encima de las fichas de los objetos. 

Para ver un registro de objetos 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 desea comenzar a enviar nuevos datos para un objeto, añada las propiedades adicionales del objeto a su fuente de datos y, a continuación, edite su asignación de objetos para incluir esta nueva propiedad. Todos los objetos creados anteriormente devolverán un null 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ía nuevas propiedades de objeto que aún no han sido asignadas a un objeto, puede actualizar su objeto personalizado para incluirlas. A continuación, todos los registros de objetos personalizados se vuelven a procesar para incluir estos datos.

Para actualizar un objeto:

1. Haga clic en Contenido > Objetos en la barra lateral de Klaviyo.
2. Seleccione el nombre del objeto que desea editar. 
3. Haga clic en Siguiente en la esquina superior derecha.
4. En la sección Propiedades del objeto cartográfico , haga clic en Añadir cartografía.

   Esta opción sólo está disponible si su objeto tiene propiedades adicionales que puedan añadirse.

5. En la columna de propiedades de origen de datos seleccione la propiedad de origen de datos que desea incluir en su objeto. 
6. En la columna Propiedad mapeada , introduzca el nombre que desea que tenga la propiedad del origen de datos en el objeto. 
7. En la columna tipo de datos, seleccione el tipo de datos apropiado de su propiedad fuente de datos.

   Las propiedades recién mapeadas no pueden marcarse como necesarias.

   
8. Haga clic en Siguiente en la esquina superior derecha. 
9. Haga clic en Siguiente en la esquina superior derecha. No tendrá que hacer cambios en sus relaciones.
10. Haga clic en Publicar cambios.

Una vez que haya completado este proceso, todos los registros de su fuente de datos se volverán a procesar y los registros de objetos personalizados existentes se actualizarán en consecuencia. 

Borrar un objeto 

Para eliminar un objeto: 

1. Haga clic en Contenido > Objetos en la barra lateral de Klaviyo.
2. En el menú situado a la derecha de su objeto, haga clic en Eliminar. 
   
3. Pulse Borrar de nuevo para confirmar la eliminación del objeto. 
4. Se eliminan el objeto y todos los registros de objetos personalizados asociados. 

Si crea un nuevo objeto personalizado utilizando la fuente de datos de un objeto anterior, se generarán nuevos registros de objetos personalizados utilizando los datos que ya ha 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 

Cómo utilizar objetos personalizados en plantilla

Cómo utilizar objetos personalizados en segmento

Cómo utilizar objetos personalizados en flujo

Visión general de la API de objetos personalizados