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 empezarAntes de empezar
Debe tener acceso a los objetos personalizados para utilizar esta funcionalidad.
¿Qué son los objetos personalizados?¿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ácticosEjemplos 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 previaCita 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ónSuscripció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.
ReservaReserva
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.
MascotaMascota
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 cuentaLímites de la cuenta
Los límites de objetos de su cuenta dependen de los límites de perfil de su cuenta y de si dispone de una plataforma de datos Klaviyo avanzada plan. Como mínimo, el acceso a estas funciones requiere un correo electrónico de pago plan o una prueba avanzada de la Plataforma de Datos Klaviyo, que puede solicitar a través de su CSM. Si opera dentro de una familia de cuentas, sus límites reflejarán los de una Plataforma de Datos Avanzada Klaviyo plan. Para más información sobre la facturación, consulte 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 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.
Si se encuentra en una plataforma de datos Klaviyo avanzada plan, el multiplicador de registros de objetos se basará en el número total de perfiles de su cuenta. Si sólo tiene un correo electrónico plan, este multiplicador se basará en el límite de perfil activo de su cuenta.
Perfiles | Plataforma avanzada de datos Klaviyo plan | Número de objetos | Número de propiedades del objeto | Multiplicador de registros de objetos |
Gratis plan | ninguno | 0 | 0 | N/A |
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 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 objetoEnviar 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 mapaPropiedades 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.
Sólo los datos mostrados en la instancia particular de la fuente de datos que se está previsualizando están disponibles en el desplegable. Puede recorrer las instancias de la fuente de datos utilizando el botón Nueva muestra de datos .
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:
- En la columna de propiedades de origen de datos seleccione la propiedad de origen de datos que desea incluir en su objeto.
- En la columna Propiedad mapeada , introduzca el nombre que desea que tenga la propiedad del origen de datos en el objeto.
- En la columna tipo de datos, seleccione el tipo de datos apropiado de su propiedad fuente de datos.
- En la columna Obligatorio, seleccione la casilla si desea que esta propiedad sea obligatoria en el objeto.
- Seleccione el botón Añadir asignación si necesita asignar propiedades de objeto adicionales.
Si una propiedad de objeto se establece como Requerido, 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 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"
]
}
}
}
]
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
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 objetoactualizar un objeto
Cualquier cambio que realice en un objeto personalizado provocará un cambio en el objeto personalizado activo.
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:
- Haga clic en Contenido > Objetos en la barra lateral de Klaviyo.
- Seleccione el nombre del objeto que desea editar.
- Haga clic en Siguiente en la esquina superior derecha.
-
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.
- En la columna de propiedades de origen de datos seleccione la propiedad de origen de datos que desea incluir en su objeto.
- En la columna Propiedad mapeada , introduzca el nombre que desea que tenga la propiedad del origen de datos en el objeto.
-
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.
- Haga clic en Siguiente en la esquina superior derecha.
- Haga clic en Siguiente en la esquina superior derecha. No tendrá que hacer cambios en sus relaciones.
- 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 objetoBorrar un objeto
Una vez borrado un objeto, no podrá recuperarse ni anularse. Cualquier segmento, flujo, plantilla o campaña que utilizara estos objetos personalizados dejará de funcionar como estaba previsto.
Para eliminar un objeto:
- Haga clic en Contenido > Objetos en la barra lateral de Klaviyo.
- En el menú situado a la derecha de su objeto, haga clic en Eliminar.
- Pulse Borrar de nuevo para confirmar la eliminación del objeto.
- 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 adicionalesRecursos adicionales
Cómo utilizar objetos personalizados en plantilla
Cómo utilizar objetos personalizados en segmento