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 obtén un vaso de agua y ponte una hebilla.

La estandarización y la interoperabilidad son conceptos clave para Adobe Experience Platform. El modelo de datos de experiencia (XDM), impulsado por el Adobe, es un esfuerzo para estandarizar los datos de experiencia del cliente y definir esquemas para la administración de la experiencia del cliente.

XDM es una especificación públicamente documentada diseñada para mejorar el poder de las experiencias digitales. Proporciona estructuras y definiciones comunes para cualquier aplicación que se pueda utilizar para comunicarse con los servicios de la Plataforma. Al cumplir con los estándares XDM, todos los datos de experiencia del cliente se pueden incorporar a una representación común que puede ofrecer perspectivas de una manera más rápida e integrada. Puede obtener perspectivas valiosas de las acciones de los clientes, definir audiencias de clientes a través de segmentos y expresar atributos de clientes para fines de personalización.

XDM es el marco fundamental que permite a Adobe Experience Cloud, con la ayuda de un Experience Platform, entregar el mensaje correcto a la persona adecuada, en el canal correcto, en el momento preciso. La metodología en la que se crea el Experience Platform, Sistema XDM, hace operativos los esquemas del modelo de datos de experiencia para que los utilicen los servicios de plataforma.

Las arquitecturas de datos necesitarán crear esquemas fuera de este tutorial, pero los ingenieros de datos trabajarán muy 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 esquemas y el Modelo de datos de experiencia (XDM):

Se requieren permisos

En la lección Configurar permisos, configure todos los controles de acceso que necesite para completar esta lección, específicamente:

  • Elementos de permisos Modelado de datos > Esquemas de Vista y Administrar Esquemas
  • Elemento de permiso Simuladores para pruebas > Luma Tutorial
  • Acceso de rol de usuario al perfil del producto Luma Tutorial Platform
  • Acceso de rol de desarrollador al perfil del producto Luma Tutorial Platform (para API)

Creación de Esquemas de lealtad mediante la interfaz de usuario

En este ejercicio crearemos un Esquema de Lealtad de Luma para ingerir datos de fidelidad de los clientes.

  1. Vaya a la interfaz de usuario de la plataforma y asegúrese de que el simulador de pruebas está seleccionado.

  2. Haga clic en Esquemas en el panel de navegación izquierdo

  3. Haga clic en el botón Crear Esquema en la parte superior derecha

  4. En el menú desplegable, seleccione Perfil individual XDM
    Esquema con la mezcla de OOTB

  5. En Propiedades de Esquema, en el lado derecho de la pantalla, escriba Nombre para mostrar Luma Loyalty Schema

Añadir mezclas estándar

Los campos se agregan a los esquemas agregando mezclas. Puede elegir entre un gran conjunto de mezclas estándar de la industria proporcionadas por Adobe o crear las suyas propias. A medida que inicio modelar sus propios datos en Experience Platform, es bueno familiarizarse con las mezclas estándar del sector que proporciona el Adobe. Siempre que sea posible, es recomendable utilizarlos, ya que a veces alimentan los servicios intermedios, como la API del cliente, el Attribution AI, Adobe Analytics, etc.

Para agregar mezclas:

  1. En la parte izquierda del editor de esquema, en la sección Mixin, haga clic en el botón Añadir:

    Añadir mezcla

  2. En el modal Mixins, seleccione las siguientes mezclas

    1. Detalles demográficos
    2. Detalles de contacto personal
  3. Tenga en cuenta que puede realizar la previsualización de los campos de la mezcla haciendo clic en el icono situado en la parte derecha de la fila.

  4. Haga clic en Añadir mezcla para agregar las mezclas al esquema
    Añadir mezclas listas para usar en el esquema de lealtad

Tómese algún tiempo para explorar el estado actual del esquema. Tenga en cuenta que estas dos mezclas han agregado campos estándar relacionados con una persona y sus datos de contacto. Estas dos mezclas pueden resultar útiles cuando crea esquemas para los datos de su propia compañía. Haga clic en una fila de mezcla específica o marque la casilla junto al nombre de la mezcla para ver cómo cambia la visualización.

Esquema con la mezcla de OOTB

NOTA

No pasa nada si una mezcla agrega un campo para un punto de datos que no se recopila. Por ejemplo, "faxPhone" puede ser un campo para el que Luma no recopila datos. 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.

Añadir mezclas personalizadas

Luego debemos agregar campos específicos al sistema de lealtad de Luma y que no existen en ninguna mezcla estándar. Para ello puede crear sus propias mezclas.

  1. En la sección Mezclas del editor de esquema, haga clic nuevamente en el botón Añadir

  2. Seleccione el botón de radio Crear nueva mezcla

  3. Escriba el nombre para mostrar como Luma Loyalty Mixin y haga clic en el botón Añadir mezcla
    Añadir campo a mezcla

  4. En la sección Mezclas del editor de esquema, haga clic en el nombre de la nueva mezcla para que los botones + aparezcan en la sección Estructura.

  5. En la sección Estructura, haga clic en + en el nivel superior de la estructura de Esquema. Creará un objeto con su identificación de inquilino (con un guión bajo como prefijo) y un campo 'Nuevo campo'.

  6. En la sección Propiedades del campo, introduzca lo siguiente

    1. Nombre del campo: loyalty
    2. Nombre para mostrar: Loyalty
    3. Tipo: Objeto
  7. Haga clic en Aplicar para agregar el campo

    Añadir campo a mezcla

  8. Seleccione el objeto loyalty recién creado y haga clic en el botón + situado junto al mismo para agregar un campo dentro del objeto

  9. Crear un campo con los valores siguientes

    1. Nombre del campo: memberSince
    2. Nombre para mostrar: Member Since
    3. Tipo: Fecha
  10. Haga clic en Aplicar para agregar el campo

  11. Repita el paso 8-10 para agregar dos campos más dentro del objeto loyalty:

    1. Puntos
      1. Nombre del campo: points
      2. Nombre para mostrar: Points
      3. Tipo: Entero
      4. Predeterminado: 0
    2. Nivel
      1. Nombre del campo: level

      2. Nombre para mostrar: Level

      3. Tipo:String

      4. Enum: Activado, con los siguientes valores de lista desglosada:

        Valor Etiqueta
        bronce Bronce
        silver Silver
        oro Oro
        platino Platino
  12. Haga clic en Guardar para guardar el estado actual del esquema, que debería tener este aspecto:

    Mezcla de lealtad finalizada

Ahora crearemos otra mezcla para contener el campo loyaltyId, así como otros identificadores que usaremos en los otros esquemas. Como ya está familiarizado con la creación de mezclas, cree una con el nombre Luma Identity Profile Mixin con los siguientes campos:

  1. Identificador del sistema
    1. Nombre del campo: systemIdentifier
    2. Nombre para mostrar: System Identifier
    3. Tipo: Objeto
  2. ID de lealtad (se incluye en el objeto systemIdentifier)
    1. Nombre del campo: loyaltyId
    2. Nombre para mostrar: Loyalty Id
    3. Tipo:String
  3. Id. de CRM (incluido en el objeto systemIdentifier)
    1. Nombre del campo: crmId
    2. Nombre para mostrar: CRM Id
    3. Tipo:String

Tu nueva mezcla debería tener este aspecto. Haga clic en el botón Guardar para guardar el esquema, pero deje el esquema abierto para el siguiente ejercicio.
Mezcla de lealtad finalizada

Crear un tipo de datos

Las mezclas, como la nueva Luma Loyalty Mixin, se pueden reutilizar en otros esquemas, lo que permite aplicar definiciones de datos estándar en varios sistemas. Sin embargo, las mezclas solo se pueden reutilizar en esquemas que comparten la misma clase, en este caso la clase de Perfil 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 el Luma Loyalty Schema aún abierto, seleccione el objeto systemIdentifier y haga clic en Convertir en nuevo tipo de datos

Mezcla de lealtad finalizada

Usaremos este tipo de datos más adelante en la lección.

Crear Esquema CRM mediante API

Ahora crearemos un esquema usando la API.

NOTA

Si prefiere omitir el ejercicio de API, puede crear el siguiente esquema con el método de IU que acaba de utilizar:

  1. Utilice la clase XDM Individual Perfil
  2. Asigne un nombre a Luma CRM Schema
  3. Utilice las siguientes mezclas: Detalles demográficos, detalles personales de contacto y Perfil de identidad de luminancia

Primero crearemos el esquema vacío:

  1. Open Postman

  2. Si no ha realizado una llamada en las últimas 24 horas, es probable que los tokens de autorización hayan caducado. Abra la llamada Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token y haga clic en Enviar para solicitar nuevos Tokenes de acceso y JWT, como hizo en la lección Postman.

  3. Abra las variables de entorno y cambie el valor de CONTENEDOR_ID de global a tenant. Recuerde que debe utilizar tenant siempre que desee interactuar con sus propios elementos personalizados en la plataforma, como crear un nuevo esquema.
    Cambiar CONTENEDOR_ID a inquilino

  4. Abra la llamada Schema Registry API > Schemas > Create a new tenant-defined schema

  5. Abra la ficha Body y pegue el siguiente código y haga clic en Send para realizar la llamada de API. Esto creará un nuevo esquema con la misma clase base XDM Individual Profile que se utilizó en el esquema de lealtad:

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

    Las referencias de Área de nombres para objetos de mezcla y clase estándar, en este y otros ejemplos de código posteriores, se pueden obtener mediante llamadas de API de lista como API de Registro de Esquema > Esquemas > Lista de todas las clases del contenedor especificado. o Schema Registry API > Mixins > Return a list of all mixins within the specified container. con el CONTAINER_ID conjunto en global y un encabezado de aceptación application/vnd.adobe.xdm+json.

  6. Debe obtener una respuesta 201 Created

  7. Copie meta:altId del cuerpo de respuesta. Lo usaremos más tarde en otro ejercicio.
    Crear el esquema CRM

  8. El nuevo esquema debe estar visible en la interfaz de usuario pero sin mezclas
    Crear el esquema CRM

NOTA

El meta:altId o ID de esquema también se puede obtener haciendo la solicitud de API Schema Registry API > Schemas > List all schemas within the specified container. con el CONTENEDOR_ID establecido en tenant y un encabezado de aceptación application/vnd.adobe.xdm+json.

CONSEJO

Problemas comunes que hacen esta llamada y posibles correcciones:

  • Sin autentificador: Ejecute el IMS: Llamada Generar + autenticación JWT mediante token de usuario para generar nuevos tokens
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/:: Actualice la variable CONTENEDOR_ IDenvironment de global a tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control:: Verificar los permisos de usuario en el Admin Console

Añadir mezclas estándar

Ahora es el momento de agregar las mezclas al esquema:

  1. En Postman, abra la llamada Schema Registry API > Schemas > Modify or update part of a tenant-defined schema

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

  3. Abra la ficha Cuerpo y pegue el siguiente código y haga clic en Enviar para realizar la llamada de API. Esto agregará las mezclas estándar a su 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 de 200 OK para la respuesta y las mezclas deben estar visibles como parte del esquema en la interfaz de usuario

    Se han añadido mezclas estándar

Añadir mezcla personalizada

Ahora vamos a agregar nuestra Mezcla de Perfiles de identidad al esquema. Mirando el cuerpo de la solicitud de nuestra última llamada, ¿cómo sabemos qué valor $ref utilizar para nuestra mezcla personalizada? Podemos encontrar el valor mediante una API de lista:

  1. Abra la llamada Schema Registry API > Mixins > Return a list of all mixins within the specified container.

  2. En la ficha Encabezados, actualice el encabezado Aceptar a application/vnd.adobe.xed-id+json

  3. Haga clic en el botón Enviar para recuperar una lista de todas las mezclas personalizadas de su cuenta

  4. Tome el valor $id del Luma Identity Profile Mixin (el suyo será diferente del valor de esta captura de pantalla)
    Recuperar la lista de mezclas

  5. Ahora vuelva a abrir la llamada Schema Registry API > Schemas > Modify or update part of a tenant-defined schema

  6. La ficha Params debe tener el $id de su esquema

  7. Abra la ficha Cuerpo y pegue el siguiente código, reemplazando el valor $ref por el $id de su propio Luma Identity Profile Mixin:

    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_MIXIN_ID"
      }
    }]
    
  8. Haga clic en Enviar

    Añadir la mezcla de identidades

Verifique que la mezcla se haya agregado al esquema comprobando la interfaz de usuario o, para obtener puntos adicionales, vea si puede averiguar cómo lista las mezclas en el esquema mediante la llamada Lookup a specific schema by its unique ID de la colección Postman.

Crear Esquema de Eventos de compra sin conexión

Ahora vamos a crear un esquema basado en la clase XDM ExperienceEvent para los datos de compra sin conexión de Luma. Dado que ahora se está familiarizando con la IU del editor de esquema, reduciré el número de capturas de pantalla en las instrucciones:

  1. Cree un esquema con la clase XDM ExperienceEvent denominada Luma Offline Purchase Events Schema

  2. Guárdela y revise la diferencia en la estructura base de los esquemas de clase de Perfil XDM. Notice_id y timestamp son campos obligatorios al utilizar la clase XDM ExperienceEvent.

    Estructura base de Experience Evento

A continuación, agregaremos una mezcla estándar y una mezcla personalizada.

Añadir mezcla estándar

Commerce Detailis es una mezcla estándar para capturar detalles de pedidos comunes. Adelante y añádalo a tu esquema. Dedique unos minutos a explorar los objetos del interior.

Añadir mezcla personalizada

Ahora agreguemos las identidades a nuestro nuevo esquema:

  1. En la sección Mezclas y haga clic en el botón Añadir.
  2. Busque Luma Identity Profile Mixin. Tenga en cuenta que no está disponible. Recuerde que las mezclas son específicas de una clase y este esquema utiliza la clase XDM ExperienceEvent en lugar de la clase XDM Individual Perfil. Se agregará una nueva combinación para la clase ExperienceEvent XDM que contiene los mismos campos de identidad exactos gracias a nuestro tipo de datos
  3. Seleccione el botón de radio Crear nueva mezcla
  4. Escriba el nombre para mostrar como Luma Identity ExperienceEvent Mixin y haga clic en el botón Añadir mezcla
  5. Asegúrese de que los botones + aparecen en la sección Estructura para poder agregar nuevos campos
  6. En la sección Estructura, haga clic en + en el nivel superior del esquema
  7. Como Nombre del campo, introduzca systemIdentifier
  8. Como Nombre para mostrar, introduzca System Identifier
  9. Como Tipo, seleccione Identificador del sistema, que es el tipo de datos personalizado que creó anteriormente
  10. Haga clic en el botón Aplicar
  11. Haga clic en el botón Guardar para guardar el esquema

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

Añadir el tipo de datos a la mezcla

Crear Esquema de Eventos Web

Ahora vamos a agregar un esquema más para los datos del sitio web de Luma. En este punto usted debería ser un experto en la creación de esquemas! Cree el siguiente esquema con estas propiedades

Propiedad Valor
Nombre del esquema Esquema de Eventos web Luma
Clase XDM ExperienceEvent
Mixin AEP Web SDK ExperienceEvent Mixin
Mixin Mezcla de Evento de experiencias de consumo

Haga clic en la mezcla del Evento de experiencias de consumo en la sección Composición del editor de esquema. Tenga en cuenta que esta mezcla contiene los objetos commerce y productListItems que también estaban en los Detalles del comercio. De hecho La mezcla de Evento de experiencias de consumo es una combinación de varias otras mezclas estándar que también están disponibles por separado.

Observe que no agregamos el Luma Identity ExperienceEvent Mixin 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 Composición del editor de esquema, observará que uno de los campos que agrega de forma predeterminada se llama IdentityMap. IdentityMap se utiliza en varias aplicaciones Adobe para vincular a Platform. Verá cómo se envían las identidades a Platform mediante identityMap en la lección de ingestión de flujo continuo.

Crear Esquema de catálogo de productos

Al utilizar las mezclas de Eventos de experiencias de consumo y detalles comerciales de Experience evento, Luma informa detalles de eventos relacionados con el producto a través del tipo de datos productListItems estándar. Pero también tienen campos adicionales de detalles del producto que les gustaría enviar a Platform. En lugar de capturar todos estos campos en sus sistemas de puntos de venta y comercio electrónico e ingerirlos en la plataforma utilizando los esquemas que acaba de crear, Luma preferiría simplemente ingerirlos directamente desde su sistema de catálogos de productos. Un "esquema de relación" en Plataforma permite definir una relación entre dos esquemas a efectos de clasificación. Luma utilizará un esquema de relación para clasificar los detalles del producto. Comenzaremos el proceso ahora y lo completaremos al final de la próxima lección.

NOTA

Si ya es cliente de Analytics o Destinatario, clasificar las entidades con esquema de relación es análogo a las clasificaciones de SAINT o cargar el catálogo de productos para Recommendations

Primero, necesitamos crear un esquema para el catálogo de productos de Luma con una clase personalizada:

  1. Haga clic en el botón Crear esquema y seleccione la opción Examinar en la lista desplegable
    Crear nuevo Esquema
  2. Seleccione el botón de radio Crear nueva clase
  3. Asigne un nombre a Luma Product Catalog Class
  4. Deje el Comportamiento como Registro
  5. Haga clic en el botón Asignar clase
    Crear nueva clase
  6. Asigne un nombre al esquema Luma Product Catalog Schema (asegúrese de actualizar el campo correcto y no actualizar el nombre de clase)
  7. Añada una nueva mezcla denominada Luma Product Catalog Mixin con los campos siguientes:
    1. productName: Nombre del producto: Cadena
    2. productCategory: Categoría del producto: Cadena
    3. productColor: Color del producto: Cadena
    4. productSku: SKU de producto: Cadena | Obligatorio
    5. productSize: Tamaño del producto: Cadena
    6. productPrice: Precio del producto: Doble
  8. Guardar el esquema

Tu nuevo esquema debería tener este aspecto. Observe cómo se muestra el campo productSku en la sección Campos requeridos:
Esquema del producto

El próximo paso es definir la relación entre los dos esquemas de ExperienceEvent y Luma Product Catalog Schema, pero hay algunos pasos adicionales que debemos seguir en la siguiente lección para poder hacerlo.

Recursos adicionales

Ahora que tiene sus esquemas, puede asignar identidades!

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now