Datos de modelo en esquemas

Última actualización: 2023-09-25
  • Temas:
  • Schemas
    Ver más sobre este tema
  • Creado para:
  • Beginner
    Intermediate
    Developer

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 basa Experience Platform. Sistema XDM, pone en funcionamiento esquemas del Modelo de datos de experiencia para que los utilicen los servicios de Platform.

Arquitectos de datos deberá crear esquemas fuera de este tutorial, pero Ingenieros de datos trabajará estrechamente 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):

SUGERENCIA

Para profundizar en el modelado de datos en Experience Platform, recomendamos realizar el curso Modelar los datos de la experiencia del cliente con XDM, disponible de forma gratuita en Experience League.

Permisos necesarios

En el Configuración de permisos Esta lección, ha configurado 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. Ir a Esquemas en el panel de navegación izquierdo
  3. Seleccione el botón de Crear esquema en la parte superior derecha
  4. En el menú desplegable, seleccione Perfil individual de XDM, ya que vamos a modelar atributos de un cliente individual (puntos, estado, etc.).
    Esquema con grupo de campos OOTB

Adición de grupos de campos estándar

A continuación, se le pedirá que añada grupos de campos al esquema. Todos los campos deben añadirse a los esquemas utilizando grupos. 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 importante 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 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:

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

    1. Datos demográficos para datos básicos del cliente, como nombre y fecha de nacimiento
    2. Datos personales de contacto para obtener información básica de contacto, como la dirección de correo electrónico y el número de teléfono
  2. 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

  3. Compruebe la Industria > Comercial para exponer los grupos de campos específicos del sector.

  4. Seleccionar Lealtad para añadir los campos del programa de fidelización.

  5. Seleccionar Agregar grupo de campos para agregar los tres grupos de campos al esquema.
    Adición de grupos de campos estándar al esquema de fidelización

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:

  1. Seleccione el nodo superior del esquema.
  2. Entrar Luma Loyalty Schema como el Nombre para mostrar.
  3. Seleccione Guardar.
    Nombre y guarde el esquema
NOTA

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 se defina en el esquema no significa que haya datos para él debe ingerirse más adelante.

Agregar un grupo de campos personalizados

Ahora vamos a crear un grupo de campos personalizados.

Mientras que el grupo de campo de fidelidad contenía un loyaltyID , Luma desea administrar todos sus identificadores del sistema en un solo grupo para garantizar la coherencia en sus esquemas.

Los grupos de campos deben crearse en el flujo de trabajo del esquema. Para crear el grupo de campos:

  1. Seleccionar Añadir en el Grupos de campos de esquema encabezado
    Añadir un nuevo grupo de campos
  2. Seleccione Crear nuevo grupo de campo
  3. Uso Luma Identity profile field group como el Nombre para mostrar
  4. Uso system identifiers for XDM Individual Profile class como el Descripción
  5. Seleccione Agregar grupos de campos
    Añadir un nuevo grupo de campos

El nuevo grupo de campo vacío se agrega al esquema. El + Los botones se pueden utilizar para añadir 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 el Propiedades del campo barra lateral para añadir los detalles del nuevo campo:

    1. Nombre del campo: systemIdentifier
    2. Nombre para mostrar: System Identifier
    3. Tipo: Objeto
    4. Seleccione Aplicar

    Añadir un nuevo grupo de campos

Ahora añada dos campos debajo de systemIdentifier objeto:

  1. Primer campo
    1. Nombre del campo: loyaltyId
    2. Nombre para mostrar: Loyalty Id
    3. Tipo: Cadena
  2. Segundo campo
    1. Nombre del campo: crmId
    2. Nombre para mostrar: CRM Id
    3. Tipo: Cadena

El nuevo grupo de campos debe tener este aspecto. Seleccione el Guardar para guardar el esquema, pero déjelo abierto para el siguiente ejercicio.
Grupo de campos de fidelización completo

Creación de un tipo de datos

Grupos de campos, como el nuevo Luma Identity profile field group, se puede reutilizar en otros esquemas, lo que permite aplicar definiciones de datos estándar en varios sistemas. Pero solo pueden ser reutilizados en esquemas que comparten una clase, en este caso la clase Perfil individual 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 systemIdentifier en un tipo de datos:

Con el Luma Loyalty Schema aún abierto, seleccione la systemIdentifier objeto y seleccione Convertir a nuevo tipo de datos

Grupo de campos de fidelización completo

Si usted Cancelar fuera del esquema y navegue hasta el Tipos de datos , verá el tipo de datos recién creado. 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.

SUGERENCIA

Si prefiere omitir el ejercicio de API, puede crear el siguiente esquema con el método de interfaz de usuario:

  1. Utilice el Perfil individual de XDM clase
  2. Asígnele el 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 tiene 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 hasta tenant. Recuerde que debe utilizar tenant siempre que desee interactuar con sus propios elementos personalizados en Platform, como crear un esquema.

  4. Seleccione Guardar
    Cambiar CONTAINER_ID a inquilino

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

  6. Abra el Cuerpo y pegue el siguiente código y seleccione Enviar para realizar la llamada de API. Esta llamada crea un nuevo esquema con el mismo XDM Individual Profile clase base:

    {
      "type": "object",
      "title": "Luma CRM Schema",
      "description": "Schema for CRM data of Luma Retail ",
      "allOf": [{
        "$ref": "https://ns.adobe.com/xdm/context/profile"
      }]
    }
    
    NOTA

    El área de nombres hace referencia a en este ejemplo de código y en los siguientes (por ejemplo, https://ns.adobe.com/xdm/context/profile), se puede obtener utilizando la lista llamadas de API con el CONTAINER_ID y acepte el encabezado establecido en los valores correctos. Algunos también son fácilmente accesibles desde la interfaz de usuario.

  7. Usted debe conseguir una 201 Created respuesta

  8. Copiar meta:altId del cuerpo de respuesta. Lo utilizaremos más adelante en otro ejercicio.
    Creación del esquema CRM

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

NOTA

El meta:altId o el id de esquema 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 establezca en tenant y un encabezado Aceptar application/vnd.adobe.xdm+json.

SUGERENCIA

Problemas comunes con esta llamada y posibles correcciones:

  • Sin token de autenticación: ejecute el OAuth: Solicitar token de acceso solicitud para generar un nuevo token
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Actualice el CONTAINER_ID variable de entorno de global hasta 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. Entrada Postman, Abra la solicitud Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. En el Parámetros pestaña, pegue el meta:altId valor 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 la Luma CRM Schema:

    [{
        "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 añadidos

Agregar grupo de campos personalizados

Ahora vamos a añadir nuestro 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 Enviar para recuperar una lista de todos los grupos de campos personalizados de la cuenta

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

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

  5. El Parámetros La pestaña debe tener el valor $id de su esquema

  6. Abra el Cuerpo y pegue el siguiente código, reemplazando el $ref valor con el $id por su cuenta Luma Identity profile field group:

    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
      }
    }]
    
  7. Seleccionar Enviar
    Adición del grupo Campo 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 el ExperienceEvent de XDM 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 ExperienceEvent de XDM clase
  2. Añadir el grupo de campos estándar Detalles de comercio para recopilar detalles de pedidos comunes. Dedique unos minutos a explorar los objetos que hay dentro.
  3. Buscar por 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. Necesitamos añadir 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.
  4. Seleccione el Crear nuevo grupo de campos botón de opción
  5. Introduzca el Nombre para mostrar as Luma Identity ExperienceEvent field group y seleccione la Adición de grupos de campos botón
  6. Asegúrese de que la + botones aparecen en en la Estructura para que pueda añadir nuevos campos
  7. Entrada Estructura , seleccione + en el nivel superior del esquema
  8. Como el Nombre de campo, introduzca systemIdentifier
  9. Como el Nombre para mostrar, introduzca System Identifier
  10. Como el Tipo, seleccione Identificador del sistema que es el tipo de datos personalizados que creó anteriormente
  11. Seleccione el Aplicar botón
  12. Asignar un nombre al esquema Luma Offline Purchase Events Schema
  13. Seleccione el botón Guardar

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

Añadir el tipo de datos al grupo de campos

Además, seleccione ExperienceEvent de XDM en el Clase encabezado e inspeccione algunos de los campos aportados por 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 ExperienceEvent de XDM
Grupo de campo Mezcla de ExperienceEvent del SDK web de AEP
Grupo de campo Evento de experiencia del consumidor
Nombre del esquema Esquema de eventos web de Luma

Seleccione el Evento de experiencia del consumidor grupo de campos. Este grupo de campos contiene los objetos commerce y productListItems que también estaban en Detalles de comercio. 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. Mezcla de ExperienceEvent del SDK web de AEP el grupo de campos 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 ha agregado la variable 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 opción ExperienceEvent de XDM clase en la Composición del editor de esquemas, verá que uno de los campos que agrega de forma predeterminada se llama IdentityMap. IdentityMap es utilizado por varias aplicaciones de Adobe 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 el uso de Detalles de comercio y Evento de experiencia del consumidor grupos de campos, Luma informa de algunos detalles de los 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.

NOTA

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 Crear esquema y seleccione el botón Examinar del menú desplegable.
    Crear nuevo esquema
  2. Seleccione el Crear nueva clase botón de opción
  3. Asígnele el nombre Luma Product Catalog Class
  4. Deje el Comportamiento as Registro
  5. Seleccione el Asignar clase botón
    Crear nueva clase
  6. 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
  7. Asignar un nombre al esquema Luma Product Catalog Schema (asegúrese de actualizar el campo correcto y no actualizar el nombre de clase)
  8. Guardar el esquema

El nuevo esquema debería tener un aspecto similar al siguiente. Observe cómo las variables productSku El campo aparece en la Campos obligatorios sección:
Esquema del producto

El siguiente paso es definir la relación entre los dos esquemas de ExperienceEvent y Luma Product Catalog SchemaSin embargo, hay algunos pasos adicionales que debemos tomar en la siguiente lección antes de que podamos hacerlo.

Recursos adicionales

Ahora que tiene sus esquemas, puede asignar identidades!

En esta página