Esta guía proporciona información general sobre cómo crear, editar y administrar esquemas del Modelo de datos de experiencia (XDM) para su organización en la interfaz de usuario de Adobe Experience Platform.
Los esquemas XDM son extremadamente personalizables y, por lo tanto, los pasos involucrados en la creación de un esquema pueden variar según el tipo de datos que desee capturar. Como resultado, este documento solo cubre las interacciones básicas que puede realizar con los esquemas en la interfaz de usuario y excluye los pasos relacionados como la personalización de clases, grupos de campos de esquema, tipos de datos y campos.
Para obtener un recorrido completo por el proceso de creación de esquemas, siga junto con la tutorial de creación de esquemas para crear un esquema de ejemplo completo y familiarizarse con las muchas capacidades de la variable Schema Editor.
Esta guía requiere una comprensión práctica del sistema XDM. Consulte la Información general de XDM para una introducción al papel de XDM dentro del ecosistema del Experience Platform, y conceptos básicos de la composición del esquema para obtener una descripción general de cómo se construyen los esquemas.
En esta sección se explica cómo crear manualmente un nuevo esquema en la interfaz de usuario. Si está introduciendo datos CSV en Platform, puede optar por asignar esos datos a un esquema XDM creado por recomendaciones generadas por AI (actualmente en versión beta) sin tener que crear manualmente el esquema.
En el Esquemas espacio de trabajo, seleccione Crear esquema en la esquina superior derecha. En el menú desplegable que aparece, puede elegir entre Perfil individual XDM y XDM ExperienceEvent como clase base para el esquema. También puede seleccionar Examinar para seleccionar entre la lista completa de clases disponibles, o crear una nueva clase personalizada en su lugar.
Una vez seleccionada una clase, la variable Schema Editor y la estructura base del esquema (proporcionada por la clase ) se muestra en el lienzo. Desde aquí, puede utilizar el carril derecho para agregar un Nombre para mostrar y Descripción para el esquema .
Ahora puede empezar a crear la estructura del esquema mediante adición de grupos de campos de esquema.
Una vez guardado y utilizado un esquema en la ingesta de datos, solo se pueden realizar cambios aditivos en él. Consulte la reglas de evolución de esquema para obtener más información.
Para editar un esquema existente, seleccione la opción Examinar y, a continuación, seleccione el nombre del esquema que desea editar.
Puede utilizar las capacidades de búsqueda y filtrado del espacio de trabajo para ayudar a encontrar el esquema más fácil. Consulte la guía de exploración de recursos XDM para obtener más información.
Una vez que seleccione un esquema, la variable Schema Editor aparece con la estructura del esquema en el lienzo. Ahora puede agregar grupos de campos al esquema (o añadir campos individuales de esos grupos), editar nombres para mostrar de camposo editar grupos de campos personalizados existentes si el esquema emplea alguno.
Esta sección explica cómo agregar grupos de campos existentes a un esquema. Si desea crear un nuevo grupo de campos personalizados, consulte la guía de creación y edición de grupos de campos en su lugar.
Una vez que haya abierto un esquema dentro de la variable Schema Editor, puede añadir campos al esquema mediante el uso de grupos de campos. Para empezar, seleccione Agregar junto a Grupos de campo en el carril izquierdo.
Aparece un cuadro de diálogo que muestra una lista de los grupos de campos que puede seleccionar para el esquema. Dado que los grupos de campos solo son compatibles con una clase, solo se enumerarán los grupos de campos asociados con la clase seleccionada del esquema. De forma predeterminada, los grupos de campos enumerados se ordenan según su popularidad de uso dentro de su organización.
Si conoce la actividad general o el área comercial de los campos que desea añadir, seleccione una o varias categorías del sector en el carril izquierdo para filtrar la lista mostrada de grupos de campos.
Para obtener más información sobre las prácticas recomendadas para el modelado de datos específico del sector en XDM, consulte la documentación sobre modelos de datos del sector.
También puede utilizar la barra de búsqueda para localizar el grupo de campos deseado. Los grupos de campos cuyo nombre coincida con la consulta aparecen en la parte superior de la lista. En Campos estándar, se muestran los grupos de campos que contienen campos que describen atributos de datos deseados.
Active la casilla situada junto al nombre del grupo de campos que desea agregar al esquema. Puede seleccionar varios grupos de campos en la lista, y cada grupo de campos seleccionado aparecerá en el carril derecho.
Para cualquier grupo de campos enumerado, puede mantener el puntero sobre él o centrarse en el icono de información () para ver una breve descripción del tipo de datos que captura el grupo de campos. También puede seleccionar el icono de vista previa (
) para ver la estructura de los campos que proporciona el grupo de campos antes de decidir agregarla al esquema.
Una vez que haya elegido los grupos de campos, seleccione Agregar grupos de campos para agregarlas al esquema.
La variable Schema Editor vuelve a aparecer con los campos proporcionados por el grupo de campos representados en el lienzo.
Después de agregar un grupo de campos a un esquema, se puede quitar campos existentes o agregar nuevos campos personalizados a esos grupos, según sus necesidades.
Después de agregar un grupo de campos a un esquema, puede quitar los campos que no necesite.
La eliminación de campos de un grupo de campos solo afecta al esquema en el que se está trabajando y no afecta al propio grupo de campos. Si elimina los campos de un esquema, dichos campos seguirán estando disponibles en todos los demás esquemas que empleen el mismo grupo de campos.
En el ejemplo siguiente, el grupo de campos estándar Detalles demográficos se ha agregado a un esquema. Quitar un único campo como taxId
, seleccione el campo en el lienzo y, a continuación, seleccione Eliminar en el carril derecho.
Si desea quitar varios campos, puede administrar el grupo de campos como un todo. Seleccione un campo que pertenezca al grupo en el lienzo y, a continuación, seleccione Administrar campos relacionados en el carril derecho.
Aparece un cuadro de diálogo que muestra la estructura del grupo de campos en cuestión. Desde aquí puede utilizar las casillas de verificación proporcionadas para seleccionar o anular la selección de los campos que necesite. Cuando esté satisfecho, seleccione Confirmar.
El lienzo vuelve a aparecer con solo los campos seleccionados presentes en la estructura del esquema.
Después de agregar un grupo de campos a un esquema, puede definir campos adicionales para ese grupo. Sin embargo, cualquier campo añadido a un grupo de campos en un esquema también aparecerá en todos los demás esquemas que empleen ese mismo grupo de campos.
Además, si se agrega un campo personalizado a un grupo de campos estándar, ese grupo de campos se convierte en un grupo de campos personalizado y el grupo de campos estándar original ya no estará disponible.
Si desea agregar un campo personalizado a un grupo de campos estándar, consulte la sección inferior para instrucciones específicas. Si va a añadir campos a un grupo de campos personalizado, consulte la sección de editar grupos de campos personalizados en la guía de interfaz de usuario de grupos de campos.
Si no desea modificar ningún grupo de campos existente, puede crear un nuevo grupo de campos personalizados para definir campos adicionales en su lugar.
El Editor de esquemas le permite añadir campos individuales directamente a un esquema si desea evitar agregar un grupo de campos completo para un caso de uso específico. Puede añadir campos individuales de grupos de campos estándar o añadir sus propios campos personalizados en su lugar.
Aunque funcionalmente el Editor de esquemas permite añadir campos individuales directamente a un esquema, esto no cambia el hecho de que todos los campos de un esquema XDM deben proporcionarlos su clase o un grupo de campos compatible con esa clase. Como se explica en las secciones siguientes, todos los campos individuales siguen asociados a una clase o grupo de campos como paso clave cuando se añaden a un esquema.
Puede agregar campos de grupos de campos estándar directamente a un esquema sin necesidad de conocer previamente su grupo de campos correspondiente. Para añadir un campo estándar a un esquema, seleccione el signo más (+) junto al nombre del esquema en el lienzo. Un Campo sin título el marcador de posición aparece en la estructura del esquema y el carril correcto se actualiza para mostrar los controles que deben configurarse.
En Nombre del campo, empiece a escribir el nombre del campo que desee añadir. El sistema busca automáticamente campos estándar que coincidan con la consulta y los enumera en Campos estándar recomendados, incluidos los grupos de campos a los que pertenecen.
Aunque algunos campos estándar comparten el mismo nombre, su estructura puede variar según el grupo de campos del que provengan. Si un campo estándar está anidado dentro de un objeto principal en la estructura del grupo de campos, el campo principal también se incluye en el esquema si se agrega el campo secundario.
Seleccione el icono de vista previa () junto a un campo estándar para ver la estructura de su grupo de campos y comprender mejor cómo se puede anidar. Para añadir el campo estándar al esquema, seleccione el icono de signo más (
).
El lienzo se actualiza para mostrar el campo estándar añadido al esquema, incluidos los campos principales anidados dentro de la estructura del grupo de campos. El nombre del grupo de campos también se enumera en Grupos de campo en el carril izquierdo. Si desea agregar más campos del mismo grupo de campos, seleccione Administrar campos relacionados en el carril derecho.
Al igual que el flujo de trabajo para los campos estándar, también puede añadir sus propios campos personalizados directamente a un esquema.
Para añadir campos al nivel raíz de un esquema, seleccione el signo más (+) junto al nombre del esquema en el lienzo. Un Campo sin título el marcador de posición aparece en la estructura del esquema y el carril correcto se actualiza para mostrar los controles que deben configurarse.
Comience a escribir el nombre del campo que desee añadir y el sistema empezará automáticamente a buscar campos estándar coincidentes. Para crear un nuevo campo personalizado, seleccione la opción superior anexada con (Campo nuevo).
Después de proporcionar un nombre para mostrar y un tipo de datos para el campo, el siguiente paso es asignar el campo a un recurso XDM principal. Si el esquema utiliza una clase personalizada, puede elegir añadir el campo a la clase asignada o grupo de campos en su lugar. Sin embargo, si el esquema utiliza una clase estándar, solo puede asignar el campo personalizado a un grupo de campos.
Esta sección solo trata cómo asignar el campo a un grupo de campos personalizado. Si desea ampliar un grupo de campos estándar con el nuevo campo personalizado, consulte la sección en adición de campos personalizados a grupos de campos estándar.
En Asignar a, seleccione Grupo de campos. Si el esquema utiliza una clase estándar, esta es la única opción disponible y está seleccionada de forma predeterminada.
A continuación, debe seleccionar un grupo de campos para el nuevo campo al que desea asociar. Empiece a escribir el nombre del grupo de campos en la entrada de texto proporcionada. Si tiene algún grupo de campos personalizados existente que coincida con la entrada, estos aparecerán en la lista desplegable. También puede escribir un nombre único para crear un nuevo grupo de campos.
Si selecciona un grupo de campos personalizado existente, cualquier otro esquema que emplee ese grupo de campos también heredará el campo recién agregado después de guardar los cambios. Por este motivo, seleccione únicamente un grupo de campos existente si desea este tipo de propagación. De lo contrario, debe optar por crear un nuevo grupo de campos personalizados.
Después de seleccionar el grupo de campos de la lista, seleccione Aplicar.
El nuevo campo se agrega al lienzo y tiene un área de nombres debajo de su ID de inquilino para evitar conflictos con campos XDM estándar. El grupo de campos al que ha asociado el nuevo campo también aparece en Grupos de campo en el carril izquierdo.
El resto de los campos proporcionados por el grupo de campos personalizados seleccionado se eliminan del esquema de forma predeterminada. Si desea añadir algunos de estos campos al esquema, seleccione un campo perteneciente al grupo y, a continuación, seleccione Administrar campos relacionados en el carril derecho.
En Asignar a, seleccione Clase. El campo de entrada siguiente se sustituye por el nombre de la clase personalizada del esquema actual, lo que indica que el nuevo campo se asignará a esta clase.
Continúe configurando el campo como desee y seleccione Aplicar cuando termine.
El nuevo campo se agrega al lienzo y tiene un área de nombres debajo de su ID de inquilino para evitar conflictos con campos XDM estándar. Al seleccionar el nombre de clase en el carril izquierdo, se muestra el nuevo campo como parte de la estructura de la clase.
Si el esquema en el que está trabajando tiene un campo de tipo objeto proporcionado por un grupo de campos estándar, puede agregar sus propios campos personalizados a ese objeto estándar.
Los campos añadidos a un grupo de campos de un esquema también aparecerán en todos los demás esquemas que empleen ese mismo grupo de campos. Además, si se agrega un campo personalizado a un grupo de campos estándar, ese grupo de campos se convierte en un grupo de campos personalizado y el grupo de campos estándar original ya no estará disponible.
Si ha participado en la versión beta de esta función, recibirá un cuadro de diálogo en el que se le informarán de los grupos de campos estándar que haya personalizado previamente. Una vez seleccionada Conocimiento, los recursos enumerados se convierten en grupos de campos personalizados.
Para empezar, seleccione el signo más (+) junto a la raíz del objeto proporcionado por el grupo de campos estándar.
Aparece un mensaje de advertencia que le solicita que confirme si desea convertir el grupo de campos estándar. Select Continuar creando un grupo de campos para continuar.
El lienzo vuelve a aparecer con un marcador de posición sin título para el nuevo campo. Tenga en cuenta que el nombre del grupo de campos estándar se ha añadido con "(Extendido)" para indicar que se ha modificado de la versión original. Desde aquí, utilice los controles del carril derecho para definir las propiedades del campo.
Después de aplicar los cambios, el nuevo campo aparece debajo del espacio de nombres del ID del inquilino dentro del objeto estándar. Esta área de nombres anidada evita conflictos de nombre de campo dentro del propio grupo de campos para evitar que se rompan los cambios en otros esquemas que utilizan el mismo grupo de campos.
Perfil del cliente en tiempo real combina datos de fuentes diferentes para construir una vista completa de cada cliente individual. Si desea que los datos capturados por un esquema participen en este proceso, debe activar el esquema para utilizarlo en Profile.
Para habilitar un esquema para Profile, debe tener un campo de identidad principal definido. Consulte la guía de definición de campos de identidad para obtener más información.
Para habilitar el esquema, comience por seleccionar el nombre del esquema en el carril izquierdo y, a continuación, seleccione la opción Perfil alterne en el carril derecho.
Aparece una ventana emergente que le advierte de que una vez que un esquema se ha habilitado y guardado, no se puede desactivar. Select Habilitar para continuar.
El lienzo vuelve a aparecer con la variable Perfil activar.
Dado que el esquema aún no se ha guardado, este es el punto de no retorno si cambia de opinión sobre permitir que el esquema participe en el perfil del cliente en tiempo real: una vez guardado un esquema habilitado, ya no se puede desactivar. Seleccione el Perfil volver a alternar para deshabilitar el esquema.
Para finalizar el proceso, seleccione Guardar para guardar el esquema.
El esquema ahora está habilitado para utilizarse en el perfil de cliente en tiempo real. Cuando Platform incorpora datos en conjuntos de datos basados en este esquema, esos datos se incorporan a los datos de perfil amalgamados.
Una vez que haya asignado una clase y agregado grupos de campos a un esquema, puede editar los nombres para mostrar de cualquiera de los campos del esquema, independientemente de si esos campos han sido proporcionados por recursos XDM estándar o personalizados.
Tenga en cuenta que los nombres para mostrar de los campos que pertenecen a clases estándar o grupos de campos solo se pueden editar en el contexto de un esquema específico. En otras palabras, cambiar el nombre para mostrar de un campo estándar en un esquema no afecta a otros esquemas que emplean la misma clase o grupo de campos asociado.
Una vez realizados los cambios en los nombres para mostrar de los campos de un esquema, esos cambios se reflejan inmediatamente en cualquier conjunto de datos existente basado en ese esquema.
Para editar el nombre para mostrar de un campo de esquema, seleccione el campo en el lienzo. En el carril derecho, proporcione el nuevo nombre en Nombre para mostrar.
Select Aplicar en el carril derecho y el lienzo se actualiza para mostrar el nuevo nombre para mostrar del campo. Select Guardar para aplicar los cambios al esquema.
Puede cambiar la clase de un esquema en cualquier momento durante el proceso de composición inicial antes de guardar el esquema.
La reasignación de la clase para un esquema debe realizarse con extrema precaución. Los grupos de campos solo son compatibles con ciertas clases y, por lo tanto, al cambiar la clase se restablecerá el lienzo y los campos que haya agregado.
Para reasignar una clase, seleccione Asignar en el lado izquierdo del lienzo.
Aparece un cuadro de diálogo que muestra una lista de todas las clases disponibles, incluidas las definidas por su organización (siendo el propietario "Cliente") así como las clases estándar definidas por el Adobe.
Seleccione una clase de la lista para mostrar su descripción en el lado derecho del cuadro de diálogo. También puede seleccionar Vista previa de la estructura de la clase para ver los campos y metadatos asociados a la clase . Select Asignar clase para continuar.
Se abre un nuevo cuadro de diálogo en el que se le pedirá que confirme que desea asignar una nueva clase. Select Asignar para confirmar.
Después de confirmar el cambio de clase, el lienzo se restablecerá y se perderá todo el progreso de composición.
Este documento abarcaba los aspectos básicos de la creación y edición de esquemas en la interfaz de usuario de Platform. Se recomienda que revise la tutorial de creación de esquemas para obtener un flujo de trabajo completo para crear un esquema completo en la interfaz de usuario, incluida la creación de grupos de campos personalizados y tipos de datos para casos de uso únicos.
Para obtener más información sobre las capacidades de la variable Esquemas espacio de trabajo, consulte Esquemas información general del espacio de trabajo.
Para aprender a administrar esquemas en la Schema Registry API, consulte la guía de extremo de esquemas.