primeros pasos con objetos personalizados

Aprende sobre los objetos personalizados, que te permiten almacenar y asociar múltiples propiedades a un solo objeto "."  Los objetos personalizados te permiten asignar conceptos de datos diversos y multirrelacionales en Klaviyo que no se pueden almacenar utilizando las propiedades del perfil. A continuación, puedes utilizar objetos personalizados en tus mensajes, segmentos y mucho más. 

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

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

Pero, ¿qué pasa si necesitas más datos o varias versiones de esa propiedad? Un buen ejemplo son las mascotas. Puedes utilizar las propiedades del perfil para almacenar datos como el nombre, la edad o la raza, pero solo se pueden utilizar una vez por perfil.

Si alguien tiene varias mascotas, puedes utilizar objetos personalizados. De esa manera, Fluffy, el gran danés, tiene tu propia tarjeta de identificación digital con tu nombre, edad, peso, etc., y Cheeks, el hámster, tiene la misma información, pero con respuestas (muy) diferentes.  

Ejemplos de casos prácticos

A continuación se muestran algunos ejemplos que demuestran cómo los objetos personalizados son flexibles en los datos que puedes tienda, comercio en Klaviyo. 

Cita

Si tienes un negocio en el que los clientes pueden concertar citas, puedes utilizar un objeto Cita para tienda, comercio cita datos para 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 un negocio en el que el cliente puede Registrarse para una suscripción, puedes utilizar un objeto Suscripción a tienda, comercio suscripción datos para 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 tienda, comercio reserva datos para 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, comercio datos sobre perfil' mascotas.  

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 

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

Límites de la cuenta 

Los límites de objetos para tu cuenta dependen de los límites del perfil de tu cuenta y de si tienes una Plataforma de Datos Klaviyo Avanzada plan. Como mínimo, el acceso a estas funciones/características requiere un correo electrónico plan de pago o una prueba avanzada de la Plataforma de Datos Klaviyo, que puedes solicitar a través de tu CSM. Si operas dentro de una familia de cuentas, tus límites reflejarán los de una Plataforma de Datos Avanzada Klaviyo plan. Para más información sobre la facturación, consulta cómo funciona la facturación compartida en Klaviyo. 

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 propiedades de objetos
  El número de propiedades que puede tener una cuenta por objeto.
   
• Límites de registros de objetos
  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 toda tu cuenta. 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 familia cuenta con 5 hijos cuenta en la que cada cuenta tiene 100.000 perfil activo, tu perfil activo total es igual a 500.000. Como se muestra en el gráfico siguiente, las cuentas con más de 400.000 perfiles tienen un multiplicador de registros de objetos de 10. Como resultado, estas cuentas pueden tienda, comercio 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 que las 4 cuentas restantes tengan menos de 2 millones de registros de objetos juntos. En cuanto al número de objetos por cuenta, como el número de perfiles combinados es superior a 400.000, cada cuenta puede tener hasta 5 objetos.

Si estás en una Plataforma de Datos Klaviyo Avanzada plan, el multiplicador de registros de objetos se basará en el número total de perfiles de tu cuenta. Si sólo tienes un correo electrónico plan, este multiplicador se basará en el límite de perfil activo de tu cuenta. 

Perfiles	Plan de Advanced KDP	Número de objetos	Número de propiedades del objeto	Multiplicador de registros de objetos
Gratis plan	ninguno	0	0	N/D
250 - 400,000	ninguno	1	15	10x
	Pagado	5	30	10x
Más de 400.000	ninguno			10x
	Pagado			10x

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 tener más de 2 KB.

Crear un objeto 

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

Sigue los pasos para crear y sincronizar una fuente de datos para tu objeto personalizado. Una vez completados estos pasos, selecciona el botón Crear objeto personalizado para crear el 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 Construye el tuyo.

La primera parte del flujo de trabajo de creación de objetos requiere establecer 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.
• Fuente de datos
  La fuente de datos de la que se obtienen los datos de los objetos. Se debe enviar al menos un registro a Klaviyo utilizando el objeto personalizado interfaz de programación de aplicaciones (API) para que aparezca como opción en el menú desplegable. 

Establece el ID del objeto

Una vez que hayas establecido un nombre para tu objeto y elegido la fuente de datos, el siguiente paso es establecer un ID de objeto y asignar las propiedades de objeto que desees. Durante este paso, podrás previsualizar los datos asociados a la fuente de datos que se envió a Klaviyo a través del objeto personalizado interfaz de programación de aplicaciones (API).

Establecer el ID del objeto es necesario para distinguir los registros de objetos entre sí. Tendrás 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 se pueda utilizar para identificar instancias específicas de un registro de objeto. Por ejemplo, con un objeto de tarjeta de regalo, puede utilizar algo como el código de descuento único como ID del objeto. Esto es único para cada instancia de la fuente de datos y existirá para cada registro de objeto. 

Siempre que Klaviyo reciba datos de tu 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 adecuado.

Enviar datos del objeto

Cuando actualizas un registro de objeto existente, se reemplaza todo el registro. Por lo tanto, es fundamental enviar todo el registro del objeto, incluso si solo deseas actualizar una propiedad.

Por ejemplo, supongamos que deseas actualizar solo 1 de las 5 propiedades de un registro. Si envías datos actualizados con el ID y solo la propiedad que deseas actualizar, las otras cuatro propiedades se establecerán en nulo. Si alguno de los campos recién anulados se utilizaba en la relación de tu perfil (por ejemplo, un identificador de perfil como una dirección de correo electrónico), el objeto ya no estará relacionado con ese perfil.

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. 

Propiedades del objeto Mapa 

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

Sólo los datos mostrados en la instancia concreta de la fuente de datos que se está previsualizando están disponibles en el desplegable. Puedes recorrer las instancias de la fuente de datos utilizando el botón Nueva muestra de datos .

Sin embargo, por este motivo, recomendamos enviar los datos de los objetos a través de la interfaz de programación de aplicaciones (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 las propiedades de los objetos:

1. En la columna propiedad fuente de datos selecciona la propiedad fuente de datos que quieras incluir en tu objeto. 
2. En la columna Propiedad mapeada , introduce el nombre que quieras que tenga la propiedad del origen de datos en el objeto. 
3. En la columna tipo de datos, selecciona el tipo de datos apropiado de tu propiedad fuente de datos.
4. En la columna Obligatorio, marca la casilla 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. 

Si una propiedad de objeto se establece como Requerida, debe existir en la fuente de datos y no puede tener un valor nulo establecido. Si la propiedad requerida no está presente, no se creará el registro del objeto.

Datos anidados en el mapeo

Por defecto, la interfaz del gestor de objetos equipo de asistencia 1 nivel de anidamiento. Para acceder a datos más profundos, debes introducir manualmente la ruta que elijas.

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

" type": "data-source-record",
 " attributes":{
 " record":{
 " child":{
 " child_id": "d64b8458",
 " name": {
          "first": "Theodore",
          "last": "Customer"
        },
 " birth_date": "2022-04-12",
 " email": "[e-mail]",
        "números_de_teléfono": [
 " [phone]",
 " [phone]"
 ]
 }
 } 
 }
}

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

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

Añadir relación 

Tras establecer un ID de objeto y asignar sus propiedades, 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 mascota, es posible que quieras establecer el nombre de la relación como «Dueño de mascota».
• Datos de origen
  Selecciona las propiedades de la fuente de datos que deseas asociar a un perfil. 
• Identificador de perfil
  Establece el identificador de perfil (es decir, correo electrónico, número de teléfono, etc.). Esto debe incluirse en la fuente de datos para que un objeto se asocie a un perfil. Usa el botón Vincular otra propiedad para agregar pares adicionales de propiedades e identificadores.

Confirmar asignaciones y crear objeto

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

Verás tu 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 sigue siendo editable y no está publicado ni activo. 
• Publicación
  El objetivo es crear registros de objetos personalizados a partir de los datos que has enviado a tu fuente de datos.  Si has enviado unos cuantos miles de registros desde tu fuente de datos, tu objeto se publicará al instante. Si has enviado varios millones de registros, la publicación puede tardar horas. Una vez completado, el estado cambiará a con actividad.
• con actividad
  El objeto se publica y se activa. Todos los registros de objetos personalizados se han creado de acuerdo con los datos enviados desde tu fuente de datos. Cualquier dato nuevo que se envíe para este objeto generará registros de objetos personalizados adicionales vinculados a tu 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 

Cualquier cambio que realices en un objeto personalizado provocará un cambio en el objeto personalizado con actividad.

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

Si envías nuevas propiedades de objeto que aún no han sido asignadas a un objeto, puedes actualizar tu objeto personalizado para incluirlas. Todos los registros de objetos personalizados se vuelven a procesar para incluir estos datos.

Para actualizar un objeto:

1. Haz clic en Contenido > Objetos en la barra lateral de Klaviyo.
2. Selecciona el nombre del objeto que quieres editar. 
3. Haz clic en Siguiente en la esquina superior derecha.

4. En la sección Propiedades del objeto Mapa , haz clic en Añadir mapeo.

   Esta opción sólo está disponible si tu objeto tiene propiedades adicionales que se puedan añadir.

5. En la columna propiedad fuente de datos selecciona la propiedad fuente de datos que quieras incluir en tu objeto. 
6. En la columna Propiedad mapeada , introduce el nombre que quieras que tenga la propiedad del origen de datos en el objeto. 

7. En la columna tipo de datos, selecciona el tipo de datos apropiado de tu propiedad fuente de datos.

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

   

8. Haz clic en Siguiente en la esquina superior derecha. 
9. Haz clic en Siguiente en la esquina superior derecha. No tendrás que hacer cambios en tus relaciones.
10. 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. 

Borrar un objeto 

Una vez que eliminas un objeto, no se puede recuperar ni anular. Cualquier segmento, flujo, plantilla o campaña que utilizara estos objetos personalizados dejará de funcionar como estaba previsto.

Para eliminar un objeto: 

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. Vuelve a pulsar Eliminar para confirmar la eliminación del objeto. 
4. Se eliminan el objeto y todos los registros de objetos personalizados asociados. 

Si creas 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 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 

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 interfaz de programación de aplicaciones (API) de Custom Objects