DocumentaciónExperience PlatformDatos de modelo en esquemas

Datos de modelo en esquemas

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

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):

https://video.tv.adobe.com/v/38506?learn=on&captions=spa

TIP
Para profundizar en el modelado de datos en Experience Platform, recomendamos ver la lista de reproducción Modelar los datos de la experiencia del cliente con XDM, disponible de forma gratuita en Experience League.

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.

  1. Vaya a la interfaz de usuario de Platform y asegúrese de que la zona protegida está seleccionada.

  2. Vaya a Esquemas en el panel de navegación izquierdo.

  3. Seleccione el botón Crear esquema en la parte superior derecha.
    Esquema con grupo de campos OOTB

  4. 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.).

  5. Seleccione Siguiente.
    Seleccionar clase base

  6. 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.

  7. Seleccione Finalizar para crear su esquema.
    Terminar de crear el esquema de fidelización

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 gran tema se analiza con más detalle en la lista de reproducción 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:

  1. Seleccione Agregar bajo el encabezado Grupos de campos.
    Agregar nuevo grupo de campos

  2. En el modal Agregar grupos de campos, seleccione los siguientes grupos de campos:

    1. Detalles demográficos para datos básicos de clientes como nombre y fecha de nacimiento
    2. Datos personales de contacto para obtener detalles básicos como la dirección de correo electrónico y el número de teléfono

  3. Puede obtener una vista previa de los campos contribuidos en el grupo de campos seleccionando el icono en el lado derecho de la fila.
    Seleccionar grupos de campos estándar

  4. Marque la casilla Sector > Comercio minorista para exponer los grupos de campos específicos del sector.

  5. Seleccione Detalles de fidelización para agregar los campos del programa de fidelización.

  6. Seleccione Agregar grupos de campos para agregar los tres grupos de campos al esquema.
    Agregar grupos de campos estándar al esquema de fidelidad

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.
Guardar el esquema

NOTE
Es aceptable si un grupo de campos agrega un campo para un punto de datos que no recopila. Por ejemplo, "faxPhone" puede ser un campo para el que Luma no recopila datos. Eso está bien. El hecho de que un campo esté definido en el esquema no significa que los datos para él deban ingerirse más adelante. También puede quitar el campo del esquema.

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:

  1. Seleccione Agregar bajo el encabezado Grupos de campos de esquema
    Agregar nuevo grupo de campos
  2. Seleccionar Crear nuevo grupo de campos
  3. Usar Luma Identity profile field group como nombre para mostrar
  4. Usar system identifiers for XDM Individual Profile class como descripción
  5. Seleccionar Agregar grupos de campos
    Agregar nuevo grupo 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:

  1. 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.

  2. En la barra lateral Propiedades del campo, agregue los detalles del nuevo campo:

    1. Nombre de campo: systemIdentifier

    2. Nombre para mostrar: System Identifier

    3. Tipo: Objeto

    4. En el menú desplegable Grupo de campos, seleccione el grupo de campos de perfil de identidad de Luma que hemos creado.

      Agregar nuevo grupo de campos

    5. Seleccionar Aplicar

      Aplicar nuevas propiedades de campo

Ahora agregue dos campos bajo el objeto systemIdentifier:

  1. Primer campo

    1. Nombre de campo: loyaltyId
    2. Nombre para mostrar: Loyalty Id
    3. Tipo: Cadena

  2. Segundo campo

    1. Nombre de campo: crmId
    2. Nombre para mostrar: CRM Id
    3. Tipo: Cadena

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.
Grupo de campos de fidelización completado

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

Grupo de campos de fidelización completo

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.

Grupo de campos de fidelización completo

Crear esquema CRM mediante API

Ahora crearemos un esquema con la API.

TIP
Si prefiere omitir el ejercicio de API, puede crear el siguiente esquema con el método de interfaz de usuario:
  1. Usar la clase Perfil individual
  2. Asigne un nombre Luma CRM Schema
  3. 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:

  1. Abrir Postman

  2. 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.

  3. Abra las variables de entorno y cambie el valor de CONTAINER_ID de global a tenant. Recuerde, debe usar tenant siempre que desee interactuar con sus propios elementos personalizados en Platform, como crear un esquema.

  4. Seleccionar Guardar
    Cambiar CONTAINER_ID a tenant

  5. Abrir la solicitud Schema Registry API > Schemas > Create a new custom schema.

  6. 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.

  7. Debería obtener una respuesta de 201 Created

  8. Copie meta:altId del cuerpo de respuesta. Lo utilizaremos más adelante en otro ejercicio.
    Crear el esquema CRM

  9. El nuevo esquema debe ser visible en la interfaz de usuario, pero sin ningún grupo de campos
    Crear el esquema CRM

NOTE
El identificador de esquema 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.
TIP
Problemas comunes con esta llamada y posibles correcciones:
  • 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 de global a tenant
  • 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:

  1. En Postman, abra la solicitud Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. En la ficha Params, pegue el valor meta:altId de la respuesta anterior como SCHEMA_ID

  3. 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"
    }
  }
]

  4. 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

    Grupos de campo estándar agregados

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:

  1. Abrir la solicitud Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Seleccione el botón Send para recuperar una lista de todos los grupos de campos personalizados de su cuenta

  3. Tome el valor $id de Luma Identity profile field group (el suyo será diferente del valor de esta captura de pantalla)
    Recuperar la lista de grupos de campos

  4. Volver a abrir la solicitud Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  5. La ficha Params debe seguir teniendo $id de su esquema

  6. Abra la ficha Body y pegue el siguiente código; reemplace el valor $ref por el $id de su propio Luma Identity profile field group:

    code language-json 
    [{
  "op": "add",
  "path": "/allOf/-",
  "value": {
    "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
  }
}]

  7. Seleccionar Enviar
    Agregando el grupo de campos de identidad

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:

  1. Cree un esquema con la clase Experience Event.
  2. Asigne un nombre al esquema Luma Offline Purchase Events Schema.
  3. 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.
  4. 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.
  5. Seleccione el botón de opción Crear nuevo grupo de campos
  6. Escriba Display name como Luma Identity ExperienceEvent field group y seleccione el botón Agregar grupos de campos
  7. Seleccione + junto al nombre del esquema.
  8. Como Nombre de campo, escriba systemIdentifier.
  9. Como Nombre para mostrar, escriba System Identifier.
  10. Como Tipo, seleccione Identificador del sistema, que es el tipo de datos personalizados que creó anteriormente.
  11. Como grupo de campos, seleccione grupo de campos Luma Identity ExperienceEvent.
  12. Seleccione el botón Aplicar.
  13. Seleccione el botón Guardar.

Observe cómo el tipo de datos agregó todos los campos.

Agregar el tipo de datos al grupo de 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:

Estructura base del evento de experiencia

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

Propiedad
Valor
Clase
Evento de experiencia
Nombre del esquema
Esquema de eventos web de Luma
Grupo de campo
ExperienceEvent del SDK web de AEP
Grupo de campo
Evento de experiencia del consumidor

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.

NOTE
Si es cliente existente de Analytics o Target, la clasificación de entidades con relaciones de esquema es análoga a las clasificaciones de SAINT o a la carga del catálogo de productos para Recommendations

En primer lugar, se debe crear un esquema para el catálogo de productos de Luma utilizando una clase personalizada:

  1. Seleccione el botón Crear esquema.

  2. En el flujo de trabajo Crear esquema, seleccione la opción Otros.
    Crear nuevo esquema

  3. Seleccione el botón Crear clase

  4. Asigne un nombre Luma Product Catalog Class

  5. Deje Funcionamiento como Registro

  6. Seleccione el botón Crear.
    Crear nueva clase

  7. 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.
    Nueva clase agregada

  8. Asigne un nombre al esquema Luma Product Catalog Schema.

  9. Crear un nuevo grupo de campos llamado Luma Product Catalog field group con los campos siguientes:

    1. productName: Nombre del producto: String
    2. productCategory: Categoría del producto: Cadena
    3. productColor: Product Color: String
    4. productSKU: Product SKU: String | Requerido
    5. productSize: Tamaño del producto: Cadena
    6. productPrice: Precio del producto: Doble

  10. 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:
Esquema del producto

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.

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad