Datos de modelo en esquemas
En esta lección, modelará los datos de Luma en esquemas. Esta es una de las lecciones más largas del tutorial, ¡así que toma un vaso de agua y abróchate!
La estandarización y la interoperabilidad son conceptos clave detrás de Adobe Experience Platform. El modelo de datos de experiencia (XDM) es un esfuerzo para estandarizar los datos de experiencia del cliente y definir esquemas para la administración de experiencias del cliente.
XDM es una especificación documentada públicamente y diseñada para mejorar la potencia de las experiencias digitales. Proporciona estructuras y definiciones comunes para cualquier aplicación que se utilice para comunicarse con los servicios de Platform. Al adherirse a los estándares XDM, todos los datos de experiencia del cliente se pueden incorporar en una representación común que puede ofrecer perspectivas de una manera más rápida e integrada. Puede obtener información valiosa de las acciones de los clientes, definir las audiencias de los clientes mediante segmentos y expresar los atributos del cliente con fines de personalización.
XDM es el marco de trabajo básico que permite a Adobe Experience Cloud, con tecnología de Experience Platform, enviar el mensaje correcto a la persona adecuada, en el canal correcto, en el momento exacto. La metodología en la que se ha creado el Experience Platform, Sistema XDM, pone en funcionamiento los esquemas del modelo de datos de experiencia para que los usen los servicios de Platform.
Los arquitectos de datos tendrán que crear esquemas fuera de este tutorial, pero los ingenieros de datos trabajarán de cerca con los esquemas creados por el arquitecto de datos.
Antes de comenzar los ejercicios, vea este breve vídeo para obtener más información sobre los esquemas y el modelo de datos de experiencia (XDM):
Permisos necesarios
En la lección Configurar permisos, configuró todos los controles de acceso necesarios para completar esta lección.
Crear esquema de fidelización mediante la IU
En este ejercicio, crearemos un esquema para los datos de fidelidad de Luma.
-
Vaya a la interfaz de usuario de Platform y asegúrese de que la zona protegida está seleccionada.
-
Vaya a Esquemas en el panel de navegación izquierdo.
-
Seleccione el botón Crear esquema en la parte superior derecha.
-
En el flujo de trabajo Crear esquema, seleccione Perfil individual como clase base para su esquema, ya que modelaremos los atributos de un cliente individual (puntos, estado, etc.).
-
Seleccione Siguiente.
-
Escriba
Luma Loyalty Schema
en el campo de texto Nombre para mostrar del esquema. En el lienzo siguiente, también puede revisar y verificar la estructura de esquema base proporcionada por la clase elegida. -
Seleccione Finalizar para crear su esquema.
Adición de grupos de campos estándar
Una vez creado el esquema, se le redirigirá al Editor de esquemas, donde puede agregar campos al esquema. Puede agregar campos individuales directamente al esquema o utilizar grupos de campos. Es importante tener en cuenta que todos los campos individuales siguen estando asociados a una clase o grupo de campos. Puede elegir entre un gran conjunto de grupos de campos estándar del sector proporcionados por Adobe o crear los suyos propios. A medida que empiece a modelar sus propios datos en Experience Platform, es bueno familiarizarse con los grupos de campo estándar del sector que proporciona Adobe. Siempre que sea posible, se recomienda utilizarlos, ya que a veces alimentan servicios descendentes, como inteligencia artificial aplicada al cliente, Attribution AI y Adobe Analytics.
Al trabajar con sus propios datos, un paso significativo será determinar cuáles de sus propios datos deben capturarse en Platform y cómo deben modelarse. Este tema de gran tamaño se analiza con más detalle en el curso Modelar los datos de la experiencia del cliente con XDM. En este tutorial, solo le guiaré a través de la implementación de algunos esquemas predeterminados.
Para agregar grupos de campos:
-
Seleccione Agregar bajo el encabezado Grupos de campos.
-
En el modal Agregar grupos de campos, seleccione los siguientes grupos de campos:
- Detalles demográficos para datos básicos de clientes como nombre y fecha de nacimiento
- Datos personales de contacto para obtener detalles básicos como la dirección de correo electrónico y el número de teléfono
-
Puede obtener una vista previa de los campos contribuidos en el grupo de campos seleccionando el icono en el lado derecho de la fila.
-
Marque la casilla Sector > Comercio minorista para exponer los grupos de campos específicos del sector.
-
Seleccione Detalles de fidelización para agregar los campos del programa de fidelización.
-
Seleccione Agregar grupos de campos para agregar los tres grupos de campos al esquema.
Ahora, dedique un tiempo a explorar el estado actual del esquema. Los grupos de campos han agregado campos estándar relacionados con una persona, sus detalles de contacto y el estado del programa de fidelización. Puede encontrar útiles estos dos grupos de campos al crear esquemas para los datos de su propia compañía. Seleccione una fila de grupo de campos específica o marque la casilla junto al nombre del grupo de campos para ver cómo cambia la visualización.
Para guardar el esquema, seleccione Guardar.
Agregar un grupo de campos personalizados
Ahora, vamos a crear un grupo de campos personalizados.
Aunque el grupo de campos de fidelidad contenía un campo loyaltyID
, Luma desea administrar todos sus identificadores del sistema en un solo grupo para garantizar la coherencia en todos sus esquemas.
Los grupos de campos deben crearse en el flujo de trabajo del esquema. Puede:
- Agregue primero un nuevo campo personalizado al esquema y, a continuación, cree un grupo de campos personalizados, o
- Cree primero un grupo de campos personalizados y, a continuación, agréguele campos.
En este tutorial, empezamos con la creación de un grupo de campos personalizados.
Para crear el grupo de campos:
- Seleccione Agregar bajo el encabezado Grupos de campos de esquema
- Seleccionar Crear nuevo grupo de campos
- Usar
Luma Identity profile field group
como nombre para mostrar - Usar
system identifiers for XDM Individual Profile class
como descripción - Seleccionar Agregar grupos de campos
El nuevo grupo de campo vacío se agrega al esquema. Los botones + se pueden usar para agregar nuevos campos a cualquier ubicación de la jerarquía. En nuestro caso, queremos añadir campos en el nivel raíz:
-
Seleccione + junto al nombre del esquema. Esto agrega un nuevo campo bajo el área de nombres de ID de inquilino para administrar los conflictos entre los campos personalizados y cualquier campo estándar.
-
En la barra lateral Propiedades del campo, agregue los detalles del nuevo campo:
-
Nombre de campo:
systemIdentifier
-
Nombre para mostrar:
System Identifier
-
Tipo: Objeto
-
En el menú desplegable Grupo de campos, seleccione el grupo de campos de perfil de identidad de Luma que hemos creado.
-
Seleccionar Aplicar
-
Ahora agregue dos campos bajo el objeto systemIdentifier
:
-
Primer campo
- Nombre de campo:
loyaltyId
- Nombre para mostrar:
Loyalty Id
- Tipo: Cadena
- Nombre de campo:
-
Segundo campo
- Nombre de campo:
crmId
- Nombre para mostrar:
CRM Id
- Tipo: Cadena
- Nombre de campo:
El nuevo grupo de campos debe tener este aspecto. Seleccione el botón Guardar para guardar el esquema, pero déjelo abierto para el siguiente ejercicio.
Creación de un tipo de datos
Los grupos de campos, como su nuevo Luma Identity profile field group
, se pueden reutilizar en otros esquemas, lo que le permite aplicar definiciones de datos estándar en varios sistemas. Pero solo se pueden reutilizar en esquemas que comparten una clase, en este caso la clase de perfil individual de XDM.
El tipo de datos es otra construcción de varios campos que se puede reutilizar en esquemas en varias clases. Vamos a convertir nuestro nuevo objeto systemIdentifier
en un tipo de datos:
Con Luma Loyalty Schema
todavía abierto, seleccione el objeto systemIdentifier
y seleccione Convertir a nuevo tipo de datos
Si cancela fuera del esquema y navega a la pestaña Tipos de datos, verá el tipo de datos que acaba de crear. Utilizaremos este tipo de datos más adelante en la lección.
Crear esquema CRM mediante API
Ahora crearemos un esquema con la API.
- Usar la clase Perfil individual
- Asigne un nombre
Luma CRM Schema
- Utilice los siguientes grupos de campos: Detalles demográficos, detalles de contacto personal y grupo de campos del perfil de identidad de Luma
Primero creamos el esquema vacío:
-
Abrir Postman
-
Si no cuenta con un token de acceso, abra la solicitud OAuth: Request Access Token y seleccione Enviar para solicitar un nuevo token de acceso.
-
Abra las variables de entorno y cambie el valor de CONTAINER_ID de
global
atenant
. Recuerde, debe usartenant
siempre que desee interactuar con sus propios elementos personalizados en Platform, como crear un esquema. -
Seleccionar Guardar
-
Abrir la solicitud Schema Registry API > Schemas > Create a new custom schema.
-
Abra la pestaña Body, pegue el siguiente código y seleccione Send para realizar la llamada de API. Esta llamada crea un nuevo esquema utilizando la misma clase base
XDM Individual Profile
:code language-json { "type": "object", "title": "Luma CRM Schema", "description": "Schema for CRM data of Luma Retail ", "allOf": [{ "$ref": "https://ns.adobe.com/xdm/context/profile" }] }
note note NOTE Las referencias de área de nombres en esta y las muestras de código subsiguientes (por ejemplo https://ns.adobe.com/xdm/context/profile
) se pueden obtener usando llamadas de API de lista con el encabezado CONTAINER_ID y aceptar establecido en los valores correctos. Algunos también son fácilmente accesibles desde la interfaz de usuario. -
Debería obtener una respuesta de
201 Created
-
Copie
meta:altId
del cuerpo de respuesta. Lo utilizaremos más adelante en otro ejercicio.
-
El nuevo esquema debe ser visible en la interfaz de usuario, pero sin ningún grupo de campos
meta:altId
o también se puede obtener realizando la solicitud de API Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. con el CONTAINER_ID establecido en tenant
y un encabezado de aceptación application/vnd.adobe.xdm+json
.- Sin token de autenticación: ejecute la solicitud OAuth: Solicitar token de acceso para generar un nuevo token
401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/
: actualizar la variable de entorno CONTAINER_ID deglobal
atenant
403: PALM Access Denied. POST access is denied for this resource from access control
: compruebe los permisos de usuario en el Admin Console
Adición de grupos de campos estándar
Ahora es el momento de agregar los grupos de campos al esquema:
-
En Postman, abra la solicitud Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
-
En la ficha Params, pegue el valor
meta:altId
de la respuesta anterior comoSCHEMA_ID
-
Abra la pestaña Cuerpo, pegue el siguiente código y seleccione Enviar para realizar la llamada de API. Esta llamada agrega los grupos de campos estándar a su
Luma CRM Schema
:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details" } }, { "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-person-details" } } ]
-
Debe obtener un estado 200 OK para la respuesta y los grupos de campos deben ser visibles como parte del esquema en la interfaz de usuario
Agregar grupo de campos personalizados
Ahora vamos a agregar nuestra Luma Identity profile field group
al esquema. En primer lugar, necesitamos encontrar el ID de nuestro nuevo grupo de campos, utilizando una API de lista:
-
Abrir la solicitud Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.
-
Seleccione el botón Send para recuperar una lista de todos los grupos de campos personalizados de su cuenta
-
Tome el valor
$id
deLuma Identity profile field group
(el suyo será diferente del valor de esta captura de pantalla)
-
Volver a abrir la solicitud Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
-
La ficha Params debe seguir teniendo
$id
de su esquema -
Abra la ficha Body y pegue el siguiente código; reemplace el valor
$ref
por el$id
de su propioLuma Identity profile field group
:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID" } }]
-
Seleccionar Enviar
Compruebe que el grupo de campos se ha agregado al esquema comprobando tanto la respuesta de la API como en la interfaz.
Crear esquema de eventos de compra sin conexión
Ahora vamos a crear un esquema basado en la clase Experience Event para los datos de compra sin conexión de Luma. Dado que ahora se está familiarizando con la interfaz de usuario del editor de esquemas, reduciré el número de capturas de pantalla en las instrucciones:
- Cree un esquema con la clase Experience Event.
- Asigne un nombre al esquema
Luma Offline Purchase Events Schema
. - Agregue el grupo de campos estándar Detalles de Commerce para capturar detalles de pedidos comunes. Dedique unos minutos a explorar los objetos que hay dentro.
- Busque
Luma Identity profile field group
. ¡No está disponible! Recuerde que los grupos de campos están vinculados a una clase y, como estamos utilizando una clase diferente para este esquema, no podemos utilizarla. Es necesario agregar un nuevo grupo de campos para la clase XDM ExperienceEvent que contenga los campos de identidad. Nuestro tipo de datos lo hará muy fácil. - Seleccione el botón de opción Crear nuevo grupo de campos
- Escriba Display name como
Luma Identity ExperienceEvent field group
y seleccione el botón Agregar grupos de campos - Seleccione + junto al nombre del esquema.
- Como Nombre de campo, escriba
systemIdentifier
. - Como Nombre para mostrar, escriba
System Identifier
. - Como Tipo, seleccione Identificador del sistema, que es el tipo de datos personalizados que creó anteriormente.
- Como grupo de campos, seleccione grupo de campos Luma Identity ExperienceEvent.
- Seleccione el botón Aplicar.
- Seleccione el botón Guardar.
Observe cómo el tipo de datos agregó todos los campos.
Además, seleccione XDM ExperienceEvent en el encabezado Class e inspeccione algunos de los campos que ha contribuido esta clase. Tenga en cuenta que los campos _id y timestamp son obligatorios al utilizar la clase XDM ExperienceEvent; estos campos deben rellenarse para cada registro que introduzca al utilizar este esquema:
Crear esquema de eventos web
Ahora vamos a crear un esquema más para los datos del sitio web de Luma. En este punto, debería ser un experto en la creación de esquemas. Cree el siguiente esquema con estas propiedades
Seleccione el grupo de campos Evento de experiencia del consumidor. Este grupo de campos contiene los objetos commerce y productListItems que también estaban en Detalles de Commerce. De hecho, Evento de experiencia del consumidor es una combinación de otros grupos de campos estándar que también están disponibles por separado. El grupo de campos ExperienceEvent del SDK web de AEP también contiene otros grupos de campos, incluidos algunos de los mismos en Evento de experiencia del consumidor. Afortunadamente, se mezclan sin problemas.
Observe que no se agregó Luma Identity ExperienceEvent field group
a este esquema. Esto se debe a que el SDK web tiene una forma diferente de recopilar identidades. Si selecciona la clase XDM ExperienceEvent en la sección Composition del editor de esquemas, verá que uno de los campos que agrega de forma predeterminada se llama IdentityMap. Varias aplicaciones de Adobe utilizan IdentityMap para vincularse a Platform. Verá cómo se envían las identidades a Platform a través de identityMap en la lección de ingesta de transmisión.
Crear esquema de catálogo de productos
Mediante los grupos de campos Detalles de Commerce y Evento de experiencia del consumidor, Luma informa de algunos detalles de eventos relacionados con el producto a través del tipo de datos estándar productListItems. Pero también tienen campos de detalles de producto adicionales que les gustaría enviar a Platform. En lugar de capturar todos estos campos en sus sistemas de punto de venta y comercio electrónico, Luma preferiría ingerirlos directamente desde su sistema de catálogo de productos. Una "relación de esquema" permite definir una relación entre dos esquemas para los fines de clasificación o búsquedas. Luma utilizará una relación para clasificar los detalles del producto. Comenzaremos el proceso ahora y lo completaremos al final de la siguiente lección.
En primer lugar, se debe crear un esquema para el catálogo de productos de Luma utilizando una clase personalizada:
-
Seleccione el botón Crear esquema.
-
En el flujo de trabajo Crear esquema, seleccione la opción Otros.
-
Seleccione el botón Crear clase
-
Asigne un nombre
Luma Product Catalog Class
-
Deje Funcionamiento como Registro
-
Seleccione el botón Crear.
-
La clase de catálogo de productos Luma que ha creado aparece en la tabla Clases a continuación. Asegúrese de que la clase esté seleccionada y, a continuación, seleccione Siguiente.
-
Asigne un nombre al esquema
Luma Product Catalog Schema
. -
Crear un nuevo grupo de campos llamado
Luma Product Catalog field group
con los campos siguientes:- productName: Nombre del producto: String
- productCategory: Categoría del producto: Cadena
- productColor: Product Color: String
- productSKU: Product SKU: String | Requerido
- productSize: Tamaño del producto: Cadena
- productPrice: Precio del producto: Doble
-
Guardar el esquema
El nuevo esquema debería tener un aspecto similar al siguiente. Observe cómo el campo productSku
aparece en la sección Campos obligatorios:
El siguiente paso es definir la relación entre los dos esquemas de ExperienceEvent y Luma Product Catalog Schema
; sin embargo, hay que seguir algunos pasos adicionales en la siguiente lección para poder hacerlo.
Recursos adicionales
Ahora que tiene sus esquemas, puede asignar identidades.