Crear un esquema con Schema Editor
La interfaz de usuario de Adobe Experience Platform le permite crear y administrar Experience Data Model esquemas (XDM) en un lienzo visual interactivo denominado Schema Editor. Este tutorial explica cómo crear un esquema con Schema Editor.
Para fines de demostración, los pasos de este tutorial implican la creación de un esquema de ejemplo que describe a los miembros de un programa de lealtad de clientes. Aunque puede utilizar estos pasos para crear un esquema diferente para sus propios fines, se recomienda que siga primero junto con la creación del esquema de ejemplo para conocer las capacidades de Schema Editor.
NOTEIntroducción
Este tutorial requiere una comprensión práctica de los distintos aspectos de Adobe Experience Platform implicados en la creación de esquemas. Antes de comenzar este tutorial, revise la documentación para los siguientes conceptos:
- Experience Data Model (XDM): El marco estandarizado mediante el cual Platform organiza los datos de experiencia del cliente.
- Aspectos básicos de la composición de esquemas: Información general sobre los esquemas XDM y sus componentes básicos, incluidas las clases, los grupos de campos de esquema, los tipos de datos y los campos individuales.
- Real-Time Customer Profile: proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
Abrir el área de trabajo Esquemas
El área de trabajo Esquemas en la interfaz de usuario de Platform proporciona una visualización de Schema Library, lo que le permite ver y administrar los esquemas disponibles para su organización. El área de trabajo también incluye Schema Editor, el lienzo en el que puede crear un esquema a lo largo de este tutorial.
Después de iniciar sesión en Experience Platform, seleccione Esquemas en el panel de navegación izquierdo para abrir el área de trabajo Esquemas. La pestaña Examinar muestra una lista de esquemas (una representación de Schema Library) que puede ver y personalizar. La lista incluye el nombre, el tipo, la clase y el comportamiento (registro o serie temporal) en los que se basa el esquema, así como la fecha y la hora de la última modificación.
Consulte la guía Exploración de recursos XDM existentes en la interfaz de usuario para obtener más información.
Creación y asignación de nombres a un esquema
Para empezar a maquetar un esquema, seleccione Crear esquema en la esquina superior derecha del área de trabajo Esquemas.
Aparecerá el cuadro de diálogo Crear un esquema. En este cuadro de diálogo, puede elegir crear manualmente un esquema añadiendo campos y grupos de campos, o puede cargar un archivo CSV y utilizar algoritmos XML para generar un esquema. Seleccione un flujo de trabajo de creación de esquemas en el cuadro de diálogo.
Beta Creación de esquemas asistida por ML o manual
Para obtener información sobre cómo utilizar un algoritmo XML para recomendar una estructura de esquema basada en un archivo cargado, consulte la guía de creación de esquemas asistida por aprendizaje automático. Esta guía de la interfaz de usuario se centra en el flujo de trabajo de creación manual.
Elegir una clase base
Aparece el flujo de trabajo Crear esquema. A continuación, elija una clase base para el esquema. Puede elegir entre las clases principales de XDM Individual Profile y XDM ExperienceEvent, o Other si estas clases no se ajustan a sus propósitos. La opción Otras clases permite crear una clase nueva o elegir entre otras clases preexistentes.
Consulte la documentación de XDM individual profile y XDM ExperienceEvent para obtener más información sobre estas clases. A los efectos de este tutorial, seleccione Perfil individual de XDM seguido de Siguiente.
Nombre y revisión
Después de seleccionar una clase, aparece la sección Nombre y revisión. En esta sección, proporcione un nombre y una descripción para identificar el esquema. Hay varias consideraciones importantes que se deben tener en cuenta al decidir un nombre para el esquema:
- Los nombres de los esquemas deben ser cortos y descriptivos para que el esquema se pueda encontrar fácilmente más adelante.
- Los nombres de los esquemas deben ser únicos, lo que significa que también deben ser lo suficientemente específicos para que no se reutilicen en el futuro. Por ejemplo, si su organización tiene programas de fidelización independientes para diferentes marcas, sería aconsejable nombrar el esquema "Miembros fieles de marca A" para que sea fácil distinguirlo de otros esquemas relacionados con la lealtad que pueda definir más adelante.
- También puede utilizar la descripción del esquema para proporcionar cualquier información contextual adicional sobre el esquema.
Este tutorial crea un esquema para introducir datos relacionados con los miembros de un programa de fidelidad y, por lo tanto, el esquema se denomina "Loyalty Members".
La estructura base del esquema (proporcionada por la clase ) se muestra en el lienzo para que revise y compruebe la clase y la estructura de esquema seleccionadas.
Escriba un nombre para mostrar del esquema descriptivo en el campo de texto. A continuación, introduzca una descripción adecuada para ayudar a identificar el esquema. Cuando haya revisado la estructura de esquema y esté satisfecho con la configuración, seleccione Finalizar para crear el esquema.
Componga su esquema
Aparece Schema Editor. Este es el lienzo sobre el que compondrá el esquema. El esquema con título propio se crea automáticamente en la sección Structure del lienzo cuando llega al editor, junto con los campos estándar incluidos en la clase base que ha seleccionado. La clase asignada para el esquema también se enumera en Class en la sección Composition.
NOTE
NOTEAdición de un grupo de campos
Ahora puede empezar a añadir campos al esquema añadiendo grupos de campos. Un grupo de campos es un grupo de uno o más campos que a menudo se utilizan juntos para describir un concepto en particular. Este tutorial utiliza grupos de campos para describir a los miembros del programa de fidelidad y capturar información clave como el nombre, el cumpleaños, el número de teléfono, la dirección, etc.
Para agregar un grupo de campos, seleccione Agregar en la subsección Grupos de campos.
Aparece un nuevo cuadro de diálogo que muestra una lista de grupos de campos disponibles. Cada grupo de campos está diseñado únicamente para utilizarse con una clase específica; por lo tanto, el cuadro de diálogo solo enumera los grupos de campos compatibles con la clase seleccionada (en este caso, la clase XDM Individual Profile). Si utiliza una clase XDM estándar, la lista de grupos de campos se ordenará de forma inteligente en función de la popularidad del uso.
Puede seleccionar uno de los filtros en el carril izquierdo para reducir la lista de grupos de campos estándar a industrias específicas, como comercio minorista, servicios financieros y atención médica.
Al seleccionar un grupo de campos de la lista, aparece en el carril derecho. Si lo desea, puede seleccionar varios grupos de campos y añadir cada uno a la lista en el carril derecho antes de confirmar. Además, aparece un icono en el lado derecho del grupo de campos seleccionado actualmente que le permite previsualizar la estructura de los campos que proporciona.
Al obtener una vista previa de un grupo de campos, se proporciona una descripción detallada del esquema del grupo de campos en el carril derecho. También puede navegar por los campos del grupo de campos en el lienzo proporcionado. A medida que selecciona diferentes campos, el carril derecho se actualiza para mostrar detalles sobre el campo en cuestión. Seleccione Atrás cuando haya terminado de obtener la vista previa para volver al cuadro de diálogo de selección de grupos de campos.
Para este tutorial, seleccione el grupo de campos Detalles demográficos y luego seleccione Agregar grupo de campos.
El lienzo del esquema vuelve a aparecer. La sección Grupos de campos ahora enumera "Detalles demográficos" y la sección Estructura incluye los campos aportados por el grupo de campos. Puede seleccionar el nombre del grupo de campos en la sección Grupos de campos para resaltar los campos específicos que proporciona dentro del lienzo.
NOTE
Este grupo de campos aporta varios campos bajo el nombre de nivel superior person con el tipo de datos "Persona". Este grupo de campos describe información sobre un individuo, incluido el nombre, la fecha de nacimiento y el sexo.
NOTEObserve que el campo name tiene un tipo de datos of "Nombre completo", lo que significa que también describe un concepto común y contiene subcampos relacionados con el nombre, como nombre, apellidos, título de cortesía y sufijo.
Seleccione los diferentes campos dentro del lienzo para mostrar cualquier campo adicional que contribuyan a la estructura del esquema.
Añadir más grupos de campos
Ahora puede repetir los mismos pasos para agregar otro grupo de campos. Cuando vea el cuadro de diálogo Agregar grupo de campos esta vez, fíjese en que el grupo de campos "Detalles demográficos" ha quedado atenuado y no se puede seleccionar la casilla que hay junto a él. Esto evita que duplique accidentalmente grupos de campos que ya ha incluido en el esquema actual.
Para este tutorial, seleccione los grupos de campos estándar Datos de contacto personal y Detalles de fidelidad de la lista, luego seleccione Agregar grupos de campos para agregarlos al esquema.
El lienzo vuelve a aparecer con los grupos de campos agregados enumerados en Grupos de campos en la sección Composición y sus campos compuestos agregados a la estructura de esquema.
Definir un grupo de campos personalizados
El esquema Miembros fieles está diseñado para capturar datos relacionados con los miembros de un programa de fidelización, y el grupo de campos estándar Detalles de fidelización que agregó al esquema proporciona la mayoría de ellos, incluido el tipo de programa, points, fecha de unión, etc.
Sin embargo, puede haber un escenario en el que desee incluir campos personalizados adicionales no cubiertos por grupos de campos estándar para lograr sus casos de uso. En el caso de agregar campos de lealtad personalizados, tiene dos opciones:
- Cree un nuevo grupo de campos personalizados para capturar estos campos. Este es el método que se explica en este tutorial.
- Amplíe el grupo de campos estándar Detalles de fidelización con campos personalizados. Esto hace que Detalles de fidelización se convierta en un grupo de campos personalizados y el grupo de campos estándar original ya no estará disponible. Consulte la guía de la interfaz de usuario Esquemas para obtener más información sobre agregar campos personalizados a la estructura de grupos de campos estándar.
Para crear un nuevo grupo de campos, selecciona Agregar en la subsección Grupos de campos como antes, pero esta vez selecciona Crear nuevo grupo de campos cerca de la parte superior del cuadro de diálogo que aparece. A continuación, se le pedirá que proporcione un nombre para mostrar y una descripción para el nuevo grupo de campos. Para este tutorial, asigne un nombre al nuevo grupo de campos "Custom Loyalty Details" y seleccione Agregar grupos de campos.
NOTE"Custom Loyalty Details" debería aparecer ahora en Grupos de campos en el lado izquierdo del lienzo, pero aún no hay campos asociados a él y, por lo tanto, no aparecen nuevos campos en Estructura.
Agregar campos al grupo de campos
Ahora que ha creado el grupo de campos "Custom Loyalty Details", es hora de definir los campos que el grupo de campos contribuirá al esquema.
Para empezar, seleccione el icono más (+) junto al nombre del esquema en el lienzo.
Aparece un marcador de posición "Campo sin título" en el lienzo y el carril derecho se actualiza para mostrar las opciones de configuración del campo.
En este caso, el esquema debe tener un tipo de objeto field que describe en detalle el nivel de lealtad actual de la persona. Usando los controles del carril derecho, empiece a crear un campo loyaltyTier con el tipo "Objeto" que se usará para guardar los campos relacionados.
En Asignar a, debe seleccionar un grupo de campos al que asignar el campo. Recuerde que todos los campos de esquema pertenecen a una clase o a un grupo de campos y, como este esquema utiliza una clase estándar, la única opción es seleccionar un grupo de campos. Empiece a escribir el nombre "Custom Loyalty Details" y, a continuación, seleccione el grupo de campos de la lista.
Cuando termine, seleccione Aplicar.
Los cambios se aplican y aparece el objeto loyaltyTier recién creado. Dado que es un campo personalizado, se anida automáticamente dentro de un espacio de nombres de objeto al ID de inquilino de su organización, precedido de un guion bajo (_tenantId en este ejemplo).
NOTESeleccione el icono más (+) junto al objeto loyaltyTier para empezar a agregar subcampos. Aparece un nuevo marcador de posición de campo y la sección Propiedades del campo está visible a la derecha del lienzo.
Cada campo requiere la siguiente información:
- Nombre de campo: El nombre del campo, preferiblemente escrito en camelCase. No se permiten caracteres de espacio. Es el nombre que se utiliza para hacer referencia al campo en el código y en otras aplicaciones de flujo descendente.
- Ejemplo: loyaltyLevel
- Nombre para mostrar: El nombre del campo, escrito en mayúsculas y minúsculas. Este es el nombre que se mostrará en el lienzo al ver o editar el esquema.
- Ejemplo: Nivel de fidelización
- Tipo: El tipo de datos of el campo. Esto incluye tipos escalares básicos and cualquier tipo de datos defined en Schema Registry. Ejemplos: String, Integer, Boolean, Person, Address, Phone number, etc.
- Descripción: Se debe incluir una descripción opcional del campo con un máximo de 200 caracteres.
El primer campo del objeto loyaltyTier será una cadena denominada id, que representa el identificador del nivel actual del miembro socio. El ID de nivel será único para cada miembro socio, ya que esta empresa establece diferentes umbrales de punto de nivel de fidelidad para cada cliente en función de diferentes factores. Definición del tipo del nuevo campo to "Cadena" y la sección Propiedades del campo se rellena con varias opciones para aplicar restricciones, incluidos el valor predeterminado, el formato y la longitud máxima. Consulte la documentación sobre prácticas recomendadas para los campos de validación de datos para obtener más información.
Dado que id será una cadena de forma libre generada aleatoriamente, no se necesitan más restricciones. Seleccione Aplicar para aplicar los cambios.
