Primeros pasos con objetos personalizados

Obtén más 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 del perfil. Luego, puedes usar objetos personalizados en tus mensajes, segmentos y mucho más.

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

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

¿Pero qué pasa si necesitas más datos o varias versiones de esa propiedad? Un gran ejemplo es el de las mascotas. Puedes usar las propiedades del perfil para guardar información como nombre, edad y raza, pero solo se pueden usar una vez por perfil.

Si alguien tiene varias mascotas, puedes usar objetos personalizados. De esa 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 se muestran algunos ejemplos que demuestran 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 utilizar 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.)
• Ubicación 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 utilizar un objeto de suscripción para almacenar los datos de suscripción de los perfiles. 

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

• ID de subscripció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.

Reservar

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 Reservation, algunos ejemplos de datos que puedes incluir son:

• ID de reserva
• Fecha de la reserva
• Ubicación de la reserva
• Ocasión de la reserva
• Recuento de huéspedes 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 tienes una empresa que atiende a dueños de mascotas, puedes usar un objeto Mascotas 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 incluir son:

• ID del 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 objetos
  El número de propiedades que puede tener una cuenta por objeto.
• Límites de registros de objetos
  La cantidad de registros de objetos permitidos para una cuenta.

La cantidad de objetos disponibles y de registros de objetos se basa en el límite de perfiles del plan. Para una familia de cuentas, el límite de perfiles del plan compartido determina estas asignaciones. Los límites de registros se comparten en toda la familia, mientras que los límites de objetos se aplican a cada cuenta por separado.

Un plan de correo electrónico gratuito con un límite de 250 perfiles incluye 2,500 registros de objetos.

Por ejemplo, si tienes una familia de cuentas con 5 cuentas y un plan de correo electrónico compartido con un límite de 500 000 perfiles con actividad, el multiplicador de registros de objetos es 10. Estas cuentas pueden almacenar un máximo combinado de 5 millones de registros (500 000 × 10). Esto significa que podrías tener 1 cuenta con 3 millones de registros, siempre y cuando las 4 cuentas restantes no tengan más de 2 millones de registros de objetos combinados. Dado que el límite de perfiles compartidos 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 registro de objeto personalizado debe ser de no más de 8 KB.
• Cada valor de propiedad dentro de un registro de objeto personalizado debe tener como máximo 2 KB.

Crea un objeto

Para comenzar 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 tu propio objeto.

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

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

Para crear una nueva fuente de datos, abre el menú desplegable Fuente de datos y selecciona Crear nueva fuente de datos.

Para crear una fuente de datos, tienes que configurar la siguiente información:

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

Haz clic en Siguiente para continuar.

Establece el ID del objeto

A continuación, configura un ID de objeto y define las propiedades del objeto. Si la fuente de datos ya contiene datos enviados a través de la interfaz de programación de aplicaciones (API) de objetos personalizados, puedes previsualizarlos y seleccionar propiedades para asignar. Si la fuente de datos está vacía, puedes definir primero las propiedades y usar el payload de ejemplo proporcionado después de la creación para comenzar a enviar datos.

Configurar el ID del objeto es necesario para distinguir los registros de objetos entre sí. Para una fuente de datos que ya contiene datos, selecciona una propiedad en ID del objeto. Para una fuente de datos vacía, Klaviyo configura el campo de ID del objeto como id; incluye un valor único para ese campo en cada registro que envíes.

El ID de 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 de regalo, puedes usar algo como el código de descuento único como el ID del objeto. Esto es único para cada instancia de la fuente de datos y existirá para cada registro de objeto.

Cuando 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 adecuado.

Enviar datos de objetos

Cuando envías una actualización a través de la interfaz de programación de aplicaciones (API) de ingesta de fuente de datos, se reemplaza el registro del objeto. Envía el registro completo, incluso si solo quieres actualizar 1 propiedad.

Por ejemplo, supongamos que quieres actualizar solo 1 de 5 propiedades opcionales en un registro. Si envías el ID y solo la propiedad que quieres actualizar, las otras 4 propiedades serán nulas. Si omites una propiedad obligatoria, la actualización se rechaza. Mantén los campos identificadores del perfil en cada actualización para que Klaviyo pueda vincular el registro con el perfil previsto.

Asignar propiedades de objetos

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

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 opcional, puedes establecer un valor nulo para ella.

Para asignar propiedades de objetos:

1. Si tu fuente de datos contiene datos, selecciona la propiedad que quieres incluir en la columna Datos de origen. Si la fuente de datos está vacía, pasa al siguiente paso.
2. En la columna Propiedad mapeada, ingresa el nombre que te gustaría que tuviera la propiedad de la fuente de datos en el objeto. Para una fuente de datos vacía, ingresa el nombre en la columna Propiedad del objeto.
3. En la columna Tipo de datos, selecciona el tipo de datos correspondiente de la propiedad de la fuente de datos.
4. En la columna Obligatorio, selecciona la casilla de verificación si deseas que esta propiedad sea obligatoria en el objeto.
5. Selecciona el botón Añadir asignación si necesitas asignar propiedades de objetos adicionales.

Datos anidados en la asignación

El menú desplegable de propiedades incluye campos anidados de las muestras de datos cargadas. Si una ruta no aparece en la lista, puedes ingresarla manualmente.

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

textCopy

{
  "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 al nombre de pila del menor, selecciona o ingresa child.name.first.

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 de la matriz phone_numbers incluyendo [0] al final de la ruta.

Añadir relación

Después de configurar un ID de objeto y asignar las propiedades del objeto, haz clic en Siguiente para agregar una relación al objeto.

Las relaciones conectan tus objetos 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 de mascota, puedes establecer que el nombre de la relación sea algo como "Propietario de mascota".
• Datos de origen
  Para una fuente de datos que contiene datos, selecciona las propiedades que identifican el perfil. Este campo no se muestra para una fuente de datos vacía.
• Identificador de perfil
  Selecciona el identificador de perfil (p. ej., correo electrónico o número de teléfono) para cada propiedad de origen. Incluye estos identificadores en los datos que envías para que el objeto se pueda asociar con un perfil. Usa Vincular otro para agregar otro par, o Agregar identificador de perfil si la fuente de datos está vacía.

Confirma las asignaciones y crea un objeto

Una vez que hayas terminado de mapear las propiedades del objeto y configurar la relación, haz clic en Crear objeto en la esquina superior derecha. Revisa la advertencia y, luego, haz clic en Crear objeto en el cuadro de diálogo de confirmación. Los mapeos existentes no se pueden editar una vez creado el objeto, y Klaviyo comienza a procesar cualquier dato que ya esté en la fuente de datos.

En la página de confirmación, haz clic en Copiar JSON para copiar una carga útil de ejemplo para tu objeto. Úsala como referencia cuando envíes tus datos a través de la interfaz de programación de aplicaciones (API) de objetos personalizados.

Haz clic en Salir para volver a la página Objetos. Verás el objeto en la lista con la siguiente información:

• Nombre del objeto
• Propietario
• Estado

Estados de objetos personalizados

Hay 3 estados principales de estado al publicar objetos personalizados:

• Borrador
  El objeto aún se puede editar y no está publicado ni activo.
• Publicación
  El objeto está creando registros de objetos personalizados a partir de los datos que enviaste a tu fuente de datos. Unos cuantos miles de registros se pueden publicar rápidamente. Unos cuantos millones de registros pueden tardar horas. Una vez que se completa, el estado cambia a Publicado.
• Publicado
  El objeto está publicado y activo. Klaviyo terminó de procesar los datos enviados desde tu fuente de datos. Los datos nuevos crean registros o actualizan registros con IDs de objeto coincidentes, y los identificadores de perfil determinan a qué perfiles se vinculan.

Objetos en las 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, navega hasta 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.

Explora todos los registros dentro de un objeto

Para explorar cada registro dentro de un objeto, no solo los registros asociados con un solo perfil, usa el explorador de registros. Haz clic en Contenido > Objetos y luego haz clic en el nombre de un objeto para abrir el explorador de registros y ver sus registros.

Actualizar un objeto

Si quieres empezar a enviar nuevos datos para un objeto, agrega las propiedades adicionales del objeto a la fuente de datos y luego edita el mapeo del objeto para incluirlas. Cuando se reprocesan los registros, se completa una propiedad recién mapeada si su valor ya estaba presente en los datos de origen. De lo contrario, es null hasta que envíes una actualización que la incluya.

Si envías nuevas propiedades de objeto que todavía no se han asignado a un objeto, puedes actualizar el objeto personalizado para incluirlas. Luego, 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. Abre el menú a la derecha del objeto que quieres editar y haz clic en Editar.
3. Haz clic en Siguiente en la esquina superior derecha.
4. En Asignar propiedades del objeto, haz clic en Agregar asignación. Si el origen de datos está vacío, esta sección se etiqueta como Propiedades del objeto.

1. En la columna Datos de origen, selecciona la propiedad de la fuente de datos que quieres incluir en el objeto. Si la fuente de datos está vacía, pasa al siguiente paso.
2. En la columna Propiedad mapeada, ingresa el nombre que te gustaría que tuviera la propiedad de la fuente de datos en el objeto. Para una fuente de datos vacía, usa la columna Propiedad del objeto.
3. En la columna Tipo de datos, selecciona el tipo de datos apropiado de la propiedad de la fuente de datos.

1. Haz clic en Siguiente en la esquina superior derecha.
2. Revisa las relaciones y luego haz clic en Publicar cambios en la esquina superior derecha. No necesitas cambiar las relaciones para agregar una propiedad.
3. Haz clic en Publicar cambios en el cuadro de diálogo de confirmación.

Haz clic en Salir para volver a Objetos. Después de publicar los cambios de asignación, los registros del origen de datos se vuelven a procesar y los registros existentes de objetos personalizados se actualizan según corresponda.

Eliminar un objeto

Para eliminar un objeto:

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

3. Para un objeto publicado, escribe DELETE en el cuadro de diálogo de confirmación y luego haz clic en Eliminar. Para un objeto en borrador, haz clic en Eliminar para confirmar.

Se eliminaron 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 sincronizaste. 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