Conceptos básicos de composición de esquemas
Creado para:
- Desarrollador
Obtenga información acerca de los esquemas XDM (Experience Data Model) y los componentes básicos, los principios y las prácticas recomendadas para componer esquemas en Adobe Experience Platform. Para obtener información general sobre XDM y cómo se usa en Experience Platform, consulte la descripción general del sistema XDM.
Explicación de los esquemas
Un esquema es un conjunto de reglas que representan y validan la estructura y el formato de los datos. En un nivel superior, los esquemas proporcionan una definición abstracta de un objeto del mundo real (como una persona) y describen qué datos deben incluirse en cada instancia de ese objeto (como nombre, apellido, cumpleaños, etc.).
Además de describir la estructura de los datos, los esquemas aplican restricciones y expectativas a los datos para que se puedan validar a medida que se mueven entre sistemas. Estas definiciones estándar permiten que los datos se interpreten de forma coherente, independientemente del origen, y eliminan la necesidad de traducción entre aplicaciones.
Experience Platform mantiene esta normalización semántica mediante el uso de esquemas. Los esquemas son la forma estándar de describir los datos en Experience Platform, lo que permite reutilizar en una organización todos los datos que se ajustan a esquemas, o incluso compartirlos entre varias organizaciones.
Los esquemas XDM son ideales para almacenar grandes cantidades de datos complejos en un formato independiente. Consulte las secciones sobre objetos incrustados y big data en el apéndice de este documento para obtener más información sobre cómo XDM lo logra.
Flujos de trabajo basados en esquemas en Experience Platform
La estandarización es un concepto clave detrás de Experience Platform. XDM, impulsado por Adobe, es un esfuerzo para estandarizar los datos de experiencia del cliente y definir esquemas estándar para la administración de experiencias del cliente.
La infraestructura en la que se ha creado Experience Platform, conocida como XDM System, facilita los flujos de trabajo basados en esquemas e incluye Schema Registry, Schema Editor, metadatos de esquema y patrones de consumo de servicio. Consulte la descripción general del sistema XDM para obtener más información.
El uso de esquemas en Experience Platform ofrece varias ventajas clave. En primer lugar, los esquemas permiten una mejor gobernanza y minimización de los datos, lo que es especialmente importante con las normas de privacidad. En segundo lugar, la creación de esquemas con los componentes estándar de Adobe permite obtener perspectivas y utilizar servicios AI/ML de forma predeterminada con personalizaciones mínimas. Por último, los esquemas proporcionan una infraestructura para compartir perspectivas de datos y una orquestación eficiente.
Planificación del esquema
El primer paso para crear un esquema es determinar el concepto, u objeto del mundo real, que está intentando capturar dentro del esquema. Una vez que identifique el concepto que intenta describir, empiece a planificar el esquema pensando en cosas como el tipo de datos, los campos de identidad potenciales y cómo puede evolucionar el esquema en el futuro.
Comportamientos de datos en Experience Platform
Los datos que se van a utilizar en Experience Platform se agrupan en dos tipos de comportamiento:
- Registrar datos: proporciona información sobre los atributos de un asunto. Un sujeto podría ser una organización o un individuo.
- Datos de series temporales: proporciona una instantánea del sistema en el momento en que un sujeto de registro realizó una acción directa o indirecta.
Todos los esquemas XDM describen datos que pueden clasificarse como registros o series temporales. El comportamiento de datos de un esquema se define mediante la clase del esquema, que se asigna a un esquema cuando se crea por primera vez. Las clases XDM se describen de forma más detallada más adelante en este documento.
Los esquemas de registros y series temporales contienen un mapa de identidades (xdm:identityMap). Este campo contiene la representación de identidad de un asunto, extraída de los campos marcados como "Identidad" tal como se describe en la siguiente sección.
Identidad
Los esquemas se utilizan para la ingesta de datos en Experience Platform. Estos datos se pueden utilizar en varios servicios para crear una única vista unificada de una entidad individual. Por lo tanto, al diseñar esquemas para identidades de clientes, es importante tener en cuenta qué campos se pueden utilizar para identificar a un sujeto, independientemente de dónde provengan los datos.
Para ayudar con este proceso, los campos clave dentro de los esquemas se pueden marcar como identidades. Tras la ingesta de datos, los datos de esos campos se insertan en el "Gráfico de identidad" para ese individuo. A continuación, Real-Time Customer Profile y otros servicios de Experience Platform pueden acceder a los datos de gráficos para proporcionar una vista unida de cada cliente individual.
Los campos que normalmente se marcan como "Identidad" incluyen: dirección de correo electrónico, número de teléfono, Experience Cloud ID (ECID), ID de CRM u otros campos de ID únicos. Tenga en cuenta cualquier identificador único específico de su organización, ya que también pueden ser buenos campos "Identidad".
Es importante tener en cuenta las identidades de los clientes durante la fase de planificación del esquema para garantizar que los datos se reúnan y se cree el perfil más sólido posible. Para obtener más información sobre cómo la información de identidad puede ayudarle a ofrecer experiencias digitales a sus clientes, consulte la descripción general del servicio de identidad. Consulte el documento de prácticas recomendadas de modelado de datos para obtener sugerencias sobre el uso de identidades al crear un esquema.
Existen dos formas de enviar datos de identidad a Experience Platform:
- Agregar descriptores de identidad a campos individuales, ya sea mediante la interfaz de usuario del Editor de esquemas o mediante la API del Registro de esquemas
- Usando un campo
identityMap
identityMap
identityMap es un campo de tipo mapa que describe los distintos valores de identidad de un individuo, junto con sus áreas de nombres asociadas. Este campo se puede utilizar para proporcionar información de identidad para los esquemas, en lugar de definir valores de identidad dentro de la estructura del propio esquema.
El principal inconveniente de usar identityMap es que las identidades se incrustan en los datos y, como resultado, se vuelven menos visibles. Si está introduciendo datos sin procesar, debe definir campos de identidad individuales dentro de la estructura de esquema real.
NOTEidentityMap se puede usar como esquema de origen en una relación, pero no se puede usar como esquema de referencia. Esto se debe a que todos los esquemas de referencia deben tener una identidad visible que se pueda asignar en un campo de referencia dentro del esquema de origen. Consulte la guía de la interfaz de usuario sobre relaciones para obtener más información sobre los requisitos de los esquemas de origen y referencia.Sin embargo, los mapas de identidad pueden resultar útiles si hay un número variable de identidades para un esquema o si está reuniendo datos de orígenes que almacenan identidades (como Airship o Adobe Audience Manager). Además, se requieren los mapas de identidad si usa Adobe Experience Platform Mobile SDK.
Un ejemplo de mapa de identidad simple tendría el siguiente aspecto:
"identityMap": {
"email": [
{
"id": "jsmith@example.com",
"primary": true
}
],
"ECID": [
{
"id": "87098882279810196101440938110216748923",
"primary": false
},
{
"id": "55019962992006103186215643814973128178",
"primary": false
}
],
"CRMID": [
{
"id": "2e33192000007456-0365c00000000000",
"primary": false
}
]
}
Como se muestra en el ejemplo anterior, cada clave del objeto identityMap representa un área de nombres de identidad. El valor de cada clave es una matriz de objetos que representa los valores de identidad (id) del área de nombres correspondiente. Consulte la documentación de Identity Service para obtener una lista de áreas de nombres de identidad estándar reconocidas por las aplicaciones de Adobe.
NOTEprimary) para cada valor de identidad. Solo necesita establecer identidades principales para los esquemas que se van a usar en Real-Time Customer Profile. Consulte la sección sobre esquemas de unión para obtener más información.Principios de evolución del esquema
A medida que la naturaleza de las experiencias digitales sigue evolucionando, también lo deben hacer los esquemas utilizados para representarlas. Por lo tanto, un esquema bien diseñado es capaz de adaptarse y evolucionar según sea necesario, sin provocar cambios destructivos en versiones anteriores del esquema.
Dado que el mantenimiento de la compatibilidad con versiones anteriores es crucial para la evolución del esquema, Experience Platform aplica un principio de versiones puramente aditivo. Este principio garantiza que todas las revisiones del esquema solo resulten en actualizaciones y cambios no destructivos. En otras palabras, no se admiten cambios importantes.
NOTELa siguiente tabla desglosa qué cambios se admiten al editar esquemas, grupos de campos y tipos de datos:
- Adición de nuevos campos al recurso
- Conversión de un campo obligatorio en opcional
- Introducción de nuevos campos obligatorios*
- Modificación del nombre para mostrar y la descripción del recurso
- Habilitar el esquema para que participe en el perfil
- Eliminación de campos definidos anteriormente
- Cambiar el nombre o redefinir campos existentes
- Eliminación o restricción de los valores de campo admitidos anteriormente
- Mover los campos existentes a una ubicación diferente en el árbol
- Eliminación del esquema
- Desactivación de la participación del esquema en el perfil
*Consulte la sección siguiente para obtener consideraciones importantes sobre la configuración de nuevos campos obligatorios.
Campos requeridos
Los campos de esquema individuales pueden marcarse como obligatorios, lo que significa que cualquier registro ingerido debe contener datos en esos campos para pasar la validación. Por ejemplo, configurar el campo de identidad principal de un esquema como obligatorio puede ayudar a garantizar que todos los registros introducidos participen en el Perfil del cliente en tiempo real. Del mismo modo, configurar un campo de marca de tiempo como obligatorio garantiza que todos los eventos de series de tiempo se conserven cronológicamente.
IMPORTANTnull o valores vacíos para ningún campo ingerido. Si no hay ningún valor para un campo en particular en un registro o evento, la clave de ese campo debe excluirse de la carga útil de ingesta.Configuración de campos según sea necesario después de la ingesta
Si un campo se ha utilizado para introducir datos y no se estableció originalmente como obligatorio, ese campo puede tener un valor nulo para algunos registros. Si establece este campo como necesario después de la ingesta, todos los registros futuros deben contener un valor para este campo aunque los registros históricos puedan ser nulos.
Cuando configure un campo opcional anterior como obligatorio, tenga en cuenta lo siguiente:
- Si consulta datos históricos y escribe los resultados en un nuevo conjunto de datos, algunas filas producirán un error porque contienen valores nulos para el campo requerido.
- Si el campo participa en Perfil del cliente en tiempo real y exporta datos antes de establecerlos como necesarios, puede ser nulo para algunos perfiles.
- Puede utilizar la API de Registro de esquemas para ver un registro de cambios con marca de tiempo para todos los recursos XDM en Experience Platform, incluidos los nuevos campos obligatorios. Consulte la guía del extremo del registro de auditoría para obtener más información.
Esquemas e ingesta de datos
Para introducir datos en Experience Platform, primero se debe crear un conjunto de datos. Los conjuntos de datos son los componentes básicos para la transformación y el seguimiento de datos de Catalog Service y, por lo general, representan tablas o archivos que contienen datos ingeridos. Todos los conjuntos de datos se basan en esquemas XDM existentes, que proporcionan restricciones sobre qué deben contener los datos ingeridos y cómo deben estructurarse. Consulte la descripción general de Ingesta de datos de Adobe Experience Platform para obtener más información.
Bloques de creación de un esquema
Experience Platform utiliza un enfoque de composición en el que los bloques de creación estándar se combinan para crear esquemas. Este método promueve la reutilización de los componentes existentes e impulsa la estandarización en todo el sector para admitir esquemas y componentes de proveedores en Experience Platform.
Los esquemas se componen mediante la fórmula siguiente:
Clase + Grupo de campos de esquema* = Esquema XDM
*Un esquema está compuesto por una clase y cero o más grupos de campos de esquema. Esto significa que puede componer un esquema de conjunto de datos sin utilizar grupos de campos.
Clase
La composición de un esquema comienza asignando una clase. Las clases definen los aspectos de comportamiento de los datos que contendrá el esquema (registro o serie temporal). Además, las clases describen el menor número de propiedades comunes que todos los esquemas basados en esa clase necesitarían incluir y proporcionan una forma de combinar varios conjuntos de datos compatibles.
La clase de un esquema determina qué grupos de campos pueden utilizarse en ese esquema. Esto se discute con más detalle en la siguiente sección.
Adobe proporciona varias clases XDM estándar ("principales"). Se requieren dos de estas clases, XDM Individual Profile y XDM ExperienceEvent, para casi todos los procesos de Experience Platform posteriores. Además de estas clases principales, también puede crear sus propias clases personalizadas para describir casos de uso más específicos para su organización. Una organización define las clases personalizadas cuando no hay clases principales definidas por Adobe disponibles para describir un caso de uso único.
La siguiente captura de pantalla muestra cómo se representan las clases en la interfaz de usuario de Experience Platform. Dado que el esquema de ejemplo mostrado no contiene ningún grupo de campos, todos los campos mostrados los proporciona la clase del esquema (XDM Individual Profile).
Para obtener la lista más actualizada de clases XDM estándar disponibles, consulte el repositorio XDM oficial. También puede consultar la guía Exploración de componentes XDM si prefiere ver los recursos en la interfaz de usuario.
Grupo de campo
Un grupo de campos es un componente reutilizable que define uno o varios campos que implementan determinadas funciones, como detalles personales, preferencias de hotel o dirección. Los grupos de campos están pensados para incluirse como parte de un esquema que implementa una clase compatible.
Los grupos de campos definen con qué clase o clases son compatibles, según el comportamiento de los datos que representan (registro o serie temporal). Esto significa que no todos los grupos de campos están disponibles para su uso con todas las clases.
Experience Platform incluye muchos grupos de campos de Adobe estándar, pero también permite a los proveedores definir grupos de campos para sus usuarios y a los usuarios individuales definir grupos de campos para sus propios conceptos específicos.
Por ejemplo, para capturar detalles como "Nombre" y "Dirección particular" para su esquema "Miembros fieles", podría usar grupos de campos estándar que definan esos conceptos comunes. Sin embargo, los conceptos más específicos de su organización (como los detalles del programa de fidelidad personalizado o los atributos de producto) que pueden no estar cubiertos por los grupos de campos estándar. En este caso, debe definir su propio grupo de campos para capturar esta información.
NOTERecuerde que los esquemas están compuestos por grupos de campos "cero o más", lo que significa que puede crear un esquema válido sin utilizar ningún grupo de campos.
La siguiente captura de pantalla muestra cómo se representan los grupos de campos en la interfaz de usuario de Experience Platform. En este ejemplo, se agrega un solo grupo de campos (Detalles demográficos) a un esquema, que proporciona una agrupación de campos a la estructura del esquema.
Para obtener la lista más actualizada de grupos de campos XDM estándar disponibles, consulte el repositorio XDM oficial. También puede consultar la guía Exploración de componentes XDM si prefiere ver los recursos en la interfaz de usuario.
NOTETipo de datos
Los tipos de datos se utilizan como tipos de campo de referencia en clases o esquemas de la misma manera que los campos literales básicos. La diferencia clave es que los tipos de datos pueden definir varios subcampos de la misma manera que los grupos de campos. La diferencia clave entre ellos es que los tipos de datos se pueden incluir en cualquier lugar de un esquema agregándolo como el "tipo de datos" de un campo. Aunque los grupos de campos solo son compatibles con determinadas clases, los tipos de datos se pueden incluir en cualquier clase principal o grupo de campos.
NOTEExperience Platform proporciona una serie de tipos de datos comunes como parte de Schema Registry para admitir el uso de patrones estándar para describir estructuras de datos comunes. Esto se explica con más detalle en los tutoriales del Registro de esquemas y se aclarará a medida que avance en los pasos para definir los tipos de datos.
La siguiente captura de pantalla muestra cómo se representan los tipos de datos en la interfaz de usuario de Experience Platform. Uno de los campos proporcionados por el grupo de campos Detalles demográficos usa el tipo de datos "Objeto", tal como indica el texto que sigue al carácter de barra vertical (|) junto al nombre del campo. Este tipo de datos en particular proporciona varios subcampos relacionados con el nombre de una persona individual, una construcción que se puede reutilizar para otros campos en los que sea necesario capturar el nombre de una persona.
Para obtener la lista más actualizada de tipos de datos XDM estándar disponibles, consulte el repositorio XDM oficial. También puede consultar la guía Exploración de componentes XDM si prefiere ver los recursos en la interfaz de usuario.
NOTECampo
Un campo es el bloque de creación más básico de un esquema. Los campos proporcionan restricciones con respecto al tipo de datos que pueden contener al definir un tipo de datos específico. Estos tipos de datos básicos definen un único campo, mientras que los tipos de datos mencionados anteriormente le permiten definir varios subcampos y reutilizar la misma estructura de varios campos en varios esquemas. Por tanto, además de definir el "tipo de datos" de un campo como uno de los tipos de datos definidos en el Registro, Experience Platform admite tipos escalares básicos como:
- Cadena
- Entero
- Duplicada
- Booleano
- Matriz
- Objeto
TIPLos intervalos válidos de estos tipos escalares se pueden restringir aún más a ciertos patrones, formatos, mínimos/máximos o valores predefinidos. Con estas restricciones, se puede representar una amplia gama de tipos de campo más específicos, incluidos los siguientes:
- Enumeración
- Largo
- Corto
- Byte
- Fecha
- Fecha-hora
- Mapa
NOTEEjemplo de composición
Los esquemas se crean mediante un modelo de composición y representan el formato y la estructura de los datos que se van a introducir en Experience Platform. Como se ha mencionado anteriormente, estos esquemas están compuestos por una clase y cero o más grupos de campos compatibles con esa clase.
Por ejemplo, un esquema que describa las compras realizadas en una tienda minorista podría llamarse "Transacciones de tienda". El esquema implementa la clase XDM ExperienceEvent combinada con el grupo de campos estándar Commerce y un grupo de campos Información del producto definido por el usuario.
Otro esquema que rastrea el tráfico del sitio web podría llamarse "Visitas web". También implementa la clase XDM ExperienceEvent, pero esta vez combina el grupo de campos estándar Web.
El diagrama siguiente muestra estos esquemas y los campos aportados por cada grupo de campos. También contiene dos esquemas basados en la clase XDM Individual Profile, incluido el esquema "Miembros socio" mencionado anteriormente en esta guía.
Unión
Aunque Experience Platform le permite componer esquemas para casos de uso específicos, también le permite ver una "unión" de esquemas para un tipo de clase específico. El diagrama anterior muestra dos esquemas basados en la clase XDM ExperienceEvent y dos esquemas basados en la clase XDM Individual Profile. La unión que se muestra a continuación agrega los campos de todos los esquemas que comparten la misma clase (XDM ExperienceEvent y XDM Individual Profile, respectivamente).
Al habilitar un esquema para utilizarlo con Real-Time Customer Profile, se incluye en la unión para ese tipo de clase. Profile ofrece perfiles sólidos y centralizados de atributos del cliente, así como una cuenta con marca de tiempo de cada evento que el cliente haya tenido en cualquier sistema integrado con Experience Platform. Profile utiliza la vista de unión para representar estos datos y proporcionar una vista integral de cada cliente individual.
Para obtener más información sobre cómo trabajar con Profile, consulte la descripción general del perfil del cliente en tiempo real.
Asignación de archivos de datos a esquemas XDM
Todos los archivos de datos que se incorporan a Experience Platform deben ajustarse a la estructura de un esquema XDM. Para obtener más información sobre cómo dar formato a los archivos de datos para que cumplan con las jerarquías XDM (incluidos los archivos de muestra), consulte el documento sobre transformaciones de ETL de muestra. Para obtener información general acerca de la ingesta de archivos de datos en Experience Platform, consulte la descripción general de la ingesta por lotes.
Esquemas para audiencias externas
Si va a llevar audiencias de sistemas externos a Experience Platform, debe utilizar los siguientes componentes para capturarlas en los esquemas:
- Definición de segmento clase: utilice esta clase estándar para capturar atributos clave de una definición de segmento externa.
- Detalles de pertenencia a segmento grupo de campos: agregue este grupo de campos al esquema XDM Individual Profile para asociar perfiles de clientes con audiencias específicas.
Pasos siguientes
Ahora que comprende los conceptos básicos de la composición de esquemas, está listo para empezar a explorar y crear esquemas con Schema Registry.
Para revisar la estructura de las dos clases XDM principales y sus grupos de campos compatibles comúnmente utilizados, consulte la siguiente documentación de referencia:
Schema Registry se usa para obtener acceso a Schema Library en Adobe Experience Platform y proporciona una interfaz de usuario y una API RESTful desde las cuales se puede obtener acceso a todos los recursos de biblioteca disponibles. Schema Library contiene recursos del sector definidos por Adobe, recursos del proveedor definidos por socios de Experience Platform y clases, grupos de campos, tipos de datos y esquemas compuestos por miembros de su organización.
Para comenzar a componer el esquema mediante la interfaz de usuario, siga el tutorial del editor de esquemas para crear el esquema "Miembros socio" mencionado en este documento.
Para empezar a usar la API Schema Registry, comience por leer la Guía para desarrolladores de API de Registro de esquemas. Después de leer la guía para desarrolladores, siga los pasos descritos en el tutorial sobre creación de un esquema con la API de Registro de esquemas.
Apéndice
Las secciones siguientes contienen información adicional sobre los principios de la composición de esquemas.
Tablas relacionales y objetos incrustados
Al trabajar con bases de datos relacionales, las prácticas recomendadas implican normalizar los datos o tomar una entidad y dividirla en partes discretas que luego se muestran en varias tablas. Para leer los datos en conjunto o actualizar la entidad, se deben realizar operaciones de lectura y escritura en muchas tablas individuales utilizando JOIN.
Mediante el uso de objetos incrustados, los esquemas XDM pueden representar directamente datos complejos y almacenarlos en documentos independientes con una estructura jerárquica. Una de las principales ventajas de esta estructura es que le permite consultar los datos sin tener que reconstruir la entidad mediante costosas uniones a varias tablas desnormalizadas. No hay restricciones estrictas en cuanto a la cantidad de niveles que puede tener la jerarquía de esquema.
Esquemas y big data
Los sistemas digitales modernos generan grandes cantidades de señales de comportamiento (datos de transacción, registros web, Internet de las cosas, visualización, etc.). Estos big data ofrecen oportunidades extraordinarias para optimizar experiencias, pero su uso es complicado debido a la escala y variedad de los datos. Para obtener valor de los datos, su estructura, formato y definiciones deben estar estandarizados para que puedan procesarse de forma coherente y eficaz.
Los esquemas resuelven este problema al permitir que los datos se integren desde varias fuentes, se estandaricen a través de estructuras y definiciones comunes y se compartan entre soluciones. Esto permite que los procesos y servicios subsiguientes respondan a cualquier tipo de pregunta que se haga sobre los datos. Se aleja del enfoque tradicional del modelado de datos, donde todas las preguntas que se le hacen a los datos se conocen de antemano y los datos se modelan para ajustarse a esas expectativas.
Objetos en comparación con campos de forma libre
Hay algunos factores clave a tener en cuenta al elegir objetos en lugar de campos de forma libre al diseñar los esquemas:
Objetos
A continuación se enumeran los pros y los contras de utilizar objetos sobre campos de forma libre.
Profesionales:
- Los objetos se utilizan mejor cuando desea crear una agrupación lógica de ciertos campos.
- Los objetos organizan el esquema de forma más estructurada.
- Los objetos ayudan indirectamente a crear una buena estructura de menú en la interfaz de usuario del Generador de segmentos. Los campos agrupados dentro del esquema se reflejan directamente en la estructura de carpetas proporcionada en la interfaz de usuario del Generador de segmentos.
Inconvenientes:
- Los campos se anidan más.
- Cuando se usa Adobe Experience Platform Query Service, se deben proporcionar cadenas de referencia más largas a los campos de consulta anidados en los objetos.
Campos de forma libre
A continuación se enumeran los pros y los contras de utilizar campos de forma libre sobre objetos.
Profesionales:
- Los campos de forma libre se crean directamente bajo el objeto raíz del esquema (
_tenantId), lo que aumenta la visibilidad. - Las cadenas de referencia para campos de forma libre tienden a ser más cortas al utilizar el servicio de consulta.
Inconvenientes:
- La ubicación de los campos de forma libre dentro del esquema es ad hoc, lo que significa que aparecen en orden alfabético dentro del Editor de esquemas. Esto puede hacer que los esquemas estén menos estructurados y campos de forma libre similares pueden terminar estando muy separados según sus nombres.