primeros pasos con objetos personalizados

Objetivos de aprendizaje

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

Antes de empezar

Debes 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 permiten mapear diversos conceptos de datos multirrelacionales en Klaviyo que no pueden ser tienda, comercio utilizando propiedades del perfil. Por ejemplo, digamos que quieres tienda, comercio datos sobre mascotas de clientes en Klaviyo. Cada mascota tiene una serie de atributos sobre ella (por ejemplo, nombre, edad, raza. etc.) lo que dificulta la tienda, comercio esta información con propiedades del 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 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 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 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.

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)
  Descripción de los datos que representa tu objeto
• fuente de datos
  La fuente de datos de la que obtener los datos del objeto. Al menos 1 registro debe enviarse a Klaviyo utilizando el objeto personalizado interfaz de programación de aplicaciones (API) para que aparezca como opción en el 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 sustituye todo el objeto. Por tanto, es fundamental enviar el objeto completo cada vez, aunque sólo quieras actualizar 1 registro. 

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

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.

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. 

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. 

{
  "tipo": "data-source-record",
  "atributos": {
    "registro": {
      "child": {
        "child_id": "d64b8458",
        "nombre": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "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, 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, puedes establecer que el nombre de la relación sea algo así como "Propietario de mascota". 
• Fuente de datos
  Selecciona las propiedades de la fuente de datos que quieras asociar a un perfil. 
• identificador de perfil
  Establece 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. Utiliza el botón Vincular otra propiedad para añadir pares adicionales de propiedad e identificador.

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 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 sus perfiles.

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

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